App Store Release
Treibe eine vollständige iOS App Store Einreichung über die App Store Connect API voran. Ziel: Der Benutzer stellt einmalig Anmeldedaten + eine config.json bereit, dann erledigt der Agent alles Automatisierbare und unterbricht den Benutzer nur bei den wenigen Dingen, die Apple wirklich nicht über die API bereitstellt. Bitte den Benutzer nicht, Dinge zu bestätigen, die bereits in der Config stehen oder sinnvolle Standardwerte haben.
Funktionsprinzip (zuerst lesen)
- Config-getrieben, nicht Prompt-getrieben. Alle App-Inhalte leben in
config.json. Befehle ausführen; nicht den Benutzer interviewen. - Nur zwei Dinge sind reine UI (Apple hat keine API): App Privacy-Datenerhebung und erstmalige Abonnement-Anbindung + Einreichung. Die Werkzeuge erkennen dies und zeigen die genauen Klicks an. Alles andere ist skriptgesteuert.
- Frage den Benutzer nur, wenn: ein erforderliches Feld in der Config fehlt (sage ihm genau welches), eine geschäftliche Entscheidung nicht in der Config steht (Abonnementpreis, Veröffentlichungszeitpunkt) oder vor der einzigen irreversiblen Aktion (endgültige Einreichung). Ansonsten fortfahren.
- Idempotent: jeder Befehl kann sicher wiederholt werden.
node cli.mjs releasekann beliebig oft ausgeführt werden.
Architektur (SOLID, damit du sie erweitern kannst)
scripts/
cli.mjs einzelner Einstiegspunkt / Dispatcher (node cli.mjs <command>)
lib/ injizierte Dienste, jeweils eine Verantwortung
env.mjs Parse+validiere Umgebung (Creds, App-ID)
jwt.mjs ES256-Token-Provider
client.mjs AscClient — Authentifizierung + HTTP + einheitliche Fehler
discovery.mjs Finde ASC-Ressourcen über natürliche Keys (keine hartcodierten IDs)
assets.mjs Reservieren→Hochladen→Festschreiben Binary-Uploader
config.mjs Lade + validiere Config, liste auf, was fehlt
log.mjs Strukturierte Ergebnisse + maschinenlesbare Zusammenfassung
context.mjs Kompositionswurzel (Dependency Injection)
commands/ eine Datei pro Aufgabe; einheitlicher Vertrag (siehe _contract.md)
Eine Fähigkeit hinzufügen = eine commands/x.mjs (meta + run(ctx)) hinzufügen und in cli.mjs registrieren.
Einrichtung (einmalig) — siehe references/setup.md
- ASC-API-Key (App Manager):
AuthKey_XXXX.p8herunterladen, Key-ID + Issuer-ID notieren. - App-Eintrag existiert in ASC (Bundle-ID registriert).
ASC_APP_ID= numerische ID aus der ASC-URL der App. - EAS-Projekt konfiguriert,
eas logindurchgeführt. config.jsonausreferences/config-template.jsonausfüllen. Jederzeit validieren: jeder Befehl gibt genau aus, welche Felder fehlen.
Umgebung
export ASC_KEY_ID=... ASC_ISSUER_ID=... ASC_P8_PATH=/abs/AuthKey_XXXX.p8 # gitignore die .p8
export ASC_APP_ID=1234567890
export APPSTORE_CONFIG=/abs/config.json
cd scripts # dann: node cli.mjs <command>
Runbook
1. Orientieren
node cli.mjs status # vollständiger schreibgeschützter Überblick
node cli.mjs check # Bereitschaft + die noch ausstehenden UI-only-Schritte
2. Das Binary bauen (EAS)
- Wenn
eas buildmit veralteten Anmeldedaten fehlschlägt („provisioning profile expired / no certificate with serial…“):dann setzenode cli.mjs credentials # neues Dist-Zertifikat + Profil → credentials.json"credentialsSource":"local"im eas.json-Produktionsprofil. - Binary bauen + einreichen (exportiere
EXPO_ASC_API_KEY_PATH/KEY_ID/ISSUER_ID+EXPO_APPLE_TEAM_ID+EXPO_APPLE_TEAM_TYPEfür nicht-interaktiven Modus):Warte, bis der Build VALID ist (eas build -p ios --profile production --non-interactive --no-wait eas submit -p ios --profile production --id <buildId>node cli.mjs status).
3. Das gesamte Listing in einem Durchgang ausfüllen
node cli.mjs release # Build anhängen → Metadaten → Preise → Inhaltsrechte →
# Altersfreigabe → Kategorie → Review-Info → Screenshots →
# Abonnement → check
release durchläuft die gesamte Pipeline (idempotent) und endet mit check, das die verbleibenden UI-only-Schritte ausgibt. Screenshots müssen zuerst existieren (config.screenshots.dir) — siehe references/screenshots.md, um sie zu generieren.
4. Die zwei UI-only-Schritte (mit genauen Klicks übergeben)
check listet diese auf, wenn sie zutreffen:
- App Privacy → Datenerhebung: Die Datentypen angeben, die dem Privacy-Manifest der App entsprechen, dann Veröffentlichen. ⚠️ Wenn das Binary
NSUserTrackingUsageDescriptionenthält, aber du kein Tracking deklarierst, wird die Veröffentlichung blockiert → den Key entfernen, neubauen (references/gotchas.md). - Erstmaliges Abonnement: Versionsseite → In-App Purchases and Subscriptions → Select → → Speichern → Add for Review → Einreichen. (Die API kann kein erstes Abonnement anhängen.)
5. Einreichen
node cli.mjs check # bestätige, dass nichts fehlt
node cli.mjs submit --submit # Nur-App / Updates (kein erstmaliges IAP)
Bei einem erstmaligen Abonnement reicht der Benutzer in der UI ein (Schritt 4.2). Überprüfe mit status: Version und Abonnement sind beide WAITING_FOR_REVIEW.
Ablehnungen
Bei Ablehnung wird die Version wieder bearbeitbar (REJECTED/METADATA_REJECTED/DEVELOPER_REJECTED). Lies die Mitteilung im Resolution-Center, behebe (Metadaten via release, oder Neubau bei Binary-Problemen), reiche erneut ein.
Referenzen
references/setup.md— Schlüsselerstellung, App-Eintrag, EAS, Secrets-Hygiene.references/gotchas.md— alle echten Fallstricke (vor dem ersten Durchlauf lesen).references/screenshots.md— Generieren von PNGs in exakter Größe (HTML → Headless Chrome).references/config-template.json— Pro-App-Konfiguration (validiert vonlib/config.mjs).