Android SDK (Em breve)
O Crowdin SDK permite entregar novas traduções do projeto Crowdin para o seu aplicativo imediatamente. Usando essa integração, não será necessário atualizar sempre o aplicativo via Google Play Store para obter a nova versão de localização.
A integração fornece:
- Entrega de conteúdo ao vivo - os arquivos localizados podem ser enviados para o aplicativo a partir do projeto sempre que necessário
- Visualização em tempo real - todas as traduções feitas pelo Editor podem ser exibidas no aplicativo em tempo real
- Capturas de tela - todas as capturas de tela feitas no aplicativo podem ser enviadas automaticamente para o seu projeto Crowdin com as strings de origem marcadas
Para mais detalhes sobre Crowdin Android SDK, iincluindo as etapas de instalação e configuração, consulte nosso repositório no GitHub.
Requisitos
Requisitos para integrar um aplicativo no Android a um projeto no Crowdin:
Ferramenta de desenvolvimento
- Android versão 16+
Linguagem de programação de aplicativos
- Java versão 8+
ou - Kotlin versão 1.3+
Distribuições e lançamentos
A distribuição é um cofre da CDN que espelha o conteúdo traduzido do seu projeto e é necessário para a integração com um aplicativo no android.
Configuração de distribuição
Siga estas etapas para configurar a distribuição:
-
Abra o projeto e vá para Configurações do projeto > Entrega de Conteúdo.
Além disso, você pode clicar no botão Obter credenciais para verificar os detalhes necessários para o aplicativo OAuth enquanto conecta o Crowdin SDK. 
-
Adicione nova distribuição usando o botão Adicionar distribuição. Escolha apenas os arquivos, traduções para os quais deseja mostrar no seu aplicativo e clique em Próximo.
-
Copie o hash de distribuição para que você possa usá-lo para integração.
-
Crie quantas distribuições você precisar e escolha arquivos diferentes para cada uma. Você precisará clicar no botão de Lançamento ao lado da distribuição necessária sempre que você desejar enviar novas traduções para o aplicativo.
Nota! Atualmente Idiomas personalizados, dialetos, e Mapeamento de idiomas não são suportados para integração do Android.
Instalação, configuração e recursos avançados do Crowdin SDK
Para mais detalhes sobre como configurar o Crowdin SDK para seu aplicativo, visite nosso repositório no GitHub.
Parâmetros
| Obrigatório para todos os recursos | |
| seu_hash_de_distribuição | Hash exclusivo que você pode obter acessando Configurações de projetos > Entrega de conteúdo. Para ver o hash da distribuição, clique no botão de três pontos na distribuição necessária, escolha Editar e copiar hash de distribuição |
| Necessário para recursos avançados | |
| source_language | Idioma de origem do seu projeto Crowdin (por exemplo, "pt-br") |
| client_id; client_secret | Credenciais de autorização Crowdin. Abra o projeto e vá para Configurações do projeto > Entrega de Conteúdo, escolha o recurso que você precisa e clique em Obter credenciais |
| Opcional | |
| network_type | Tipo de rede a ser usado. Você pode selecionar NetworkType.ALL, NetworkType.CELLULAR, ou NetworkType.WIFI |
| interval_in_milisec | Intervalos de atualização em milissegundos |
Padrões de exportação de arquivo
Você pode definir padrões de exportação de arquivos e verificar os existentes usando Configurações de arquivo. Os seguintes espaços reservados são suportados para integração do Android:
| Nome | Descrição |
|---|---|
| %language% | Nome do idioma (por exemplo, Ucraniano) |
| %two_letters_code% | Código do idioma ISO 639-1 (por exemplo uk) |
| %three_letters_code% | Código do idioma ISO 639-2/T (por exemplo ukr) |
| %locale% | Localidade (por exemplo uk-UA) |
| %locale_with_underscore% | Localidade (por exemplo uk-Ua) |
| %android_code% | Identificador de localidade do Android usado para nomear diretórios "values-" |
Segurança
O recurso CDN do SDK do Crowdin para Android foi criado com a segurança em mente, o que significa que é necessário o mínimo de acesso possível do usuário final. Ao decidir usar o SDK do Crowdin Android, verifique se você disponibilizou as seguintes informações para seus usuários finais.
- Usamos as vantagens do Amazon Web Services (AWS) para nossa infraestrutura de computação. A AWS possui certificação ISO 27001 e concluiu várias auditorias SSAE 16. Todas as traduções são armazenadas nos servidores da AWS.
- Quando você usa o CDN SDN do Crowdin Android- as traduções são carregadas no Amazon CloudFront para serem entregues no aplicativo e acelerar o download. Lembre-se de que seus usuários baixam traduções sem nenhuma autenticação adicional.
- Usamos a criptografia para manter seus dados privados enquanto em trânsito.
- Não armazenamos nenhuma informação de identificação pessoal (PII) sobre o usuário final, mas você pode optar por desenvolver a opção de exclusão dentro do aplicativo para garantir que seus usuários tenham controle total.
- Os recursos Capturas de tela automáticas e Visualização em tempo real devem ser usados pela equipe de desenvolvimento e pela equipe de tradutores. Esses recursos não devem ser compilados na versão de produção do seu aplicativo. Portanto, não deve afetar a privacidade dos usuários finais de forma alguma.