Gerenciamento de tradução

Over-the-air (Strings)

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

As atualizações over-the-air (OTA) oferecem uma maneira flexível de entregar atualizações de tradução para aplicativos móveis e web sem exigir uma nova versão na App Store, no Google Play ou em outras plataformas de implantação. Essa abordagem oferece suporte à localização contínua e aos fluxos de trabalho de desenvolvimento ágil, reduzindo atrasos e processos manuais.

O recurso OTA no Phrase Strings integra-se às plataformas iOS, Android, React Native, Flutter, i18next e Rails. As atualizações para rótulos de texto são enviadas instantaneamente para aplicativos móveis.

Diagrama do dispositivo do usuário OTA

Uma nova versão deve ser criada para que as configurações atualizadas sejam aplicadas. Todo o conteúdo incluído em uma versão deve estar disponível no Phrase Strings, que transmite as traduções diretamente para o aplicativo. Se o conteúdo não estiver presente, as traduções não serão entregues.

Para aplicativos móveis, o OTA requer a integração do kit de desenvolvimento de software (SDK) correspondente ao aplicativo para recuperar traduções do Phrase Strings durante a execução.

Dica

Para obter detalhes sobre distribuição, versões e referência da API, consulte o Developer Hub.

Ao iniciar um aplicativo que implementa o SDK para iOS, Android, React Native ou Flutter pela primeira vez em um dispositivo, um identificador de dispositivo único e aleatório é gerado. Este identificador rastreia usuários ativos durante um determinado período de tempo. Ele não é usado para nenhuma outra forma ou meio de rastreamento e não contém nenhuma informação do usuário ou do dispositivo.

O número de solicitações OTA e a quantidade de usuários ativos mensais (MAU) estão sujeitos aos , conforme o plano de preços selecionado.

MAU é o número de dispositivos únicos dos quais as traduções são solicitadas. Cada dispositivo recebe um ID aleatório. O MAU é calculado com base no número de IDs únicos atribuídos nos últimos 30 dias. Cada interação com os servidores do Phrase é considerada uma solicitação.

Dados enviados com solicitações OTA

O SDK comunica-se com o serviço OTA para verificar atualizações e inclui os seguintes detalhes em cada solicitação:

  • Identificador do dispositivo (por exemplo, "F3AFCB10-80A2-84CB-94C0-27F5EF58876D"). Único para este aplicativo e, portanto, não permite rastrear um dispositivo específico.)

  • Versão do aplicativo (por exemplo, "1.2.0")

  • Última atualização do arquivo de tradução (por exemplo, "1542187679")

  • Versão do SDK (por exemplo, "1.0.0")

  • Localidade (por exemplo, "de-DE")

  • Formato de arquivo (por exemplo, "strings")

  • Cliente (por exemplo, "ios")

  • ID da distribuição () (ID da distribuição)

  • Segredo do ambiente (para distinguir o desenvolvimento da produção)

Domínios usados pelos SDKs:

Datacenter da UE

  • ota.eu.phrase.com

  • cdn.eu.phrase.com

  • ota.phraseapp.com

  • cdn.phraseapp.com

Datacenter dos EUA

  • ota.us.phrase.com

  • cdn.us.phrase.com

Os SDKs OTA da Phrase são projetados para garantir que os aplicativos permaneçam funcionais mesmo se a API OTA estiver indisponível. Nesses casos, o SDK recorre às últimas traduções obtidas com sucesso armazenadas no dispositivo ou às traduções incluídas no pacote do aplicativo. Isso evita erros ou strings ausentes para os usuários finais. Para garantir um fallback confiável, as traduções incluídas no aplicativo devem ser mantidas atualizadas a cada nova versão do aplicativo.

Distribuições OTA

Distribuições são configurações que definem como e onde as atualizações OTA são entregues para uma plataforma ou projeto específico.

As plataformas de destino são definidas dentro da distribuição:

  • iOS

  • Android

  • Flutter

  • i18next

  • Rails

Múltiplas distribuições são possíveis, mas, idealmente, há uma distribuição por projeto. Ao usar uma distribuição para iOS e Android, os espaços reservados para os dois formatos são convertidos automaticamente.

Permissões

O gerenciamento de distribuições e versões OTA é limitado pela atribuição de projeto. Os usuários os gerenciam apenas em projetos aos quais estão atribuídos.

As funções de Proprietário, Administrador, Gerente de Projeto, Desenvolvedor e Designer têm acesso total às distribuições e versões OTA por padrão. A função de Tradutor não tem acesso.

Proprietários e Administradores têm acesso a todos os projetos.

Os usuários precisam de permissão em nível de conta para gerenciar distribuições antes de criar uma. A nova distribuição é anexada apenas a projetos aos quais o usuário tem acesso.

Para um controle mais granular, clientes Enterprise podem entrar em contato com a equipe de suporte para tratar de uma função personalizada.

Fallbacks

Se os fallbacks de idioma estiverem definidos nas configurações de idioma do projeto ao qual a distribuição está conectada, as strings do idioma selecionado serão exibidas se o idioma solicitado existir, mas a chave não estiver traduzida.

Se um idioma específico de país (por exemplo, en-GB) for usado, mas não fizer parte da versão, o sistema pode recorrer a uma versão padrão (por exemplo, en) desse idioma, se ela existir no projeto. Se o idioma solicitado não for encontrado, a localidade padrão do projeto poderá ser fornecida.

Os fallbacks não funcionarão em chaves vinculadas.

A configuração de projeto Usar fallback para traduções não verificadas é aplicada quando o arquivo de versão é gerado. Isso não depende da opção Usar idioma de fallback na guia Idiomas de fallback.

A opção Usar idioma de fallback na distribuição é resolvida quando um dispositivo solicita uma versão. Cobre apenas chaves ausentes ou não traduzidas, não traduções não verificadas.

Criar uma distribuição

Para criar uma distribuição, siga estas etapas:

  1. Na caixa Over the air (OTA) na página Integrações, clique em Configurar ou no número de configurações, caso já existam algumas.

    A página Over the air abre e exibe as configurações existentes.

  2. Clique em Nova distribuição. A janela Adicionar distribuição abre.

  3. Na aba Geral, informe um Nome, o Projeto ao qual a distribuição está associada, os Idiomas necessários e as Plataformas necessárias.

    • Para distribuições Android, clique na aba Android para selecionar a opção de formato que envolve qualquer tradução, incluindo tags HTML, em CDATA, se necessário.

    • Após selecionar o projeto a ser associado à distribuição, a aba Agendamento torna-se disponível. Se necessário, use esta aba para configurar versões OTA agendadas () na distribuição.

  4. Na aba Idiomas de fallback, selecione as configurações de fallback específicas da distribuição conforme necessário. As opções de fallback são priorizadas conforme exibido na lista.

  5. Opcionalmente, clique na aba Traduções para selecionar a opção de usar a versão revisada mais recente das traduções. Habilite esta opção apenas ao trabalhar com o fluxo de trabalho de revisão avançado ().

  6. Clique em Gravar.

    Os detalhes da distribuição são exibidos com os IDs exigidos pelos SDKs. Os detalhes podem ser exibidos novamente clicando na distribuição na página Over the air.

Versões OTA

Para atualizar as traduções, crie uma nova versão na distribuição. O estado atual do projeto é exportado e disponibilizado para os clientes conectados.

Para criar uma versão, siga estas etapas:

  1. Na página Over the air, clique em Adicionar versão ao lado da distribuição desejada.

    A janela Nova versão é aberta.

  2. Forneça uma Descrição, a Plataforma obrigatória, a Ramificação, os Idiomas e as Versões do aplicativo.

    Os idiomas que ainda não foram adicionados à lista de idiomas da distribuição aparecem desmarcados e indisponíveis para seleção. Adicione os idiomas necessários à distribuição para que possam ser selecionados em versões futuras.

    Se nenhum idioma for selecionado manualmente ao criar uma versão, todos os idiomas configurados na distribuição serão incluídos na versão por padrão.

    Se necessário, insira tags para incluir apenas chaves com tags específicas na versão. Adicionar um filtro de tag a uma versão inclui apenas as chaves que possuem essa tag. As chaves sem a tag são totalmente excluídas da versão, e o aplicativo conectado recorre aos arquivos de tradução estáticos incluídos localmente em sua base de código para essas chaves. A filtragem por tag funciona independentemente de ramificação: se a ramificação estiver ativada, selecione a ramificação e as tags relevantes; se a ramificação não estiver ativada, selecione apenas as tags relevantes.

  3. Clique em Gravar.

    A versão é adicionada à lista na parte inferior da página de detalhes da distribuição.

Agendar versões OTA

Para configurar agendamentos recorrentes para a publicação da distribuição, siga estas etapas:

  1. Na página Over the air, clique no ícone de engrenagem Modificar ao lado da distribuição desejada.

    A janela Editar distribuição é exibida.

  2. Selecione a guia Agendar versão e clique em Ativar agendamento.

    As opções de agendamento de versão são exibidas.

    Nota

    As opções de agendamento também estão disponíveis durante a criação de uma nova distribuição.

  3. No menu suspenso Criar versões a cada, escolha a frequência de criação das versões selecionando uma das opções disponíveis:

    • Dia

    • Semana

      Selecione os dias da semana desejados para as versões agendadas.

  4. Forneça um horário e o Fuso horário correspondente.

  5. Se necessário, selecione Ramificação, Tags e Idiomas para as versões agendadas.

    • O campo Ramificação é exibido apenas se a ramificação estiver ativada no projeto. Selecionar uma ramificação atualiza a lista de localidades e idiomas.

  6. Opcionalmente, especifique as versões do aplicativo nos campos Versão mín. e Versão máx..

    Deixe os campos em branco para aplicar o agendamento de versões a todas as versões do aplicativo.

  7. Clique em Gravar.

    A distribuição é atualizada com as informações sobre o agendamento de versões.

Desativar o agendamento interrompe a publicação automática da distribuição, mas as configurações definidas são salvas.

Nota

Devido a melhorias constantes, a interface do usuário pode não ser exatamente a mesma que é apresentada no vídeo.

Nota

Não há opção na interface do Strings para pausar ou desativar temporariamente as atualizações OTA. Para impedir que um aplicativo busque traduções, remova o ID da distribuição da configuração OTA do aplicativo; restaure o ID para retomar as atualizações OTA. Como último recurso, exclua a distribuição e crie uma nova.

Relatórios do SDK móvel e da biblioteca Web para OTA

A integração do SDK móvel ou da biblioteca Web apropriada permite a atualização de traduções com um único clique, mas também fornece métricas para medir o uso. Os relatórios do SDK móvel e da biblioteca Web fornecem informações valiosas sobre os usuários ativos do aplicativo e os idiomas em que usam o aplicativo. Este conjunto de relatórios está disponível para cada distribuição, e os dados são atualizados duas vezes ao dia.

Os relatórios apresentam o número de usuários ativos, o total de solicitações, as solicitações por idioma e por plataforma e os idiomas dos dispositivos para os quais não há traduções disponíveis.

Os relatórios de cada distribuição são acessados através do ícone Abrir relatórios na página Over the air.

O número de usuários ativos mostrado nestes relatórios reflete uma janela móvel de 30 dias com base na data atual, não um período fixo de calendário ou de ciclo de faturamento.

Integração do SDK OTA

A documentação técnica para a integração dos SDKs OTA está disponível no arquivo README de cada repositório de projeto:

Esse artigo foi útil?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.