asc localize metadata
Nutze dieses Skill, um englische (oder andere Ausgangssprache) App Store Metadaten abzurufen, per LLM zu übersetzen und die Übersetzungen automatisiert zurück in App Store Connect zu übertragen.
Befehlsfindung und Ausgabekonventionen
- Bestätige Flags immer mit
--helpfür die exakteasc-Version:asc localizations --helpasc localizations download --helpasc localizations upload --helpasc apps info edit --help
- Bevorzuge explizite lange Flags (
--app,--version,--version-id,--type,--app-info). - Standardausgabe ist JSON; verwende
--output tablenur für manuelle Überprüfungsschritte. - Bevorzuge deterministische ID-basierte Operationen. Wähle nicht die "erste Zeile" via
head -1, es sei denn, der Benutzer stimmt ausdrücklich zu.
Voraussetzungen
- Authentifizierung konfiguriert (
asc auth loginoderASC_*-Umgebungsvariablen) - Kennen deiner App-ID (
asc apps listzum Finden) - Mindestens ein Gebietsschema (normalerweise en-US) hat bereits Metadaten in App Store Connect
Unterstützte Gebietsschemata
App Store Connect-Gebietsschemata für Versions- und App-Info-Lokalisierungen:
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
Zwei Arten von Metadaten
Versionslokalisierungen (pro Release)
Felder: description, keywords, whatsNew, supportUrl, marketingUrl, promotionalText
App-Info-Lokalisierungen (App-Ebene, dauerhaft)
Felder: name, subtitle, privacyPolicyUrl, privacyChoicesUrl, privacyPolicyText
Arbeitsablauf
Schritt 1: IDs auflösen
# App-ID finden
asc apps list --output table
# Neueste Versions-ID finden
asc versions list --app "APP_ID" --state READY_FOR_DISTRIBUTION --output table
# oder für bearbeitbare Version:
asc versions list --app "APP_ID" --state PREPARE_FOR_SUBMISSION --output table
# App-Info-ID finden (für App-Ebenen-Felder wie Name/Untertitel)
asc apps info list --app "APP_ID" --output table
Hinweise:
- Versionslokalisierungsfelder (description, keywords, whatsNew, etc.) sind versionsspezifisch.
- App-Info-Felder (name, subtitle, privacy URLs/text) sind App-Ebene und verwenden
--type app-info. - Wenn du nur Namen (App-Name, Versionszeichenfolge) hast und IDs deterministisch benötigst, verwende
asc-id-resolver.
Schritt 2: Ausgangsgebietsschema herunterladen
# Versionslokalisierungen in lokale .strings-Dateien herunterladen
# (description, keywords, whatsNew, promotionalText, supportUrl, marketingUrl, ...)
asc localizations download --version "VERSION_ID" --path "./localizations"
# App-Info-Lokalisierungen in lokale .strings-Dateien herunterladen
# (name, subtitle, privacyPolicyUrl, privacyChoicesUrl, privacyPolicyText, ...)
asc localizations download --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"
Dies erstellt Dateien wie ./localizations/en-US.strings und ./app-info-localizations/en-US.strings. Falls ein Download nicht verfügbar ist, lies die Felder einzeln aus:
# Vorhandene Lokalisierungen und deren Inhalt anzeigen
asc localizations list --version "VERSION_ID" --output table
Schritt 3: Mit LLM übersetzen
Für jedes Zielgebietsschema den Quelltext übersetzen. Beachte dabei folgende Regeln:
Übersetzungsrichtlinien
- Tonfall & Register: Verwende immer formelle, höfliche Sprache. Verwende formelle "Sie"-Formen, wo die Sprache diese unterscheidet (Russisch: «вы», Deutsch: «Sie», Französisch: «vous», Spanisch: «usted», Niederländisch: «u», Italienisch: «Lei», Portugiesisch: «você» formell usw.). App Store-Beschreibungen sind professionelle Marketingtexte – niemals lockeren oder informellen Tonfall verwenden.
- description: Natürlich übersetzen, Tonfall an den lokalen Markt anpassen. Formatierung beibehalten (Zeilenumbrüche, Aufzählungspunkte, Emojis). Innerhalb von 4000 Zeichen bleiben.
- keywords: NICHT wörtlich übersetzen. Recherchiere, wonach Benutzer in diesem Gebietsschema im App Store suchen würden. Komma-getrennt, maximal 100 Zeichen insgesamt. Keine Duplikate, kein App-Name (Apple fügt ihn automatisch hinzu).
- whatsNew: Versionshinweise übersetzen. Prägnant halten. Maximal 4000 Zeichen.
- promotionalText: Marketing-Slogan übersetzen. Maximal 170 Zeichen. Kann ohne neue Version aktualisiert werden.
- subtitle: Slogan kreativ anpassen. Maximal 30 Zeichen – sehr knapp, möglicherweise kreative Anpassung nötig.
- name: Normalerweise den ursprünglichen App-Namen beibehalten. Nur übersetzen, wenn der Benutzer es ausdrücklich verlangt. Maximal 30 Zeichen.
LLM-Übersetzungs-Prompt-Vorlage
Für jedes Zielgebietsschema diesen Ansatz verwenden:
Übersetze die folgenden App Store-Metadaten von {source_locale} nach {target_locale}.
Regeln:
- description: Natürliche, flüssige Übersetzung. Formatierung beibehalten (Zeilenumbrüche, Aufzählungspunkte, Emojis). Maximal 4000 Zeichen.
- keywords: NICHT wörtlich übersetzen. Wähle Schlüsselwörter, die Muttersprachler im App Store suchen würden. Komma-getrennt, maximal 100 Zeichen insgesamt. App-Namen nicht einfügen.
- whatsNew: Versionshinweise natürlich übersetzen. Maximal 4000 Zeichen.
- promotionalText: Marketing-Slogan übersetzen. Maximal 170 Zeichen.
- subtitle: Slogan kreativ anpassen, um maximal 30 Zeichen zu passen.
- name: Originalen App-Namen beibehalten, es sei denn, der Benutzer hat ausdrücklich um eine Übersetzung gebeten. Maximal 30 Zeichen.
- Verwende formelle, höfliche Sprache und formelle "Sie"-Formen (Deutsch: Sie, Russisch: вы, Französisch: vous, Spanisch: usted, Niederländisch: u usw.). App Store-Texte sind professionelle Marketingtexte – niemals informellen Tonfall verwenden.
- Respektiere den kulturellen Kontext. Ein spielerischer Ton im Englischen muss möglicherweise für formelle Märkte angepasst werden (z.B. ja, de-DE).
Quelle ({source_locale}):
description: """
{description}
"""
keywords: {keywords}
whatsNew: """
{whatsNew}
"""
promotionalText: {promotionalText}
name: {name}
subtitle: {subtitle}
Schritt 4: Übersetzungen hochladen
Option A: Über .strings-Dateien (Stapelverarbeitung)
Erstelle eine .strings-Datei pro Gebietsschema im entsprechenden Verzeichnis.
Beispiel für Versionslokalisierung:
// de-DE.strings
"description" = "Deine App-Beschreibung hier";
"keywords" = "Mathe,Kinder,Einmaleins,Lernen";
"whatsNew" = "Fehlerbehebungen und Verbesserungen";
"promotionalText" = "Lerne das Einmaleins spielend!";
Dann die Versionslokalisierungen hochladen:
asc localizations upload --version "VERSION_ID" --path "./localizations"
Beispiel für App-Info-Lokalisierung:
// de-DE.strings
"subtitle" = "Einmaleins spielend lernen";
Dann die App-Info-Lokalisierungen hochladen:
asc localizations upload --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"
Option B: Über einzelne Befehle (Feinsteuerung)
# Versionslokalisierungsfelder (Feinsteuerung).
# Bevorzuge die explizite Angabe der Versions-ID für Determinismus.
asc apps info edit --app "APP_ID" --version-id "VERSION_ID" --locale "de-DE" \
--description "Deine Beschreibung..." \
--keywords "Mathe,Kinder,Einmaleins" \
--whats-new "Fehlerbehebungen und Verbesserungen"
Für App-Ebenen-Felder:
# Untertitel/Name (App-Info-Lokalisierung) wird über App-Info-Lokalisierungen verwaltet.
# Verwende den .strings + Upload-Ablauf (es gibt keinen `asc app-infos localizations ...` Befehl).
#
# 1) Bearbeiten: ./app-info-localizations/de-DE.strings
# "subtitle" = "Einmaleins spielend lernen";
#
# 2) Hochladen:
asc localizations upload --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"
Schritt 5: Überprüfen
# Überprüfen, ob alle Gebietsschemata vorhanden sind
asc localizations list --version "VERSION_ID" --output table
# App-Info-Lokalisierungen überprüfen
asc localizations list --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --output table
Zeichenbegrenzungen (vor dem Hochladen durchsetzen!)
| Feld | Begrenzung |
|---|---|
| Name | 30 |
| Untertitel | 30 |
| Schlüsselwörter | 100 (komma-getrennt) |
| Beschreibung | 4000 |
| What's New | 4000 |
| Werbetext | 170 |
Validiere immer, dass der übersetzte Text innerhalb der Begrenzungen liegt, bevor du hochlädst. Abgeschnittener Text wirkt unprofessionell. Falls die Übersetzung die Begrenzung überschreitet, kürze sie – schneide sie nicht mitten im Satz ab.
Vollständiges Beispiel: nl-NL und ru zu Roxy Math hinzufügen
# 1) IDs deterministisch auflösen (nicht automatisch die "erste" Zeile auswählen)
# Wenn du nur Namen hast, verwende das asc-id-resolver Skill.
asc apps list --output table
APP_ID="APP_ID_HERE"
asc versions list --app "$APP_ID" --state PREPARE_FOR_SUBMISSION --output table
VERSION_ID="VERSION_ID_HERE"
asc apps info list --app "$APP_ID" --output table
APP_INFO_ID="APP_INFO_ID_HERE"
# 2) Englische Quelle herunterladen (oder dein gewähltes Ausgangsschema)
asc localizations download --version "$VERSION_ID" --path "./localizations"
asc localizations download --app "$APP_ID" --type app-info --app-info "$APP_INFO_ID" --path "./app-info-localizations"
# 3) en-US.strings lesen, nach nl-NL und ru übersetzen (LLM-Schritt)
# 4) nl-NL.strings und ru.strings schreiben nach:
# - ./localizations/ (Versionslokalisierungsfelder)
# - ./app-info-localizations/ (Untertitel/Name/Datenschutzfelder)
# 5) Alle hochladen
asc localizations upload --version "$VERSION_ID" --path "./localizations"
asc localizations upload --app "$APP_ID" --type app-info --app-info "$APP_INFO_ID" --path "./app-info-localizations"
# 6) Überprüfen
asc localizations list --version "$VERSION_ID" --output table
asc localizations list --app "$APP_ID" --type app-info --app-info "$APP_INFO_ID" --output table
Agentenverhalten
- Beginne immer damit, die Ausgangssprache zu lesen – übersetze niemals aus dem Gedächtnis oder Annahmen.
- Überprüfe zuerst vorhandene Lokalisierungen – überschreibe keine bestehenden Übersetzungen, es sei denn, der Benutzer bittet um eine Aktualisierung.
- Version vs. App-Info ist unterschiedlich – Versionsfelder liegen unter
--version "VERSION_ID"; Untertitel/Name/Datenschutz liegen unter--app ... --type app-info. - Bevorzuge deterministische IDs – wähle IDs nicht via
head -1aus, es sei denn, ausdrücklich gewünscht; verwende--output tablezur Auswahl oderasc-id-resolver. - Validiere Zeichenbegrenzungen vor dem Hochladen. Zähle Zeichen für jedes Feld. Bei Überschreitung neu übersetzen, kürzer.
- Schlüsselwörter sind speziell – nicht wörtlich übersetzen. Recherchiere gebietsschema-angepasste Suchbegriffe. Denke wie ein Benutzer, der im App Store in dieser Sprache sucht.
- Zeige dem Benutzer die Übersetzungen vor dem Hochladen – präsentiere eine Zusammenfassungstabelle aller Felder × Gebietsschemata zur Genehmigung. Nicht ohne Bestätigung übertragen.
- Verarbeite ein Gebietsschema nach dem anderen, wenn viele Sprachen übersetzt werden – einfacher zur Überprüfung und Fehlererkennung.
- Wenn der Upload für ein Gebietsschema fehlschlägt, protokolliere den Fehler, fahre mit anderen Gebietsschemata fort und melde alle Fehler am Ende.
- Für Aktualisierungen bestehender Lokalisierungen – lade die aktuellen Daten herunter, zeige, was sich ändern wird, hole Genehmigung ein, dann lade hoch.
Hinweise
- Versionslokalisierungen sind an eine bestimmte Version gebunden. Erstelle die Version zuerst, falls sie nicht existiert.
promotionalTextkann jederzeit ohne neue Versionseinreichung aktualisiert werden.whatsNewist nur für Updates relevant, nicht für die erste Version.- Verwende das
asc-id-resolverSkill, wenn du nur App-/Versionsnamen anstelle von IDs hast. - Verwende das
asc-metadata-syncSkill für nicht-übersetzungsbezogene Metadatenoperationen. - Für die Lokalisierung von Abonnement-/In-App-Kauf-Anzeigenamen verwende stattdessen das
asc-subscription-localizationSkill.