iOS SDK

Crowdin SKD consente di consegnare le nuove traduzioni dal progetto di Crowdin alla tua applicazione immediatamente. Usando l’integrazione con Crowdin SKD non ci sarà necessità di aggiornare l’applicazione nell’App Store ogni volta che c’è una nuova versione di localizzazione.

L’integrazione fornisce:

  • Over-The-Air Content Delivery – the localized files can be sent to the application from the project whenever needed.
  • Real-Time Preview – all the translations that are done in the Editor can be shown in your version of the application in real-time. View the translations already made and the ones you’re currently typing in.
  • Screenshots – all screenshots made in the application may be automatically sent to your Crowdin project with tagged source strings.

Requisiti

Requirements to integrate an iOS application with a project in Crowdin:

Strumento di Sviluppo

  • Xcode version 10.2+

Linguaggio di Programmazione App

  • Swift version 4.2+

Operating System

  • iOS version 9.0+

Distribuzioni e Release

Distribution is a CDN vault that mirrors the translated content of your project and is required for integration with an iOS app.

Segui questi passaggi per configurare la distribuzione:

  1. Apri il progetto necessario e vai a Impostazioni Progetto > Consegna Contenuto. Over-the-Air Content Delivery Also, you can click Get Credentials button to check the details required for the OAuth application while connecting Crowdin SDK. Consegna Contenuto Over-the-Air

  2. Aggiungi nuova distribuzione usando il pulsante Aggiungi Distribuzione. Scegli solo i file, le traduzioni per cui vuoi che sia mostrato nella tua applicazione e clicca Successivo. Consegna Contenuto Over-the-Air

  3. Copia l’hash di distribuzione così che tu lo possa usare per l’integrazione. Consegna Contenuto Over-the-Air

  4. Crea tante distribuzioni quante te ne servono e scegli file differenti per ognuna. Avrai bisogno di cliccare il pulsante Release dopo la distribuzione necessaria ogni volta che vuoi inviare nuove traduzioni all’app. Consegna Contenuto Over-the-Air

Note! Currently Custom Languages, Dialects, and Language Mapping are not supported for IOS integration.

Installazione Crowdin SDK, Configurazione e Funzioni Avanzate

For more details on how to set up Crowdin SDK for your application visit our GitHub repository.

Parametri

Richiesto per tutte le funzioni
hash_tua_distribuzioneL'hash unico che puoi ottenere andando in Impostazioni Progetto > Consegna Contenuto. Per vedere l'hash di distribuzione, clicca il pulsante a tre puntini sulla distribuzione necessaria, scegli Modifica e copia l'hash di distribuzione
localizzazioni Le lingue di destinazione del tuo progetto Crowdin (es. 'fr', 'el'). Formato: osx_locale
source_languageLa lingua d'origine del tuo progetto di Crowdin (es. "it"). Formato: osx_locale
Richiesto per l'Anteprima in Tempo Reale e gli Screenshot
client_id;
client_secret
Credenziali di autorizzazione Crowdin. Apri il progetto e vai a Impostazioni Progetto > Consegna Contenuto, scegli la funzione che ti serve e clicca Ottieni Credenziali
your_organization_domainQuesto campo non è usato per il progetto Crowdin

Modelli di Esportazione File

Puoi impostare i modelli di esportazione del file e controllare quelli esistenti usando Impostazioni File. The following placeholders are supported for IOS integration:

Nome Descrizione
%language% Nome lingua (es. Ucraino)
%locale% Locale (es. uk-UA)
%locale_with_underscore% Locale (es. uk_UA)
%osx_code% L'identificatore locale OS X usato per rinominare le directory ".lproj"
%osx_locale% Il locale OS X usato per nominare le risorse di traduzione (es. uk, zh-Hans, zh_HK)

Sicurezza

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. AWS ha la certificazione ISO 27001 ed ha completato molti controlli SSAE 16. 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.

Questo articolo è stato utile?