iOS SDK

Crowdin SDK allows delivering new translations from the Crowdin Enterprise project to your application immediately. Using integration with Crowdin SDK, there will be no need to update the application in the App Store every time there is a new localization version.

Bütünleştirme şunları sağlar:

  • Kablosuz İçerik Teslimi – yerelleştirilmiş dosyalar gerektiğinde projeden uygulamaya gönderilebilir.
  • Gerçek Zamanlı Önizleme – Düzenleyicide yapılan tüm çeviriler, uygulama sürümünüzde gerçek zamanlı olarak gösterilebilir. Zaten yapılmış çevirileri ve şu anda yazmakta olduklarınızı görüntüleyin.
  • Ekran Görüntüleri – uygulamada alınan tüm ekran görüntüleri otomatik olarak Crowdin Enterprise projenize etiketlenmiş kaynak dizgileriyle gönderilebilir.

Gereksinimler

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

Geliştirme Araçları

  • Xcode sürüm 10.2+

Uygulama Programlama Dili

  • Swift sürüm 4.2+

İşletim Sistemi

  • iOS sürüm 9.0+

Dağıtımlar ve Yayımlar

Configure the distribution to mirror the translated content of your project and integrate with the iOS app. Read more about Distributions.

Yapılandırma

To configure iOS SDK integration, follow these steps:

  1. Set up Distribution in Crowdin Enterprise.
  2. Set up SDK and enable Over-The-Air Content Delivery feature using Xcode.

Dağıtım Kurulumu

To configure distribution, follow these steps:

  1. Open your project and go to Applications > System.
  2. Find iOS SDK and click Connect. iOS Integration
  3. Define distribution. You can:
    • Add new distribution using the Create Distribution button. Select only the files translations for which you want to be shown in your application and click Create
      Create Distribution
      or
    • Select existing distribution (if any). Pay attention to the Last release time and, if needed, release distribution using the Over-The-Air Content Delivery tab. Existing Distribution
  4. Bütünleştirme için kullanabileceğiniz dağıtım adreslemesini kopyalayın.
Note! Currently, Custom Languages, Dialects, and Language Mapping are not supported for iOS integration.

Crowdin SDK Setup

To integrate SDK with your application, you need to enable Over-The-Air Content Delivery so that the application can pull translations from the CDN vault. For this, follow step-by-step instructions located in our GitHub repository.

Advanced Features

Real-time Preview

This feature allows translators to see translations in the application in real-time. Managers and the QA team can also use it to preview translations before release.

Ekran Görüntüleri

Enable this feature if you want all the screenshots made in the application to be automatically sent to your Crowdin Enterprise project with tagged strings. This way, translators will have an additional context for the source strings.

Parametreler

Tüm özellikler için gerekli
your_distribution_hashUnique hash, which you can get by going to Integrations > Content Delivery. To see the distribution hash, click on the needed distribution, select Edit and copy distribution hash.
localizations Target languages of your Crowdin Enterprise project (e.g., ‘fr’, ‘el’). Biçim: osx_locale.
source_languageSource language of your Crowdin Enterprise project (e.g., "en"). Biçim: osx_locale.
Gelişmiş özellikler için gerekli
client_id
client_secret
Crowdin Enterprise yetkilendirme kimlik bilgileri. Open the project and go to Applications > System > iOS SDK. In the Advanced features section, click on the needed feature, and click Get Credentials.
your_organization_domainDomain name of your Organization in Crowdin Enterprise.

Dosya Dışa Aktarma Şekilleri

You can set file export patterns and check existing ones using File Settings. The following placeholders are supported for iOS integration:

Ad Açıklama
%language% Dil adı (örn. Ukraynaca)
%locale% Yerel ayar (örn. uk-UA)
%locale_with_underscore% Yerel ayar (örn. uk_UA)
%osx_code% ".lproj" dizinlerini adlandırmak için kullanılan OS X yerel ayar tanımlayıcısı
%osx_locale% OS X locale used to name translation resources (e.g., uk, zh-Hans, zh_HK)

Güvenlik

Crowdin iOS SDK CDN özelliği güvenlik göz önünde bulundurularak oluşturulmuştur, bu da son kullanıcıdan mümkün olan en az erişimin gerektiği anlamına gelir. Crowdin iOS SDK’yı kullanmaya karar verdiğinizde, lütfen aşağıdaki bilgileri son kullanıcılarınıza ulaşabilir hale getirdiğinizden emin olun.

  • Bilişim altyapımız için Amazon Web Hizmetleri’nin (AWS) avantajlarını kullanıyoruz. AWS, ISO 27001 sertifikasına sahiptir ve birden fazla SSAE 16 denetimlerini tamamlamıştır. Tüm çeviriler AWS sunucularında saklanır.
  • Crowdin iOS SDK CDN kullandığınızda – çevirileri uygulamaya iletilmek ve indirme işlemini hızlandırmak için Amazon CloudFront’a yüklenir. Kullanıcılarınızın hiçbir ek kimlik doğrulama yapmadan çevirileri indirdiğini unutmayın.
  • Aktarım sırasında verilerinizi gizli tutmak için şifreleme kullanıyoruz.
  • Son kullanıcı hakkında Kişisel Olarak Teşhis Edilebilir Bilgileri (PII) saklamayız, ancak kullanıcılarınızın tam denetim sahibi olduğundan emin olmak için uygulamanızın içinde devre dışı bırakma seçeneğini geliştirmeye karar verebilirsiniz.
  • Otomatik Ekran Görüntüleri ve Gerçek Zamanlı Önizleme özelliklerinin, geliştirme ekibi ve çevirmen ekibi tarafından kullanılması beklenir. Those features should not be compiled to the production version of your app. Therefore, they should not affect end-users privacy in any way.

Soru ve Yanıt

Q: What might cause the occasional delay in getting the latest translations in the app?
A: CDN caches all the translations in release for up to 15 minutes. Crowdin Enterprise’da yeni çeviriler yayımlandığında, CDN yine de bunları gecikmeli olarak geri döndürebilir.

Bu makale yararlı oldu mu?