commit | 460479ec9886b591c00ca7f6a94ba1ba6243044d | [log] [tgz] |
---|---|---|
author | Xavier Ducrohet <xav@android.com> | Tue Aug 21 11:32:21 2012 -0700 |
committer | android code review <noreply-gerritcodereview@google.com> | Tue Aug 21 11:32:21 2012 -0700 |
tree | 5b23185088ef65af6eec893d9d4cc83f30fdba53 | |
parent | 1d963e6684952b9259e2be2b33b36b649f889f26 [diff] | |
parent | 08bd6cfc94cf36d4ab8540574fc8eaa3a6271c64 [diff] |
Merge "Initial prototype of Gradle plugin to build Android applications"
A prototype Gradle plugin to build Android applications. This is intended to be used to explore how such a plugin would look and to develop some ideas about how such a plugin would be implemented.
The plugin is functional, if a bit rough, and can generate packaged applications ready to install.
The plugin adds 2 concepts to the Gradle DSL:
release
and debug
. You can add additional build types.If you do not define any flavors for your product, a default flavor called main
is added.
From this, the plugin will add the appropriate tasks to build each combination of build type and product flavor. The plugin will also define the following source directories:
src/main/java
- Java source to be included in all application variants.src/main/res
- Resources to be included in all application variants.src/$BuildType/java
- Java source to be included in all application variants with the given build type.src/$BuildType/res
- Java source to be included in all application variants with the given build type.src/$ProductFlavor/java
- Resources to be included in all application variants with the given product flavor.src/$ProductFlavor/res
- Resources to be included in all application variants with the given product flavor.src/test/java
- Test source to be included in all test applications.src/test$ProductFlavor/java
- Test source to be include for the test application for the given product flavor.You can configure these locations by configuring the associated source set.
Compile time dependencies are declared in the usual way.
Have a look at the basic/build.gradle
and customized/build.gradle
build files to see the DSL in action.
android.packageName
- defaults to that specified in src/main/AndroidManifest.xml
android.versionCode
- defaults to that specified in src/main/AndroidManifest.xml
android.versionName
- defaults to that specified in src/main/AndroidManifest.xml
android.target
- defaults to android-16
.android.productFlavors.$flavor.packageName
- defaults to ${android.packageName}
android.productFlavors.$flavor.versionCode
- defaults to ${android.versionCode}
android.productFlavors.$flavor.versionName
- defaults to ${android.versionName}
android.buildTypes.$type.zipAlign
- defaults to true
for release
and false
for debug
sourceSets.main.java.srcDirs
- defaults to src/main/java
sourceSets.main.resources.srcDirs
- defaults to src/main/res
sourceSets.$flavor.java.srcDirs
- defaults to src/$flavor/java
sourceSets.$flavor.resources.srcDirs
- defaults to src/$flavor/res
sourceSets.$buildType.java.srcDirs
- defaults to src/$buildType/java
sourceSets.$buildType.resources.srcDirs
- defaults to src/$buildType/res
sourceSets.test.java.srcDirs
- defaults to src/test/java
sourceSets.test$Flavor.java.srcDirs
- defaults to src/test$Flavor/java
dependencies.compile
- compile time dependencies for all applications.The source tree contains the following:
buildSrc
directory contains the plugin implementation.basic
directory contains a simple application that follows the conventionscustomized
directory contains an application with some custom build types, product flavors and other customizations.multiproject
directory contains an application composed from several Gradle projects.Before you start, edit the basic/local.properties
and customized/local.properties
files to point at your local install of the Android SDK. Normally, these files would not be checked into source control, but would be generated when the project is bootstrapped.
Try ./gradlew basic:tasks
in the root directory.
You can also run:
assemble
- builds all combinations of build type and product flavorassemble$BuildType
- build all flavors for the given build type.assemble$ProductFlavor
- build all build types for the given product flavor.assemble$ProductFlavor$BuildType
- build the given application variant.install$ProductFlavor$BuildType
- build and install the given application variant.For each variant (product-flavor, build-type):
build/source
from resource directories (main-source-set, product-flavor-source-set, build-type-source-set)build/libs
build/resources
build/libs
build/libs
.Some other notes:
sourceSets.main.compileClasspath
as the compile classpath for each variant. Could potentially also include sourceSets.$BuildType.compileClasspath
and sourceSets.$ProductFlavor.compileClasspath
as well.