Een Xcode String Catalog is één bestand met alle talen van je app. Wil je Duits, Japans en Portugees toevoegen, dan vul je dat ene bestand in en doet Xcode de rest.
Deze gids gaat over Localizable.xcstrings en het ene aspect dat dit anders maakt dan een gewone vertaalopdracht: meervoudsvormen. Bekijk voor de andere app-indelingen hoe je de taalbestanden van je app vertaalt.
Wat is een String Catalog?
String Catalogs verschenen met Xcode 15. In de WWDC23-sessie van Apple worden ze beschreven als een manier om al je tekenreeksen op één plek te beheren. Na elke build zoekt Xcode naar vertaalbare tekenreeksen en voegt die toe aan de catalogus. Met de plusknop voeg je een taal toe.
Onder de motorkap is het een JSON-bestand dat standaard Localizable.xcstrings heet. Elke sleutel bevat de vertalingen voor alle talen, plus de opmerking voor vertalers.
Welke optie moet je gebruiken?
| Geschikt voor | Waar het tekortschiet | |
|---|---|---|
| AI Glot | Meerdere talen in één opdracht, meervoudsvormen per taal en een glossary die consistent moet blijven | Niet nodig voor tien tekenreeksen |
| Lokalisaties exporteren in Xcode | Eén lokalisatiecatalogus per taal om naar een vertaler te sturen, waarna je de lokalisaties importeert | Xcode maakt de bestanden klaar, maar vertaalt ze niet. Je hebt dus nog steeds een vertaler of tool nodig |
| Een platform voor vertaalbeheer (Crowdin, Lokalise, Phrase) | Een team met reviewers en een koppeling met een repository | Je moet eerst een project instellen en je repository koppelen |
| DeepL | XLIFF-bestanden, die op de lijst staan | .xcstrings staat niet op die lijst |
| ChatGPT, Claude of een andere assistent | Een handvol tekenreeksen | Een catalogus is geneste JSON met varianten voor meervoudsvormen. Een lang bestand verwerken kost tijd, verbruikt je gebruikslimiet en kan leiden tot een kapotte sleutel of een ontbrekende meervoudsvorm |
| Een freelancer of bureau | Je App Store-pagina en onboarding | Duurt lang en wordt per woord berekend |
Betaal een professional voor de vijf tekenreeksen die je app verkopen. Laat de duizenden andere door een engine vertalen.
Waarom AI Glot goed past bij een String Catalog
- De vertalingen komen bij de juiste sleutel en taal terecht. De catalogus blijft één bestand.
- Meervoudsvormen worden per taal afgehandeld. Russisch heeft vier vormen en Arabisch zes. Elke vorm wordt met de juiste categorie opgeslagen.
- Opmaakaanduidingen blijven behouden.
%@,%den%1$@blijven in de vertaalde tekenreeks staan. - Opmerkingen voor vertalers blijven gekoppeld aan hun sleutels.
- Je kunt alleen de ontbrekende vertalingen aanvullen. Beoordeelde tekenreeksen blijven ongewijzigd.
- Eerst een plan, dan pas kosten.
Het traject van één bestand
- 1UploadenLocalizable.xcstrings zoals die isMaximaal 8 MB
- 2Geef aan wat je nodig hebtToe te voegen talenGratis
- 3Bekijk het planOntbrekende sleutels per taal, kostenGratis
- 4GoedkeurenDe enige stap die iets kostVerbruikt credits
- 5DownloadenDezelfde catalogus, ingevuldVervang het bestand
Waarom meervoudsvormen zo belangrijk zijn
Het Engels heeft twee meervoudsvormen. Andere talen hebben er meer, en een bericht met ‘3 foto’s’ heeft in elke taal de juiste vorm nodig.
- één
- overig
- één
- weinig
- veel
- overig
- nul
- één
- twee
- weinig
- veel
- overig
Een categorie die de brontaal niet heeft maar de doeltaal wel gebruikt, wordt toegevoegd. Zo krijgt een Russische catalogus de vormen few en many. Zonder die vormen geeft de app bij sommige aantallen de verkeerde vorm weer.
Wat je achteraf controleert
Substitutions and device variations. Die zijn nog niet vertaald en blijven ongewijzigd. In het plan zie je om hoeveel het er gaat.
Talenlijst. Open de catalogus in Xcode en controleer of elke nieuwe taal erin staat en de voortgang als voltooid wordt weergegeven.
Lengte. Start de app in een van de nieuwe talen en open de schermen met de langste teksten om te controleren of er tekst buiten een knop valt.
Zo doe je het, stap voor stap
1. Probeer gratis een bestand. De String Catalog-vertaler vereist geen account en accepteert bestanden tot 2 MB en 5,000 woorden.
2. Upload Localizable.xcstrings in de app. Je vindt het bestand in de projectmap, in de map Resources als je de standaardlocatie van Apple hebt gekozen.
3. Geef in één zin aan wat je nodig hebt.
Add German, Japanese and Portuguese.
Translate only the keys that have no translation in each language yet.De zin bepaalt wat er in de hele catalogus wordt vertaald. Een regel over de formulering, zoals ‘laat elke formaatspecificatie precies staan zoals die is geschreven’ of ‘gebruik de informele aanspreekvorm’, zet je bij het goedkeuren in het tweede vak. Die regel wordt namelijk toegepast op elke tekenreeks terwijl die wordt geschreven.
4. Voeg een woordenlijst toe met de appnaam, functienamen en woorden die je app altijd op dezelfde manier gebruikt. Zo stel je er een samen.
5. Bekijk het abonnement en kies een kwaliteitsniveau.
Lite levert ongeveer drie keer zoveel woorden per credit en is sneller. Ideaal voor een nieuwe taalversie die je nog controleert. Standard is bedoeld voor de teksten op je App Store-pagina. Eén credit staat bij Standard voor één woord.
6. Goedkeuren en downloaden, vervang daarna de catalogus in je project.
Eén catalogus, meerdere talen
De aantallen zijn voorbeelden. In tegenstelling tot de meeste bestandsindelingen bevat een String Catalog alle talen, zodat je één bestand terugkrijgt in plaats van één bestand per taal.
Drie manieren om het te gebruiken
Vanaf de opdrachtregel wordt dit bij elke release opnieuw uitgevoerd, wanneer Xcode nieuwe tekenreeksen aan de catalogus heeft toegevoegd:
id=$(aiglot batches create Localizable.xcstrings \
--instruction "Add German, Japanese and Portuguese. Translate only the keys with no translation yet." \
--json | jq -r '.data.id')
aiglot batches get "$id" --json | jq '.data.plan'
aiglot batches approve "$id" --quality lite \
--instructions "Keep every format specifier exactly as written."
aiglot batches download "$id" --output Localizable.xcstringsMet je AI-agent: koppel AI Glot als MCP-server. De agent kan je project uitlezen, termen voor de woordenlijst voorstellen, de taak uitvoeren en de catalogus terugzetten op de juiste plek.
In de app: uploaden, klikken, downloaden. Geschikt voor een eenmalige taak.
Bekijk voor een API-integratie de API-documentatie.
Op de pagina Prijzen zie je wat grotere volumes kosten. Een gratis account bevat credits waarmee je een echt bestand kunt vertalen.
De hier genoemde limieten zijn de limieten die golden toen dit werd geschreven: 8 MB per String Catalog en 2 MB en 5.000 woorden in de gratis tool. De beschrijving van String Catalogs en Export Localizations is afkomstig uit Apple’s WWDC23-sessie. De lijst van DeepL komt uit de eigen documentatie. Bestandsnamen en aantallen tekenreeksen in de diagrammen zijn voorbeelden. In je abonnementsoverzicht staan de werkelijke gegevens voor je eigen bestand. Je kunt dit gratis bekijken.