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:

json
{
  "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:

sh
lingo push --wait

O 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.