ionic package build
Create a package build on Appflow
$ ionic package build [options]
This command creates a package build on Appflow. While the build is running, it prints the remote build log to the terminal. If the build is successful, it downloads the created app package file in the current directory. Downloading build artifacts can be skipped by supplying the flag skip-download
.
Apart from --commit
, every option can be specified using the full name setup within the Dashboard.
The --signing-certificate
option is mandatory for any iOS build but not for Android debug builds.
Customizing the build:
- The
--environment
and--native-config
options can be used to customize the groups of values exposed to the build. - Override the preferred platform with
--build-stack
. This is useful for building older iOS apps.
Deploying the build to an App Store:
- The
--destination
option can be used to deliver the app created by the build to the configured App Store. This can be used only together with build typerelease
for Android and build typesapp-store
orenterprise
for iOS.
Downloading build artifacts:
- By default once the build is complete, all artifacts are downloaded for the selected platform.
aab
andapk
for Androidipa
anddsym
for iOS. - The
--artifact-type
option can be used to limit artifact downloads to only of that type. For instance, with Android, you can specifyaab
if you do not wish to downloadapk
.
Examples
$ ionic package build android debug
$ ionic package build ios development --signing-certificate="iOS Signing Certificate Name"
$ ionic package build android debug --environment="My Custom Environment Name"
$ ionic package build android debug --native-config="My Custom Native Config Name"
$ ionic package build android debug --commit=2345cd3305a1cf94de34e93b73a932f25baac77c
$ ionic package build android debug --artifact-type=aab
$ ionic package build android debug --skip-download
$ ionic package build android debug --aab-name="my-app-prod.aab" --apk-name="my-app-prod.apk"
$ ionic package build ios development --signing-certificate="iOS Signing Certificate Name" --build-stack="iOS - Xcode 9"
$ ionic package build ios development --signing-certificate="iOS Signing Certificate Name" --ipa-name=my_custom_file_name.ipa
$ ionic package build ios app-store --signing-certificate="iOS Signing Certificate Name" --destination="Apple App Store Destination"
Inputs
platform | |
---|---|
Description | The platform to package ( |
type | |
Description | The build type ( |
Options
--signing-certificate =<name> | |
---|---|
Description | Signing certificate |
--environment =<name> | |
Description | The group of environment variables exposed to your build |
--native-config =<name> | |
Description | The group of native config variables exposed to your build |
--destination =<name> | |
Description | The configuration to deploy the build artifact to the app store |
--build-file-name =<name> | |
Description | The name for the downloaded build file |
--artifact-type =<name> | |
Description | The artifact type ( |
--skip-download | |
Description | Skip downloading build artifacts after command succeeds. |
Advanced Options
--commit =<sha1> | |
---|---|
Description | Commit (defaults to HEAD) |
--build-stack =<name> | |
Description | Target platform ( |
--ipa-name =<name> | |
Description | The name for the downloaded ipa file |
--dsym-name =<name> | |
Description | The name for the downloaded dsym file |
--apk-name =<name> | |
Description | The name for the downloaded apk file |
--aab-name =<name> | |
Description | The name for the downloaded aab file |