Communitygithub.com

exiao/skills

Lokalisieren Sie Abonnement- und In-App-Kauf-Anzeigenamen massenhaft für alle App Store Locales mit asc. Verwenden Sie dies, um Abonnement-/IAP-Namen für jede Sprache auszufüllen, ohne manuell durch App Store Connect klicken zu müssen.

Was ist skills?

Diese Skill ermöglicht die Bulk-Erstellung oder -Aktualisierung von Anzeigenamen (und Beschreibungen) für Abonnements, Abonnementgruppen und In-App-Käufe in allen App Store Connect Locales. Sie ersetzt den zeitraubenden manuellen Prozess, bei dem Entwickler jede Sprache einzeln in App Store Connect anklicken müssen, um denselben Anzeigenamen zu setzen. Die Skill unterstützt alle gängigen App Store Locales (z. B. en-US, de-DE, ja, zh-Hans) und arbeitet mit dem `asc`-CLI-Tool von Apple. Sie ist ideal für iOS/macOS-Entwickler, die mehrere Abonnements oder IAPs verwalten und eine konsistente Lokalisierung über alle Märkte hinweg sicherstellen möchten. Die Skill führt den Benutzer durch Schritte wie das Auflisten vorhandener Lokalisierungen, das Erstellen fehlender Einträge mit einem einzigen Befehl pro Locale und die Überprüfung der Ergebnisse. Sie vermeidet doppelte Einträge, indem sie zuerst prüft, welche Locales bereits vorhanden sind, und erstellt nur für fehlende Locales. Bei Fehlern wird der Vorgang fortgesetzt und anschließend über alle Fehler berichtet, sodass der Benutzer sie gezielt beheben kann.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/exiao/skills/tree/HEAD/app-store/app-store-connect/subscription-localization

In Ihrer bevorzugten KI fragen

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

Dokumentation

Lokalisierung von ASC-Abonnements

Verwenden Sie diesen Skill, um Anzeigenamen (und Beschreibungen) für Abonnements, Abonnementgruppen und In-App-Käufe in allen App Store Connect Locales massenhaft zu erstellen oder zu aktualisieren. Dies eliminiert den mühsamen manuellen Prozess, bei dem Sie jede Sprache in App Store Connect einzeln anklicken müssen, um denselben Anzeigenamen festzulegen.

Voraussetzungen

  • Authentifizierung konfiguriert (asc auth login oder ASC_*-Umgebungsvariablen).
  • Kennen Sie Ihre App-ID (ASC_APP_ID oder --app).
  • Abonnementgruppen und Abonnements existieren bereits.

Unterstützte App Store Locales

Dies sind die von App Store Connect für Abonnement- und IAP-Lokalisierungen unterstützten Locales:

ar-SA, ca, cs, da, de-DE, el, en-AU, en-CA, en-GB, en-US,
es-ES, es-MX, fi, fr-CA, fr-FR, he, hi, hr, hu, id, it,
ja, ko, ms, nl-NL, no, pl, pt-BR, pt-PT, ro, ru, sk,
sv, th, tr, uk, vi, zh-Hans, zh-Hant

Arbeitsablauf: Massenlokalisierung eines Abonnements

1. IDs auflösen

# Abonnementgruppen finden
asc subscriptions groups list --app "APP_ID" --output table

# Abonnements innerhalb einer Gruppe finden
asc subscriptions list --group "GROUP_ID" --output table

2. Vorhandene Lokalisierungen prüfen

asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table

Dies zeigt an, welche Locales bereits einen Namen gesetzt haben. Erstellen Sie nur Lokalisierungen für fehlende Locales.

3. Lokalisierungen für alle fehlenden Locales erstellen

Führen Sie für jedes Locale, das noch keine Lokalisierung hat, Folgendes aus:

asc subscriptions localizations create \
  --subscription-id "SUB_ID" \
  --locale "LOCALE" \
  --name "Anzeigename"

Um beispielsweise "Monthly Pro" für alle Locales zu setzen:

# Ein Befehl pro Locale (überspringen Sie alle, die bereits existieren)
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ar-SA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ca" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "cs" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "da" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "de-DE" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "el" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-AU" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-CA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-GB" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-ES" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-MX" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-CA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-FR" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "he" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hr" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hu" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "id" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "it" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ja" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ko" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ms" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "nl-NL" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "no" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pl" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-BR" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-PT" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ro" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ru" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sk" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sv" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "th" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "tr" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "uk" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "vi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hans" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hant" --name "Monthly Pro"

4. Überprüfen

asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table

Arbeitsablauf: Massenlokalisierung einer Abonnementgruppe

Abonnementgruppen haben ebenfalls einen eigenen Anzeigenamen pro Locale (dies ist der "Gruppenname", der Benutzern im Abonnementverwaltungsblatt angezeigt wird).

1. Vorhandene Gruppenlokalisierungen prüfen

asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table

2. Für fehlende Locales erstellen

asc subscriptions groups localizations create \
  --group-id "GROUP_ID" \
  --locale "LOCALE" \
  --name "Gruppen-Anzeigename"

Optional: Legen Sie einen benutzerdefinierten App-Namen für die Gruppe fest:

asc subscriptions groups localizations create \
  --group-id "GROUP_ID" \
  --locale "LOCALE" \
  --name "Gruppen-Anzeigename" \
  --custom-app-name "Meine App"

3. Überprüfen

asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table

Arbeitsablauf: Massenlokalisierung eines In-App-Kaufs

IAPs haben ihre eigenen Lokalisierungsbefehle mit demselben Muster.

1. IAP-ID auflösen

asc iap list --app "APP_ID" --output table

2. Vorhandene Lokalisierungen prüfen

asc iap localizations list --iap-id "IAP_ID" --paginate --output table

3. Für fehlende Locales erstellen

asc iap localizations create \
  --iap-id "IAP_ID" \
  --locale "LOCALE" \
  --name "Anzeigename"

Optionale Beschreibung:

asc iap localizations create \
  --iap-id "IAP_ID" \
  --locale "LOCALE" \
  --name "Alle Funktionen freischalten" \
  --description "Einmaliger Kauf zum Freischalten aller Premium-Funktionen"

4. Überprüfen

asc iap localizations list --iap-id "IAP_ID" --paginate --output table

Aktualisieren vorhandener Lokalisierungen

So ändern Sie den Anzeigenamen für vorhandene Lokalisierungen:

Abonnements

asc subscriptions localizations update --id "LOC_ID" --name "Neuer Name"

Abonnementgruppen

asc subscriptions groups localizations update --id "LOC_ID" --name "Neuer Gruppenname"

In-App-Käufe

asc iap localizations update --id "LOC_ID" --name "Neuer Name"

Für eine Massenaktualisierung listen Sie zuerst die vorhandenen Lokalisierungen auf, extrahieren Sie die IDs und aktualisieren Sie dann jede.

Massenlokalisierung aller Abonnements in einer App

Für eine vollständige App mit mehreren Abonnementgruppen und Abonnements:

# 1. Alle Gruppen auflisten
asc subscriptions groups list --app "APP_ID" --paginate

# 2. Für jede Gruppe die Gruppe selbst lokalisieren
#    (Arbeitsablauf zur Gruppenlokalisierung oben wiederholen)

# 3. Für jede Gruppe Abonnements auflisten
asc subscriptions list --group "GROUP_ID" --paginate

# 4. Für jedes Abonnement dieses lokalisieren
#    (Arbeitsablauf zur Abonnementlokalisierung oben wiederholen)

Agentenverhalten

  • Listen Sie immer zuerst die vorhandenen Lokalisierungen auf, um doppelte Erstellungsfehler zu vermeiden.
  • Überspringen Sie Locales, die bereits eine Lokalisierung haben; erstellen Sie nur fehlende.
  • Wenn der Benutzer einen einzelnen Anzeigenamen angibt, verwenden Sie diesen für alle Locales (gleicher Name überall).
  • Wenn der Benutzer übersetzte Namen pro Locale angibt, verwenden Sie den lokalspezifischen Namen für jedes.
  • Wenn eine Beschreibung angegeben wird, übergeben Sie --description beim Erstellen. Andernfalls lassen Sie ihn weg.
  • Verwenden Sie --output table für Überprüfungsschritte, damit der Benutzer visuell bestätigen kann.
  • Verwenden Sie die Standard-JSON-Ausgabe für Zwischenautomatisierungsschritte.
  • Führen Sie nach der Massenerstellung immer den List-Befehl aus, um die Vollständigkeit zu überprüfen.
  • Bei Apps mit vielen Abonnements verarbeiten Sie diese sequentiell pro Gruppe, um die Ausgabe lesbar zu halten.
  • Wenn ein Create-Aufruf für ein Locale fehlschlägt, protokollieren Sie das Locale und den Fehler und fahren Sie mit den verbleibenden Locales fort. Melden Sie nach Abschluss des Batches alle Fehler gemeinsam, damit der Benutzer sie beheben kann.

Hinweise

  • Abonnement-Anzeigenamen werden Benutzern im Abonnementverwaltungsblatt und in Kaufdialogen angezeigt.
  • Das Erstellen einer Lokalisierung für ein Locale, das bereits existiert, schlägt fehl; überprüfen Sie immer zuerst.
  • Es gibt keine Bulk-API; jedes Locale erfordert einen separaten Create-Aufruf.
  • Verwenden Sie --paginate bei List-Befehlen, um sicherzustellen, dass alle vorhandenen Lokalisierungen zurückgegeben werden.
  • Verwenden Sie den Skill asc-id-resolver, wenn Sie nur App-Namen anstelle von IDs haben.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Verwandte Skills