Skip to content

migrate-to-1-0.mdx

Latest commit

 

History

History
109 lines (76 loc) · 3.95 KB

migrate-to-1-0.mdx

File metadata and controls

109 lines (76 loc) · 3.95 KB

Migrate to 1.0

Upgrade from deprecated compatibility commands to the 1.0 command surface

Version 1.0 removes the long-standing deprecated command shims and old alias paths. If you have older shell scripts, CI jobs, or internal runbooks, update them to the canonical 1.0 commands on this page before you cut over.

What changed

The 1.0 release keeps the current command families, but removes older compatibility verbs and alias trees that had been kept around during the transition to the clearer view / edit / list command style.

Use asc --help and asc <command> --help against the 1.0 binary when updating automation. The CLI is the source of truth.

Common migrations

  • Deprecated asc apps create -> asc web apps create
  • Deprecated asc submit preflight -> asc validate
  • Deprecated asc submit create -> asc publish appstore --submit --confirm
  • Deprecated asc release run -> asc publish appstore --submit --confirm
  • Deprecated asc apps get -> asc apps view
  • Deprecated asc age-rating set -> asc age-rating edit
  • Deprecated asc pricing availability set -> asc pricing availability edit
  • Deprecated asc versions get -> asc versions view

Release workflow migration

Use these replacements for App Store shipping flows:

Deprecated command: asc release run --app "APP_ID" --version "1.0.0" --build "BUILD_ID" --metadata-dir "./metadata/version/1.0.0" --confirm

Canonical replacements:

asc publish appstore --app "APP_ID" --ipa "./MyApp.ipa" --version "1.0.0" --submit --confirm
asc release stage --app "APP_ID" --version "1.0.0" --build "BUILD_ID" --metadata-dir "./metadata/version/1.0.0" --confirm

Use publish appstore when you want an end-to-end ship flow that uploads the build and submits it. Use release stage when you already have the build in App Store Connect and want to prepare the version without creating the review submission yet.

Submission workflow migration

Deprecated readiness check: asc submit preflight --app "APP_ID" --version "1.0.0"

Deprecated final submission step: asc submit create --app "APP_ID" --version "1.0.0" --build "BUILD_ID" --confirm

Canonical replacements:

asc validate --app "APP_ID" --version "1.0.0"
asc publish appstore --app "APP_ID" --ipa "./MyApp.ipa" --version "1.0.0" --submit --confirm

For post-submit lifecycle work, keep using:

asc submit status --version-id "VERSION_ID"
asc submit cancel --version-id "VERSION_ID" --confirm

App creation migration

App creation is now an explicit web-session workflow:

asc web apps create --name "My App" --bundle-id "com.example.app" --sku "MYAPP123" --apple-id "user@example.com"

This flow is unofficial and uses Apple web-session endpoints. It is separate from the API-key driven apps family on purpose.

Updating get / set scripts

Several older command families used get and set verbs. In 1.0, migrate those scripts to the canonical verbs shown in help output:

  • get becomes view
  • set becomes edit
  • collection-oriented reads stay list

Examples:

asc apps view --id "APP_ID"
asc categories set --app "APP_ID" --primary GAMES
asc age-rating edit --app "APP_ID" --all-none
asc pricing availability edit --app "APP_ID" --territory "USA,GBR,IND" --available true

Upgrade checklist

  1. Search your repo for removed commands such as release run, submit preflight, submit create, and apps create.
  2. Replace get and set aliases with view and edit where the 1.0 help output shows those canonical verbs.
  3. Re-run your CI scripts with the 1.0 binary and verify exit codes, stderr handling, and structured output parsing.
  4. Update internal runbooks and onboarding docs to point at the canonical command pages.

Related docs