stringsdict da Apple
Traduza strings compatíveis em recursos de plural, preservando os campos de controle do plist e a estrutura de seleção de formato.
Os recursos de plural da Apple combinam o texto exibido ao leitor com instruções para selecionar a forma correta. O processador de arquivos xcode-stringsdict traduz os campos de string compatíveis no plist e preserva os valores de controle usados pelo formatador da Apple.
Campos de texto e chaves de controle #
Este trecho define uma mensagem que varia conforme a contagem:
<plist version="1.0">
<dict>
<key>items</key>
<dict>
<key>NSStringLocalizedFormatKey</key>
<string>%#@count@</string>
<key>count</key>
<dict>
<key>NSStringFormatSpecTypeKey</key>
<string>NSStringPluralRuleType</string>
<key>NSStringFormatValueTypeKey</key>
<string>d</string>
<key>one</key><string>%d item</string>
<key>other</key><string>%d items</string>
</dict>
</dict>
</dict>
</plist>NSStringFormatSpecTypeKey e NSStringFormatValueTypeKey contêm dados de controle e ficam fora da tradução. Outros valores <string> compatíveis, incluindo NSStringLocalizedFormatKey, tornam-se campos de texto. Mantenha os tokens do formatador, como %#@count@ e %d, inalterados ao revisar as traduções.
Os campos são associados pelos caminhos de suas chaves no plist, dentro de dicionários e arrays. Elementos <string/> vazios também são lidos como valores de string e podem ser expandidos para <string>...</string> quando uma substituição é gravada.
Reconstrução e plurais #
O conteúdo de origem atual fornece a estrutura do plist. Os valores de origem anteriores permitem identificar alterações, e os campos correspondentes já existentes no destino podem fornecer textos já aceitos. As substituições inserem texto codificado no conteúdo de origem, preservando o cabeçalho e a formatação ao redor dos trechos compatíveis.
O processador mantém a estrutura existente de seleção de plural. Ele não gera todas as categorias de plural do idioma de destino nem garante que o texto funcione para todas as quantidades. Teste o recurso de plural com o formatador da Apple que o utiliza, em vez de verificar apenas one e other isoladamente.
Configure e teste recursos de plural #
A CLI infere xcode-stringsdict a partir de .stringsdict; o modo com escopo por chave não está disponível. Selecione os arquivos pela configuração da CLI ou pelo GitHub.
Mantenha esses recursos de cada idioma nos diretórios .lproj do aplicativo, junto às tabelas de strings. Valide o plist e carregue-o no aplicativo com quantidades que selecionem formas diferentes. Os Catálogos de strings usam uma estrutura diferente, com vários idiomas em um único arquivo compartilhado.