iOS SDK
Crowdin SDK, Crowdin projesinden uygulamanıza anında yeni çevirilerin iletilmesini sağlar. Crowdin SDK ile bütünleştirmeyi kullanarak, her yeni yerelleştirme sürümü olduğunda uygulamayı App Store’da güncellemeye gerek kalmayacaktır.
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 projenize etiketlenmiş kaynak dizgileriyle gönderilebilir.
Kurulum ve ayarlama adımları dahil Crowdin iOS SDK hakkında daha fazla ayrıntı için lütfen GitHub depomuza bakın.
Gereksinimler
Bir iOS uygulamasını Crowdin’deki bir projeyle bütünleştirmek için gereksinimler:
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
Dağıtım, projenizin çevrilmiş içeriğini yansıtan ve bir iOS uygulamasıyla bütünleştirmek için gerekli olan bir CDN kasasıdır.
Dağıtımı yapılandırmak için şu adımları izleyin:
-
Gerekli projeyi açın ve Proje Ayarları > İçerik Teslimi’ne gidin.
Ayrıca, Crowdin SDK’yı bağlarken OAuth uygulaması için gereken ayrıntıları denetlemek amacıyla Kimlik Bilgilerini Al düğmesine tıklayabilirsiniz. 
-
Ekle düğmesini kullanarak yeni dağıtım ekleyin. Sadece uygulamanızda gösterilmesini istediğiniz çevirileri, dosyaları seçin ve İleri’ye tıklayın.
-
Bütünleştirme için kullanabileceğiniz dağıtım adreslemesini kopyalayın.
-
İstediğiniz kadar dağıtım oluşturun ve her biri için farklı dosyalar seçin. Uygulamaya her defasında yeni çevirileri göndermek istediğinizde, gerekli dağıtımın yanındaki Yayımla düğmesine tıklamanız gerekecek.
Not! Şu anda iOS bütünleştirmesi için Özel Diller, Lehçeler ve Dil Eşleme desteklenmemektedir.
Crowdin SDK Kurulum, Ayarlama ve Gelişmiş Özellikler
Uygulamanız için Crowdin SDK’nın nasıl ayarlanacağı hakkında daha fazla ayrıntı için GitHub depomuzu ziyaret edin.
Parametreler
| Tüm özellikler için gerekli | |
| your_distribution_hash | Proje Ayarları > İçerik Teslimi’ne giderek alabileceğiniz benzersiz adresleme. Dağıtım adreslemesini görmek için gerekli dağıtımdaki üç noktalı düğmeye tıklayın, Düzenle’yi seçin ve dağıtım adreslemesini kopyalayın |
| localizations | Crowdin projenizin hedef dilleri (örn. "tr", "de"). Biçim: osx_locale |
| source_language | Crowdin projenizin kaynak dili (örn. "en"). Biçim: osx_locale |
| Gerçek Zamanlı Önizleme ve Ekran Görüntüleri için gerekli | |
| client_id; client_secret | Crowdin yetkilendirme kimlik bilgileri. Projeyi açın ve Proje Ayarları > İçerik Teslimi’ne gidin, ihtiyacınız olan özelliği seçin ve Kimlik Bilgilerini Al’a tıklayın |
| your_organization_domain | Bu alan Crowdin projesinde kullanılmıyor |
Dosya Dışa Aktarma Şekilleri
Dosya dışa aktarma şekillerini ayarlayabilir ve Dosya Ayarları’nı kullanarak varolanları denetleyebilirsiniz. Aşağıdaki yer tutucular iOS bütünleştirmesi için desteklenir:
| 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% | Çeviri kaynaklarını adlandırmak için kullanılan OS X yerel ayarı (yani 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. Bu özellikler, uygulamanızın üretim sürümünde derlenmemelidir. Bu nedenle, son kullanıcıların gizliliğini hiçbir şekilde etkilememelidir.