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.

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:

  1. Nyissa meg a projektjét, majd menjen a Projekt beállítások > Tartalom kézbesítés lehetőséghez.

    Over-the-Air tartalomküldés 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. Over-the-Air tartalomküldés

  2. 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. Over-the-Air tartalomküldés

  3. Másolja a vágólapra az Elosztás hash-t, hogy az integrációhoz használhassa. Over-the-Air tartalomküldés

  4. 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.

    Over-the-Air tartalomküldés

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_hashEgyedi 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_languageForrá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_typeA használt hálózat típusa. Választhat a NetworkType.ALL, NetworkType.CELLULAR, vagy NetworkType.WIFI közül
interval_in_milisecFrissí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.

Hasznos volt ez a cikk?