Communitygithub.com

appstore-release

Automatisieren Sie iOS-App-Einreichungen bei App Store Connect mit einer einzigen Konfigurationsdatei für eine konsistente und zuverlässige Release-Pipeline.

Was ist appstore-release?

Appstore-Release ist ein KI-Agenten-Skill, der den gesamten iOS-App-Einreichungsprozess bei App Store Connect automatisiert – vom Bau des Binärs über das Hochladen von Metadaten und Screenshots bis hin zur endgültigen Einreichung zur Überprüfung. Es nutzt die App Store Connect API und arbeitet konfigurationsgesteuert: Der Benutzer stellt einmalig eine `config.json`-Datei sowie ASC-API-Schlüssel bereit, und der Agent erledigt dann alles Automatisierbare. Der Skill unterstützt die Plattformen Claude Code, Cursor, Codex und ähnliche KI-Agenten-Tools. Er ist idempotent ausgelegt, sodass alle Befehle wiederholt ausgeführt werden können, ohne Nebeneffekte. Nur zwei Schritte erfordern manuelle UI-Interaktion: die Angabe der App-Datenschutzdaten und die erstmalige Anbindung von Abonnements. Der Skill gibt in diesen Fällen präzise Klickanweisungen, sodass der Benutzer nahtlos weiterarbeiten kann. Die Architektur ist modular und erweiterbar (SOLID-Prinzipien), sodass neue Funktionen einfach als neue Befehlsdateien hinzugefügt werden können. Dieser Skill ist besonders nützlich für Entwicklerteams, die ihren iOS-App-Release-Prozess konsistent, wiederholbar und zeitsparend gestalten möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add threelipped-genushesperiphona524/appstore-release

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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)

  1. Config-getrieben, nicht Prompt-getrieben. Alle App-Inhalte leben in config.json. Befehle ausführen; nicht den Benutzer interviewen.
  2. 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.
  3. 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.
  4. Idempotent: jeder Befehl kann sicher wiederholt werden. node cli.mjs release kann 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

  1. ASC-API-Key (App Manager): AuthKey_XXXX.p8 herunterladen, Key-ID + Issuer-ID notieren.
  2. App-Eintrag existiert in ASC (Bundle-ID registriert). ASC_APP_ID = numerische ID aus der ASC-URL der App.
  3. EAS-Projekt konfiguriert, eas login durchgeführt.
  4. config.json aus references/config-template.json ausfü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 build mit veralteten Anmeldedaten fehlschlägt („provisioning profile expired / no certificate with serial…“):
    node cli.mjs credentials     # neues Dist-Zertifikat + Profil → credentials.json
    
    dann setze "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_TYPE für nicht-interaktiven Modus):
    eas build -p ios --profile production --non-interactive --no-wait
    eas submit -p ios --profile production --id <buildId>
    
    Warte, bis der Build VALID ist (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:

  1. App Privacy → Datenerhebung: Die Datentypen angeben, die dem Privacy-Manifest der App entsprechen, dann Veröffentlichen. ⚠️ Wenn das Binary NSUserTrackingUsageDescription enthält, aber du kein Tracking deklarierst, wird die Veröffentlichung blockiert → den Key entfernen, neubauen (references/gotchas.md).
  2. 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 von lib/config.mjs).

Verwandte Skills