[GH-ISSUE #147] [feat] Add support for build-specific "What to Test" notes (betaBuildLocalizations) #32

New issue

Closed

opened 2026-02-26 21:32:53 +03:00 by kerem · 2 comments

kerem commented

2026-02-26 21:32:53 +03:00

Owner

Originally created by @mithileshchellappan on GitHub (Jan 25, 2026).
Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/147

Feature Request

Add support for managing TestFlight "What to Test" notes (test instructions shown to beta testers).

Problem

No way to add/manage test notes via CLI. Users must manually add them through App Store Connect web UI.

Proposed Solution

Two-part approach:

1. Add flags to upload commands

asc builds upload --app "APP_ID" --ipa app.ipa \
  --test-notes "Test the new feature X" \
  --locale "en-US" \
  --wait

asc publish testflight --app "APP_ID" --ipa app.ipa \
  --group "GROUP_ID" \
  --test-notes "Test instructions" \
  --locale "en-US"

2. Add CRUD subcommand

asc builds test-notes <create|update|get|list|delete> [flags]

Examples:

# Create
asc builds test-notes create --build "BUILD_ID" \
  --locale "en-US" --whats-new "Test instructions"

# List
asc builds test-notes list --build "BUILD_ID"

# Update
asc builds test-notes update --id "LOC_ID" --whats-new "Updated"

# Delete
asc builds test-notes delete --id "LOC_ID"

API Reference

Endpoints:

POST /v1/betaBuildLocalizations (create)
PATCH /v1/betaBuildLocalizations/{id} (update)
GET /v1/betaBuildLocalizations/{id} (get)
GET /v1/builds/{id}/betaBuildLocalizations (list)
DELETE /v1/betaBuildLocalizations/{id} (delete)

Attributes:

whatsNew (string) - Test instructions
locale (string) - Locale code (e.g., "en-US")

Docs: https://developer.apple.com/documentation/appstoreconnectapi/testflight/beta_build_localizations

Implementation Note

Test notes can only be added after build reaches processingState: "VALID". When --test-notes is used, auto-wait for processing or require --wait flag.

Use Case

# Automated TestFlight deployment
asc builds upload --app "$APP_ID" --ipa app.ipa \
  --test-notes "Test feature X" --locale "en-US" --wait
asc builds add-groups --build "$BUILD_ID" --group "$GROUP_ID"
asc testflight review submit --build "$BUILD_ID" --confirm

Environment

asc version: 0.12.0
Platform: macOS

Originally created by @mithileshchellappan on GitHub (Jan 25, 2026). Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/147 ## Feature Request Add support for managing TestFlight "What to Test" notes (test instructions shown to beta testers). ## Problem No way to add/manage test notes via CLI. Users must manually add them through App Store Connect web UI. ## Proposed Solution **Two-part approach:** ### 1. Add flags to upload commands ```bash asc builds upload --app "APP_ID" --ipa app.ipa \ --test-notes "Test the new feature X" \ --locale "en-US" \ --wait ``` ```bash asc publish testflight --app "APP_ID" --ipa app.ipa \ --group "GROUP_ID" \ --test-notes "Test instructions" \ --locale "en-US" ``` ### 2. Add CRUD subcommand ```bash asc builds test-notes <create|update|get|list|delete> [flags] ``` **Examples:** ```bash # Create asc builds test-notes create --build "BUILD_ID" \ --locale "en-US" --whats-new "Test instructions" # List asc builds test-notes list --build "BUILD_ID" # Update asc builds test-notes update --id "LOC_ID" --whats-new "Updated" # Delete asc builds test-notes delete --id "LOC_ID" ``` ## API Reference **Endpoints:** - `POST /v1/betaBuildLocalizations` (create) - `PATCH /v1/betaBuildLocalizations/{id}` (update) - `GET /v1/betaBuildLocalizations/{id}` (get) - `GET /v1/builds/{id}/betaBuildLocalizations` (list) - `DELETE /v1/betaBuildLocalizations/{id}` (delete) **Attributes:** - `whatsNew` (string) - Test instructions - `locale` (string) - Locale code (e.g., "en-US") **Docs:** https://developer.apple.com/documentation/appstoreconnectapi/testflight/beta_build_localizations ## Implementation Note Test notes can only be added after build reaches `processingState: "VALID"`. When `--test-notes` is used, auto-wait for processing or require `--wait` flag. ## Use Case ```bash # Automated TestFlight deployment asc builds upload --app "$APP_ID" --ipa app.ipa \ --test-notes "Test feature X" --locale "en-US" --wait asc builds add-groups --build "$BUILD_ID" --group "$GROUP_ID" asc testflight review submit --build "$BUILD_ID" --confirm ``` ## Environment - `asc` version: `0.12.0` - Platform: macOS

kerem closed this issue

2026-02-26 21:32:53 +03:00

kerem commented

2026-02-26 21:32:54 +03:00

Author

Owner

@mithileshchellappan commented on GitHub (Jan 25, 2026):

I'll have a PR ready to push by tomorrow (if @rudrankriyam doesn't have claude push it by then 😅)

@mithileshchellappan commented on GitHub (Jan 25, 2026): I'll have a PR ready to push by tomorrow (if @rudrankriyam doesn't have claude push it by then 😅)

kerem commented

2026-02-26 21:32:54 +03:00

Author

Owner

@rudrankriyam commented on GitHub (Jan 25, 2026):

Currently testing the implementation, should go live in the next version very soon

@rudrankriyam commented on GitHub (Jan 25, 2026): Currently testing the implementation, should go live in the next version very soon

kerem referenced this issue

2026-02-26 21:34:16 +03:00

[PR #32] [MERGED] Add analytics and sales reporting commands #241