Cadeias de texto da Apple

Traduza os valores das tabelas de cadeias de texto da Apple, mantendo as chaves de pesquisa e aplicando sequências de escape ao texto reconstruído.

Uma tabela de cadeias de texto da Apple associa chaves de pesquisa fixas ao texto apresentado. O processador de ficheiros xcode-strings traduz os valores à direita, mantém as chaves e grava os literais de cadeia de texto com sequências de escape num ficheiro .strings por idioma.

Chaves e valores #

Por exemplo:

text
/* Checkout heading */
"checkout.title" = "Complete your order";
"delivery.estimate" = "Delivery within %d days";

Os dois valores à direita são unidades de texto. checkout.title e delivery.estimate continuam a ser chaves de pesquisa. Os comentários são preservados junto das entradas, mas este processador não transforma o seu conteúdo em indicações para quem traduz. Quando uma etiqueta curta for ambígua, utilize os mecanismos de contexto suportados pelo workflow de tradução.

As chaves e os valores entre aspas, os sinais de atribuição e os pontos e vírgulas fazem parte da sintaxe suportada para tabelas de cadeias de texto. O analisador descodifica as sequências de escape suportadas; na saída, aplica sequências de escape a aspas, barras invertidas, quebras de linha, tabulações e retornos de carro. A substituição dos valores preserva os comentários em redor e o espaçamento das entradas.

Fusão e localização dos recursos #

A versão anterior da origem permite identificar, por chave, os valores alterados, enquanto um destino existente fornece as traduções a preservar. A versão atual da origem define o conjunto de entradas e os comentários. Para mensagens alteradas, utilize as atualizações habituais da origem. Depois de alterar as orientações de tradução, pode optar por atualizar todo o ficheiro; consulte Âmbitos da CLI.

Coloque os recursos de cada idioma onde a aplicação os carrega, por exemplo, en.lproj/Localizable.strings e de.lproj/Localizable.strings. Para efeitos de derivação do caminho, uma origem em Base.lproj é interpretada de forma diferente de um diretório com o nome de um idioma. Verifique o destino através da ferramenta selecionada; a tradução da tabela não configura o idioma de desenvolvimento da aplicação nem a associação dos recursos.

Configurar e carregar a tabela de cadeias de texto #

A CLI infere xcode-strings a partir de .strings. Consulte Configuração da CLI para conhecer as regras de seleção e de caminhos, ou GitHub para a gravação gerida no repositório.

Carregue a tabela de destino na aplicação e teste os especificadores de formato com valores reais. Utilize stringsdict para recursos de seleção de plurais. Se o projeto utilizar Catálogos de cadeias de texto, siga antes as respetivas regras de fusão de ficheiros partilhados: mudar o nome de um catálogo por idioma criaria uma estrutura de recursos diferente.