Android SDK

Crowdin SDK, Crowdin projesinden uygulamanıza anında yeni çevirilerin iletilmesini sağlar. Bu bütünleştirmeyi kullanarak, yeni yerelleştirme sürümünü almak için her defasında Google Play Store aracılığıyla uygulamayı güncellemeye gerek olmayacaktı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.

Gereksinimler

Android uygulamasını Crowdin’deki projeyle bütünleştirmek için gereksinimler:

Geliştirme Araçları

  • Android SDK sürüm 16+

Uygulama Programlama Dili

  • Java sürüm 8+
    veya
  • Kotlin sürüm 1.3+

Dağıtımlar ve Yayımlar

Dağıtım, projenizin çevrilmiş içeriğini yansıtan ve Android uygulamasıyla bütünleştirmek için gerekli olan bir CDN kasasıdır.

Dağıtım Kurulumu

Dağıtımı yapılandırmak için şu adımları izleyin:

  1. Projenizi açın ve Proje Ayarları > İçerik Teslimi’ne gidin.

    Kablosuz İçerik Teslimi 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. Kablosuz İçerik Teslimi

  2. 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. Kablosuz İçerik Teslimi

  3. Bütünleştirme için kullanabileceğiniz dağıtım adreslemesini kopyalayın. Kablosuz İçerik Teslimi

  4. İ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.

    Kablosuz İçerik Teslimi

Not! Şu anda Android 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_hashProje 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
Gelişmiş özellikler için gerekli
source_languageCrowdin projenizdeki kaynak dil (örn. "en")
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
İsteğe Bağlı
network_typeKullanılacak ağ türü. NetworkType.ALL, NetworkType.CELLULAR veya NetworkType.WIFI’yi seçebilirsiniz
interval_in_milisecMilisaniye olarak aralıkları güncelleyin

Dosya Dışa Aktarma Şekilleri

Dosya dışa aktarma şekillerini ayarlayabilir ve Dosya Ayarları’nı kullanarak varolanları denetleyebilirsiniz. Aşağıdaki yer tutucular Android bütünleştirmesi için desteklenir:

Ad Açıklama
%language% Dil adı (örn. Ukraynaca)
%two_letters_code% Dil kodu ISO 639-1 (örn. uk)
%three_letters_code% Dil kodu ISO 639-2/T (örn. ukr)
%locale% Yerel ayar (örn. uk-UA)
%locale_with_underscore% Yerel ayar (örn. uk_UA)
%android_code% "values-" dizinlerini adlandırmak için kullanılan Android Locale tanımlayıcısı

Güvenlik

Crowdin Android 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 Android 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 Android 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.

Bu makale yararlı oldu mu?