asc-build-lifecycle

1# asc build lifecycle
2 
3Use this skill to manage build state, processing, and retention.
4 
5## Find the right build
6- Latest build:
7  - `asc builds info --app "APP_ID" --latest --version "1.2.3" --platform IOS`
8- Next safe build number:
9  - `asc builds next-build-number --app "APP_ID" --version "1.2.3" --platform IOS`
10  - The command scans the full processed-build history and in-flight uploads, then returns one greater than the highest positive numeric build number. Blank or non-numeric processed build numbers are skipped with a warning; if no usable number remains, it falls back to `--initial-build-number`.
11- Recent builds:
12  - `asc builds list --app "APP_ID" --sort -uploadedDate --limit 10`
13 
14## Inspect processing state
15- `asc builds info --build-id "BUILD_ID"`
16- TestFlight state in one call: `asc builds info --build-id "BUILD_ID" --include buildBetaDetail,betaAppReviewSubmission,betaGroups --output json`. A build never submitted for beta review has no `betaAppReviewSubmissions` entry in `included`.
17 
18## Distribution flows
19- Prefer end-to-end:
20  - `asc publish testflight --app "APP_ID" --ipa "./app.ipa" --group "GROUP_ID" --wait`
21  - `asc publish appstore --app "APP_ID" --ipa "./app.ipa" --version "1.2.3" --wait --submit --confirm`
22 
23## Cleanup
24- Preview expiration:
25  - `asc builds expire-all --app "APP_ID" --older-than 90d --dry-run`
26- Apply expiration:
27  - `asc builds expire-all --app "APP_ID" --older-than 90d --confirm`
28- Single build:
29…