Package com.android.manifmerger

Class ManifestMerger2

java.lang.Object

com.android.manifmerger.ManifestMerger2

@Immutable
public class ManifestMerger2
extends Object

merges android manifest files, idempotent.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ManifestMerger2.AutoAddingProperty	Defines a property that can add or override itself into an XML document.
static class	ManifestMerger2.FileStreamProvider	A ManifestMerger2.FileStreamProvider provides (buffered, if necessary) InputStream instances for a given File handle.
static class	ManifestMerger2.Invoker	This class will hold all invocation parameters for the manifest merging tool.
static interface	ManifestMerger2.ManifestDocumentProvider	A ManifestMerger2.ManifestDocumentProvider provides the merged manifest XML Document instance for the project a given File belongs to.
static class	ManifestMerger2.MapBasedKeyBasedValueResolver<T>	Helper class for map based placeholders key value pairs.
static class	ManifestMerger2.MergeFailureException
static enum	ManifestMerger2.MergeType	Defines the merging type expected from the tool.
static interface	ManifestMerger2.ProcessCancellationChecker
static class	ManifestMerger2.SelectorResolver	Implementation a KeyResolver capable of resolving all selectors value in the context of the passed libraries to this merging activities.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	COMPATIBLE_SCREENS_SUB_MANIFEST
static final String	WEAR_APP_SUB_MANIFEST

Method Summary

Modifier and Type	Method	Description
static com.google.common.collect.ImmutableList<Element>	getChildElementsByName(Element element, String name)	Returns a list of elements which are the immediate children of the given element and have the given name.
ManifestMerger2.FileStreamProvider	getFileStreamProvider()	Returns the ManifestMerger2.FileStreamProvider used by this manifest merger.
static ManifestMerger2.Invoker	newMerger(File mainManifestFile, com.android.utils.ILogger logger, ManifestMerger2.MergeType mergeType)	Creates a new ManifestMerger2.Invoker instance to invoke the merging tool to merge manifest files for an application.
protected void	performSystemPropertiesInjection(MergingReport.Builder mergingReport, XmlDocument xmlDocument)	Perform ManifestSystemProperty injection.
static void	setAndroidAttribute(XmlElement node, String localName, String value)	Set an Android-namespaced XML attribute on the given node.
static String	setManifestAndroidAttribute(XmlDocument document, String attribute, String value)	Set an android namespaced attribute for the manifest element.

Methods inherited from class java.lang.Object

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

Field Details

COMPATIBLE_SCREENS_SUB_MANIFEST

public static final String COMPATIBLE_SCREENS_SUB_MANIFEST

See Also:

• Constant Field Values

WEAR_APP_SUB_MANIFEST

public static final String WEAR_APP_SUB_MANIFEST

See Also:

• Constant Field Values

Method Details

setManifestAndroidAttribute

public static String setManifestAndroidAttribute(@NonNull
 XmlDocument document,
 @NonNull
 String attribute,
 @NonNull
 String value)

Set an android namespaced attribute for the manifest element.

Parameters:

document - the document whose attributes will be modified

attribute - the new attribute to be set

value - the new value of the attribute

Returns:

the previous value of the attribute or null if the attribute was not set.

setAndroidAttribute

public static void setAndroidAttribute(XmlElement node,
 String localName,
 String value)

Set an Android-namespaced XML attribute on the given node.

Parameters:

node - Node in which to set the attribute; must be part of a document

localName - Non-prefixed attribute name

value - value of the attribute

getChildElementsByName

@NonNull
public static com.google.common.collect.ImmutableList<Element> getChildElementsByName(@NonNull
 Element element,
 @NonNull
 String name)

Returns a list of elements which are the immediate children of the given element and have the given name.

Parameters:

element - the immediate parent of any elements in the returned list

name - the name of any elements in the returned list

Returns:

the list (possibly empty) of children elements with the given name

getFileStreamProvider

@NonNull
public ManifestMerger2.FileStreamProvider getFileStreamProvider()

Returns the ManifestMerger2.FileStreamProvider used by this manifest merger. Use this to read files if you need to access the content of a XmlDocument.

newMerger

@NonNull
public static ManifestMerger2.Invoker newMerger(@NonNull
 File mainManifestFile,
 @NonNull
 com.android.utils.ILogger logger,
 @NonNull
 ManifestMerger2.MergeType mergeType)

Creates a new ManifestMerger2.Invoker instance to invoke the merging tool to merge manifest files for an application.

Parameters:

mainManifestFile - application main manifest file.

logger - the logger interface to use.

Returns:

an ManifestMerger2.Invoker instance that will allow further customization and trigger the merging tool.

performSystemPropertiesInjection

protected void performSystemPropertiesInjection(@NonNull
 MergingReport.Builder mergingReport,
 @NonNull
 XmlDocument xmlDocument)

Perform ManifestSystemProperty injection.

Parameters:

mergingReport - to log actions and errors.

xmlDocument - the xml document to inject into.