Skip to main content

Android Sign

Android Sign step signs your APK or AAB with the given Android keystore and exports a binary file compatible with Android devices.

info

This step follows the Android Build step to sign the unsigned build output if the project doesn't include a keystore. If your project includes a keystore, the build application step will generate a signed artifact. If you do not disable this step, your artifact will be unsigned and then re-signed using the keystore selected in the Configuration or in this step.

Prerequisites

The workflow steps that need to be executed before running the Android Build workflow step, along with their respective reasons, are listed in the table below.

Prerequisite Workflow StepDescription
Git CloneThis step relies on the Android Build step and the Git Clone step is necessary for the Android Build step to run successfully.
Android BuildThe app required for this step is generated by the Android Build (or alternative build steps).
caution

If a step other than the Android Build step is used to build an app, then the Android Sign step depends on this step.

warning

To share the signed apps created as an output of this step or to view them on the Download Artifacts page, please ensure that the Export Build Artifacts step is included in your workflow after this step.

Input Variables

For each component, specific input variables are required for its operation on your system. The input variables necessary for the Android Sign are as follows:

Variable NameDescriptionStatus
$AC_APK_PATHThe path of the APK file. This path is automatically generated in the Android Build step. You may need to modify this input variable to provide a different path.Required
$AC_AAB_PATHThe path of the AAB file. This path is automatically generated in the Android Build step. You may need to modify this input variable to provide a different path.Required
$AC_ANDROID_KEYSTORE_PATHKeystore file can be selected in the Configuration. This value will be auto-generated depending on your keystore file selection in signing configuration on Appcircle.Required
$AC_ANDROID_KEYSTORE_PASSWORDPassword for the selected keystore file. This value will be auto-generated based on your keystore file selection.Required
$AC_ANDROID_ALIASAlias name for the selected keystore file. This value will be auto-generated depending on your Configuration
$AC_ANDROID_ALIAS_PASSWORDAlias password for the selected keystore file. This value will be auto-generated depending on your Configuration
$AC_V2_SIGNDefaults to false. Set true if the signature should be done using apksigner instead of jarsigner. For more information, Apps targeting Android 11 require APK Signature Scheme v2.Optional

Output Variables

The outputs that can result from the operation of this component are listed as follows.

Variable NameDescription
$AC_SIGNED_APK_PATHPath for the signed APK file output. If an APK file is provided as input, the signed app will also be in APK format.
$AC_SIGNED_AAB_PATHPath for the signed App Bundle file output. If an AAB file is provided as input, the signed app will also be in AAB format.
tip

If both input value types (AAB and APK) are provided, the same type of signed app will be generated for both.

To access the source code of this component, please use the following link:

Preview of GitHub - appcircleio/appcircle-android-sign-component