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 Szerkesztőben készült fordítás az alkalmazásban valós időben jeleníthető meg 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
For more details on Crowdin iOS SDK, including installation and setup steps, please view our GitHub repository.
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.
Also, you can click Get Credentials button to check the details required for the OAuth application while connecting Crowdin SDK. 
-
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.
Note! Currently Custom Languages, Dialects, and Language Mapping are not supported for IOS integration.
Crowdin SDK telepítés, beállítás, illetve speciális funkciók
For more details on how to set up Crowdin SDK for your application visit our GitHub repository.
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”}. The following placeholders are supported for IOS integration:
| 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
Crowdin iOS SDK CDN feature is built with security in mind, which means minimal access possible from the end-user is required. When you decide to use Crowdin iOS SDK, please make sure you’ve made the following information accessible to your end-users.
- We use the advantages of Amazon Web Services (AWS) for our computing infrastructure. Az AWS ISO 27001 tanúsítvánnyal rendelkezik, illetve már több SSAE 16 ellenőrzésen is átesett. All the translations are stored at AWS servers.
- When you use Crowdin iOS SDK CDN – translations are uploaded to Amazon CloudFront to be delivered to the app and speed up the download. Keep in mind that your users download translations without any additional authentication.
- We use encryption to keep your data private while in transit.
- We do not store any Personally Identifiable Information (PII) about the end-user, but you can decide to develop the opt-out option inside your application to make sure your users have full control.
- The Automatic Screenshots and Real-Time Preview features are supposed to be used by the development team and translators team. Those features should not be compiled to the production version of your app. Therefore, should not affect end-users privacy in any way.