DSL object used to configure product flavors.
Property | Description |
applicationId | The application ID. |
consumerProguardFiles | ProGuard rule files to be included in the published AAR. |
dimension | Name of the dimension this product flavor belongs to. |
flavorDimension | Deprecated Name of the dimension this product flavor belongs to. Has been replaced by
|
manifestPlaceholders | The manifest placeholders. |
multiDexEnabled | Whether Multi-Dex is enabled for this variant. |
proguardFiles | Returns ProGuard configuration files to be used. |
signingConfig | Signing config used by this product flavor. |
testApplicationId | Test application ID. |
testFunctionalTest | See instrumentation. |
testHandleProfiling | See instrumentation. |
testInstrumentationRunner | Test instrumentation runner class name. |
testInstrumentationRunnerArguments | Test instrumentation runner custom arguments.
e.g. |
useJack | Whether the experimental Jack toolchain should be used. |
versionCode | Version code. |
versionName | Version name. |
Method | Description |
maxSdkVersion(targetSdkVersion) | Sets the maximum SDK version to the given value. |
minSdkVersion(minSdkVersion) | Sets minimum SDK version. |
minSdkVersion(minSdkVersion) | Sets minimum SDK version. |
proguardFile(proguardFile) | Adds a new ProGuard configuration file. |
proguardFiles(proguardFileArray) | Adds new ProGuard configuration files. |
resConfig(config) | Adds a resource configuration filter. |
resConfigs(config) | Adds several resource configuration filters. |
resConfigs(config) | Adds several resource configuration filters. |
resValue(type, name, value) | Adds a new generated resource. |
setProguardFiles(proguardFileIterable) | Sets the ProGuard configuration files. |
targetSdkVersion(targetSdkVersion) | Sets the target SDK version to the given value. |
targetSdkVersion(targetSdkVersion) | Sets the target SDK version to the given value. |
testInstrumentationRunnerArgument(key, value) | Adds a custom argument to the test instrumentation runner, e.g: |
testInstrumentationRunnerArguments(args) | Adds custom arguments to the test instrumentation runner, e.g: |
useJack(useJack) | Whether the experimental Jack toolchain should be used. |
ProGuard rule files to be included in the published AAR.
These proguard rule files will then be used by any application project that consumes the AAR (if ProGuard is enabled).
This allows AAR to specify shrinking or obfuscation exclude rules.
This is only valid for Library project. This is ignored in Application project.
String
dimension
Name of the dimension this product flavor belongs to.
String
flavorDimension
Note: This property is deprecated and will be removed in a future version of the plugin.
Name of the dimension this product flavor belongs to. Has been replaced by
dimension
Boolean
multiDexEnabled
Whether Multi-Dex is enabled for this variant.
Returns ProGuard configuration files to be used.
There are 2 default rules files
- proguard-android.txt
- proguard-android-optimize.txt
They are located in the SDK. Using getDefaultProguardFile(String filename)
will return the
full path to the files. They are identical except for enabling optimizations.
See similarly named methods to specify the files.
SigningConfig
signingConfig
Signing config used by this product flavor.
Boolean
testFunctionalTest
See instrumentation.
Boolean
testHandleProfiling
See instrumentation.
String
testInstrumentationRunner
Test instrumentation runner class name.
This is a fully qualified class name of the runner, e.g.
android.test.InstrumentationTestRunner
See instrumentation.
Test instrumentation runner custom arguments.
e.g. [key: "value"]
will give
adb shell am instrument -w -e key value com.example
...".
See instrumentation.
Test runner arguments can also be specified from the command line:
INSTRUMENTATION_TEST_RUNNER_ARGS=size=medium,foo=bar ./gradlew connectedAndroidTest ./gradlew connectedAndroidTest -Pcom.android.tools.instrumentationTestRunnerArgs=size=medium,foo=bar
Sets the maximum SDK version to the given value.
void
minSdkVersion
(String
minSdkVersion)
Sets minimum SDK version.
void
proguardFile
(Object
proguardFile)
Adds a new ProGuard configuration file.
proguardFile getDefaultProguardFile('proguard-android.txt')
There are 2 default rules files
- proguard-android.txt
- proguard-android-optimize.txt
They are located in the SDK. Using getDefaultProguardFile(String filename)
will return the
full path to the files. They are identical except for enabling optimizations.
void
proguardFiles
(Object
...
proguardFileArray)
Object
...Adds new ProGuard configuration files.
There are 2 default rules files
- proguard-android.txt
- proguard-android-optimize.txt
They are located in the SDK. Using getDefaultProguardFile(String filename)
will return the
full path to the files. They are identical except for enabling optimizations.
void
resConfig
(String
config)
Adds a resource configuration filter.
If a qualifier value is passed, then all other resources using a qualifier of the same type but of different value will be ignored from the final packaging of the APK.
For instance, specifying 'hdpi', will ignore all resources using mdpi, xhdpi, etc...
void
resConfigs
(String
...
config)
String
...Adds several resource configuration filters.
If a qualifier value is passed, then all other resources using a qualifier of the same type but of different value will be ignored from the final packaging of the APK.
For instance, specifying 'hdpi', will ignore all resources using mdpi, xhdpi, etc...
void
resConfigs
(Collection
<String
>
config)
Collection
<String
>Adds several resource configuration filters.
If a qualifier value is passed, then all other resources using a qualifier of the same type but of different value will be ignored from the final packaging of the APK.
For instance, specifying 'hdpi', will ignore all resources using mdpi, xhdpi, etc...
Adds a new generated resource.
This is equivalent to specifying a resource in res/values.
See Resource Types.
void
setProguardFiles
(Iterable
<?>
proguardFileIterable)
Iterable
<?>Sets the ProGuard configuration files.
There are 2 default rules files
- proguard-android.txt
- proguard-android-optimize.txt
They are located in the SDK. Using getDefaultProguardFile(String filename)
will return the
full path to the files. They are identical except for enabling optimizations.
Sets the target SDK version to the given value.
void
targetSdkVersion
(String
targetSdkVersion)
Sets the target SDK version to the given value.
Adds a custom argument to the test instrumentation runner, e.g:
testInstrumentationRunnerArgument "size", "medium"
Test runner arguments can also be specified from the command line:
INSTRUMENTATION_TEST_RUNNER_ARGS=size=medium,foo=bar ./gradlew connectedAndroidTest ./gradlew connectedAndroidTest -Pcom.android.tools.instrumentationTestRunnerArgs=size=medium,foo=bar
Adds custom arguments to the test instrumentation runner, e.g:
testInstrumentationRunnerArguments(size: "medium", foo: "bar")
Test runner arguments can also be specified from the command line:
INSTRUMENTATION_TEST_RUNNER_ARGS=size=medium,foo=bar ./gradlew connectedAndroidTest ./gradlew connectedAndroidTest -Pcom.android.tools.instrumentationTestRunnerArgs=size=medium,foo=bar
void
useJack
(Boolean
useJack)
Whether the experimental Jack toolchain should be used.
See Jack and Jill