Android SDK (kommer snart)

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.

Integrationen leverer:

  • Over-The-Air Indholdslevering – de oversatte filer kan sendes til appen fra projektet, når det er nødvendigt.
  • Realtidsforhåndsvisning – alle oversættelser, foretaget via Redigeringsværktøjet, kan vises i din version af appen i realtid. Se de oversættelser, som allerede er foretaget, og dem, du i øjeblikket skrive på.
  • Skærmfotos – alle skærmfotos fra appen kan automatisk sendes til dit projekt med taggede kildestrenge.

Krav

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

Udviklerværktøj

  • Android SDK, version 16+

App-programmeringssprog

  • Java version 8+
    eller
  • Kotlin version 1.3+

Distributioner og Udgivelser

Configure the distribution to mirror the translated content of your project and integrate with the Android app. Read more about Distributions.

Opsætning

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.

Distributionsopsætning

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. Copy the distribution hash so you can use it for integration.
Note! Currently, Custom Languages, Dialects, and Language Mapping are not supported for Android integration.

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.

Skærmfotos

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.

Parametre

Krævet til funktioner
din_distributions-hashUnique 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.
Krævet til avancerede funktioner
source_languageSource language of your Crowdin Enterprise project (e.g., "en").
client_id
client_secret
Crowdin-godkendelsesakkreditiver. Open the project and go to Applications > System > Android SDK. In the Advanced features section, click on the needed feature, and click Get Credentials.
Valgfri
network_typeNetværkstypen, der skal benyttes. Du kan vælge NetworkType.ALL, NetworkType.CELLULAR eller NetworkType.WIFI
interval_in_milisecOpdateringsintervaller i millisekunder

Fileksportmønstre

You can set file export patterns and check existing ones using File Settings. Flg. variabler understøttes af Android-integration:

Navn Beskrivelse
%language% Language name (e.g., Ukrainian)
%two_letters_code% Language code ISO 639-1 (e.g., uk)
%three_letters_code% Language code ISO 639-2/T (e.g., ukr)
%locale% Locale (e.g., uk-UA)
%locale_with_underscore% Locale (e.g., uk_UA)
%android_code% Android Landestandard-ID benyttes ved navngivning af "værdier"-mapper

Sikkerhed

Crowdin Android SDK CDN feature is built with security in mind, which means minimal access possible from the end-user is required. Når du beslutter dig for at benytte Crowdins Android-SDK, så sørg for, at du har gjort flg. oplysninger tilgængelige for dine slutbrugere.

  • Platformens IT-infrastruktur gør brug af fordelene ved Amazon Web Services (AWS). AWS er ISO 27001-certificeret og har gennemført adskillige SSAE 16-revisioner. Alle oversættelser lagres på AWS-servere.
  • Når du bruger Crowdins Android-SDK CDN, så uploades oversættelser til Amazon CloudFront for levering til din app samt accelereret download. Vær opmærksom på, at dine brugere downloader oversættelser uden ekstra godkendelse.
  • Der benyttes kryptering til at holde dine data fortrolige under transit.
  • Vi lagrer ingen Personligt Identificerbare Information (PII) om slutbrugere, men du kan vælge at udvikle en fravalgsmulighed i din app for at sikre, at dine brugere har den fulde kontrol.
  • Funktionerne Automatisk Skærmfoto og Realtidsforhåndsvisning er tiltænkt brugt af udviklings- og oversætterelsesteamene. Those features should not be compiled to the production version of your app. Therefore, they should not affect end-users privacy in any way.

Q&A

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 15 minutes. When new translations are released in Crowdin Enterprise, CDN may still return them with a delay.

Var denne artikel nyttig?