Adapty Flutter SDK'yı v4.1'e Taşıma

Adapty Flutter SDK 4.1; Adapty Attribution’ın etkinleştirilme şeklini değiştiriyor, harici attribution API’lerini yeniden adlandırıyor ve yedek paywall dosya biçimini güncelliyor. Bunlara ek olarak App Store’da tanıtılan uygulama içi satın almaları destekliyor ve bir flow görünümünü kapattıktan sonra canlı tutmanın yolunu ekliyor.

Hâlâ 3.x’teyseniz önce v4.0’a geçiş rehberiyle başlayın, ardından bu kılavuzu takip edin.

Hızlı başvuru kılavuzu

Satın alma, profil ve flow sunum API’leri bunun dışında değişmemiştir.

Kurulum

pubspec.yaml dosyanızda adapty_flutter sürümünü v4.1 olarak güncelleyin:

dependencies:
  adapty_flutter: ^4.1.1

Uygulamanız Kids Mode kullanıyorsa bunun yerine adapty_flutter_kids belirtin:

dependencies:
  adapty_flutter_kids: ^4.1.1

Gereksinimler 4.0’dan bu yana değişmedi: Flutter 3.32.0 (Dart 3.8.0) ve iOS 15.0. Tam kurulum için Adapty SDK’yı Yükle sayfasına bakın.

4.1, yerel iOS SDK’yı 4.1.3 ve yerel Android SDK’yı 4.1.1 sürümüne sabitler. iOS sürümü ayrıca flow analitik olaylarının sayısal parametrelerindeki bir hatayı da düzeltir: bu düzeltmeden önce, her 0 ve 1 değeri flowViewDidReceiveAnalyticEvent’e false ve true olarak ulaşıyordu.

⚠️ Adapty Attribution varsayılan olarak devre dışıdır

4.0 ve önceki sürümlerde SDK, Adapty Attribution için yüklemeleri otomatik olarak kaydediyordu. 4.1’den itibaren bu özellik varsayılan olarak kapalıdır: SDK yüklemeleri kaydetmez, onUpdateInstallationDetailsSuccessStream ve onUpdateInstallationDetailsFailStream hiçbir zaman tetiklenmez ve getCurrentInstallationStatus AdaptyInstallationStatusNotAvailable döndürür.

Adapty Attribution kullanıyorsanız, SDK’yı yapılandırırken bu özelliği etkinleştirin:

  await Adapty().activate(
-   configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY'),
+   configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY')
+     ..withAdaptyAttributionEnabled(true),
  );

Adapty Attribution kullanmıyorsanız herhangi bir değişiklik yapmanıza gerek yoktur.

Yeniden Adlandırılan Harici Attribution API’leri

Harici bir sağlayıcıdan (Adjust, AppsFlyer, Branch, Tenjin veya özel bir sağlayıcı) attribution verisi ileten API’ler, native SDK’larla uyumlu olacak şekilde yeniden adlandırıldı.

updateAttribution → updateExternalAttribution

Metod yeniden adlandırıldı ve source parametresi provider olarak değiştirildi. Parametre artık bir string yerine AdaptyExternalAttributionProvider alıyor; attribution verisi hâlâ bir map:

- await Adapty().updateAttribution(attribution, source: 'adjust');
+ await Adapty().updateExternalAttribution(attribution, provider: AdaptyExternalAttributionProvider.adjust);

AdaptyAttributionSource → AdaptyExternalAttributionProvider

Sağlayıcı türü yeniden adlandırıldı. Bir string üzerindeki açık bir sarmalayıcı olmaya devam eder — önceden tanımlanmış değerler şunlardır: appleAds, adjust, appsflyer, branch, tenjin ve Adapty’nin doğrudan entegre olmadığı sağlayıcılar için yeni bir custom. Herhangi başka bir string’den de oluşturabilirsiniz; bu sayede Adapty’nin ileride ekleyeceği bir sağlayıcı, SDK güncellemesi gerektirmeden çalışır:

final provider = AdaptyExternalAttributionProvider('my_provider');

AdaptyProfile.appliedAttributionSources → appliedExternalAttributionProviders

Profile’a uygulanan attribution sağlayıcılarını listeleyen profil özelliği yeniden adlandırıldı ve öğe türü de buna göre değişti:

- if (profile.appliedAttributionSources.contains(AdaptyAttributionSource.appleAds)) {
+ if (profile.appliedExternalAttributionProviders.contains(AdaptyExternalAttributionProvider.appleAds)) {
      // Apple Ads attribution has been applied
  }

Serileştirilmiş profil alanı applied_attribution_sources adını koruduğundan, ham profili okuyan bir backend için herhangi bir değişiklik gerekmez. Ancak bu özelliği okuyan kodun güncellenmesi gerekir — bkz. Apple Ads hedefli paywall gösterme.

Yedek dosyalar

Yedek dosya biçimi SDK 4.1’de değişti. Placements > Fallbacks bölümünden dosyayı yeniden indirin ve uygulamanıza ekleyin; 4.0 için daha önce indirmiş olsanız bile bu adımı atlamamanız gerekir.

App Store’da öne çıkan uygulama içi satın almalar

Flutter SDK 4.0, App Store ürün sayfanızda öne çıkan uygulama içi satın almaları desteklemiyordu: üzerine inşa edildiği yerel iOS SDK’sında bunlar için herhangi bir API bulunmuyordu. 4.1 bu desteği ekliyor; dolayısıyla bu yeni bir özellik olup, yeni kod değişikliği yapmadan güncelleme yapmanız uygulamanızın davranışını hiçbir şekilde değiştirmez.

By default the SDK completes a promoted purchase itself. Write code only to complete it yourself, for example to show a screen first: subscribe to didReceivePromotedPurchaseStream and pass the product to makePromotedPurchase. While anything is subscribed to that stream, the SDK stops completing promoted purchases for you.

Flow görünümünü kapattıktan sonra canlı tutma

AdaptyUI().dismissFlowView ve AdaptyUIFlowView.dismiss, bir destroy bayrağı kabul eder:

await AdaptyUI().dismissFlowView(view, destroy: false);

Varsayılan değeri true’dur; bu, görünümü eskisi gibi serbest bırakır. destroy: false ile görünüm canlı kalır; böylece tekrar gösterebilir ve kullanıcı, flow’un biriktirdiği durumla birlikte kaldığı ekrana geri döner.

Bu şekilde canlı tutulan bir görünüm, destroy: true ile kapatılana kadar bellekte tutulur. Serbest bırakılmış bir görünümü sunmaya çalışmak başarısız olur; bu nedenle söz konusu flow’u tekrar göstermek için createFlowView’ı yeniden çağırın.