axiom-localization

Skill do kompleksowej lokalizacji aplikacji na iOS przy użyciu String Catalogs (format .xcstrings). Dowiesz się, jak zarządzać tłumaczeniami w Xcode 15+, obsługiwać języki RTL (arabski, hebrajski), poprawnie formatować plurale, daty i waluty według ustawień regionu. Skill obejmuje migrację ze starszych plików .strings i .stringsdict, przygotowanie App Shortcuts do lokalizacji oraz debugowanie brakujących tłumaczeń.

1. Otwórz projekt w Xcode 15 lub nowszej wersji. Jeśli używasz Xcode 26+, uzyskasz dodatkowe możliwości automatycznego generowania symboli i makra #bundle.

2. Utwórz String Catalog: przejdź do File → New → File, wybierz "String Catalog" i nazwij plik (np. Localizable.xcstrings), następnie dodaj go do swojego celu (target).

3. Dodaj ciągi znaków do katalogu — każdy string otrzyma unikalny klucz. Dla każdego klucza możesz od razu dodać tłumaczenia na inne języki lub uzupełnić je później.

4. Obsługuj plurale i formatowanie: użyj odpowiednich zmiennych dla form liczby pojedynczej i mnogiej (krytyczne dla wielu języków), a dla dat, liczb i walut zastosuj formatowanie zależne od ustawień regionu użytkownika.

5. Jeśli migrujesz ze starszych plików .strings lub .stringsdict, Xcode może automatycznie skonwertować istniejące tłumaczenia do formatu .xcstrings — sprawdź opcje migracji w menu File.

6. Przygotuj App Shortcuts i App Intents do lokalizacji, upewniając się, że wszystkie ciągi znaków są zdefiniowane w katalogu. Debuguj brakujące tłumaczenia, sprawdzając logi Xcode i testując aplikację w różnych ustawieniach języka i regionu.