/* * Copyright (C) 2009 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.android.ant; import org.apache.tools.ant.BuildException; import org.apache.tools.ant.Project; import org.apache.tools.ant.Task; import org.apache.tools.ant.taskdefs.ExecTask; import org.apache.tools.ant.types.Path; import java.io.File; import java.util.ArrayList; /** * Task able to run an Exec task on aapt several times. *

It does not follow the exec task format, instead it has its own parameters, which maps * directly to aapt.

*

The following map shows how to use the task for each supported aapt command line * parameter.

* * * * * * * * * * * * * * * *
Aapt OptionAnt NameType
path to aaptexecutableattribute (Path)
commandcommandattribute (String)
-vverboseattribute (boolean)
-fforceattribute (boolean)
-M AndroidManifest.xmlmanifestattribute (Path)
-I base-packageandroidjarattribute (Path)
-A asset-source-dirassetsattribute (Path
-S resource-sources<res path="">nested element(s)
with attribute (Path)
-0 extension<nocompress extension="">
<nocompress>
nested element(s)
with attribute (String)
-F apk-fileapkfolder
outfolder
apkbasename
basename
attribute (Path)
attribute (Path) deprecated
attribute (String)
attribute (String) deprecated
-J R-file-dirrfolderattribute (Path)
-m always enabled
*/ public final class AaptExecLoopTask extends Task { /** * Class representing a <nocompress> node in the main task XML. * This let the developers prevent compression of some files in assets/ and res/raw/ * by extension. * If the extension is null, this will disable compression for all files in assets/ and * res/raw/ */ public final static class NoCompress { String mExtension; /** * Sets the value of the "extension" attribute. * @param extention the extension. */ public void setExtension(String extention) { mExtension = extention; } } private String mExecutable; private String mCommand; private boolean mForce = true; // true due to legacy reasons private boolean mVerbose = false; private int mVersionCode = 0; private String mManifest; private ArrayList mResources; private String mAssets; private String mAndroidJar; private String mApkFolder; @Deprecated private String mApkBaseName; private String mApkName; private String mResourceFilter; private String mRFolder; private final ArrayList mNoCompressList = new ArrayList(); /** * Sets the value of the "executable" attribute. * @param executable the value. */ public void setExecutable(Path executable) { mExecutable = TaskHelper.checkSinglePath("executable", executable); } /** * Sets the value of the "command" attribute. * @param command the value. */ public void setCommand(String command) { mCommand = command; } /** * Sets the value of the "force" attribute. * @param force the value. */ public void setForce(boolean force) { mForce = force; } /** * Sets the value of the "verbose" attribute. * @param verbose the value. */ public void setVerbose(boolean verbose) { mVerbose = verbose; } public void setVersioncode(String versionCode) { if (versionCode.length() > 0) { try { mVersionCode = Integer.decode(versionCode); } catch (NumberFormatException e) { System.out.println(String.format( "WARNING: Ignoring invalid version code value '%s'.", versionCode)); } } } /** * Sets the value of the "manifest" attribute. * @param manifest the value. */ public void setManifest(Path manifest) { mManifest = TaskHelper.checkSinglePath("manifest", manifest); } /** * Sets the value of the "resources" attribute. * @param resources the value. * * @deprecated Use nested element(s) */ @Deprecated public void setResources(Path resources) { System.out.println("WARNNG: Using deprecated 'resources' attribute in AaptExecLoopTask." + "Use nested element(s) instead."); if (mResources == null) { mResources = new ArrayList(); } mResources.add(new Path(getProject(), resources.toString())); } /** * Sets the value of the "assets" attribute. * @param assets the value. */ public void setAssets(Path assets) { mAssets = TaskHelper.checkSinglePath("assets", assets); } /** * Sets the value of the "androidjar" attribute. * @param androidJar the value. */ public void setAndroidjar(Path androidJar) { mAndroidJar = TaskHelper.checkSinglePath("androidjar", androidJar); } /** * Sets the value of the "outfolder" attribute. * @param outFolder the value. * @deprecated use {@link #setApkfolder(Path)} */ @Deprecated public void setOutfolder(Path outFolder) { System.out.println("WARNNG: Using deprecated 'outfolder' attribute in AaptExecLoopTask." + "Use 'apkfolder' (path) instead."); mApkFolder = TaskHelper.checkSinglePath("outfolder", outFolder); } /** * Sets the value of the "apkfolder" attribute. * @param apkFolder the value. */ public void setApkfolder(Path apkFolder) { mApkFolder = TaskHelper.checkSinglePath("apkfolder", apkFolder); } /** * Sets the value of the "basename" attribute. * @param baseName the value. * @deprecated use {@link #setApkbasename(String)} */ @Deprecated public void setBasename(String baseName) { System.out.println("WARNNG: Using deprecated 'basename' attribute in AaptExecLoopTask." + "Use 'resourceFilename' (string) instead."); mApkBaseName = baseName; } /** * Sets the value of the "apkbasename" attribute. * @param apkbaseName the value. */ public void setApkbasename(String apkbaseName) { System.out.println("WARNNG: Using deprecated 'apkbasename' attribute in AaptExecLoopTask." + "Use 'resourceFilename' (string) instead."); mApkBaseName = apkbaseName; } /** * Sets the value of the apkname attribute * @param apkName the value */ public void setResourceFilename(String apkName) { mApkName = apkName; } /** * Sets the value of the "rfolder" attribute. * @param rFolder the value. */ public void setRfolder(Path rFolder) { mRFolder = TaskHelper.checkSinglePath("rfolder", rFolder); } public void setresourceFilter(String filter) { if (filter != null && filter.length() > 0) { mResourceFilter = filter; } } /** * Returns an object representing a nested nocompress element. */ public Object createNocompress() { NoCompress nc = new NoCompress(); mNoCompressList.add(nc); return nc; } /** * Returns an object representing a nested res element. */ public Object createRes() { if (mResources == null) { mResources = new ArrayList(); } Path path = new Path(getProject()); mResources.add(path); return path; } /* * (non-Javadoc) * * Executes the loop. Based on the values inside default.properties, this will * create alternate temporary ap_ files. * * @see org.apache.tools.ant.Task#execute() */ @Override public void execute() throws BuildException { Project taskProject = getProject(); // first do a full resource package callAapt(null /*customPackage*/); // if the parameters indicate generation of the R class, check if // more R classes need to be created for libraries. if (mRFolder != null && new File(mRFolder).isDirectory()) { String libPkgProp = taskProject.getProperty("android.libraries.package"); if (libPkgProp != null) { // get the main package to compare in case the libraries use the same String mainPackage = taskProject.getProperty("manifest.package"); String[] libPkgs = libPkgProp.split(";"); for (String libPkg : libPkgs) { if (libPkg.length() > 0 && mainPackage.equals(libPkg) == false) { // FIXME: instead of recreating R.java from scratch, maybe copy // the files (R.java and manifest.java)? This would force to replace // the package line on the fly. callAapt(libPkg); } } } } } /** * Calls aapt with the given parameters. * @param resourceFilter the resource configuration filter to pass to aapt (if configName is * non null) * @param customPackage an optional custom package. */ private void callAapt(String customPackage) { Project taskProject = getProject(); final boolean generateRClass = mRFolder != null && new File(mRFolder).isDirectory(); if (generateRClass) { } else if (mResourceFilter == null) { System.out.println("Creating full resource package..."); } else { System.out.println(String.format( "Creating resource package with filter: (%1$s)...", mResourceFilter)); } // create a task for the default apk. ExecTask task = new ExecTask(); task.setExecutable(mExecutable); task.setFailonerror(true); // aapt command. Only "package" is supported at this time really. task.createArg().setValue(mCommand); // force flag if (mForce) { task.createArg().setValue("-f"); } // verbose flag if (mVerbose) { task.createArg().setValue("-v"); } if (generateRClass) { task.createArg().setValue("-m"); } // filters if needed if (mResourceFilter != null) { task.createArg().setValue("-c"); task.createArg().setValue(mResourceFilter); } // no compress flag // first look to see if there's a NoCompress object with no specified extension boolean compressNothing = false; for (NoCompress nc : mNoCompressList) { if (nc.mExtension == null) { task.createArg().setValue("-0"); task.createArg().setValue(""); compressNothing = true; break; } } if (compressNothing == false) { for (NoCompress nc : mNoCompressList) { task.createArg().setValue("-0"); task.createArg().setValue(nc.mExtension); } } if (customPackage != null) { task.createArg().setValue("--custom-package"); task.createArg().setValue(customPackage); } // if the project contains libraries, force auto-add-overlay Object libSrc = taskProject.getReference("android.libraries.res"); if (libSrc != null) { task.createArg().setValue("--auto-add-overlay"); } if (mVersionCode != 0) { task.createArg().setValue("--version-code"); task.createArg().setValue(Integer.toString(mVersionCode)); } // manifest location if (mManifest != null) { task.createArg().setValue("-M"); task.createArg().setValue(mManifest); } // resources locations. if (mResources.size() > 0) { for (Path pathList : mResources) { for (String path : pathList.list()) { // This may not exists, and aapt doesn't like it, so we check first. File res = new File(path); if (res.isDirectory()) { task.createArg().setValue("-S"); task.createArg().setValue(path); } } } } // add other resources coming from library project Object libPath = taskProject.getReference("android.libraries.res"); if (libPath instanceof Path) { for (String path : ((Path)libPath).list()) { // This may not exists, and aapt doesn't like it, so we check first. File res = new File(path); if (res.isDirectory()) { task.createArg().setValue("-S"); task.createArg().setValue(path); } } } // assets location. This may not exists, and aapt doesn't like it, so we check first. if (mAssets != null && new File(mAssets).isDirectory()) { task.createArg().setValue("-A"); task.createArg().setValue(mAssets); } // android.jar if (mAndroidJar != null) { task.createArg().setValue("-I"); task.createArg().setValue(mAndroidJar); } // apk file. This is based on the apkFolder, apkBaseName, and the configName (if applicable) String filename = null; if (mApkName != null) { filename = mApkName; } else if (mApkBaseName != null) { filename = mApkBaseName + ".ap_"; } if (filename != null) { File file = new File(mApkFolder, filename); task.createArg().setValue("-F"); task.createArg().setValue(file.getAbsolutePath()); } // R class generation if (generateRClass) { task.createArg().setValue("-J"); task.createArg().setValue(mRFolder); } // final setup of the task task.setProject(taskProject); task.setOwningTarget(getOwningTarget()); // execute it. task.execute(); } }