eas-cli

eas-cli

EAS command line tool

• Installation
• Usage
• Commands

Installation

npm install -g eas-cli
# or
yarn global add eas-cli

Usage

eas COMMAND
# runs the command
eas (-v|--version|version)
# prints the version
eas --help COMMAND
# outputs help for specific command

Commands

• eas account:login
• eas account:logout
• eas account:view
• eas build
• eas build:cancel [BUILD_ID]
• eas build:configure
• eas build:list
• eas build:view [BUILD_ID]
• eas credentials
• eas device:create
• eas device:list
• eas device:view [UDID]
• eas help [COMMAND]
• eas submit --platform=(android|ios)

eas account:login

log in with your Expo account

USAGE
  $ eas account:login

ALIASES
  $ eas login

See code: build/commands/account/login.ts

eas account:logout

log out

USAGE
  $ eas account:logout

ALIASES
  $ eas logout

See code: build/commands/account/logout.ts

eas account:view

show the username you are logged in as

USAGE
  $ eas account:view

ALIASES
  $ eas whoami

See code: build/commands/account/view.ts

eas build

Start a build

USAGE
  $ eas build

OPTIONS
  -p, --platform=(android|ios|all)
  --non-interactive                 Run command in --non-interactive mode
  --profile=profile                 [default: release] Name of the build profile from eas.json
  --skip-credentials-check          Skip validation of build credentials
  --skip-project-configuration      Skip project configuration
  --[no-]wait                       Wait for build(s) to complete

See code: build/commands/build/index.ts

eas build:cancel [BUILD_ID]

Cancel a build.

USAGE
  $ eas build:cancel [BUILD_ID]

See code: build/commands/build/cancel.ts

eas build:configure

Configure the project to support EAS Build.

USAGE
  $ eas build:configure

OPTIONS
  -p, --platform=(android|ios|all)  Platform to configure
  --allow-experimental              Enable experimental configuration steps.

See code: build/commands/build/configure.ts

eas build:list

list all builds for your project

USAGE
  $ eas build:list

OPTIONS
  --limit=limit
  --platform=(all|android|ios)
  --status=(in-queue|in-progress|errored|finished|canceled)

See code: build/commands/build/list.ts

eas build:view [BUILD_ID]

view a build for your project

USAGE
  $ eas build:view [BUILD_ID]

See code: build/commands/build/view.ts

eas credentials

Manage your credentials

USAGE
  $ eas credentials

See code: build/commands/credentials.ts

eas device:create

register new Apple Devices to use for internal distribution

USAGE
  $ eas device:create

See code: build/commands/device/create.ts

eas device:list

list all registered devices for your account

USAGE
  $ eas device:list

OPTIONS
  --apple-team-id=apple-team-id

See code: build/commands/device/list.ts

eas device:view [UDID]

view a device for your project

USAGE
  $ eas device:view [UDID]

See code: build/commands/device/view.ts

eas help [COMMAND]

display help for eas

USAGE
  $ eas help [COMMAND]

ARGUMENTS
  COMMAND  command to show help for

OPTIONS
  --all  see all commands in CLI

See code: @oclif/plugin-help

eas submit --platform=(android|ios)

Submits build artifact to app store

USAGE
  $ eas submit --platform=(android|ios)

OPTIONS
  -p, --platform=(android|ios)                                       For which platform you want to submit a build

  Android specific options=android-package                           Android package name (default: expo.android.package
                                                                     from app config)

  iOS specific options=app-name                                      The name of your app as it will appear on the App
                                                                     Store (default: expo.name from app config)

  iOS specific options=apple-id                                      Your Apple ID username (you can also set
                                                                     EXPO_APPLE_ID env variable)

  iOS specific options=apple-team-id                                 Your Apple Developer Team ID

  iOS specific options=asc-app-id                                    App Store Connect unique application Apple ID
                                                                     number. Providing this param results in skipping
                                                                     app creation step. Learn more:
                                                                     https://expo.fyi/asc-app-id

  iOS specific options=bundle-identifier                             Your iOS Bundle Identifier (default:
                                                                     expo.ios.bundleIdentifier from app config)

  iOS specific options=company-name                                  The name of your company, needed only for the first
                                                                     upload of any app to App Store

  --id=id                                                            ID of the build to submit

  Android specific options=key                                       Path to the JSON key used to authenticate with
                                                                     Google Play

  iOS specific options=language                                      [default: en-US] Primary language (e.g. English,
                                                                     German, ...)

  --latest                                                           Submit the latest build for specified platform

  --path=path                                                        Path to the .apk/.aab file

  Android specific options=(completed|draft|halted|inProgress)       [default: completed] Release status (used when
                                                                     uploading new APKs/AABs)

  iOS specific options=sku                                           An unique ID for your app that is not visible on
                                                                     the App Store, will be generated unless provided

  Android specific options=(production|beta|alpha|internal|rollout)  [default: internal] The track of the application to
                                                                     use

  Android specific options=(apk|aab)                                 Android archive type

  --url=url                                                          App archive url

  --verbose                                                          Always print logs from Submission Service

ALIASES
  $ eas build:submit

EXAMPLES
  $ eas submit --platform=ios
       - Fully interactive iOS submission

  $ eas submit --platform=android
       - Fully interactive Android submission

  $ eas submit -p android --latest --key=/path/to/google-services.json
       - Minimal non-interactive Android submission, however it can ask you for other params if not specified

  $ EXPO_APPLE_APP_SPECIFIC_PASSWORD=xxx eas submit -p ios --latest --apple-id=[e-mail] --asc-app-id=1234567890,
       - Minimal non-interactive iOS submission, assuming you already have an app in App Store Connect
         and provide its App ID

See code: build/commands/submit.ts

Changelog

0.6.0 - 2021-03-09

🛠 Breaking changes

• Generic iOS projects: build release builds by default. (#266 by @dsokal)

🎉 New features

• Log the size of the archived project when uploading. (#264 by @wkozyra95)
• Add more build metadata (release channel, build profile name, git commit hash). (#265 by @dsokal)
• Display App Store link after successful submission. (#144 by @barthap)
• Add experimental.disableIosBundleIdentifierValidation flag to eas.json. (#263 by @wkozyra95)
• Support internal distribution in non-interactive builds. (#269 by @dsokal)

🐛 Bug fixes

• Print Apple Team ID in the output of device:list when the team name is unknown. (#268 by @wkozyra95)