Localizar uma aplicação iOS
Traduza catálogos de cadeias de texto da Apple ou recursos legados sem perder os idiomas partilhados e verifique o resultado no Xcode e na aplicação.
Uma aplicação iOS pode manter as mesmas chamadas de consulta de texto localizado e acrescentar um idioma aos seus ficheiros de recursos. O Lingo.dev traduz esses recursos; o Xcode e a aplicação continuam a determinar que pacote, tabela, idioma e variação são apresentados ao utilizador.
Utilize o formato que o projeto já carrega. Os catálogos de cadeias de texto guardam vários idiomas num único ficheiro .xcstrings, enquanto os recursos .strings e .stringsdict utilizam ficheiros separados por idioma. Esta diferença determina onde o resultado é escrito e o que precisa de ser protegido durante uma atualização.
Definir os recursos de referência #
Num projeto com catálogos de cadeias de texto, identifique o idioma de desenvolvimento, os idiomas de destino suportados e os catálogos carregados pela aplicação. O Xcode 15 introduziu .xcstrings, geralmente com o nome Localizable.xcstrings. As mensagens podem estar distribuídas por vários catálogos, por funcionalidade ou pacote; inclua todos os que fornecem texto ao ecrã que está a localizar.
Para recursos legados, identifique os diretórios .lproj, as tabelas de cadeias de texto e os dicionários de plurais relevantes. Base.lproj pode conter recursos base da interface; a sua presença, por si só, não indica ao tradutor que idioma de origem ou tabela de cadeias de texto deve utilizar. Mantenha a definição do idioma de desenvolvimento do projeto coerente com a configuração dos ficheiros.
Associe o texto do ecrã a chamadas de consulta de texto localizado antes de traduzir. A tradução de ficheiros não substitui cadeias de texto da interface fixas no código nem regista recursos num destino do Xcode. Mantenha os comentários que indicam aos revisores quem fala e em que ecrã. O processador de catálogos de cadeias de texto existente preserva esses comentários, mas não os inclui nas indicações das unidades de tradução. Por isso, coloque o contexto necessário à geração nas orientações suportadas pelo motor de localização.
Configurar um catálogo de cadeias de texto partilhado #
Instale e associe a versão atual da CLI a partir da raiz do projeto:
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr --files 'App/Localizable.xcstrings' --yes
lingo linkPara um catálogo nesse caminho, o .lingo/config.json resultante deve ter esta estrutura:
{
"orgId": "org_...",
"engineId": "eng_...",
"sourceLocale": "en",
"targetLocales": ["es", "fr"],
"files": [{ "pattern": "App/Localizable.xcstrings" }]
}Mantenha os identificadores gerados pela associação, em vez de copiar os marcadores de posição. A extensão seleciona xcode-xcstrings. Cada destino escreve no mesmo caminho do catálogo, acrescentando entradas de idioma e preservando a origem e os restantes idiomas. Um targetPath separado não é válido para este formato de ficheiro partilhado.
O valor de origem encontra-se na estrutura partilhada:
{
"sourceLanguage": "en",
"strings": {
"Welcome": {
"comment": "Greeting on the signed-in home screen",
"localizations": {
"en": { "stringUnit": { "state": "translated", "value": "Welcome" } }
}
}
},
"version": "1.0"
}Após a tradução, procure as entradas dos idiomas pedidos junto de en. O processador também suporta nós terminais de plurais e de variações por dispositivo na origem e ignora as entradas marcadas com shouldTranslate: false. Se uma entrada não tiver uma localização de origem, a respetiva chave passa a ser o texto de origem; uma chave técnica não substitui a mensagem pretendida. Catálogos de cadeias de texto da Apple explica estas regras de seleção e por que motivo a origem atual e o catálogo existente têm de se manter alinhados.
Manter os ficheiros legados num caminho próprio #
Num projeto legado, utilize estas entradas de ficheiros em vez da entrada do catálogo partilhado:
[{ "pattern": "App/en.lproj/Localizable.strings" }, { "pattern": "App/en.lproj/Localizable.stringsdict" }]Inclua apenas os recursos que o projeto realmente contém. As extensões selecionam os respetivos processadores; o resultado em espanhol deve ficar em App/es.lproj/. Mantenha a definição do idioma de desenvolvimento do projeto coerente com esta seleção da origem.
As chaves das cadeias de texto e os marcadores de formatação fazem parte do contrato de execução. Preserve %@, os argumentos posicionais e os tipos esperados pelo código que faz a chamada. Um .stringsdict contém uma estrutura de variáveis de plural que tem de se manter coerente com a respetiva cadeia de formatação. Consulte Cadeias de texto da Apple e dicionários de cadeias de texto para conhecer os contratos específicos de cada formato, em vez de os tratar como simples XML ou texto.
Traduzir e inspecionar o resultado da fusão #
Antes de substituir o catálogo atual, guarde-o no controlo de versões ou numa cópia separada. Para proteger as alterações locais, submeta sem --wait e inspecione lingo pull --dry-run antes de obter o resultado. Resolva quaisquer divergências em vez de forçar a substituição. A gravação de resultados após a espera não faz a nova verificação de conflitos efetuada pela operação pull; consulte Preservar traduções revistas.
Para uma primeira tradução sem conflitos, utilize o comando seguinte apenas se o catálogo permanecer inalterado durante a espera. Antes de adicionar idiomas a um projeto existente, conclua as atualizações normais da origem para os idiomas existentes, obtenha e inspecione os resultados e mantenha essa revisão da origem fixa enquanto adiciona e preenche os novos idiomas. Adicionar um idioma explica a ordem a seguir:
lingo push --backfill-missing --waitNos catálogos partilhados, o planeamento é feito por idioma, mesmo que o ficheiro já exista. Inspecione as entradas dos idiomas pedidos em vez de procurar um novo nome de ficheiro. Um primeiro envio simples pode estabelecer a versão de referência da origem sem traduzir. Após alterações normais à origem, utilize lingo push --wait; se não aguardar, obtenha o resultado registado com lingo pull no checkout a partir do qual efetuou a submissão.
Para corrigir uma formulação, edite a entrada de destino no Xcode. O comando --force da CLI pode continuar a reutilizar traduções incorporadas num catálogo inalterado. Para voltar a gerar uma entrada após alterar as orientações, utilize o procedimento de correção do catálogo, que preserva a origem e as traduções adjacentes.
lingo purge ignora os catálogos de cadeias de texto porque a origem e os destinos partilham o mesmo caminho. Para voltar a gerar uma tradução selecionada, utilize o workflow de correção de catálogos de cadeias de texto.
Verificar no Xcode e em ecrãs representativos #
Abra o resultado no Xcode e verifique se o catálogo ou ficheiro legado está incluído no destino e no pacote pretendidos. Compile com o esquema existente do projeto. Execute uma configuração no idioma de destino e inspecione um ecrã que contenha um rótulo simples, um valor formatado e uma variação de plural ou por dispositivo.
Compare os marcadores de posição do idioma de destino com o código que faz as chamadas. Teste contagens que selecionem diferentes formas de plural em cada idioma; as categorias do inglês não constituem uma especificação completa para todos os idiomas de destino. Verifique se os idiomas não alterados continuam presentes no catálogo resultante da fusão. Reveja os rótulos longos, o texto de acessibilidade, a truncagem e o comportamento da direita para a esquerda, quando aplicável.
As verificações de compilação do Xcode podem detetar problemas nos recursos, enquanto a verificação do significado cabe a um revisor linguístico ou a uma medição aplicável. lingo check não comprova que .xcstrings esteja completo nem que os plurais da Apple funcionem corretamente.
Garantir que a automatização preserva o ficheiro partilhado #
Mantenha as origens, as traduções de destino aceites, a configuração e .lingo/lock.json em conjunto e escolha a GitHub App ou um executor de CI para tarefas recorrentes. O executor gere a sua própria autenticação, o estado e a gravação de resultados que podem ser revistos. Reveja as diferenças de um catálogo de cadeias de texto como uma alteração a um ficheiro partilhado: identifique a revisão da origem, os idiomas alterados e os idiomas preservados antes de aceitar a alteração.
Para projetos multiplataforma, utilize os workflows separados de Android e Flutter para os qualificadores XML e a geração de ARB. Cada plataforma continua a precisar das suas próprias verificações de carregamento de recursos e de apresentação dos ecrãs.