Communitygithub.com

IGTA-Tech/claude-skills-research (Lokalisierung & International…

Verwenden Sie diese Fähigkeit beim Lokalisieren von Apps, Nutzen von String Catalogs, Generieren typsicherer Symbole (Xcode 26+), Handhabung von Pluralformen, RTL-Layouts, gebietsschemabasierter Formatierung oder bei der Migration von .strings-Dateien – umfassende i18n-Muster für Xcode 15-26.

Was ist claude-skills-research (Lokalisierung & International…?

Diese Fähigkeit bietet einen umfassenden Leitfaden zur App-Lokalisierung mit String Catalogs (`.xcstrings`), Apples einheitlichem Format ab Xcode 15, das veraltete `.strings`- und `.stringsdict`-Dateien ersetzt. Sie behandelt SwiftUI- und UIKit-Lokalisierungs-APIs, die Handhabung von Pluralformen (entscheidend für Sprachen wie Russisch oder Arabisch mit mehreren Pluralregeln), Unterstützung für rechts-nach-links (RTL)-Layouts (z. B. für Arabisch oder Hebräisch), gebietsschemabasierte Formatierung von Daten, Zahlen und Währungen sowie Migrationsstrategien von Legacy-Formaten. Die Fähigkeit unterstützt Entwickler auf Plattformen wie Claude Code, Cursor und Codex und ist für Xcode 15-26 optimiert, mit besonderen Neuerungen in Xcode 26+ (automatische Symbolgenerierung, `#bundle`-Makro, KI-gestützte Kommentargenerierung). Sie ist ideal für Einrichtung der Internationalisierung, Fehlersuche bei fehlenden Übersetzungen, Vorbereitung von App Shortcuts und Sicherstellung, dass Apps die Anforderungen für den Apple Design Award in der Kategorie Inklusivität erfüllen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/IGTA-Tech/claude-skills-research/tree/HEAD/Axiom/.claude-plugin/plugins/axiom/skills/localization

In Ihrer bevorzugten KI fragen

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

Dokumentation

Lokalisierung & Internationalisierung

Umfassender Leitfaden zur App-Lokalisierung mit String Catalogs. Gewinner des Apple Design Awards für Inklusivität unterstützen stets mehrere Sprachen mit exzellenter RTL-Unterstützung (Rechts-nach-Links).

Übersicht

String Catalogs (.xcstrings) sind das einheitliche Format von Xcode 15 für die Verwaltung von App-Lokalisierungen. Sie ersetzen veraltete .strings- und .stringsdict-Dateien durch ein einziges JSON-basiertes Format, das einfacher zu warten, zu diffen und in Übersetzungsworkflows zu integrieren ist.

Diese Fähigkeit behandelt String Catalogs, SwiftUI/UIKit-Lokalisierungs-APIs, Plural-Handhabung, RTL-Unterstützung, gebietsschemabasierte Formatierung und Migrationsstrategien von Legacy-Formaten.

Wann diese Fähigkeit verwenden

  • Einrichten von String Catalogs in Xcode 15+
  • Lokalisieren von SwiftUI- und UIKit-Apps
  • Korrekte Handhabung von Pluralformen (entscheidend für viele Sprachen)
  • Unterstützung von RTL-Sprachen (Arabisch, Hebräisch)
  • Formatieren von Daten, Zahlen und Währungen je nach Gebietsschema
  • Migration von veralteten .strings/.stringsdict-Dateien
  • Vorbereiten von App Shortcuts und App Intents für die Lokalisierung
  • Fehlersuche bei fehlenden Übersetzungen oder falschen Pluralformen

Systemanforderungen

  • Xcode 15+ für String Catalogs (.xcstrings)
  • Xcode 26+ für automatische Symbolgenerierung, #bundle-Makro und KI-gestützte Kommentargenerierung
  • iOS 15+ für LocalizedStringResource
  • iOS 16+ für App Shortcuts-Lokalisierung
  • Frühere iOS-Versionen verwenden veraltete .strings-Dateien

Teil 1: String Catalogs (WWDC 2023/10155)

Erstellen eines String Catalogs

Methode 1: Xcode Navigator

  1. Datei → Neu → Datei
  2. „String Catalog“ auswählen
  3. Benennen (z. B. Localizable.xcstrings)
  4. Zum Ziel hinzufügen

Methode 2: Automatische Extraktion

Xcode 15 kann Zeichenfolgen automatisch extrahieren aus:

  • SwiftUI-Ansichten (Zeichenfolgenliterale in Text, Label, Button)
  • Swift-Code (String(localized:))
  • Objective-C (NSLocalizedString)
  • C (CFCopyLocalizedString)
  • Interface Builder-Dateien (.storyboard, .xib)
  • Info.plist-Werte
  • App Shortcuts-Phrasen

Erforderliche Buildeinstellungen:

  • „Compiler zum Extrahieren von Swift-Zeichenfolgen verwenden“ → Ja
  • „Lokalisierung bevorzugt String Catalogs“ → Ja

String Catalog-Struktur

Jeder Eintrag hat:

  • Schlüssel: Eindeutige Kennung (Standard: der englische Text)
  • Standardwert: Fallback, falls Übersetzung fehlt
  • Kommentar: Kontext für Übersetzer
  • Zeichenfolgentabelle: Organisationscontainer (Standard: „Localizable“)

Beispiel .xcstrings-JSON:

{
  "sourceLanguage" : "en",
  "strings" : {
    "Thanks for shopping with us!" : {
      "comment" : "Label above checkout button",
      "localizations" : {
        "en" : {
          "stringUnit" : {
            "state" : "translated",
            "value" : "Thanks for shopping with us!"
          }
        },
        "es" : {
          "stringUnit" : {
            "state" : "translated",
            "value" : "¡Gracias por comprar con nosotros!"
          }
        }
      }
    }
  },
  "version" : "1.0"
}

Übersetzungszustände

Xcode verfolgt den Zustand jeder Übersetzung:

  • Neu (⚪) – Zeichenfolge wurde noch nicht übersetzt
  • Benötigt Überprüfung (🟡) – Quelle geändert, Übersetzung möglicherweise veraltet
  • Überprüft (✅) – Übersetzung genehmigt und aktuell
  • Veraltet (🔴) – Zeichenfolge nicht mehr im Quellcode gefunden

Workflow:

  1. Entwickler fügt Zeichenfolge hinzu → Neu
  2. Übersetzer fügt Übersetzung hinzu → Überprüft
  3. Entwickler ändert Quelle → Benötigt Überprüfung
  4. Übersetzer aktualisiert → Überprüft
  5. Entwickler entfernt Code → Veraltet

Teil 2: SwiftUI-Lokalisierung

LocalizedStringKey (Automatisch)

SwiftUI-Ansichten mit String-Parametern unterstützen automatisch Lokalisierung:

// ✅ Automatisch lokalisierbar
Text("Welcome to WWDC!")
Label("Thanks for shopping with us!", systemImage: "bag")
Button("Checkout") { }

// Xcode extrahiert diese Zeichenfolgen in den String Catalog

Wie es funktioniert: SwiftUI verwendet intern LocalizedStringKey, das Zeichenfolgen in String Catalogs nachschlägt.

String(localized:) mit Kommentaren

Für explizite Lokalisierung in Swift-Code:

// Einfach
let title = String(localized: "Welcome to WWDC!")

// Mit Kommentar für Übersetzer
let title = String(localized: "Welcome to WWDC!",
                   comment: "Notification banner title")

// Mit benutzerdefinierter Tabelle
let title = String(localized: "Welcome to WWDC!",
                   table: "WWDCNotifications",
                   comment: "Notification banner title")

// Mit Standardwert (Schlüssel ≠ englischer Text)
let title = String(localized: "WWDC_NOTIFICATION_TITLE",
                   defaultValue: "Welcome to WWDC!",
                   comment: "Notification banner title")

Best Practice: Immer comment angeben, um Übersetzern Kontext zu geben.

LocalizedStringResource (Aufgeschobene Lokalisierung)

Zum Übergeben lokalisierbarer Zeichenfolgen an andere Funktionen:

import Foundation

struct CardView: View {
    let title: LocalizedStringResource
    let subtitle: LocalizedStringResource

    var body: some View {
        ZStack {
            RoundedRectangle(cornerRadius: 10.0)
            VStack {
                Text(title)      // Wird zur Renderzeit aufgelöst
                Text(subtitle)
            }
            .padding()
        }
    }
}

// Verwendung
CardView(
    title: "Recent Purchases",
    subtitle: "Items you've ordered in the past week."
)

Hauptunterschied: LocalizedStringResource verschiebt die Suche bis zur Verwendung, sodass benutzerdefinierte Ansichten vollständig lokalisierbar sind.

AttributedString mit Markdown

// Markdown-Formatierung bleibt über Lokalisierungen hinweg erhalten
let subtitle = AttributedString(localized: "**Bold** and _italic_ text")

Teil 3: UIKit & Foundation

NSLocalizedString-Makro

// Einfach
let title = NSLocalizedString("Recent Purchases", comment: "Button Title")

// Mit Tabelle
let title = NSLocalizedString("Recent Purchases",
                             tableName: "Shopping",
                             comment: "Button Title")

// Mit Bundle
let title = NSLocalizedString("Recent Purchases",
                             tableName: nil,
                             bundle: .main,
                             value: "",
                             comment: "Button Title")

Bundle.localizedString

let customBundle = Bundle(for: MyFramework.self)
let text = customBundle.localizedString(forKey: "Welcome",
                                        value: nil,
                                        table: "MyFramework")

Benutzerdefinierte Makros

// Objective-C
#define MyLocalizedString(key, comment) \
    [myBundle localizedStringForKey:key value:nil table:nil]

Info.plist-Lokalisierung

App-Namen, Berechtigungen usw. lokalisieren:

  1. Info.plist auswählen
  2. Editor → Lokalisierung hinzufügen
  3. InfoPlist.strings für jede Sprache erstellen:
// InfoPlist.strings (Spanisch)
"CFBundleName" = "Mi Aplicación";
"NSCameraUsageDescription" = "La app necesita acceso a la cámara para tomar fotos.";

Teil 4: Pluralbildung

Verschiedene Sprachen haben unterschiedliche Pluralregeln:

  • Englisch: 2 Formen (one, other)
  • Russisch: 3 Formen (one, few, many)
  • Polnisch: 3 Formen (one, few, other)
  • Arabisch: 6 Formen (zero, one, two, few, many, other)

SwiftUI-Plural-Handhabung

// Xcode erstellt automatisch Pluralvarianten
Text("\(count) items")

// Mit benutzerdefinierter Formatierung
Text("\(visitorCount) Recent Visitors")

Im String Catalog:

{
  "strings" : {
    "%lld Recent Visitors" : {
      "localizations" : {
        "en" : {
          "variations" : {
            "plural" : {
              "one" : {
                "stringUnit" : {
                  "state" : "translated",
                  "value" : "%lld Recent Visitor"
                }
              },
              "other" : {
                "stringUnit" : {
                  "state" : "translated",
                  "value" : "%lld Recent Visitors"
                }
              }
            }
          }
        }
      }
    }
  }
}

XLIFF-Exportformat

Beim Exportieren für die Übersetzung (Datei → Lokalisierungen exportieren):

Legacy (stringsdict):

<trans-unit id="/%lld Recent Visitors:dict/NSStringLocalizedFormatKey:dict/:string">
    <source>%#@recentVisitors@</source>
</trans-unit>

<trans-unit id="/%lld Recent Visitors:dict/recentVisitors:dict/one:dict/:string">
    <source>%lld Recent Visitor</source>
    <target>%lld Visitante Recente</target>
</trans-unit>

String Catalog (sauberer):

<trans-unit id="%lld Recent Visitors|==|plural.one">
    <source>%lld Recent Visitor</source>
    <target>%lld Visitante Recente</target>
</trans-unit>

<trans-unit id="%lld Recent Visitors|==|plural.other">
    <source>%lld Recent Visitors</source>
    <target>%lld Visitantes Recentes</target>
</trans-unit>

Substitutionen mit Pluralvariablen

// Mehrere Variablen mit unterschiedlichen Pluralformen
let message = String(localized: "\(songCount) songs on \(albumCount) albums")

Xcode erstellt Varianten für jede Pluralform einer Variable:

  • songCount: one, other
  • albumCount: one, other
  • Gesamtkombinationen: 2 × 2 = 4 Übersetzungseinträge

Teil 5: Geräte- und Breitenvarianten

Gerätespezifische Zeichenfolgen

Unterschiedlicher Text für verschiedene Plattformen:

// Gleicher Code, unterschiedliche Zeichenfolgen pro Gerät
Text("Bird Food Shop")

String Catalog-Varianten:

{
  "Bird Food Shop" : {
    "localizations" : {
      "en" : {
        "variations" : {
          "device" : {
            "applewatch" : {
              "stringUnit" : {
                "value" : "Bird Food"
              }
            },
            "other" : {
              "stringUnit" : {
                "value" : "Bird Food Shop"
              }
            }
          }
        }
      }
    }
  }
}

Ergebnis:

  • iPhone/iPad: „Bird Food Shop“
  • Apple Watch: „Bird Food“ (kürzer für kleinen Bildschirm)

Breitenvarianten

Für dynamische Schriftarten und Größenklassen:

Text("Application Settings")

String Catalog kann kürzeren Text für schmale Breiten bereitstellen.


Teil 6: RTL-Unterstützung

Layout-Spiegelung

SwiftUI spiegelt Layouts automatisch für RTL-Sprachen:

// ✅ Wird automatisch für Arabisch/Hebräisch gespiegelt
HStack {
    Image(systemName: "chevron.right")
    Text("Next")
}

// iPhone (Englisch): [>] Next
// iPhone (Arabisch):  Next [<]

Leading/Trailing vs. Left/Right

Immer semantische Richtungen verwenden:

// ✅ Richtig – wird automatisch gespiegelt
.padding(.leading, 16)
.frame(maxWidth: .infinity, alignment: .leading)

// ❌ Falsch – wird nicht gespiegelt
.padding(.left, 16)
.frame(maxWidth: .infinity, alignment: .left)

Bilder und Symbole

Bilder markieren, die gespiegelt werden sollen oder nicht:

// ✅ Richtungsabhängig – wird für RTL gespiegelt
Image(systemName: "chevron.forward")

// ✅ Nicht richtungsabhängig – wird nie gespiegelt
Image(systemName: "star.fill")

// Benutzerdefinierte Bilder
Image("backButton")
    .flipsForRightToLeftLayoutDirection(true)

Testen im RTL-Modus

Xcode-Schema:

  1. Schema bearbeiten → Ausführen → Optionen
  2. Anwendungssprache: Arabisch / Hebräisch
  3. ODER: App-Sprache → Rechts-nach-Links-Pseudosprache

Simulator: Einstellungen → Allgemein → Sprache & Region → Bevorzugte Sprachen

SwiftUI-Vorschau:

struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView()
            .environment(\.layoutDirection, .rightToLeft)
            .environment(\.locale, Locale(identifier: "ar"))
    }
}

Teil 7: Gebietsschemabasierte Formatierung

DateFormatter

let formatter = DateFormatter()
formatter.locale = Locale.current  // ✅ Aktuelles Gebietsschema verwenden
formatter.dateStyle = .long
formatter.timeStyle = .short

let dateString = formatter.string(from: Date())

// USA: „January 15, 2024 at 3:30 PM“
// Frankreich: „15 janvier 2024 à 15:30“
// Japan: „2024年1月15日 15:30"

Nie Datumsformatzeichenfolgen hartcodieren:

// ❌ Falsch – bricht in anderen Gebietsschemata
formatter.dateFormat = "MM/dd/yyyy"

// ✅ Richtig – passt sich an das Gebietsschema an
formatter.dateStyle = .short

NumberFormatter für Währung

let formatter = NumberFormatter()
formatter.locale = Locale.current
formatter.numberStyle = .currency

let priceString = formatter.string(from: 29.99)

// USA: „$29.99“
// UK: „£29.99“
// Japan: „¥30“ (rundet auf ganze Zahl)
// Frankreich: „29,99 €“ (Komma als Dezimaltrennzeichen, Leerzeichen vor Symbol)

MeasurementFormatter

let distance = Measurement(value: 100, unit: UnitLength.meters)

let formatter = MeasurementFormatter()
formatter.locale = Locale.current

let distanceString = formatter.string(from: distance)

// USA: „328 ft“ (konvertiert in angloamerikanisches Maß)
// Metrische Länder: „100 m“

Gebietsschemaspezifische Sortierung

let names = ["Ångström", "Zebra", "Apple"]

// ✅ Gebietsschemabewusste Sortierung
let sorted = names.sorted { (lhs, rhs) in
    lhs.localizedStandardCompare(rhs) == .orderedAscending
}

// Schweden: ["Ångström", "Apple", "Zebra"]  (Å kommt im Schwedischen an erster Stelle)
// USA: ["Ångström", "Apple", "Zebra"]      (Å wird wie A behandelt)

Teil 8: App Shortcuts-Lokalisierung

Phrasen mit Parametern

import AppIntents

struct ShowTopDonutsIntent: AppIntent {
    static var title: LocalizedStringResource = "Show Top Donuts"

    @Parameter(title: "Timeframe")
    var timeframe: Timeframe

    static var parameterSummary: some ParameterSummary {
        Summary("\(.applicationName) Trends for \(\$\.timeframe)") {
            \$\.timeframe
        }
    }
}

String Catalog enthält Einträge für:

  • Show Top Donuts – Kurzbefehlstitel
  • Timeframe – Parameterbezeichnung
  • \(.applicationName) Trends for \(\$\.timeframe) – Zusammenfassung mit Platzhaltern

Teil 9: Migration von Strings zu String Catalogs

Manuelle Migration

  1. String Catalog erstellen: Datei → Neu → Datei → „String Catalog“
  2. Schlüssel manuell hinzufügen: Xcode-Editor für jeden Schlüssel
  3. Übersetzungen kopieren: Manuelles Übertragen aus .strings-Dateien

Automatische Migration (Xcode 15+)

  1. Legacy .strings-Dateien beibehalten: Xcode extrahiert daraus
  2. Automatischen Export aktivieren: Buildeinstellungen → „Localization Prefers String Catalogs“ → Ja
  3. Build ausführen: Xcode generiert .xcstrings aus vorhandenen .strings-Dateien

Wichtig: Migration ist ein Einwegprozess für XLIFF-Exporte – stellen Sie sicher, dass String Catalogs vollständig sind, bevor Sie Legacy-Dateien entfernen.


Teil 10: Fortgeschrittene Themen

Symbolgenerierung (Xcode 26+)

Xcode 26 kann automatisch typsichere Symbole aus String Catalogs generieren:

// String Catalog definiert den Schlüssel: "welcome_message"
// Xcode generiert:
let text = String(localized: Localizable.welcomeMessage)

KI-gestützte Kommentargenerierung (Xcode 26+)

Xcode 26 kann automatisch Kontextkommentare für Übersetzer generieren, indem es den Quellcode analysiert.

#bundle-Makro (Xcode 26+)

Das #bundle-Makro vereinfacht die Bundle-Referenzierung für Frameworks:

// Vor Xcode 26:
let text = String(localized: "Hello", bundle: .module)

// Ab Xcode 26:
let text = String(localized: "Hello", bundle: #bundle)

Fehlerbehebung

ProblemWahrscheinliche UrsacheLösung
Zeichenfolge nicht lokalisierbarLocalizedStringKey nicht verwendetText() oder String(localized:) verwenden
XLIFF-Import schlägt fehlVeraltete .stringsdict-PluraleZu String Catalogs migrieren
RTL-Layout nicht gespiegeltExplizites .leading/.trailing` fehlt.leading/.trailingstatt.left/.right verwenden
Falsches Plural-FormatFalsche PluralvariablenVar1 plural other ...-Syntax prüfen
Standardtext angezeigtSprache wird nicht unterstütztSprache zu Xcode-Projekt hinzufügen
App Shortcuts nicht lokalisierbarLocalizedStringResource nicht verwendetLocalizedStringResource-Typ verwenden

Zusammenfassung

  • String Catalogs sind der empfohlene Weg ab Xcode 15
  • LocalizedStringKey automatisiert SwiftUI-Lokalisierung
  • Pluralformen variieren stark zwischen Sprachen – String Catalogs handhabt dies nativ
  • RTL-Unterstützung ist meist automatisch, erfordert aber semantische Layout-APIs
  • Gebietsschemabasierte Formatierung verwendet Locale.current anstelle von hartcodierten Mustern
  • Migration von Legacy-Formaten ist mit Xcode 15+ weitgehend automatisiert

Individual skills in this repo

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

IGTA-Tech/claude-skills-research

Use when implementing SwiftUI animations, understanding VectorArithmetic, using @Animatable macro, choosing between spring and timing curve animations, or debugging animation behavior - comprehensive animation reference from iOS 13 through iOS 26

IGTA-Tech/claude-skills-research

Use when CAAnimation completion handler doesn't fire, spring physics look wrong on device, animation duration mismatches actual time, gesture + animation interaction causes jank, or timing differs between simulator and real hardware - systematic CAAnimation diagnosis with CATransaction patterns, frame rate awareness, and device-specific behavior

IGTA-Tech/claude-skills-research

This skill should be used when comparing two videos to analyze compression results or quality differences. Generates interactive HTML reports with quality metrics (PSNR, SSIM) and frame-by-frame visual comparisons. Triggers when users mention "compare videos", "video quality", "compression analysis", "before/after compression", or request quality assessment of compressed videos.

IGTA-Tech/claude-skills-research

Download YouTube videos and HLS streams (m3u8) from platforms like Mux, Vimeo, etc. using yt-dlp and ffmpeg. Use this skill when users request downloading videos, extracting audio, handling protected streams with authentication headers, or troubleshooting download issues like nsig extraction failures, 403 errors, or cookie extraction problems.

IGTA-Tech/claude-skills-research

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

IGTA-Tech/claude-skills-research

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

IGTA-Tech/claude-skills-research

Download YouTube video transcripts when user provides a YouTube URL or asks to download/get/fetch a transcript from YouTube. Also use when user wants to transcribe or get captions/subtitles from a YouTube video.

Verwandte Skills