Android SDK (Em breve)

Crowdin SDK allows delivering new translations from the Crowdin Enterprise project to your application immediately. Using integration with Crowdin SDK there will be no need to update the application in the Google Play Store every time there is a new localization version.

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 Enterprise com as strings de origem marcadas.

Requisitos

Requirements to integrate Android application with a project in Crowdin Enterprise:

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 the distribution to mirror the translated content of your project and integrate with the Android app. Read more about Distributions.

Configuração

To configure Android SDK integration, follow these steps:

  1. Set up Distribution in Crowdin Enterprise.
  2. Set up SDK and enable Over-The-Air Content Delivery feature using Android Studio.

Configuração de distribuição

To configure distribution, follow these steps:

  1. Open your project and go to Applications > System.
  2. Find Android SDK and click Connect. Android Integration
  3. Define distribution. You can:
    • Add new distribution using the Create Distribution button. Select only the files translations for which you want to be shown in your application and click Create
      Create Distribution
      or
    • Select existing distribution (if any). Pay attention to the Last release time and, if needed, release distribution using the Over-The-Air Content Delivery tab. Existing Distribution
  4. Copie o hash de distribuição para que você possa usá-lo para integração.
Nota! Atualmente, Idiomas persnalizados, dialetos, e Mapeamento de idiomas não são suportados para integração do Android.

Crowdin SDK Setup

To integrate SDK with your application, you need to enable Over-The-Air Content Delivery so that the application can pull translations from the CDN vault. For this, follow step-by-step instructions located in our GitHub repository.

Advanced Features

Real-time Preview

This feature allows translators to see translations in the application in real-time. Managers and the QA team can also use it to preview translations before release.

Capturas de tela

Enable this feature if you want all the screenshots made in the application to be automatically sent to your Crowdin Enterprise project with tagged strings. This way, translators will have an additional context for the source strings.

Parâmetros

Obrigatório para todos os recursos
seu_hash_de_distribuiçãoUnique hash, which you can get by going to Integrations > 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_languageSource language of your Crowdin Enterprise project (e.g., "en").
client_id
client_secret
Credenciais de autorização Crowdin. Open the project and go to Applications > System > Android SDK. In the Advanced features section, click on the needed feature, and click Get Credentials.
Opcional
network_typeTipo de rede a ser usado. Você pode selecionar NetworkType.ALL, NetworkType.CELLULAR, ou NetworkType.WIFI
interval_in_milisecIntervalos de atualização em milissegundos

Padrões de exportação de arquivo

You can set file export patterns and check existing ones using File Settings. 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. Those features should not be compiled to the production version of your app. Therefore, they should not affect end-users privacy in any way.

Pergunta e resposta

Q: What might cause the occasional delay in getting the latest translations in the app?
A: CDN caches all the translations in release for up to 1 hour. When new translations are released in Crowdin Enterprise, CDN may still return them with a delay.

Este artigo foi útil?