com.android.apksig

Class SigningCertificateLineage.Builder

java.lang.Object

com.android.apksig.SigningCertificateLineage.Builder

Enclosing class:

SigningCertificateLineage

public static class SigningCertificateLineage.Builder
extends java.lang.Object

Builder of SigningCertificateLineage instances.

Constructor Summary

Constructors

Constructor and Description
Builder(SigningCertificateLineage.SignerConfig originalSignerConfig, SigningCertificateLineage.SignerConfig newSignerConfig) Constructs a new Builder.

Method Summary

Modifier and Type	Method and Description
SigningCertificateLineage	build()
SigningCertificateLineage.Builder	setMinSdkVersion(int minSdkVersion) Sets the minimum Android platform version (API Level) on which this lineage is expected to validate.
SigningCertificateLineage.Builder	setNewCapabilities(SigningCertificateLineage.SignerCapabilities signerCapabilities) Sets capabilities to give mNewSignerConfig.
SigningCertificateLineage.Builder	setOriginalCapabilities(SigningCertificateLineage.SignerCapabilities signerCapabilities) Sets capabilities to give mOriginalSignerConfig.

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder(SigningCertificateLineage.SignerConfig originalSignerConfig,
               SigningCertificateLineage.SignerConfig newSignerConfig)

Constructs a new Builder.

Parameters:

originalSignerConfig - first signer in this lineage, parent of the next

newSignerConfig - new signer in the lineage; the new signing key that the APK will use

Method Detail

setMinSdkVersion

public SigningCertificateLineage.Builder setMinSdkVersion(int minSdkVersion)

Sets the minimum Android platform version (API Level) on which this lineage is expected to validate. It is possible that newer signers in the lineage may not be recognized on the given platform, but as long as an older signer is, the lineage can still be used to sign an APK for the given platform. By default, this value is set to the value for the P release, since this structure was created for that release, and will also be set to that value if a smaller one is specified.

setOriginalCapabilities

public SigningCertificateLineage.Builder setOriginalCapabilities(SigningCertificateLineage.SignerCapabilities signerCapabilities)

Sets capabilities to give mOriginalSignerConfig. These capabilities allow an older signing certificate to still be used in some situations on the platform even though the APK is now being signed by a newer signing certificate.

setNewCapabilities

public SigningCertificateLineage.Builder setNewCapabilities(SigningCertificateLineage.SignerCapabilities signerCapabilities)

Sets capabilities to give mNewSignerConfig. These capabilities allow an older signing certificate to still be used in some situations on the platform even though the APK is now being signed by a newer signing certificate. By default, the new signer will have all capabilities, so when first switching to a new signing certificate, these capabilities have no effect, but they will act as the default level of trust when moving to a new signing certificate.

build

public SigningCertificateLineage build()
                                throws java.security.cert.CertificateEncodingException,
                                       java.security.InvalidKeyException,
                                       java.security.NoSuchAlgorithmException,
                                       java.security.SignatureException

Throws:

java.security.cert.CertificateEncodingException

java.security.InvalidKeyException

java.security.NoSuchAlgorithmException

java.security.SignatureException