Strings da Apple
Traduza os valores das tabelas de strings da Apple, preservando as chaves de busca e aplicando sequências de escape ao texto reconstruído.
Uma tabela de strings da Apple associa chaves de busca fixas ao texto exibido. O processador de arquivos xcode-strings traduz os valores à direita, mantém essas chaves e grava os literais de string com sequências de escape em um arquivo .strings por idioma.
Chaves e valores #
Por exemplo:
/* 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 sendo chaves de busca. Os comentários são preservados junto às entradas, mas o processador não transforma seu conteúdo em dicas para tradutores. Quando um rótulo curto for ambíguo, use os mecanismos de contexto aceitos pelo workflow de tradução.
A sintaxe de tabela de strings aceita chaves e valores entre aspas, sinais de atribuição e pontos e vírgulas. O analisador decodifica as sequências de escape compatíveis; na saída, são aplicadas 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 ao redor e o espaçamento das entradas.
Mesclagem e localização dos recursos #
A versão anterior da origem permite identificar, por chave, quais valores mudaram, enquanto um destino existente fornece as traduções a preservar. A origem atual define o conjunto de entradas e os comentários. Para mensagens alteradas, use as atualizações habituais da origem. Se mudar as orientações de tradução, opte por atualizar o arquivo inteiro; consulte Escopos da CLI.
Coloque os recursos de idioma nos locais de onde o aplicativo os carrega, como en.lproj/Localizable.strings e de.lproj/Localizable.strings. Para a derivação de caminhos, uma origem em Base.lproj é interpretada de forma diferente de uma origem em um diretório com nome de idioma. Verifique o destino na ferramenta selecionada; traduzir a tabela não configura o idioma de desenvolvimento do aplicativo nem a inclusão dos recursos no projeto.
Configure e carregue a tabela de strings #
A CLI infere xcode-strings a partir de .strings. Consulte Configuração da CLI para ver as regras de seleção e de caminhos, ou GitHub para saber sobre a saída gerenciada no repositório.
Carregue a tabela de destino no aplicativo e teste os especificadores de formato com valores reais. Use stringsdict para recursos de seleção de plural. Se o projeto usa Catálogos de strings, siga as regras de mesclagem de arquivos compartilhados desse formato: renomear um catálogo por idioma criaria uma estrutura de recursos diferente.