Flutter SDK'da yerelleştirmeleri ve yerel ayar kodlarını kullanma

Bu neden önemli

Adapty bir flow için yerelleştirme seçerken ve özel paywall için remote config okurken locale kodları devreye girer.

Locale kodları karmaşık bir yapıya sahiptir ve platformdan platforma farklılık gösterebilir; bu nedenle Adapty desteklediği her platformda tek bir iç standarda dayanır. Bu standardı anlamak, bir kullanıcının hangi yerelleştirmeyi alacağını önceden tahmin etmenizi sağlar.

Adapty’de dil kodu standardı

Dil kodları için Adapty, BCP 47 standardının hafifçe değiştirilmiş bir versiyonunu kullanır: her kod, tire ile ayrılmış küçük harf alt etiketlerinden oluşur. Bazı örnekler: en (İngilizce), pt-br (Portekizce (Brezilya)), zh (Basitleştirilmiş Çince), zh-hant (Geleneksel Çince).

Yerel ayar kodu eşleştirme

Adapty, kullanıcının yerel ayarıyla eşleşen lokalizasyonu ararken şu adımları izler:

Yerel ayar dizesi küçük harfe dönüştürülür ve tüm alt çizgiler (_) kısa çizgiyle (-) değiştirilir
Adapty, tam olarak eşleşen yerel ayar koduyla lokalizasyonu arar
Eşleşme bulunamazsa, Adapty ilk kısa çizgiden önceki alt dizeyi alır (pt-br için pt) ve eşleşen lokalizasyonu arar
Yine eşleşme bulunamazsa, Adapty varsayılan en lokalizasyonunu döndürür

Bu şekilde 'pt_BR', pt-BR ve pt-br hepsi aynı lokalizasyona karşılık gelir.

Yerelleştirmeleri Uygulamak

SDK v4’te bir flow çekerken locale kodu iletmezsiniz.

Flow Builder ve Paywall Builder paywalls’ları: Adapty, yerelleştirmeyi cihazdan ve builder’da yapılandırdığınız yerelleştirmelerden otomatik olarak çözer. Flow’u createFlowView ile render edin — locale koduna gerek yok.
Özel (remote config) paywalls’lar: getFlow, yapılandırılmış tüm yerelleştirmeleri flow.remoteConfigs içinde döndürür. Her girdinin bir locale kodu ve config içeriği (data dizesi veya ayrıştırılmış dictionary) bulunur. Kullanıcıya uyan girdiyi kendi yedek mantığınızla seçin:


final flow = await Adapty().getFlow(placementId: 'YOUR_PLACEMENT_ID');
final config = flow.remoteConfigs.firstWhereOrNull((c) => c.locale == 'en') ??
    flow.remoteConfig; // the first remote config, if present
// read your values from config?.dictionary

Yukarıdaki yerel ayar kodu eşleştirme kuralları, Adapty’nin her remote config üzerinde depolanan locale kodlarını nasıl normalleştirdiğini açıklar.

Bu neden önemli

Locale kodlarının devreye girdiği birkaç senaryo vardır; örneğin uygulamanızın mevcut yerelleştirmesi için doğru paywall’ı çekmeye çalışırken.

Locale kodları karmaşık olup platformdan platforma farklılık gösterebildiğinden, desteklediğimiz tüm platformlar için dahili bir standart kullanıyoruz. Ancak bu kodlar karmaşık olduğundan, sunucumuza tam olarak ne gönderdiğinizi ve ardından ne olduğunu anlamanız son derece önemlidir; böylece her zaman beklediğinizi alırsınız.

Adapty’de yerel ayar kodu standardı

Adapty, yerel ayar kodları için BCP 47 standardının hafifçe değiştirilmiş bir versiyonunu kullanır: her kod, kısa çizgilerle ayrılmış küçük harfli alt etiketlerden oluşur. Birkaç örnek: en (İngilizce), pt-br (Portekizce (Brezilya)), zh (Basitleştirilmiş Çince), zh-hant (Geleneksel Çince).

Yerel ayar kodu eşleştirme

Adapty, istemci tarafı SDK’sından yerel ayar koduyla birlikte bir çağrı aldığında ve bir paywall için ilgili yerelleştirmeyi aramaya başladığında şunlar gerçekleşir:

Gelen yerel ayar dizesi küçük harfe dönüştürülür ve tüm alt çizgiler (_) kısa çizgilerle (-) değiştirilir
Ardından tam olarak eşleşen yerel ayar koduna sahip yerelleştirmeyi arayız
Eşleşme bulunamazsa, ilk kısa çizgiden önceki alt dizeyi alırız (pt-br için pt) ve eşleşen yerelleştirmeyi arayız
Yine eşleşme bulunamazsa, varsayılan en yerelleştirmesini döndürürüz Bu sayede 'pt_BR' gönderen bir iOS cihazı, pt-BR gönderen bir Android cihazı ve pt-br gönderen başka bir cihaz aynı sonucu alır.

Yerelleştirmeleri uygulama: önerilen yöntem

Yerelleştirmelerle ilgileniyorsanız, büyük ihtimalle projenizde zaten yerelleştirilmiş string dosyalarıyla çalışıyorsunuzdur. Bu durumda, her bir dosyaya ilgili yerelleştirme için hedeflenen Adapty locale kodunu içeren bir anahtar-değer çifti eklemenizi öneririz. Ardından SDK’mızı çağırırken bu anahtara karşılık gelen değeri şu şekilde çıkarabilirsiniz:

// 1. app_en.arb, app_es.arb, app_pt_br.arb dosyalarınızı düzenleyin

/*
app_en.arb
*/
"adapty_paywalls_locale": "en",

/*
app_es.arb
*/
"adapty_paywalls_locale": "es",

/*
app_pt_br.arb
*/
"adapty_paywalls_locale": "pt-br",

// 2. Locale kodunu çıkarın ve kullanın
final locale = AppLocalizations.of(context)!.adapty_paywalls_locale;
// locale kodunu AdaptyUI.getViewConfiguration veya Adapty.getPaywall metoduna iletin

Bu sayede uygulamanızın her kullanıcısı için hangi yerelleştirmenin alınacağını tam olarak kontrol edebilirsiniz.

Yerelleştirmeleri uygulama: alternatif yöntem

Her yerelleştirme için açıkça yerel ayar kodu tanımlamak yerine benzer (ama özdeş olmayan) sonuçlar elde edebilirsiniz. Bu yaklaşımda, platformun sağladığı başka nesnelerden yerel ayar kodunu çıkarırsınız:

final locale = Localizations.localeOf(context).languageCode;
// pass locale code to AdaptyUI.getViewConfiguration or Adapty.getPaywall method

Bu yaklaşımı önermiyoruz; bunun birkaç nedeni var:

iOS’ta tercih edilen diller ile mevcut yerel ayar özdeş değildir. Yerelleştirmenin doğru şekilde seçilmesini istiyorsanız, ya Apple’ın mantığına güvenmeniz gerekir (bu, yerelleştirilmiş string dosyalarıyla önerilen yaklaşımı kullandığınızda kutudan çıkar gibi çalışır) ya da bunu kendiniz yeniden oluşturmanız gerekir.
Adapty’nin sunucusunun tam olarak ne alacağını öngörmek zordur. Örneğin iOS’ta, bir cihazdan ar_OM@numbers='latn' gibi bir yerel ayar elde edip sunucumuza göndermeniz mümkündür. Bu çağrı için aradığınız ar-om yerelleştirmesini değil, büyük olasılıkla beklemediğiniz ar yerelleştirmesini alırsınız. Yine de bu yaklaşımı kullanmaya karar verirseniz, tüm ilgili kullanım senaryolarını kapsadığınızdan emin olun.