Android SDK
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.
Az integráció a következőket biztosítja:
- Over-The-Air tartalomküldés – a lefordított fájlok a projektből bármikor átküldhetők az alkalmazásba.
- Valós idejű előnézet – az összes, a Szerkesztőben elvégzett fordítás valós időben megjeleníthető az alkalmazás verziójában. Tekintse meg a már elkészült és a jelenleg beírt fordításokat.
- Képernyőképek – az alkalmazásban készített összes képernyőkép automatikusan elküldhető a Crowdin Enterprise projektbe megjelölt forrás-karakterláncokkal.
A Crowdin Android SDK-hoz kapcsolódó további részletek érdekében, beleértve a telepítési, beállítási lépéseket, kérjük, tekintse meg a GitHub adattárunkat.
Követelmények
Requirements to integrate Android application with a project in Crowdin Enterprise:
Fejlesztőeszközök
- Android SDK 16+ verzió
Alkalmazás programozási nyelv
- Java 8+ verzió
vagy - Kotlin 1.3+ verzió
Elosztások és kiadások
Configure the distribution to mirror the translated content of your project and integrate with the Android app. Read more about Distributions.
Konfiguráció
To configure Android SDK integration, follow these steps:
- Set up Distribution in Crowdin Enterprise.
- Set up SDK and enable Over-The-Air Content Delivery feature using Android Studio.
Elosztás beállítása
To configure distribution, follow these steps:
- Open your project and go to Applications > System.
- Find Android SDK and click Connect.
- 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
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.
- 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
- Copy the distribution hash so you can use it for integration.
Figyelmeztetés! Jelenleg az Egyéni nyelvek, Dialektusok, és a Nyelv hozzárendelése nem támogatott az Android integrációnál.
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.
Képernyőképek
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.
Paraméterek
| Minden funkcióhoz szükséges | |
| your_distribution_hash | Unique 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. |
| Speciális funkciókhoz szükséges | |
| source_language | Source language of your Crowdin Enterprise project (e.g., "en"). |
| client_id client_secret | Crowdin Enterprise hitelesítő adatok. Open the project and go to Applications > System > Android SDK. In the Advanced features section, click on the needed feature, and click Get Credentials. |
| Opcionális | |
| network_type | A használt hálózat típusa. Választhat a NetworkType.ALL, NetworkType.CELLULAR, vagy NetworkType.WIFI közül |
| interval_in_milisec | Frissítési időköz ezredmásodpercben |
Fájl exportálási minták
You can set file export patterns and check existing ones using File Settings. A következő helyőrzők támogatottak az Android integrációhoz:
| Név | Leírás |
|---|---|
| %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 területi azonosító, a "values-" könyvtárak elnevezésére használható |
Biztonság
A Crowdin Android SDK CDN szolgáltatás a biztonság szem előtt tartásával épült, ami azt jelenti, hogy minimális hozzáférésre van szükség a végfelhasználótól. Ha úgy dönt, hogy a Crowdin Android SDK-t használja, kérjük, ellenőrizze, hogy elérhetővé tette-e a következő információkat a végfelhasználói számára.
- Az Amazon Web Services-t (AWS) előnyeit használjuk a számítástechnikai infrastruktúránkhoz. Az AWS ISO 27001 tanúsítvánnyal rendelkezik, illetve már több SSAE 16 ellenőrzésen is átesett. A fordítások az AWS szervereken kerülnek tárolásra.
- A Crowdin Android SDK CDN használatakor – a fordítások az Amazon CloudFront alkalmazásba kerülnek feltöltésre, hogy az alkalmazáshoz kiadható legyen, és felgyorsítsuk a letöltést. Ne feledje, hogy a felhasználók további hitelesítés nélkül töltik le a fordításokat.
- Titkosítást használunk a kiadás során az adatok bizalmas kezelése érdekében.
- A végfelhasználóval kapcsolatban nem tárolunk semmilyen személyesen azonosítható információt (PII), de dönthet úgy, hogy az alkalmazáson belül kidolgozza az opt-out (kilépési) opciót, hogy a felhasználók megkaphassák a teljes ellenőrzést.
- Az Automatikus képernyőképek és a Valós idejű előnézeti funkciókat a fejlesztői csapat és a fordítói csapat fogja használni. 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 1 hour. When new translations are released in Crowdin Enterprise, CDN may still return them with a delay.