huihuisang/localize-app-store-screenshots

Lokalisieren von App Store-Screenshots

Bewahren Sie das freigegebene Kunstwerk und lokalisieren Sie nur dessen Marketingtexte. Rendern Sie den endgültigen Text deterministisch mit installierten Schriftarten, setzen Sie ihn nur innerhalb des freigegebenen Textbereichs zusammen und verwenden Sie asc für die Prüfung und Zustellung.

Arbeitsablauf

1. Inventarisieren Sie die Quell-PNGs, deren Reihenfolge, Abmessungen, Gerätefamilien und vorhandene entfernte Screenshots.
2. Schreiben Sie marktgerechte Texte. Bewahren Sie die Verkaufsidee; übersetzen Sie nicht wörtlich, wenn die Formulierung ungeschickt wird. Halten Sie Zeilenumbrüche beabsichtigt.
3. Prüfen Sie jedes Quellbild vor der Bearbeitung.
4. Bereiten Sie eine saubere Vorlage vor, indem Sie nur den Quell-Marketingtext entfernen. Bevorzugen Sie eine vorhandene, freigegebene saubere Vorlage. Wenn eine Bereinigung erforderlich ist, verwenden Sie eine enge Maske und bewahren Sie jeden Pixel außerhalb dieser Maske.
5. Rendern Sie den exakten lokalisierten Text mit scripts/render_localized_text.py. Verwenden Sie eine installierte Schriftart mit bestätigter Glyphenabdeckung; verwenden Sie niemals Bildgenerierung, um den endgültigen Text zu zeichnen.
6. Definieren Sie eine enge Textbereichsbox und überprüfen Sie, dass sich die endgültige Bitmap von der freigegebenen Quelle nur innerhalb dieser Box unterscheidet.
7. Prüfen Sie ein beschriftetes Kontaktblatt, dann inspizieren Sie jeden CJK-Titel bei 100%-Skalierung auf exakte Glyphen, Rechtschreibung, Umbruch, Hierarchie und Bereinigungsnähte.
8. Validieren Sie Abmessungen, RGB-Opazität, Dateianzahl, Reihenfolge, exakte Manifest-Kopie und null geänderte Pixel außerhalb jedes erlaubten Bereichs.
9. Erstellen Sie ASC-Prüfartefakte, prüfen Sie sie, genehmigen Sie sie und laden Sie sie mit plan/apply nur hoch, wenn die geplanten Gruppen genau der beabsichtigten Lokalisierungs-/Anzeigetyp-Matrix entsprechen. Löschen oder ersetzen Sie niemals entfernte Screenshots ohne ausdrückliche Genehmigung.
10. Listen Sie die entfernten Screenshots erneut auf und überprüfen Sie Lokalisierung, Gerätefamilie, Anzahl und Verarbeitungsstatus.

Grenzen der Bildgenerierung

Bitten Sie kein Bildmodell, den endgültigen lokalisierten Text zu rendern. Generativer Text kann substituierte Glyphen, Überreste oder halluzinierte Zeichen enthalten, selbst wenn die Eingabeaufforderung wörtlich ist.

Verwenden Sie Bildgenerierung nur, wenn ein sauberer Hintergrundpatch lokal nicht erstellt werden kann, und fordern Sie die Entfernung an, nicht den Ersatz:

Verwendungszweck: präzise-objekt-bearbeitung
Asset-Typ: saubere Vorlage für einen lokalisierten App Store-Screenshot
Eingabebild: Bearbeitungsziel
Hauptanforderung: Entfernen Sie nur den vorhandenen Marketingtext und rekonstruieren Sie den Hintergrund.
Einschränkungen: Bewahren Sie den Hintergrund, das Gerätemockup, die Perspektive, die Beleuchtung, jeden Produktbildschirm-Pixel, die Farben, den Zuschnitt und das Seitenverhältnis. Übersetzen oder zeichnen Sie die Produkt-UI nicht neu.
Vermeiden Sie: jeglichen Text, Buchstaben, Symbole, Wasserzeichen, Neugestaltung, Geräteänderungen, UI-Änderungen oder veränderte Produktbilder.

Lehnen Sie das Ergebnis ab, wenn sich die Komposition oder das geschützte Kunstwerk ändert. Verwenden Sie niemals die vollständige generierte Bitmap; setzen Sie nur einen geprüften Bereinigungspatch innerhalb des erlaubten Bereichs zusammen.

Deterministische Komposition

Bereiten Sie eine saubere Vorlage lokal vor, wenn der Quelltext auf einem strukturierten Hintergrund hell ist:

python scripts/prepare_clean_master.py \
  --source /pfad/zu/freigegeben.png \
  --output /pfad/zu/sauberer-vorlage.png \
  --box x,y,breite,hoehe

Rendern Sie exakten Text aus einem JSON-Manifest:

python scripts/render_localized_text.py --manifest /pfad/zu/text-manifest.json
python scripts/verify_localized_text.py --manifest /pfad/zu/text-manifest.json

Erstellen Sie ein JSON-Manifest unter Verwendung des Schemas in references/manifest.md, dann führen Sie aus:

python scripts/compose_localized_patch.py --manifest /pfad/zu/manifest.json

Das Skript skaliert die generierte Bearbeitung auf die exakten Quellabmessungen, mischt nur innerhalb des erlaubten Rechtecks plus weicher Kante, schreibt undurchsichtiges RGB-PNG und überprüft, dass dekorierte Pixel außerhalb des erlaubten Bereichs mit der Quelle identisch sind.

Verbreitern Sie eine Box nicht, um Modellabweichungen zu verbergen. Ziehen Sie sie um den Marketingtext herum eng. Schließen Sie niemals Produkt-UI in den erlaubten Bereich ein.

App Store-Qualitätssicherung

• Bewahren Sie die Quellabmessungen, es sei denn, Sie zielen auf einen anderen Apple-Anzeigetyp ab.
• Fordern Sie undurchsichtige RGB-Ausgabe; lehnen Sie PNGs mit Alphakanal ab.
• Behalten Sie einen geordneten Satz pro Storefront und Anzeigetyp bei.
• Verwenden Sie marktgerechte Schriftarten/Glyphen und prüfen Sie CJK-Ausgabe visuell.
• Bestätigen Sie jeden Titel in Miniaturansichtsskala und jeden Untertitel in 100%-Skalierung.
• Vergleichen Sie sichtbaren Text Zeichen für Zeichen mit dem geprüften Manifest. OCR kann die QA für lateinische Schriften unterstützen, ersetzt jedoch niemals die visuelle CJK-Prüfung.
• Lehnen Sie restliche Quellbuchstaben, doppelte Striche, Ersatzglyphen, Tofu-Boxen, unerwartete Zeichensetzung oder modellgenerierten Text ab.
• Behandeln Sie null Pixeländerungen außerhalb des Bereichs als harte Invariante.

ASC-Upload-Sicherheit

Lesen Sie die installierten Skills asc-shots-pipeline und asc-cli-usage vor dem Upload. Bestätigen Sie aktuelle Flags mit asc screenshots --help und befehlsspezifischem --help.

Bevorzugen Sie:

asc screenshots review-generate --framed-dir OUTPUT_ROOT --output-dir REVIEW_DIR
asc screenshots review-open --output-dir REVIEW_DIR
asc screenshots review-approve --all-ready --output-dir REVIEW_DIR
asc screenshots plan --app APP_ID --version VERSION --review-output-dir REVIEW_DIR --output json
asc screenshots apply --app APP_ID --version VERSION --review-output-dir REVIEW_DIR --confirm --output json

Wenn plan/apply die beabsichtigte Lokalisierungszuordnung nicht ausdrücken kann, lösen Sie die exakte Versions-Lokalisierungs-ID auf und verwenden Sie asc screenshots upload für diese Lokalisierung allein. Listen Sie Screenshots vorher und nachher auf. Gehen Sie nicht davon aus, dass der Upload vorhandene Screenshots ersetzt; prüfen Sie zuerst das CLI-Verhalten und die Apple-Beschränkungen.

Einige Abmessungen werden von mehreren Apple-Anzeigetypen akzeptiert. Beispielsweise kann 1290x2796 sowohl als APP_IPHONE_67 als auch als APP_IPHONE_69 validieren. Wenn die Planausgabe dieselben Dateien über Anzeigetypen dupliziert, wenden Sie sie nicht an. Führen Sie einen app-weiten Upload mit einem expliziten --device-type durch, nach einem passenden Trockenlauf:

asc screenshots upload --app APP_ID --version-id VERSION_ID --path OUTPUT_ROOT --device-type APP_IPHONE_67 --dry-run
asc screenshots upload --app APP_ID --version-id VERSION_ID --path OUTPUT_ROOT --device-type APP_IPHONE_67

Ressourcen

• scripts/compose_localized_patch.py: pixelgenaue Komposition und Validierung.
• references/manifest.md: Manifest-Schema und Beispiel.