Catálogos de strings da Apple
Atualize os valores no idioma de destino em um catálogo XCStrings, preservando o idioma de origem e os demais idiomas.
Um catálogo .xcstrings reúne o conteúdo de origem e suas traduções. O manipulador de arquivos xcode-xcstrings preenche as entradas no idioma de destino dentro desse catálogo e mantém os demais idiomas no mesmo arquivo. O resultado é um catálogo atualizado no caminho de origem, e não um novo arquivo para cada idioma.
Valores de origem e variações #
Uma entrada com um valor de origem explícito em inglês tem este formato:
{
"sourceLanguage": "en",
"strings": {
"checkout.title": {
"localizations": {
"en": {
"stringUnit": {
"state": "translated",
"value": "Complete your order"
}
}
}
}
},
"version": "1.0"
}O stringUnit.value do idioma de origem fornece o texto. As variações de plural ou dispositivo compatíveis fornecem valores-folha separados, cada um com uma identidade específica da variação. Quando uma entrada não tem uma localização no idioma de origem, sua chave é usada como texto de origem. Essa alternativa é útil quando as chaves contêm o próprio texto de origem, mas uma chave técnica como checkout.title não substitui a mensagem desejada em inglês.
Uma entrada com shouldTranslate: false é ignorada. Os comentários do catálogo podem permanecer na estrutura compartilhada, mas as dicas do manipulador identificam o formato e a variação; isso não significa que cada comentário seja usado como orientação para a tradução.
A completude é verificada por idioma #
A completude é verificada no idioma solicitado. O manipulador seleciona os campos de origem compatíveis que foram alterados ou que não têm valor de destino. Assim, um novo idioma pode receber traduções mesmo que o catálogo compartilhado já exista.
As traduções já presentes no catálogo podem ser reutilizadas mesmo com --force da CLI. Limpar uma entrada de destino separada não remove os valores do catálogo de origem. Use o procedimento de correção abaixo quando uma mensagem inalterada precisar de uma nova redação.
A montagem parte do catálogo de origem atual, preserva os dados de idioma já existentes para suas entradas, quando aplicável, e grava as traduções solicitadas nas entradas e variações atuais. Revise todas as diferenças no arquivo compartilhado, incluindo as alterações na origem e os idiomas que não foram modificados. As novas unidades de destino usam o estado translated; a aceitação por uma pessoa continua dependendo de uma decisão de revisão separada.
A estrutura das variações de plural e dispositivo segue os valores-folha de origem compatíveis. Não presuma que todas as formas gramaticais de cada idioma de destino foram geradas ou verificadas. Examine o conjunto de variações e confira a exibição de casos representativos no aplicativo.
Configurar a saída no arquivo compartilhado #
A CLI infere xcode-xcstrings a partir de .xcstrings e grava a saída no caminho de origem. A configuração rejeita um targetPath separado para esse tipo. Siga o guia de início rápido de arquivos da CLI até a etapa de obtenção dos resultados ou use o GitHub para a tradução gerenciada do repositório.
Corrigir uma tradução existente #
Para fazer uma correção pontual na redação, edite o valor do idioma no Xcode e confira o resultado no aplicativo. Para gerar a tradução novamente após alterar as orientações do engine, primeiro conclua o trabalho de tradução pendente e preserve o catálogo inteiro. Mantenha a linha de base existente da CLI e inclua o idioma desejado em targetLocales.
Remova apenas a entrada de destino que deseja gerar novamente. No exemplo acima, para uma tradução em alemão, essa entrada é strings["checkout.title"].localizations.de; mantenha en, os demais idiomas e as entradas vizinhas. Salve o arquivo e execute um envio incremental comum:
lingo push --waitO catálogo alterado é enviado sem esse destino, indicando que a entrada selecionada precisa de tradução. Não edite o arquivo enquanto aguarda. Confira o novo valor em alemão e todas as diferenças do catálogo antes de aceitá-lo. No caso de uma entrada com variações de plural ou dispositivo, remover a entrada do idioma gera novamente todas as variações de origem compatíveis dessa entrada.
Use esse procedimento com a linha de base salva e um envio simples. Padrões posicionais, --backfill-missing e --key selecionam trabalhos diferentes; purge ignora o arquivo compartilhado.
Revisar todas as alterações no catálogo #
Preserve o catálogo registrado no controle de versão ou uma cópia local antes de substituí-lo ou fazer uma limpeza. O comando purge da CLI ignora esse formato porque a origem e a saída compartilham o mesmo caminho. Para gerar uma tradução novamente, remova a entrada do idioma desejado conforme descrito acima.
As verificações de catálogo da CLI não garantem a completude dos idiomas no XCStrings. Use o Xcode e verificações no aplicativo para conferir a inclusão dos recursos, o idioma de desenvolvimento, os múltiplos catálogos, os marcadores de posição e as variações exibidas. Consulte Localizar um aplicativo iOS para seguir esse workflow. Os formatos legados strings e stringsdict mantêm a lógica de arquivos separados por idioma.