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.
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 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 é aplicada quando o arquivo de versão é gerado. Isso não depende da opção na guia .
A opção 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:
-
Na caixa na página , clique em Configurar ou no número de configurações, caso já existam algumas.
A página abre e exibe as configurações existentes.
-
Clique em Nova distribuição. A janela abre.
-
Na aba Geral, informe um , o ao qual a distribuição está associada, os necessários e as 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.
-
-
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.
-
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 ().
-
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 .
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:
-
Na página Over the air, clique em Adicionar versão ao lado da distribuição desejada.
A janela é aberta.
-
Forneça uma , a obrigatória, a , os e as .
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.
-
Clique em Gravar.
A versão é adicionada à lista na parte inferior da página de detalhes da distribuição.
Para configurar agendamentos recorrentes para a publicação da distribuição, siga estas etapas:
-
Na página , clique no ícone de engrenagem
ao lado da distribuição desejada.
A janela é exibida.
-
Selecione a guia Agendar versão e clique em .
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.
-
No menu suspenso , escolha a frequência de criação das versões selecionando uma das opções disponíveis:
-
-
Selecione os dias da semana desejados para as versões agendadas.
-
-
Forneça um horário e o correspondente.
-
Se necessário, selecione , e para as versões agendadas.
-
O campo é exibido apenas se a ramificação estiver ativada no projeto. Selecionar uma ramificação atualiza a lista de localidades e idiomas.
-
-
Opcionalmente, especifique as versões do aplicativo nos campos e .
Deixe os campos em branco para aplicar o agendamento de versões a todas as versões do aplicativo.
-
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
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.
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 na página .
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.
A documentação técnica para a integração dos SDKs OTA está disponível no arquivo README de cada repositório de projeto: