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:
{
"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:
lingo push --waitO 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.