diff options
Diffstat (limited to 'files/ant/build.xml')
| -rw-r--r-- | files/ant/build.xml | 1534 |
1 files changed, 1534 insertions, 0 deletions
diff --git a/files/ant/build.xml b/files/ant/build.xml new file mode 100644 index 000000000..aab440c4e --- /dev/null +++ b/files/ant/build.xml @@ -0,0 +1,1534 @@ +<?xml version="1.0" encoding="UTF-8"?> +<project name="android_rules" default="debug"> + + <!-- + This build file is imported by the project build file. It contains + all the targets and tasks necessary to build Android projects, be they + regular projects, library projects, or test projects. + + At the beginning of the file is a list of properties that can be overridden + by adding them to your ant.properties (properties are immutable, so their + first definition sticks and is never changed). + + Follows: + - custom task definitions, + - more properties (do not override those unless the whole build system is modified). + - macros used throughout the build, + - base build targets, + - debug-specific build targets, + - release-specific build targets, + - instrument-specific build targets, + - test project-specific build targets, + - install targets, + - help target + --> + + <!-- ******************************************************* --> + <!-- **************** Overridable Properties *************** --> + <!-- ******************************************************* --> + + <!-- You can override these values in your build.xml or ant.properties. + Overriding any other properties may result in broken build. --> + + <!-- Tells adb which device to target. You can change this from the command line + by invoking "ant -Dadb.device.arg=-d" for device "ant -Dadb.device.arg=-e" for + the emulator. --> + <property name="adb.device.arg" value="" /> + + <!-- fileset exclude patterns (space separated) to prevent + files inside src/ from being packaged. --> + <property name="android.package.excludes" value="" /> + + <!-- set some properties used for filtering/override. If those weren't defined + before, then this will create them with empty values, which are then ignored + by the custom tasks receiving them. --> + <property name="version.code" value="" /> + <property name="version.name" value="" /> + <property name="aapt.resource.filter" value="" /> + <!-- 'aapt.ignore.assets' is the list of file patterns to ignore under /res and /assets. + Default is "!.svn:!.git:.*:<dir>_*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~" + + Overall patterns syntax is: + [!][<dir>|<file>][*suffix-match|prefix-match*|full-match]:more:patterns... + + - The first character flag ! avoids printing a warning. + - Pattern can have the flag "<dir>" to match only directories + or "<file>" to match only files. Default is to match both. + - Match is not case-sensitive. + --> + <property name="aapt.ignore.assets" value="" /> + + <!-- dex force jumbo options, to be used when dex merging fails with + UNEXPECTED TOP-LEVEL EXCEPTION: com.android.dx.util.DexException: Cannot handle conversion to jumbo index! + at com.android.dx.merge.InstructionTransformer.jumboCheck(InstructionTransformer.java:103) + ... + --> + <property name="dex.force.jumbo" value="false" /> + <property name="dex.disable.merger" value="false" /> + + <!-- compilation options --> + <property name="java.encoding" value="UTF-8" /> + <property name="java.target" value="1.5" /> + <property name="java.source" value="1.5" /> + <property name="java.compilerargs" value="" /> + <property name="java.compiler.classpath" value="" /> + + <!-- Renderscript options --> + <property name="renderscript.debug.opt.level" value="O0" /> + <property name="renderscript.release.opt.level" value="O3" /> + <property name="renderscript.support.mode" value="false" /> + + <!-- manifest merger default value --> + <property name="manifestmerger.enabled" value="false" /> + + <!-- instrumentation options --> + <property name="emma.filter" value="" /> + + <!-- Verbosity --> + <property name="verbose" value="false" /> + + <!-- Output location of the HTML report for the "lint" target. + Ideally this would be specified as + value="${out.dir}/lint-results.html" + but we can't make a forward reference to the definition for + ${out.dir}, and it is not a configurable property (yet). + --> + <property name="lint.out.html" value="bin/lint-results.html" /> + + <!-- Output location of the XML report for the "lint" target --> + <property name="lint.out.xml" value="bin/lint-results.xml" /> + + <!-- ******************************************************* --> + <!-- ********************* Custom Tasks ******************** --> + <!-- ******************************************************* --> + + <!-- jar file from where the tasks are loaded --> + <path id="android.antlibs"> + <pathelement path="${sdk.dir}/tools/lib/ant-tasks.jar" /> + </path> + + <!-- Custom tasks --> + <taskdef resource="anttasks.properties" classpathref="android.antlibs" /> + + <!-- Emma configuration --> + <property name="emma.dir" value="${sdk.dir}/tools/lib" /> + <path id="emma.lib"> + <pathelement location="${emma.dir}/emma.jar" /> + <pathelement location="${emma.dir}/emma_ant.jar" /> + </path> + <taskdef resource="emma_ant.properties" classpathref="emma.lib" /> + <!-- End of emma configuration --> + + + <!-- ******************************************************* --> + <!-- ******************* Other Properties ****************** --> + <!-- ******************************************************* --> + <!-- overriding these properties may break the build + unless the whole file is updated --> + + <!-- Input directories --> + <property name="source.dir" value="src" /> + <property name="source.absolute.dir" location="${source.dir}" /> + <property name="gen.absolute.dir" location="gen" /> + <property name="resource.absolute.dir" location="res" /> + <property name="asset.dir" value="assets" /> + <property name="asset.absolute.dir" location="${asset.dir}" /> + <property name="jar.libs.dir" value="libs" /> + <property name="jar.libs.absolute.dir" location="${jar.libs.dir}" /> + <property name="native.libs.absolute.dir" location="libs" /> + + <property name="manifest.file" value="AndroidManifest.xml" /> + <property name="manifest.abs.file" location="${manifest.file}" /> + + <!-- Output directories --> + <property name="out.dir" value="bin" /> + <property name="out.absolute.dir" location="${out.dir}" /> + <property name="out.classes.absolute.dir" location="${out.dir}/classes" /> + <property name="out.res.absolute.dir" location="${out.dir}/res" /> + <property name="out.rs.obj.absolute.dir" location="${out.dir}/rsObj" /> + <property name="out.rs.libs.absolute.dir" location="${out.dir}/rsLibs" /> + <property name="out.aidl.absolute.dir" location="${out.dir}/aidl" /> + <property name="out.dexed.absolute.dir" location="${out.dir}/dexedLibs" /> + <property name="out.manifest.abs.file" location="${out.dir}/AndroidManifest.xml" /> + + <!-- tools location --> + <property name="android.tools.dir" location="${sdk.dir}/tools" /> + <property name="android.platform.tools.dir" location="${sdk.dir}/platform-tools" /> + <condition property="exe" value=".exe" else=""><os family="windows" /></condition> + <condition property="bat" value=".bat" else=""><os family="windows" /></condition> + <property name="adb" location="${android.platform.tools.dir}/adb${exe}" /> + <property name="lint" location="${android.tools.dir}/lint${bat}" /> + + <!-- Intermediate files --> + <property name="dex.file.name" value="classes.dex" /> + <property name="intermediate.dex.file" location="${out.absolute.dir}/${dex.file.name}" /> + <property name="resource.package.file.name" value="${ant.project.name}.ap_" /> + + <!-- Build property file --> + <property name="out.build.prop.file" location="${out.absolute.dir}/build.prop" /> + + + <!-- This is needed by emma as it uses multilevel verbosity instead of simple 'true' or 'false' + The property 'verbosity' is not user configurable and depends exclusively on 'verbose' + value.--> + <condition property="verbosity" value="verbose" else="quiet"> + <istrue value="${verbose}" /> + </condition> + + <!-- properties for signing in release mode --> + <condition property="has.keystore"> + <and> + <isset property="key.store" /> + <length string="${key.store}" when="greater" length="0" /> + <isset property="key.alias" /> + </and> + </condition> + <condition property="has.password"> + <and> + <isset property="has.keystore" /> + <isset property="key.store.password" /> + <isset property="key.alias.password" /> + </and> + </condition> + + <!-- properties for packaging --> + <property name="build.packaging.nocrunch" value="true" /> + + <!-- whether we need to fork javac. + This is only needed on Windows when running Java < 7 --> + <condition else="false" property="need.javac.fork"> + <and> + <matches pattern="1\.[56]" string="${java.specification.version}"/> + <not> + <os family="unix"/> + </not> + </and> + </condition> + + <!-- ******************************************************* --> + <!-- ************************ Macros *********************** --> + <!-- ******************************************************* --> + + <!-- macro to do a task on if project.is.library is false. + elseText attribute is displayed otherwise --> + <macrodef name="do-only-if-not-library"> + <attribute name="elseText" /> + <element name="task-to-do" implicit="yes" /> + <sequential> + <if condition="${project.is.library}"> + <else> + <task-to-do /> + </else> + <then> + <echo level="info">@{elseText}</echo> + </then> + </if> + </sequential> + </macrodef> + + <!-- macro to do a task on if manifest.hasCode is true. + elseText attribute is displayed otherwise --> + <macrodef name="do-only-if-manifest-hasCode"> + <attribute name="elseText" default=""/> + <element name="task-to-do" implicit="yes" /> + <sequential> + <if condition="${manifest.hasCode}"> + <then> + <task-to-do /> + </then> + <else> + <if> + <condition> + <length string="@{elseText}" trim="true" when="greater" length="0" /> + </condition> + <then> + <echo level="info">@{elseText}</echo> + </then> + </if> + </else> + </if> + </sequential> + </macrodef> + + + <!-- Configurable macro, which allows to pass as parameters output directory, + output dex filename and external libraries to dex (optional) --> + <macrodef name="dex-helper"> + <element name="external-libs" optional="yes" /> + <attribute name="nolocals" default="false" /> + <sequential> + <!-- sets the primary input for dex. If a pre-dex task sets it to + something else this has no effect --> + <property name="out.dex.input.absolute.dir" value="${out.classes.absolute.dir}" /> + + <!-- set the secondary dx input: the project (and library) jar files + If a pre-dex task sets it to something else this has no effect --> + <if> + <condition> + <isreference refid="out.dex.jar.input.ref" /> + </condition> + <else> + <path id="out.dex.jar.input.ref"> + <path refid="project.all.jars.path" /> + </path> + </else> + </if> + + <dex executable="${dx}" + output="${intermediate.dex.file}" + dexedlibs="${out.dexed.absolute.dir}" + nolocals="@{nolocals}" + forceJumbo="${dex.force.jumbo}" + disableDexMerger="${dex.disable.merger}" + verbose="${verbose}"> + <path path="${out.dex.input.absolute.dir}"/> + <path refid="out.dex.jar.input.ref" /> + <external-libs /> + </dex> + </sequential> + </macrodef> + + <!-- This is macro that enable passing variable list of external jar files to ApkBuilder + Example of use: + <package-helper> + <extra-jars> + <jarfolder path="my_jars" /> + <jarfile path="foo/bar.jar" /> + <jarfolder path="your_jars" /> + </extra-jars> + </package-helper> --> + <macrodef name="package-helper"> + <element name="extra-jars" optional="yes" /> + <sequential> + <apkbuilder + outfolder="${out.absolute.dir}" + resourcefile="${resource.package.file.name}" + apkfilepath="${out.packaged.file}" + debugpackaging="${build.is.packaging.debug}" + debugsigning="${build.is.signing.debug}" + verbose="${verbose}" + hascode="${manifest.hasCode}" + previousBuildType="${build.last.is.packaging.debug}/${build.last.is.signing.debug}" + buildType="${build.is.packaging.debug}/${build.is.signing.debug}"> + <dex path="${intermediate.dex.file}"/> + <sourcefolder path="${source.absolute.dir}"/> + <jarfile refid="project.all.jars.path" /> + <nativefolder path="${native.libs.absolute.dir}" /> + <nativefolder refid="project.library.native.folder.path" /> + <nativefolder refid="project.rs.support.libs.path" /> + <nativefolder path="${out.rs.libs.absolute.dir}" /> + <extra-jars/> + </apkbuilder> + </sequential> + </macrodef> + + <!-- This is macro which zipaligns in.package and outputs it to out.package. Used by targets + debug, -debug-with-emma and release.--> + <macrodef name="zipalign-helper"> + <attribute name="in.package" /> + <attribute name="out.package" /> + <sequential> + <zipalign + executable="${zipalign}" + input="@{in.package}" + output="@{out.package}" + verbose="${verbose}" /> + </sequential> + </macrodef> + + <macrodef name="run-tests-helper"> + <attribute name="emma.enabled" default="false" /> + <element name="extra-instrument-args" optional="yes" /> + <sequential> + <echo level="info">Running tests ...</echo> + <exec executable="${adb}" failonerror="true"> + <arg line="${adb.device.arg}" /> + <arg value="shell" /> + <arg value="am" /> + <arg value="instrument" /> + <arg value="-w" /> + <arg value="-e" /> + <arg value="coverage" /> + <arg value="@{emma.enabled}" /> + <extra-instrument-args /> + <arg value="${project.app.package}/${test.runner}" /> + </exec> + </sequential> + </macrodef> + + <macrodef name="record-build-key"> + <attribute name="key" default="false" /> + <attribute name="value" default="false" /> + <sequential> + <propertyfile file="${out.build.prop.file}" comment="Last build type"> + <entry key="@{key}" value="@{value}"/> + </propertyfile> + </sequential> + </macrodef> + + <macrodef name="record-build-info"> + <sequential> + <record-build-key key="build.last.target" value="${build.target}" /> + <record-build-key key="build.last.is.instrumented" value="${build.is.instrumented}" /> + <record-build-key key="build.last.is.packaging.debug" value="${build.is.packaging.debug}" /> + <record-build-key key="build.last.is.signing.debug" value="${build.is.signing.debug}" /> + </sequential> + </macrodef> + + <macrodef name="uninstall-helper"> + <attribute name="app.package" default="false" /> + <sequential> + <echo level="info">Uninstalling @{app.package} from the default emulator or device...</echo> + <exec executable="${adb}" failonerror="true"> + <arg line="${adb.device.arg}" /> + <arg value="uninstall" /> + <arg value="@{app.package}" /> + </exec> + </sequential> + </macrodef> + + <!-- ******************************************************* --> + <!-- ******************** Build Targets ******************** --> + <!-- ******************************************************* --> + + <!-- Basic Ant + SDK check --> + <target name="-check-env"> + <checkenv /> + </target> + + <!-- target to disable building dependencies --> + <target name="nodeps"> + <property name="dont.do.deps" value="true" /> + </target> + + <!-- generic setup --> + <target name="-setup" depends="-check-env"> + <echo level="info">Project Name: ${ant.project.name}</echo> + <gettype projectTypeOut="project.type" /> + + <!-- sets a few boolean based on project.type + to make the if task easier --> + <condition property="project.is.library" value="true" else="false"> + <equals arg1="${project.type}" arg2="library" /> + </condition> + <condition property="project.is.test" value="true" else="false"> + <equals arg1="${project.type}" arg2="test" /> + </condition> + <condition property="project.is.testapp" value="true" else="false"> + <equals arg1="${project.type}" arg2="test-app" /> + </condition> + + <!-- If a test project, resolve absolute path to tested project. --> + <if condition="${project.is.test}"> + <then> + <property name="tested.project.absolute.dir" location="${tested.project.dir}" /> + </then> + </if> + + <!-- get the project manifest package --> + <xpath input="${manifest.abs.file}" + expression="/manifest/@package" output="project.app.package" /> + + </target> + + <!-- empty default pre-clean target. Create a similar target in + your build.xml and it'll be called instead of this one. --> + <target name="-pre-clean"/> + + <!-- clean target --> + <target name="clean" depends="-setup, -pre-clean" + description="Removes output files created by other targets."> + <delete dir="${out.absolute.dir}" verbose="${verbose}" /> + <delete dir="${gen.absolute.dir}" verbose="${verbose}" /> + + <!-- if we know about a tested project or libraries, we clean them too. --> + <if condition="${project.is.test}"> + <then> + <property name="tested.project.absolute.dir" location="${tested.project.dir}" /> + <subant failonerror="true"> + <fileset dir="${tested.project.absolute.dir}" includes="build.xml" /> + <target name="clean" /> + </subant> + </then> + </if> + + <!-- get all the libraries --> + <if> + <condition><not><isset property="dont.do.deps" /></not></condition> + <then> + <getlibpath libraryFolderPathOut="project.library.folder.path" /> + <if> + <condition> + <isreference refid="project.library.folder.path" /> + </condition> + <then> + <!-- clean the libraries with nodeps since we already + know about all the libraries even the indirect one --> + <subant + buildpathref="project.library.folder.path" + antfile="build.xml" + failonerror="true"> + <target name="nodeps" /> + <target name="clean" /> + </subant> + </then> + </if> + </then> + </if> + </target> + + <!-- Pre build setup --> + <target name="-build-setup" depends="-setup"> + <!-- find location of build tools --> + <getbuildtools name="android.build.tools.dir" verbose="${verbose}" /> + + <!-- read the previous build mode --> + <property file="${out.build.prop.file}" /> + <!-- if empty the props won't be set, meaning it's a new build. + To force a build, set the prop to empty values. --> + <property name="build.last.target" value="" /> + <property name="build.last.is.instrumented" value="" /> + <property name="build.last.is.packaging.debug" value="" /> + <property name="build.last.is.signing.debug" value="" /> + + <!-- If the "debug" build type changed, clear out the compiled code. + This is to make sure the new BuildConfig.DEBUG value is picked up + as javac can't deal with this type of change in its dependency computation. --> + <if> + <condition> + <and> + <length string="${build.last.is.packaging.debug}" trim="true" when="greater" length="0" /> + <not><equals + arg1="${build.is.packaging.debug}" + arg2="${build.last.is.packaging.debug}" /></not> + </and> + </condition> + <then> + <echo level="info">Switching between debug and non debug build: Deleting previous compilation output...</echo> + <delete dir="${out.classes.absolute.dir}" verbose="${verbose}" /> + </then> + <else> + <!-- Else, we may still need to clean the code, for another reason. + special case for instrumented: if the previous build was + instrumented but not this one, clear out the compiled code --> + <if> + <condition> + <and> + <istrue value="${build.last.is.instrumented}" /> + <isfalse value="${build.is.instrumented}" /> + </and> + </condition> + <then> + <echo level="info">Switching from instrumented to non-instrumented build: Deleting previous compilation output...</echo> + <delete dir="${out.classes.absolute.dir}" verbose="${verbose}" /> + </then> + </if> + </else> + </if> + + <echo level="info">Resolving Build Target for ${ant.project.name}...</echo> + <!-- load project properties, resolve Android target, library dependencies + and set some properties with the results. + All property names are passed as parameters ending in -Out --> + <gettarget + androidJarFileOut="project.target.android.jar" + androidAidlFileOut="project.target.framework.aidl" + bootClassPathOut="project.target.class.path" + targetApiOut="project.target.apilevel" + minSdkVersionOut="project.minSdkVersion" /> + + <!-- Value of the hasCode attribute (Application node) extracted from manifest file --> + <xpath input="${manifest.abs.file}" expression="/manifest/application/@android:hasCode" + output="manifest.hasCode" default="true"/> + + <echo level="info">----------</echo> + <echo level="info">Creating output directories if needed...</echo> + <mkdir dir="${resource.absolute.dir}" /> + <mkdir dir="${jar.libs.absolute.dir}" /> + <mkdir dir="${out.absolute.dir}" /> + <mkdir dir="${out.res.absolute.dir}" /> + <mkdir dir="${out.rs.obj.absolute.dir}" /> + <mkdir dir="${out.rs.libs.absolute.dir}" /> + <do-only-if-manifest-hasCode> + <mkdir dir="${gen.absolute.dir}" /> + <mkdir dir="${out.classes.absolute.dir}" /> + <mkdir dir="${out.dexed.absolute.dir}" /> + </do-only-if-manifest-hasCode> + + <echo level="info">----------</echo> + <echo level="info">Resolving Dependencies for ${ant.project.name}...</echo> + <dependency + libraryFolderPathOut="project.library.folder.path" + libraryPackagesOut="project.library.packages" + libraryManifestFilePathOut="project.library.manifest.file.path" + libraryResFolderPathOut="project.library.res.folder.path" + libraryBinAidlFolderPathOut="project.library.bin.aidl.folder.path" + libraryRFilePathOut="project.library.bin.r.file.path" + libraryNativeFolderPathOut="project.library.native.folder.path" + jarLibraryPathOut="project.all.jars.path" + targetApi="${project.target.apilevel}" + renderscriptSupportMode="${renderscript.support.mode}" + buildToolsFolder="${android.build.tools.dir}" + renderscriptSupportLibsOut="project.rs.support.libs.path" + verbose="${verbose}" /> + + <!-- compile the libraries if any --> + <if> + <condition> + <and> + <isreference refid="project.library.folder.path" /> + <not><isset property="dont.do.deps" /></not> + </and> + </condition> + <then> + <!-- figure out which target must be used to build the library projects. + If emma is enabled, then use 'instrument' otherwise, use 'debug' --> + <condition property="project.libraries.target" value="instrument" else="${build.target}"> + <istrue value="${build.is.instrumented}" /> + </condition> + + <echo level="info">----------</echo> + <echo level="info">Building Libraries with '${project.libraries.target}'...</echo> + + <!-- no need to build the deps as we have already + the full list of libraries --> + <subant failonerror="true" + buildpathref="project.library.folder.path" + antfile="build.xml"> + <target name="nodeps" /> + <target name="${project.libraries.target}" /> + <property name="emma.coverage.absolute.file" location="${out.absolute.dir}/coverage.em" /> + </subant> + </then> + </if> + + <!-- compile the main project if this is a test project --> + <if condition="${project.is.test}"> + <then> + <!-- figure out which target must be used to build the tested project. + If emma is enabled, then use 'instrument' otherwise, use 'debug' --> + <condition property="tested.project.target" value="instrument" else="debug"> + <isset property="emma.enabled" /> + </condition> + + <echo level="info">----------</echo> + <echo level="info">Building tested project at ${tested.project.absolute.dir} with '${tested.project.target}'...</echo> + <subant target="${tested.project.target}" failonerror="true"> + <fileset dir="${tested.project.absolute.dir}" includes="build.xml" /> + </subant> + + <!-- get the tested project full classpath to be able to build + the test project --> + <testedprojectclasspath + projectLocation="${tested.project.absolute.dir}" + projectClassPathOut="tested.project.classpath"/> + </then> + <else> + <!-- no tested project, make an empty Path object so that javac doesn't + complain --> + <path id="tested.project.classpath" /> + </else> + </if> + </target> + + <!-- empty default pre-build target. Create a similar target in + your build.xml and it'll be called instead of this one. --> + <target name="-pre-build"/> + + <!-- Code Generation: compile resources (aapt -> R.java), aidl, renderscript --> + <target name="-code-gen"> + <!-- always merge manifest --> + <mergemanifest + appManifest="${manifest.abs.file}" + outManifest="${out.manifest.abs.file}" + enabled="${manifestmerger.enabled}"> + <library refid="project.library.manifest.file.path" /> + </mergemanifest> + + <do-only-if-manifest-hasCode + elseText="hasCode = false. Skipping aidl/renderscript/R.java"> + <echo level="info">Handling aidl files...</echo> + <aidl executable="${aidl}" + framework="${project.target.framework.aidl}" + libraryBinAidlFolderPathRefid="project.library.bin.aidl.folder.path" + genFolder="${gen.absolute.dir}" + aidlOutFolder="${out.aidl.absolute.dir}"> + <source path="${source.absolute.dir}"/> + </aidl> + + <!-- renderscript generates resources so it must be called before aapt --> + <echo level="info">----------</echo> + <echo level="info">Handling RenderScript files...</echo> + <!-- set the rs target prop in case it hasn't been set. --> + <property name="renderscript.target" value="${project.minSdkVersion}" /> + <renderscript + buildToolsRoot="${android.build.tools.dir}" + genFolder="${gen.absolute.dir}" + resFolder="${out.res.absolute.dir}" + rsObjFolder="${out.rs.obj.absolute.dir}" + libsFolder="${out.rs.libs.absolute.dir}" + targetApi="${renderscript.target}" + optLevel="${renderscript.opt.level}" + supportMode="${renderscript.support.mode}" + binFolder="${out.absolute.dir}" + buildType="${build.is.packaging.debug}" + previousBuildType="${build.last.is.packaging.debug}"> + <source path="${source.absolute.dir}"/> + </renderscript> + + <echo level="info">----------</echo> + <echo level="info">Handling Resources...</echo> + <aapt executable="${aapt}" + command="package" + verbose="${verbose}" + manifest="${out.manifest.abs.file}" + originalManifestPackage="${project.app.package}" + androidjar="${project.target.android.jar}" + rfolder="${gen.absolute.dir}" + nonConstantId="${android.library}" + libraryResFolderPathRefid="project.library.res.folder.path" + libraryPackagesRefid="project.library.packages" + libraryRFileRefid="project.library.bin.r.file.path" + ignoreAssets="${aapt.ignore.assets}" + binFolder="${out.absolute.dir}" + proguardFile="${out.absolute.dir}/proguard.txt"> + <res path="${out.res.absolute.dir}" /> + <res path="${resource.absolute.dir}" /> + </aapt> + + <echo level="info">----------</echo> + <echo level="info">Handling BuildConfig class...</echo> + <buildconfig + genFolder="${gen.absolute.dir}" + package="${project.app.package}" + buildType="${build.is.packaging.debug}" + previousBuildType="${build.last.is.packaging.debug}"/> + + </do-only-if-manifest-hasCode> + </target> + + <!-- empty default pre-compile target. Create a similar target in + your build.xml and it'll be called instead of this one. --> + <target name="-pre-compile"/> + + <!-- Compiles this project's .java files into .class files. --> + <target name="-compile" depends="-pre-build, -build-setup, -code-gen, -pre-compile"> + <do-only-if-manifest-hasCode elseText="hasCode = false. Skipping..."> + <!-- merge the project's own classpath and the tested project's classpath --> + <path id="project.javac.classpath"> + <path refid="project.all.jars.path" /> + <path refid="tested.project.classpath" /> + <path path="${java.compiler.classpath}" /> + </path> + <javac encoding="${java.encoding}" + source="${java.source}" target="${java.target}" + debug="true" extdirs="" includeantruntime="false" + destdir="${out.classes.absolute.dir}" + bootclasspathref="project.target.class.path" + verbose="${verbose}" + classpathref="project.javac.classpath" + fork="${need.javac.fork}"> + <src path="${source.absolute.dir}" /> + <src path="${gen.absolute.dir}" /> + <compilerarg line="${java.compilerargs}" /> + </javac> + + <!-- if the project is instrumented, intrument the classes --> + <if condition="${build.is.instrumented}"> + <then> + <echo level="info">Instrumenting classes from ${out.absolute.dir}/classes...</echo> + + <!-- build the filter to remove R, Manifest, BuildConfig --> + <getemmafilter + appPackage="${project.app.package}" + libraryPackagesRefId="project.library.packages" + filterOut="emma.default.filter"/> + + <!-- define where the .em file is going. This may have been + setup already if this is a library --> + <property name="emma.coverage.absolute.file" location="${out.absolute.dir}/coverage.em" /> + + <!-- It only instruments class files, not any external libs --> + <emma enabled="true"> + <instr verbosity="${verbosity}" + mode="overwrite" + instrpath="${out.absolute.dir}/classes" + outdir="${out.absolute.dir}/classes" + metadatafile="${emma.coverage.absolute.file}"> + <filter excludes="${emma.default.filter}" /> + <filter value="${emma.filter}" /> + </instr> + </emma> + </then> + </if> + + <!-- if the project is a library then we generate a jar file --> + <if condition="${project.is.library}"> + <then> + <echo level="info">Creating library output jar file...</echo> + <property name="out.library.jar.file" location="${out.absolute.dir}/classes.jar" /> + <if> + <condition> + <length string="${android.package.excludes}" trim="true" when="greater" length="0" /> + </condition> + <then> + <echo level="info">Custom jar packaging exclusion: ${android.package.excludes}</echo> + </then> + </if> + + <propertybyreplace name="project.app.package.path" input="${project.app.package}" replace="." with="/" /> + + <jar destfile="${out.library.jar.file}"> + <fileset dir="${out.classes.absolute.dir}" + includes="**/*.class" + excludes="${project.app.package.path}/R.class ${project.app.package.path}/R$*.class ${project.app.package.path}/BuildConfig.class"/> + <fileset dir="${source.absolute.dir}" excludes="**/*.java ${android.package.excludes}" /> + </jar> + </then> + </if> + + </do-only-if-manifest-hasCode> + </target> + + <!-- empty default post-compile target. Create a similar target in + your build.xml and it'll be called instead of this one. --> + <target name="-post-compile"/> + + <!-- Obfuscate target + This is only active in release builds when proguard.config is defined + in default.properties. + + To replace Proguard with a different obfuscation engine: + Override the following targets in your build.xml, before the call to <setup> + -release-obfuscation-check + Check whether obfuscation should happen, and put the result in a property. + -debug-obfuscation-check + Obfuscation should not happen. Set the same property to false. + -obfuscate + check if the property set in -debug/release-obfuscation-check is set to true. + If true: + Perform obfuscation + Set property out.dex.input.absolute.dir to be the output of the obfuscation + --> + <target name="-obfuscate"> + <if condition="${proguard.enabled}"> + <then> + <property name="obfuscate.absolute.dir" location="${out.absolute.dir}/proguard" /> + <property name="preobfuscate.jar.file" value="${obfuscate.absolute.dir}/original.jar" /> + <property name="obfuscated.jar.file" value="${obfuscate.absolute.dir}/obfuscated.jar" /> + <!-- input for dex will be proguard's output --> + <property name="out.dex.input.absolute.dir" value="${obfuscated.jar.file}" /> + + <!-- Add Proguard Tasks --> + <property name="proguard.jar" location="${android.tools.dir}/proguard/lib/proguard.jar" /> + <taskdef name="proguard" classname="proguard.ant.ProGuardTask" classpath="${proguard.jar}" /> + + <!-- Set the android classpath Path object into a single property. It'll be + all the jar files separated by a platform path-separator. + Each path must be quoted if it contains spaces. + --> + <pathconvert property="project.target.classpath.value" refid="project.target.class.path"> + <firstmatchmapper> + <regexpmapper from='^([^ ]*)( .*)$$' to='"\1\2"'/> + <identitymapper/> + </firstmatchmapper> + </pathconvert> + + <!-- Build a path object with all the jar files that must be obfuscated. + This include the project compiled source code and any 3rd party jar + files. --> + <path id="project.all.classes.path"> + <pathelement location="${preobfuscate.jar.file}" /> + <path refid="project.all.jars.path" /> + </path> + <!-- Set the project jar files Path object into a single property. It'll be + all the jar files separated by a platform path-separator. + Each path must be quoted if it contains spaces. + --> + <pathconvert property="project.all.classes.value" refid="project.all.classes.path"> + <firstmatchmapper> + <regexpmapper from='^([^ ]*)( .*)$$' to='"\1\2"'/> + <identitymapper/> + </firstmatchmapper> + </pathconvert> + + <!-- Turn the path property ${proguard.config} from an A:B:C property + into a series of includes: -include A -include B -include C + suitable for processing by the ProGuard task. Note - this does + not include the leading '-include "' or the closing '"'; those + are added under the <proguard> call below. + --> + <path id="proguard.configpath"> + <pathelement path="${proguard.config}"/> + </path> + <pathconvert pathsep='" -include "' property="proguard.configcmd" refid="proguard.configpath"/> + + <mkdir dir="${obfuscate.absolute.dir}" /> + <delete file="${preobfuscate.jar.file}"/> + <delete file="${obfuscated.jar.file}"/> + <jar basedir="${out.classes.absolute.dir}" + destfile="${preobfuscate.jar.file}" /> + <proguard> + -include "${proguard.configcmd}" + -include "${out.absolute.dir}/proguard.txt" + -injars ${project.all.classes.value} + -outjars "${obfuscated.jar.file}" + -libraryjars ${project.target.classpath.value} + -dump "${obfuscate.absolute.dir}/dump.txt" + -printseeds "${obfuscate.absolute.dir}/seeds.txt" + -printusage "${obfuscate.absolute.dir}/usage.txt" + -printmapping "${obfuscate.absolute.dir}/mapping.txt" + </proguard> + </then> + </if> + </target> + + <!-- Converts this project's .class files into .dex files --> + <target name="-dex" depends="-compile, -post-compile, -obfuscate"> + <do-only-if-manifest-hasCode elseText="hasCode = false. Skipping..."> + <!-- only convert to dalvik bytecode is *not* a library --> + <do-only-if-not-library elseText="Library project: do not convert bytecode..." > + <!-- special case for instrumented builds: need to use no-locals and need + to pass in the emma jar. --> + <if condition="${build.is.instrumented}"> + <then> + <dex-helper nolocals="true"> + <external-libs> + <fileset file="${emma.dir}/emma_device.jar" /> + </external-libs> + </dex-helper> + </then> + <else> + <dex-helper /> + </else> + </if> + </do-only-if-not-library> + </do-only-if-manifest-hasCode> + </target> + +<!-- Updates the pre-processed PNG cache --> + <target name="-crunch"> + <exec executable="${aapt}" taskName="crunch"> + <arg value="crunch" /> + <arg value="-v" /> + <arg value="-S" /> + <arg path="${resource.absolute.dir}" /> + <arg value="-C" /> + <arg path="${out.res.absolute.dir}" /> + </exec> + </target> + + <!-- Puts the project's resources into the output package file + This actually can create multiple resource package in case + Some custom apk with specific configuration have been + declared in default.properties. + --> + <target name="-package-resources" depends="-crunch"> + <!-- only package resources if *not* a library project --> + <do-only-if-not-library elseText="Library project: do not package resources..." > + <aapt executable="${aapt}" + command="package" + versioncode="${version.code}" + versionname="${version.name}" + debug="${build.is.packaging.debug}" + manifest="${out.manifest.abs.file}" + assets="${asset.absolute.dir}" + androidjar="${project.target.android.jar}" + apkfolder="${out.absolute.dir}" + nocrunch="${build.packaging.nocrunch}" + resourcefilename="${resource.package.file.name}" + resourcefilter="${aapt.resource.filter}" + libraryResFolderPathRefid="project.library.res.folder.path" + libraryPackagesRefid="project.library.packages" + libraryRFileRefid="project.library.bin.r.file.path" + previousBuildType="${build.last.target}" + buildType="${build.target}" + ignoreAssets="${aapt.ignore.assets}"> + <res path="${out.res.absolute.dir}" /> + <res path="${resource.absolute.dir}" /> + <!-- <nocompress /> forces no compression on any files in assets or res/raw --> + <!-- <nocompress extension="xml" /> forces no compression on specific file extensions in assets and res/raw --> + </aapt> + </do-only-if-not-library> + </target> + + <!-- Packages the application. --> + <target name="-package" depends="-dex, -package-resources"> + <!-- only package apk if *not* a library project --> + <do-only-if-not-library elseText="Library project: do not package apk..." > + <if condition="${build.is.instrumented}"> + <then> + <package-helper> + <extra-jars> + <!-- Injected from external file --> + <jarfile path="${emma.dir}/emma_device.jar" /> + </extra-jars> + </package-helper> + </then> + <else> + <package-helper /> + </else> + </if> + </do-only-if-not-library> + </target> + + <target name="-post-package" /> + <target name="-post-build" /> + + <target name="-set-mode-check"> + <fail if="build.is.mode.set" + message="Cannot run two different modes at the same time. If you are running more than one debug/release/instrument type targets, call them from different Ant calls." /> + </target> + + <!-- ******************************************************* --> + <!-- **************** Debug specific targets *************** --> + <!-- ******************************************************* --> + + <target name="-set-debug-files" depends="-set-mode-check"> + + <property name="out.packaged.file" location="${out.absolute.dir}/${ant.project.name}-debug-unaligned.apk" /> + <property name="out.final.file" location="${out.absolute.dir}/${ant.project.name}-debug.apk" /> + <property name="build.is.mode.set" value="true" /> + </target> + + + <target name="-set-debug-mode" depends="-setup"> + <!-- record the current build target --> + <property name="build.target" value="debug" /> + + <if> + <condition> + <and> + <istrue value="${project.is.testapp}" /> + <istrue value="${emma.enabled}" /> + </and> + </condition> + <then> + <property name="build.is.instrumented" value="true" /> + </then> + <else> + <property name="build.is.instrumented" value="false" /> + </else> + </if> + + <!-- whether the build is a debug build. always set. --> + <property name="build.is.packaging.debug" value="true" /> + + <!-- signing mode: debug --> + <property name="build.is.signing.debug" value="true" /> + + <!-- Renderscript optimization level: none --> + <property name="renderscript.opt.level" value="${renderscript.debug.opt.level}" /> + + </target> + + <target name="-debug-obfuscation-check"> + <!-- proguard is never enabled in debug mode --> + <property name="proguard.enabled" value="false"/> + </target> + + <!-- Builds debug output package --> + <target name="-do-debug" depends="-set-debug-mode, -debug-obfuscation-check, -package, -post-package"> + <!-- only create apk if *not* a library project --> + <do-only-if-not-library elseText="Library project: do not create apk..." > + <sequential> + <zipalign-helper in.package="${out.packaged.file}" out.package="${out.final.file}" /> + <echo level="info">Debug Package: ${out.final.file}</echo> + </sequential> + </do-only-if-not-library> + <record-build-info /> + </target> + + <!-- Builds debug output package --> + <target name="debug" depends="-set-debug-files, -do-debug, -post-build" + description="Builds the application and signs it with a debug key."> + </target> + + + <!-- ******************************************************* --> + <!-- *************** Release specific targets ************** --> + <!-- ******************************************************* --> + + <!-- called through target 'release'. Only executed if the keystore and + key alias are known but not their password. --> + <target name="-release-prompt-for-password" if="has.keystore" unless="has.password"> + <!-- Gets passwords --> + <input + message="Please enter keystore password (store:${key.store}):" + addproperty="key.store.password" /> + <input + message="Please enter password for alias '${key.alias}':" + addproperty="key.alias.password" /> + </target> + + <!-- called through target 'release'. Only executed if there's no + keystore/key alias set --> + <target name="-release-nosign" unless="has.keystore"> + <!-- no release builds for library project --> + <do-only-if-not-library elseText="" > + <sequential> + <echo level="info">No key.store and key.alias properties found in build.properties.</echo> + <echo level="info">Please sign ${out.packaged.file} manually</echo> + <echo level="info">and run zipalign from the Android SDK tools.</echo> + </sequential> + </do-only-if-not-library> + <record-build-info /> + </target> + + <target name="-release-obfuscation-check"> + <echo level="info">proguard.config is ${proguard.config}</echo> + <condition property="proguard.enabled" value="true" else="false"> + <and> + <isset property="build.is.mode.release" /> + <isset property="proguard.config" /> + </and> + </condition> + <if condition="${proguard.enabled}"> + <then> + <echo level="info">Proguard.config is enabled</echo> + <!-- Secondary dx input (jar files) is empty since all the + jar files will be in the obfuscated jar --> + <path id="out.dex.jar.input.ref" /> + </then> + </if> + </target> + + <target name="-set-release-mode" depends="-set-mode-check"> + <property name="out.packaged.file" location="${out.absolute.dir}/${ant.project.name}-release-unsigned.apk" /> + <property name="out.final.file" location="${out.absolute.dir}/${ant.project.name}-release.apk" /> + <property name="build.is.mode.set" value="true" /> + + <!-- record the current build target --> + <property name="build.target" value="release" /> + + <property name="build.is.instrumented" value="false" /> + + <!-- release mode is only valid if the manifest does not explicitly + set debuggable to true. default is false. --> + <xpath input="${manifest.abs.file}" expression="/manifest/application/@android:debuggable" + output="build.is.packaging.debug" default="false"/> + + <!-- signing mode: release --> + <property name="build.is.signing.debug" value="false" /> + + <!-- Renderscript optimization level: aggressive --> + <property name="renderscript.opt.level" value="${renderscript.release.opt.level}" /> + + <if condition="${build.is.packaging.debug}"> + <then> + <echo>*************************************************</echo> + <echo>**** Android Manifest has debuggable=true ****</echo> + <echo>**** Doing DEBUG packaging with RELEASE keys ****</echo> + <echo>*************************************************</echo> + </then> + <else> + <!-- property only set in release mode. + Useful for if/unless attributes in target node + when using Ant before 1.8 --> + <property name="build.is.mode.release" value="true"/> + </else> + </if> + </target> + + <target name="-release-sign" if="has.keystore" > + <!-- only create apk if *not* a library project --> + <do-only-if-not-library elseText="Library project: do not create apk..." > + <sequential> + <property name="out.unaligned.file" location="${out.absolute.dir}/${ant.project.name}-release-unaligned.apk" /> + + <!-- Signs the APK --> + <echo level="info">Signing final apk...</echo> + <signapk + input="${out.packaged.file}" + output="${out.unaligned.file}" + keystore="${key.store}" + storepass="${key.store.password}" + alias="${key.alias}" + keypass="${key.alias.password}"/> + + <!-- Zip aligns the APK --> + <zipalign-helper + in.package="${out.unaligned.file}" + out.package="${out.final.file}" /> + <echo level="info">Release Package: ${out.final.file}</echo> + </sequential> + </do-only-if-not-library> + <record-build-info /> + </target> + + <!-- This runs -package-release and -release-nosign first and then runs + only if release-sign is true (set in -release-check, + called by -release-no-sign)--> + <target name="release" + depends="-set-release-mode, -release-obfuscation-check, -package, -post-package, -release-prompt-for-password, -release-nosign, -release-sign, -post-build" + description="Builds the application in release mode."> + </target> + + <!-- ******************************************************* --> + <!-- ************ Instrumented specific targets ************ --> + <!-- ******************************************************* --> + + <!-- These targets are specific for the project under test when it + gets compiled by the test projects in a way that will make it + support emma code coverage --> + + <target name="-set-instrumented-mode" depends="-set-mode-check"> + <property name="out.packaged.file" location="${out.absolute.dir}/${ant.project.name}-instrumented-unaligned.apk" /> + <property name="out.final.file" location="${out.absolute.dir}/${ant.project.name}-instrumented.apk" /> + <property name="build.is.mode.set" value="true" /> + + <!-- whether the build is an instrumented build. --> + <property name="build.is.instrumented" value="true" /> + </target> + + <!-- Builds instrumented output package --> + <target name="instrument" depends="-set-instrumented-mode, -do-debug" + description="Builds an instrumented packaged."> + <!-- only create apk if *not* a library project --> + <do-only-if-not-library elseText="Library project: do not create apk..." > + <sequential> + <zipalign-helper in.package="${out.packaged.file}" out.package="${out.final.file}" /> + <echo level="info">Instrumented Package: ${out.final.file}</echo> + </sequential> + </do-only-if-not-library> + <record-build-info /> + </target> + + <!-- ******************************************************* --> + <!-- ************ Test project specific targets ************ --> + <!-- ******************************************************* --> + + <!-- enable code coverage --> + <target name="emma"> + <property name="emma.enabled" value="true" /> + </target> + + <!-- fails if the project is not a test project --> + <target name="-test-project-check" depends="-setup"> + <if> + <condition> + <and> + <isfalse value="${project.is.test}" /> + <isfalse value="${project.is.testapp}" /> + </and> + </condition> + <then> + <fail message="Project is not a test project." /> + </then> + </if> + </target> + + <target name="test" depends="-test-project-check" + description="Runs tests from the package defined in test.package property"> + <property name="test.runner" value="android.test.InstrumentationTestRunner" /> + + <if condition="${project.is.test}"> + <then> + <property name="tested.project.absolute.dir" location="${tested.project.dir}" /> + + <!-- Application package of the tested project extracted from its manifest file --> + <xpath input="${tested.project.absolute.dir}/AndroidManifest.xml" + expression="/manifest/@package" output="tested.project.app.package" /> + + <if condition="${emma.enabled}"> + <then> + <getprojectpaths projectPath="${tested.project.absolute.dir}" + binOut="tested.project.out.absolute.dir" + srcOut="tested.project.source.absolute.dir" /> + + <getlibpath projectPath="${tested.project.absolute.dir}" + libraryFolderPathOut="tested.project.lib.source.path" + leaf="@{source.dir}" /> + + </then> + </if> + + </then> + <else> + <!-- this is a test app, the tested package is the app's own package --> + <property name="tested.project.app.package" value="${project.app.package}" /> + + <if condition="${emma.enabled}"> + <then> + <property name="tested.project.out.absolute.dir" value="${out.absolute.dir}" /> + <property name="tested.project.source.absolute.dir" value="${source.absolute.dir}" /> + + <getlibpath + libraryFolderPathOut="tested.project.lib.source.path" + leaf="@{source.dir}" /> + + </then> + </if> + + </else> + </if> + + <property name="emma.dump.file" + value="/data/data/${tested.project.app.package}/coverage.ec" /> + + <if condition="${emma.enabled}"> + <then> + <echo>Running tests...</echo> + <run-tests-helper emma.enabled="true"> + <extra-instrument-args> + <arg value="-e" /> + <arg value="coverageFile" /> + <arg value="${emma.dump.file}" /> + </extra-instrument-args> + </run-tests-helper> + + <echo level="info">Setting permission to download the coverage file...</echo> + <exec executable="${adb}" failonerror="true"> + <arg line="${adb.device.arg}" /> + <arg value="shell" /> + <arg value="run-as" /> + <arg value="${tested.project.app.package}" /> + <arg value="chmod" /> + <arg value="644" /> + <arg value="${emma.dump.file}" /> + </exec> + <echo level="info">Downloading coverage file into project directory...</echo> + <exec executable="${adb}" failonerror="true"> + <arg line="${adb.device.arg}" /> + <arg value="pull" /> + <arg value="${emma.dump.file}" /> + <arg path="${out.absolute.dir}/coverage.ec" /> + </exec> + + <pathconvert property="tested.project.lib.source.path.value" refid="tested.project.lib.source.path"> + <firstmatchmapper> + <regexpmapper from='^([^ ]*)( .*)$$' to='"\1\2"'/> + <identitymapper/> + </firstmatchmapper> + </pathconvert> + + <echo level="info">Extracting coverage report...</echo> + <emma> + <property name="report.html.out.encoding" value="UTF-8" /> + <report sourcepath="${tested.project.source.absolute.dir}:${tested.project.lib.source.path.value}" + verbosity="${verbosity}"> + <!-- TODO: report.dir or something like should be introduced if necessary --> + <infileset file="${out.absolute.dir}/coverage.ec" /> + <infileset file="${tested.project.out.absolute.dir}/coverage.em" /> + <!-- TODO: reports in other, indicated by user formats --> + <html outfile="${out.absolute.dir}/coverage.html" /> + <txt outfile="${out.absolute.dir}/coverage.txt" /> + <xml outfile="${out.absolute.dir}/coverage.xml" /> + </report> + </emma> + <echo level="info">Cleaning up temporary files...</echo> + <delete file="${out.absolute.dir}/coverage.ec" /> + <delete file="${tested.project.out.absolute.dir}/coverage.em" /> + <exec executable="${adb}" failonerror="true"> + <arg line="${adb.device.arg}" /> + <arg value="shell" /> + <arg value="run-as" /> + <arg value="${tested.project.app.package}" /> + <arg value="rm" /> + <arg value="${emma.dump.file}" /> + </exec> + <echo level="info">Saving the coverage reports in ${out.absolute.dir}</echo> + </then> + <else> + <run-tests-helper /> + </else> + </if> + </target> + + <!-- ******************************************************* --> + <!-- ********** Run Lint on the project ********* --> + <!-- ******************************************************* --> + + <target name="lint" + description="Runs lint on the project to look for potential bugs" > + <lint executable="${lint}" + html="${lint.out.html}" + xml="${lint.out.xml}" + src="${source.absolute.dir}:${gen.absolute.dir}" + classpath="${out.classes.absolute.dir}" /> + </target> + + <!-- ******************************************************* --> + <!-- ********** Install/uninstall specific targets ********* --> + <!-- ******************************************************* --> + + <target name="install" + description="Installs the newly build package. Must be used in conjunction with a build target + (debug/release/instrument). If the application was previously installed, the application + is reinstalled if the signature matches." > + <!-- only do install if *not* a library project --> + <do-only-if-not-library elseText="Library project: nothing to install!" > + <if> + <condition> + <isset property="out.final.file" /> + </condition> + <then> + <if> + <condition> + <resourceexists> + <file file="${out.final.file}"/> + </resourceexists> + </condition> + <then> + <echo level="info">Installing ${out.final.file} onto default emulator or device...</echo> + <exec executable="${adb}" failonerror="true"> + <arg line="${adb.device.arg}" /> + <arg value="install" /> + <arg value="-r" /> + <arg path="${out.final.file}" /> + </exec> + + <!-- now install the tested project if applicable --> + <!-- can't use project.is.test since the setup target might not have run --> + <if> + <condition> + <and> + <isset property="tested.project.dir" /> + <not> + <isset property="dont.do.deps" /> + </not> + </and> + </condition> + <then> + <property name="tested.project.absolute.dir" location="${tested.project.dir}" /> + + <!-- figure out which tested package to install based on emma.enabled --> + <condition property="tested.project.install.target" value="installi" else="installd"> + <isset property="emma.enabled" /> + </condition> + <subant target="${tested.project.install.target}" failonerror="true"> + <fileset dir="${tested.project.absolute.dir}" includes="build.xml" /> + </subant> + </then> + </if> + </then> + <else> + <fail message="File ${out.final.file} does not exist." /> + </else> + </if> + </then> + <else> + <echo>Install file not specified.</echo> + <echo></echo> + <echo>'ant install' now requires the build target to be specified as well.</echo> + <echo></echo> + <echo></echo> + <echo> ant debug install</echo> + <echo> ant release install</echo> + <echo> ant instrument install</echo> + <echo>This will build the given package and install it.</echo> + <echo></echo> + <echo>Alternatively, you can use</echo> + <echo> ant installd</echo> + <echo> ant installr</echo> + <echo> ant installi</echo> + <echo> ant installt</echo> + <echo>to only install an existing package (this will not rebuild the package.)</echo> + <fail /> + </else> + </if> + </do-only-if-not-library> + </target> + + <target name="installd" depends="-set-debug-files, install" + description="Installs (only) the debug package." /> + <target name="installr" depends="-set-release-mode, install" + description="Installs (only) the release package." /> + <target name="installi" depends="-set-instrumented-mode, install" + description="Installs (only) the instrumented package." /> + <target name="installt" depends="-test-project-check, installd" + description="Installs (only) the test and tested packages." /> + + + <!-- Uninstalls the package from the default emulator/device --> + <target name="uninstall" depends="-setup" + description="Uninstalls the application from a running emulator or device."> + <if> + <condition> + <isset property="project.app.package" /> + </condition> + <then> + <uninstall-helper app.package="${project.app.package}" /> + </then> + <else> + <fail message="Could not find application package in manifest. Cannot run 'adb uninstall'." /> + </else> + </if> + + <!-- Now uninstall the tested project, if applicable --> + <if> + <condition> + <and> + <istrue value="${project.is.test}" /> + <not> + <isset property="dont.do.deps" /> + </not> + </and> + </condition> + <then> + <property name="tested.project.absolute.dir" location="${tested.project.dir}" /> + + <!-- Application package of the tested project extracted from its manifest file --> + <xpath input="${tested.project.absolute.dir}/AndroidManifest.xml" + expression="/manifest/@package" output="tested.project.app.package" /> + <if> + <condition> + <isset property="tested.project.app.package" /> + </condition> + <then> + <uninstall-helper app.package="${tested.project.app.package}" /> + </then> + <else> + <fail message="Could not find tested application package in manifest. Cannot run 'adb uninstall'." /> + </else> + </if> + </then> + </if> + + </target> + + + <!-- ******************************************************* --> + <!-- ************************* Help ************************ --> + <!-- ******************************************************* --> + + <target name="help"> + <!-- displays starts at col 13 + |13 80| --> + <echo>Android Ant Build. Available targets:</echo> + <echo> help: Displays this help.</echo> + <echo> clean: Removes output files created by other targets.</echo> + <echo> This calls the same target on all dependent projects.</echo> + <echo> Use 'ant nodeps clean' to only clean the local project</echo> + <echo> debug: Builds the application and signs it with a debug key.</echo> + <echo> The 'nodeps' target can be used to only build the</echo> + <echo> current project and ignore the libraries using:</echo> + <echo> 'ant nodeps debug'</echo> + <echo> release: Builds the application. The generated apk file must be</echo> + <echo> signed before it is published.</echo> + <echo> The 'nodeps' target can be used to only build the</echo> + <echo> current project and ignore the libraries using:</echo> + <echo> 'ant nodeps release'</echo> + <echo> instrument:Builds an instrumented package and signs it with a</echo> + <echo> debug key.</echo> + <echo> test: Runs the tests. Project must be a test project and</echo> + <echo> must have been built. Typical usage would be:</echo> + <echo> ant [emma] debug install test</echo> + <echo> emma: Transiently enables code coverage for subsequent</echo> + <echo> targets.</echo> + <echo> install: Installs the newly build package. Must either be used</echo> + <echo> in conjunction with a build target (debug/release/</echo> + <echo> instrument) or with the proper suffix indicating</echo> + <echo> which package to install (see below).</echo> + <echo> If the application was previously installed, the</echo> + <echo> application is reinstalled if the signature matches.</echo> + <echo> installd: Installs (only) the debug package.</echo> + <echo> installr: Installs (only) the release package.</echo> + <echo> installi: Installs (only) the instrumented package.</echo> + <echo> installt: Installs (only) the test and tested packages (unless</echo> + <echo> nodeps is used as well.</echo> + <echo> uninstall: Uninstalls the application from a running emulator or</echo> + <echo> device. Also uninstall tested package if applicable</echo> + <echo> unless 'nodeps' is used as well.</echo> + </target> +</project> |