Android SDK (Em breve)
O Crowdin SDK permite entregar novas traduções do projeto Crowdin para o seu aplicativo imediatamente. Usando a integração com o Crowdin SDK, não haverá necessidade de atualizar o aplicativo no Google Play Store sempre que houver uma 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.
- Entrega de conteúdo ao vivo - os arquivos localizados podem ser enviados para o aplicativo a partir do projeto sempre que necessário. Veja as traduções já feitas e as que você está digitando no momento.
- 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
Configure a distribuição para espelhar o conteúdo traduzido do seu projeto e integrar com o aplicativo Android. Leia mais sobre Distribuições.
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 | Unique hash, which you can get by going to Settings > Content Delivery. To see the distribution hash, click  on the needed distribution, select Edit and copy distribution hash. |
| 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. Open the project and go to Settings > Content Delivery. In the For Mobile Applications section, click Get Credentials. |
| 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. A AWS possui certificação ISO 27001 e concluiu várias auditorias SSAE 16.
- 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.
Pergunta e resposta
Q: O que pode causar o atraso ocasional na obtenção das traduções mais recentes no aplicativo? A: O CDN armazena em cache todas as traduções na versão por até 15 minutos. Quando novas traduções são lançadas no Crowdin, a CDN ainda pode devolvê-las com atraso.