iOS 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 az App Store-on 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 iOS 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 iOS alkalmazás Crowdin projekttel való integrálásának követelményei:
Fejlesztőeszközök
- Xcode 10.2+ verzió
Alkalmazás programozási nyelv
- Swift 4.2+ verzió
Operációs rendszer
- iOS 9.0+ 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 iOS alkalmazással való integrációhoz szükséges.
Az elosztás beállításához kövesse az alábbi lépéseket:
-
Nyissa meg a kívánt projektet, 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 iOS 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 |
| localizations | Célnyelvek a Crowdin projektjéhez (pl. 'fr', 'el'). Formátum: osx_locale |
| source_language | Forrásnyelv a Crowdin projektben (pl. "en"). Formátum: osx_locale |
| A Valós idejű előnézethez és a Képernyőképekhez szükséges | |
| 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 |
| your_organization_domain | Ez a mező nem kerül használatra a Crowdin projektben |
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 iOS integrációhoz:
| Név | Leírás |
|---|---|
| %language% | Nyelv neve (pl. Ukrán) |
| %locale% | Területi beállítások (pl. uk-UA) |
| %locale_with_underscore% | Területi beállítások (pl. uk_UA) |
| %osx_code% | OS X területi azonosító az ".lproj" könyvtárak elnevezésére használható |
| %osx_locale% | OS X területi kód a lefordított források elnevezésére használható (pl. uk, zh-Hans, zh_HK) |
Biztonság
A Crowdin iOS 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 iOS 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 iOS 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.