Catálogos de cadeias de caracteres da Apple

Atualize os valores no idioma de destino num catálogo XCStrings, preservando o idioma de origem e os restantes idiomas.

Um catálogo .xcstrings reúne o texto de origem e as respetivas traduções. O processador de ficheiros xcode-xcstrings preenche as entradas no idioma de destino dentro desse catálogo, mantendo os restantes idiomas no mesmo ficheiro. O resultado é um catálogo atualizado no caminho de origem, não um novo ficheiro por idioma.

Valores de origem e variações #

Uma entrada com um valor de origem explícito em inglês tem este aspeto:

json
{
  "sourceLanguage": "en",
  "strings": {
    "checkout.title": {
      "localizations": {
        "en": {
          "stringUnit": {
            "state": "translated",
            "value": "Complete your order"
          }
        }
      }
    }
  },
  "version": "1.0"
}

O elemento stringUnit.value do idioma de origem fornece o texto. As variações de plural ou de dispositivo suportadas fornecem valores distintos nos nós folha, cada um com uma identidade específica da variação. Quando uma entrada não tem uma localização de origem, a respetiva chave é usada como texto de origem. Esta alternativa é útil quando as chaves contêm o texto de origem, mas uma chave técnica como checkout.title não substitui a mensagem pretendida em inglês.

Uma entrada com shouldTranslate: false é ignorada. Os comentários do catálogo podem permanecer na estrutura partilhada, mas as indicações do processador 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 tradução é verificada por idioma #

A verificação de que a tradução está completa é feita no idioma solicitado. O processador seleciona os campos de origem suportados que foram alterados ou que não têm um valor de destino. Assim, um novo idioma pode receber traduções mesmo que o catálogo partilhado já exista.

As traduções já presentes no catálogo podem ser reutilizadas mesmo com --force na CLI. Limpar uma entrada de destino separada não remove os valores que estão no catálogo de origem. Siga o procedimento de correção abaixo quando precisar de reformular uma mensagem que não foi alterada.

A montagem parte do catálogo de origem atual, preserva os dados de idioma existentes nas respetivas entradas, quando aplicável, e grava as traduções solicitadas nas entradas e variações atuais. Reveja todas as diferenças do ficheiro partilhado, incluindo as alterações ao conteúdo de 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 a depender de uma decisão de revisão separada.

A estrutura das variações de plural e de dispositivo segue os nós folha de origem suportados. Não presuma que foram geradas ou verificadas todas as formas gramaticais de cada idioma de destino. Examine o conjunto de variações e teste a apresentação de casos representativos na aplicação.

Configurar a saída num ficheiro partilhado #

A CLI infere xcode-xcstrings a partir de .xcstrings e grava a saída no caminho de origem. A configuração não permite um targetPath separado para este tipo. Siga o guia de início rápido para ficheiros com a CLI até à obtenção dos resultados ou use o GitHub para gerir a tradução do repositório.

Corrigir uma tradução existente #

Para fazer uma correção pontual à formulação, edite o valor desse idioma no Xcode e verifique-o na aplicação. Para voltar a gerar a tradução depois de alterar as orientações do motor, conclua primeiro o trabalho de tradução pendente e preserve o catálogo completo. Mantenha a referência de base existente da CLI e inclua o idioma pretendido em targetLocales.

Remova apenas a entrada de destino que pretende voltar a gerar. No exemplo acima, com o alemão como idioma de destino, essa entrada é strings["checkout.title"].localizations.de; mantenha en, os restantes idiomas e as entradas adjacentes. Guarde o ficheiro e execute um envio incremental normal:

sh
lingo push --wait

O catálogo alterado é submetido sem essa entrada de destino, pelo que a entrada selecionada precisa de tradução. Não edite o ficheiro enquanto aguarda. Examine o novo valor em alemão e todas as diferenças do catálogo antes de o aceitar. Numa entrada com variações de plural ou de dispositivo, remover a entrada do respetivo idioma faz com que todas as variações de origem suportadas sejam geradas novamente.

Use este procedimento com a referência de base guardada e um envio simples. Os padrões posicionais, --backfill-missing e --key selecionam trabalho diferente; purge ignora o ficheiro partilhado.

Rever todas as alterações ao catálogo #

Preserve a versão do catálogo guardada no repositório ou uma cópia local antes de o substituir ou limpar. O comando purge da CLI ignora este formato porque a origem e a saída partilham o mesmo caminho. Para voltar a gerar uma tradução, remova a entrada do idioma pretendido, conforme descrito acima.

As verificações de catálogo da CLI não garantem que as traduções de cada idioma estejam completas em XCStrings. Use o Xcode e faça verificações na aplicação para confirmar a inclusão dos recursos, o idioma de desenvolvimento, os vários catálogos, os marcadores de posição e as variações apresentadas. Consulte Localizar uma aplicação iOS para conhecer esse workflow. Os formatos antigos strings e stringsdict continuam a usar ficheiros separados por idioma.