ContextQMD
Back to Openclaw

App Store metadata (Fastlane deliver)

apps/ios/fastlane/metadata/README.md

2026.6.92.1 KB
Original Source

App Store metadata (Fastlane deliver)

This directory is used by fastlane deliver for App Store Connect text metadata.

Upload metadata only

bash
cd apps/ios
APP_STORE_CONNECT_APP_ID=YOUR_APP_STORE_CONNECT_APP_ID \
DELIVER_METADATA=1 fastlane ios metadata

Release notes only

pnpm ios:release:upload uses this mode before archiving so the editable App Store version has current release notes without rewriting all metadata:

bash
cd apps/ios
DELIVER_RELEASE_NOTES=1 fastlane ios metadata

Optional: include screenshots

bash
cd apps/ios
DELIVER_METADATA=1 DELIVER_SCREENSHOTS=1 fastlane ios metadata

Auth

The ios metadata lane uses App Store Connect API key auth from apps/ios/fastlane/.env:

  • Keychain-backed (recommended on macOS):
    • APP_STORE_CONNECT_KEY_ID
    • APP_STORE_CONNECT_ISSUER_ID
    • APP_STORE_CONNECT_KEYCHAIN_SERVICE (default: openclaw-app-store-connect-key)
    • APP_STORE_CONNECT_KEYCHAIN_ACCOUNT (default: current user)
  • File/path fallback:
    • APP_STORE_CONNECT_KEY_ID
    • APP_STORE_CONNECT_ISSUER_ID
    • APP_STORE_CONNECT_KEY_PATH

Or set APP_STORE_CONNECT_API_KEY_PATH.

Notes

  • Locale files live under metadata/en-US/.
  • release_notes.txt is generated from apps/ios/CHANGELOG.md; after changelog updates, run pnpm ios:version:sync.
  • Release notes resolve from ## <pinned iOS version> first, then fall back to ## Unreleased while a TestFlight train is still in progress.
  • When starting a new production release train, pin the iOS version first with pnpm ios:version:pin -- --from-gateway.
  • The release upload flow uploads release notes and screenshots before the IPA, and never submits for App Review.
  • privacy_url.txt is set to https://openclaw.ai/privacy.
  • If app lookup fails in deliver, set one of:
    • APP_STORE_CONNECT_APP_IDENTIFIER (bundle ID)
    • APP_STORE_CONNECT_APP_ID (numeric App Store Connect app ID, e.g. from /apps/<id>/... URL)
  • App Review submission is manual. Keep review contact, demo account, and reviewer notes outside this repo and enter them directly in App Store Connect when submitting for review.