Method Detail

• public def Packager(@com.android.annotations.NonNull String apkLocation, @com.android.annotations.NonNull String resLocation, com.android.ide.common.signing.CertificateInfo certificateInfo, @com.android.annotations.Nullable String createdBy, @com.android.annotations.Nullable com.android.builder.model.PackagingOptions packagingOptions, com.android.utils.ILogger logger)

  Creates a new instance. This creates a new builder that will create the specified output file, using the two mandatory given input files. An optional debug keystore can be provided. If set, it is expected that the store password is 'android' and the key alias and password are 'androiddebugkey' and 'android'. An optional com.android.utils.ILogger can also be provided for verbose output. If null, there will be no output.

  throws:

  com.android.builder.packaging.PackagerException

  Parameters:

  apkLocation - the file to create

  resLocation - the file representing the packaged resource file.

  certificateInfo - the signing information used to sign the package. Optional the OS path to the debug keystore, if needed or null.

  logger - the logger.

• public void addDexFiles(@com.android.annotations.NonNull File mainDexFolder, @com.android.annotations.NonNull Collection<File> extraDexFiles)

• @Override public void addFile(File file, String archivePath)

  Adds a file to the APK at a given path

  throws:

  PackagerException if an error occurred

  throws:

  com.android.builder.packaging.SealedPackageException if the APK is already sealed.

  throws:

  DuplicateFileException if a file conflicts with another already added to the APK at the same location inside the APK archive.

  Parameters:

  file - the file to add

  archivePath - the path of the file inside the APK archive.

• public void addNativeLibraries(@com.android.annotations.NonNull File nativeFolder, @com.android.annotations.Nullable Set<String> abiFilters)

  Adds the native libraries from the top native folder. The content of this folder must be the various ABI folders. This may or may not copy gdbserver into the apk based on whether the debug mode is set.

  throws:

  PackagerException if an error occurred

  throws:

  SealedPackageException if the APK is already sealed.

  throws:

  DuplicateFileException if a file conflicts with another already added to the APK at the same location inside the APK archive.

  Parameters:

  nativeFolder - the root folder containing the abi folders which contain the .so

  abiFilters - a list of abi filters to include. If null or empty, all abis are included.

  See Also:

  setJniDebugMode(boolean)

• public Packager.JarStatus addResourcesFromJar(File jarFile)

  Adds the resources from a jar file.

  throws:

  PackagerException if an error occurred

  throws:

  SealedPackageException if the APK is already sealed.

  throws:

  DuplicateFileException if a file conflicts with another already added to the APK at the same location inside the APK archive.

  Parameters:

  jarFile - the jar File.

  Returns:

  a JarStatus object indicating if native libraries where found in the jar file.

• public static String getLocalVersion()

• public void sealApk()

  Seals the APK, and signs it if necessary.

  throws:

  PackagerException if an error occurred

  throws:

  SealedPackageException if the APK is already sealed.

• public void setJniDebugMode(boolean jniDebugMode)

  Sets the JNI debug mode. In debug mode, when native libraries are present, the packaging will also include one or more copies of gdbserver in the final APK file. These are used for debugging native code, to ensure that gdbserver is accessible to the application. There will be one version of gdbserver for each ABI supported by the application. the gbdserver files are placed in the libs/abi/ folders automatically by the NDK.

  Parameters:

  jniDebugMode - the jni-debug mode flag.