Android SDK
A Crowdin SDK lehetővé teszi az új fordítások azonnali kiadását a Crowdin projektből az alkalmazásába. Ennek az integrációnak a használatával nem kell minden alkalommal frissítenie az alkalmazást a Google Play Áruházon keresztül, hogy az új honosított verziót kiadja.
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 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
Az Android alkalmazás Crowdin projekttel való integrálásának követelményei:
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
Az elosztás/terjesztés egy CDN-tároló (tartalomelosztó hálózat), amely tükrözi a projekt lefordított tartalmát, valamint az Android alkalmazással való integrációhoz szükséges.
Elosztás beállítása
Az elosztás beállításához kövesse az alábbi lépéseket:
-
Nyissa meg a projektjét, majd menjen a Projekt beállítások > Tartalom kézbesítés lehetőséghez.
A Crowdin SDK csatlakoztatása közben az OAuth alkalmazáshoz szükséges adatok ellenőrzéséhez nyomja meg a Hitelesítő adatok lekérése gombot. 
-
Adjon hozzá egy új elosztást az Elosztás hozzáadása gombbal. Csak azokat a fájlokat és fordításokat válassza ki, amelyeknek az alkalmazásában szeretne megjeleníteni, majd kattintson a Tovább gombra.
-
Másolja a vágólapra az Elosztás hash-t, hogy az integrációhoz használhassa.
-
Hozzon létre annyi elosztást, amennyire szüksége van, és válasszon különálló fájlt mindegyikhez. Minden alkalommal, amikor új fordításokat szeretne küldeni az alkalmazásba, rá kell kattintania a Kiadás gombra a kiválasztott elosztás mellett.
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 telepítés, beállítás, illetve speciális funkciók
A további részletekért, hogy hogyan kell beállítani Crowdin SDK-t az alkalmazásához keresse fel a GitHub adattárunkat.
Paraméterek
| Minden funkcióhoz szükséges | |
| your_distribution_hash | Egyedi hash, melyet a Projekt beállítások > Tartalom kézbesítés alatt szerezhet be. Az elosztási hash megtekintéséhez kattintson a három pont gombra a szükséges elosztáson, válassza a Szerkesztés lehetőséget, és másolja a vágólapra az elosztási hash-t |
| Speciális funkciókhoz szükséges | |
| source_language | Forrásnyelv a Crowdin projektben (pl. "en") |
| client_id; client_secret | Crowdin hitelesítő adatok. Nyissa meg a projektjét, majd menjen a Projekt beállítások > Tartalom kézbesítés lehetőséghez, válassza a kívánt funkciót, majd kattintson a Hitelesítő adatok lekérése gombra |
| 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
Az exportálási minták beállítását és a meglévők ellenőrzését a Fájl beállítások teheti meg{:target=”_blank”}. A következő helyőrzők támogatottak az Android integrációhoz:
| Név | Leírás |
|---|---|
| %language% | Nyelv neve (pl. Ukrán) |
| %two_letters_code% | Nyelv kódja ISO 639-1 (pl. uk) |
| %three_letters_code% | Nyelv kódja ISO 639-2/T (pl. ukr) |
| %locale% | Területi beállítások (pl. uk-UA) |
| %locale_with_underscore% | Területi beállítások (pl. 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. Ezeket a funkciókat nem szabad az alkalmazás kiadási verziójába beleépíteni. Ezért a végfelhasználók adatvédelmét ez semmilyen módon nem befolyásolhatja.