com.simpligility.maven.plugins.android.standalonemojos

Class ManifestMergerMojo

java.lang.Object

org.apache.maven.plugin.AbstractMojo

com.simpligility.maven.plugins.android.AbstractAndroidMojo

com.simpligility.maven.plugins.android.standalonemojos.ManifestMergerMojo

All Implemented Interfaces:

org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo

@Mojo(name="manifest-merger",
      defaultPhase=PROCESS_RESOURCES)
public class ManifestMergerMojo
extends AbstractAndroidMojo

Manifest Merger V2 AndroidManifest.xml file. http://tools.android.com/tech-docs/new-build-system/user-guide/manifest-merger

Author:

Benoit Billington - benoit.billington@gmail.com

Field Summary

Fields

Modifier and Type	Field and Description
protected Boolean	manifestMergeLibraries Merge Manifest with library projects.
protected File	manifestMergeReportFile Merge Manifest with library projects.
protected UsesSdk	manifestUsesSdk Update the uses-sdk tag.
protected Integer	manifestVersionCode Update the android:versionCode attribute with the specified parameter.
protected Boolean	manifestVersionCodeUpdateFromVersion Update the android:versionCode attribute automatically from the project version e.g 3.2.1 will become version code 3002001.
protected String	manifestVersionDigits The number of digits per version element.
protected String	manifestVersionName Update the android:versionName with the specified parameter.
protected String	manifestVersionNamingPattern Optionally use a pattern to match version elements for automatic generation of version codes, useful in case of complex version naming schemes.

Fields inherited from class com.simpligility.maven.plugins.android.AbstractAndroidMojo

aaptExtraArgs, aaptVerbose, adbConnectionTimeout, androidManifestFile, assetsDirectory, attachJar, attachSources, combinedAssets, configurations, customPackage, dependencyGraphBuilder, destinationManifestFile, device, devices, deviceThreads, ENV_ANDROID_HOME, ENV_ANDROID_NDK_HOME, execution, extractedDependenciesDirectory, extractedDependenciesJavaResources, extractedDependenciesJavaSources, finalName, genDirectory, generateApk, ips, nativeLibrariesDirectory, ndkOutputDirectory, proguardFile, project, projectHelper, projectOutputDirectory, release, renameManifestPackage, resourceDirectory, resourceOverlayDirectories, resourceOverlayDirectory, resources, session, sourceDirectory, sourceEncoding, SUPPORTED_PACKAGING_TYPES, targetDirectory, undeployBeforeDeploy

Fields inherited from interface org.apache.maven.plugin.Mojo

ROLE

Constructor Summary

Constructors

Constructor and Description
ManifestMergerMojo()

Method Summary

Modifier and Type	Method and Description
void	execute()
void	manifestMergerV2()

Methods inherited from class com.simpligility.maven.plugins.android.AbstractAndroidMojo

copyFolder, deployApk, deployBuiltApk, deployDependencies, doWithDevices, extractInstrumentationRunnerFromAndroidManifest, extractPackageNameFromAndroidArtifact, extractPackageNameFromAndroidManifest, extractPackageNameFromAndroidManifestXmlTree, extractPackageNameFromApk, getAndroidManifestPackageName, getAndroidNdk, getAndroidSdk, getArtifactResolverHelper, getDependencyResolver, getDirectDependencyArtifacts, getJack, getLibraryUnpackDirectory, getNativeHelper, getRelevantCompileArtifacts, getResourceOverlayDirectories, getTransitiveDependencyArtifacts, getTransitiveDependencyArtifacts, getUnpackedAarClassesJar, getUnpackedApkLibSourceFolder, getUnpackedLibAssetsFolder, getUnpackedLibFolder, getUnpackedLibHelper, getUnpackedLibNativesFolder, getUnpackedLibResourceFolder, getUnpackedLibsDirectory, initAndroidDebugBridge, isAPKBuild, isInstrumentationTest, resolveArtifactToFile, undeployApk, undeployApk, waitForInitialDeviceList

Methods inherited from class org.apache.maven.plugin.AbstractMojo

getLog, getPluginContext, setLog, setPluginContext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

manifestVersionName

@Parameter(property="android.manifestMerger.versionName",
           defaultValue="${project.version}")
protected String manifestVersionName

Update the android:versionName with the specified parameter. If left empty it will use the version number of the project. Exposed via the project property android.manifestMerger.versionName.

manifestVersionCode

@Parameter(property="android.manifestMerger.versionCode",
           defaultValue="1")
protected Integer manifestVersionCode

Update the android:versionCode attribute with the specified parameter. Exposed via the project property android.manifestMerger.versionCode.

manifestVersionCodeUpdateFromVersion

@Parameter(property="android.manifest.versionCodeUpdateFromVersion",
           defaultValue="false")
protected Boolean manifestVersionCodeUpdateFromVersion

Update the android:versionCode attribute automatically from the project version e.g 3.2.1 will become version code 3002001. As described in this blog post http://www.simpligility.com/2010/11/release-version-management-for-your-android-application/ but done without using resource filtering. The value is exposed via the project property property android.manifest.versionCodeUpdateFromVersion and the resulting value as android.manifest.versionCode. For the purpose of generating the versionCode, if a version element is missing it is presumed to be 0. The maximum values for the version increment and version minor values are 999, the version major should be no larger than 2000. Any other suffixes do not participate in the version code generation.

manifestVersionNamingPattern

@Parameter(property="android.manifestMerger.versionNamingPattern")
protected String manifestVersionNamingPattern

Optionally use a pattern to match version elements for automatic generation of version codes, useful in case of complex version naming schemes. The new behavior is disabled by default; set the pattern to a non-empty string to activate. Otherwise, continue using the old behavior of separating version elements by dots and ignoring all non-digit characters. The pattern is standard Java regex. Capturing groups in the pattern are sequentially passed to the version code generator, while other parts are ignored. Be sure to properly escape your pattern string, in case you use characters that have special meaning in XML. Exposed via the project property android.manifestMerger.versionNamingPattern.

manifestVersionDigits

@Parameter(property="android.manifestMerger.versionDigits",
           defaultValue="4,3,3")
protected String manifestVersionDigits

The number of digits per version element. Must be specified as a comma/semicolon separated list of digits, one for each version element, Exposed via the project property android.manifestMerger.versionDigits.

manifestMergeLibraries

@Parameter(property="android.manifestMerger.mergeLibraries",
           defaultValue="false")
protected Boolean manifestMergeLibraries

Merge Manifest with library projects. Exposed via the project property android.manifestMerger.mergeLibraries.

manifestMergeReportFile

@Parameter(property="android.manifestMerger.mergeReportFile")
protected File manifestMergeReportFile

Merge Manifest with library projects. Exposed via the project property android.manifestMerger.mergeLibraries.

manifestUsesSdk

protected UsesSdk manifestUsesSdk

Update the uses-sdk tag. It can be configured to change: android:minSdkVersion, android:maxSdkVersion and android:targetSdkVersion

Constructor Detail

ManifestMergerMojo

public ManifestMergerMojo()

Method Detail

execute

public void execute()
             throws org.apache.maven.plugin.MojoExecutionException,
                    org.apache.maven.plugin.MojoFailureException

Throws:

org.apache.maven.plugin.MojoExecutionException

org.apache.maven.plugin.MojoFailureException

manifestMergerV2

public void manifestMergerV2()
                      throws org.apache.maven.plugin.MojoExecutionException,
                             org.apache.maven.plugin.MojoFailureException

Throws:

org.apache.maven.plugin.MojoExecutionException

org.apache.maven.plugin.MojoFailureException