asc-build-lifecycle

Manage build lifecycle on App Store Connect: find the latest or next safe build number, inspect processing state, and expire old builds. Use this when managing build retention policies, waiting on build processing, or preparing builds for TestFlight or App Store distribution.

• Find latest builds or determine next safe build numbers for a version
• List recent builds sorted by upload date
• Inspect build processing state and details
• Preview and apply build expiration policies based on age
• Publish builds to TestFlight or App Store with end-to-end workflows
• Expire individual builds or batch-expire builds older than a specified duration

1. 1.Identify the build you need: use `asc builds info --app APP_ID --latest --version X.Y.Z --platform IOS` to find the latest build or `asc builds list --app APP_ID --sort -uploadedDate --limit 10` to see recent builds
2. 2.Check processing state: run `asc builds info --build-id BUILD_ID` to inspect the current state of a specific build
3. 3.For distribution, use end-to-end commands: `asc publish testflight --app APP_ID --ipa ./app.ipa --group GROUP_ID --wait` for TestFlight or `asc publish appstore --app APP_ID --ipa ./app.ipa --version X.Y.Z --wait --submit --confirm` for App Store
4. 4.To manage retention, preview expiration with `asc builds expire-all --app APP_ID --older-than 90d --dry-run`, then apply with `--confirm` flag
5. 5.For individual builds, use `asc builds expire --build-id BUILD_ID --confirm` to remove a specific build