Skip to main content
Version: v5

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.

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 type release for Android and build types app-store or enterprise for iOS.

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 ios development --signing-certificate="iOS Signing Certificate Name" --build-stack="iOS - Xcode 9"
$ ionic package build ios development --signing-certificate="iOS Signing Certificate Name" --build-file-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 (android, ios)

type

Description

The build type (debug, release, development, ad-hoc, app-store, enterprise)

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

Advanced Options

--commit =<sha1>

Description

Commit (defaults to HEAD)

--build-stack =<name>

Description

Build stack ("Android", "iOS - Xcode 11 (Preferred)", "iOS - Xcode 10")

--build-file-name =<name>

Description

The name for the downloaded build file