Android.sdk QML Type
Provides support for building Android packages. More...
Import Statement: | import QbsModules |
Since: | Qbs 1.4 |
Properties
- aaptName : string
(since Qbs 1.17)
- aidlSearchPaths : stringList
- apkBaseName : string
- assetsDir : path
- automaticSources : bool
- buildToolsVersion : string
- dexCompilerName : string
(since Qbs 1.20)
- embedJar : bool
(since Qbs 1.10)
- manifestFile : string
- minimumVersion : string
(since Qbs 1.17)
- ndkDir : string
- packageName : string
- packageType : string
(since Qbs 1.17)
- platform : string
- resourcesDir : path
- sdkDir : string
- sourcesDir : path
- targetVersion : string
(since Qbs 1.17)
- versionCode : string
- versionName : string
Detailed Description
The Android.sdk module contains the properties and rules to create Android application packages from Java sources, resources, and so on. It is usually pulled in indirectly by declaring an Application product.
Relevant File Tags
Tag | Auto-tagged File Names | Since | Description |
---|---|---|---|
"android.aidl" | *.aidl | 1.4.0 | Attached to Android AIDL files. One Java source file will be generated for each such file. |
"android.assets" | - | 1.4.0 | Attached to Android assets, which are typically located in an assets/ subdirectory. These files are tagged automatically if the automaticSources property is enabled. |
"android.manifest" | AndroidManifest.xml | 1.4.0 | Attached to the Android manifest. There must be one such file for every Android app. |
"android.resources" | - | 1.4.0 | Attached to Android resources, which are typically located in a res/ subdirectory. These files are tagged automatically if the automaticSources property is enabled. |
Property Documentation
aaptName: string
Name of the aapt binary. Allowed options: "aapt" and "aapt2".
Default: "aapt2"
This property was introduced in Qbs 1.17.
aidlSearchPaths: stringList
Search paths for import statements to pass to the aidl
tool via the -I
option.
apkBaseName: string
The base name of the APK file to to be built, that is, the file name without the ".apk" extension.
Default: packageName
assetsDir: path
The base directory for Android assets in the respective product.
Note: Android requires that the file name of this directory is always "assets"
.
Default: "src/main/assets"
in the product source directory
automaticSources: bool
If true
, Java sources as well as Android resources, assets, and the manifest file will be automatically included in the respective product via wildcards. Set this property to false
if you want to specify these files manually.
Default: true
buildToolsVersion: string
The version of the build tools such as aapt
and dx
.
Default: Highest build tools version version available in the SDK.
dexCompilerName: string
Name of the dex compiler binary. Allowed options: "dx" and "d8".
Default: "d8"
This property was introduced in Qbs 1.20.
embedJar: bool
If true
, then if the dependency is a JAR file, its classes and the classes of its dependencies (if embedJar
is also true for them) will be recursively processed by dex
and included in the final APK.
Default: true
This property was introduced in Qbs 1.10.
manifestFile: string
The file path to the Android manifest file. This property is only relevant if automaticSources is enabled.
Note: Android requires that the file name is always "AndroidManifest.xml".
Default: "src/main/AndroidManifest.xml"
in the product source directory
minimumVersion: string
Minimum API Level required for the application to run.
Default: "21"
This property was introduced in Qbs 1.17.
ndkDir: string
The NDK base directory, if an NDK is present.
Default: Determined automatically based on standard search paths.
packageName: string
The package name of the respective product. The package
attribute in the manifest file will be set to this value automatically.
Default: name
packageType: string
Type of the package. Allowed options: "apk" and "aab". Type "apk" generates a runnable package whereas "aab" generates a package for Google Play.
Default: "apk"
This property was introduced in Qbs 1.17.
platform: string
The versioned platform name (for example, "android-21"
).
Default: Highest build tools version version available in the SDK.
resourcesDir: path
The base directory for Android resources in the respective product.
Note: Android requires that the file name of this directory is always "res"
.
Default: "src/main/res"
in the product source directory
sdkDir: string
The SDK base directory.
Default: Determined automatically based on standard search paths.
sourcesDir: path
The base directory for Java sources. This property is only relevant if automaticSources is enabled.
Default: "src/main/java"
in the product source directory
targetVersion: string
API Level that the application targets.
Default: platformVersion
This property was introduced in Qbs 1.17.
versionCode: string
The Android Manifest version code of the respective product. The android:versionCode
attribute in the manifest file will be set to this value if not undefined.
In the following example we provide an architecture-specific value for android:versionCode
:
// ... property int _version: 1 property int _patchVersion: 0 Android.sdk.versionCode: { switch (Android.ndk.abi) { case "armeabi-v7a": return 132000000 | _version * 10 + _patchVersion; case "arm64-v8a": return 164000000 | _version * 10 + _patchVersion; case "x86": return 232000000 | _version * 10 + _patchVersion; case "x86_64": return 264000000 | _version * 10 + _patchVersion; } throw "Unknown architecture"; }
Default: undefined
versionName: string
The Android Manifest version name of the respective product. The android:versionName
attribute in the manifest file will be set to this value if not undefined.
Default: undefined