Adapty Flutter SDK'yı v. 3.0'a Taşıma

Adapty SDK v.3.0, no-code ve kullanıcı dostu bir paywall oluşturma aracının yeni sürümü olan Adapty Paywall Builder için destek sunuyor. Maksimum esneklik ve zengin tasarım özellikleriyle paywall’larınız çok daha etkili ve kârlı hale gelecek.

AdaptyUI kütüphanesinin artık kullanımdan kaldırıldığını ve AdaptySDK’nın bir parçası olarak dahil edildiğini lütfen unutmayın.

AdaptyUI SDK’yı Kaldırma

  1. AdaptyUI artık Adapty SDK içinde bir modül haline geldiğinden, pubspec.yaml dosyanızdan adapty_ui_flutter bağımlılığını kaldırın:

    dependencies:
    + adapty_flutter: ^3.2.1
    - adapty_flutter: ^2.10.3
    - adapty_ui_flutter: ^2.1.3
  2. Şu komutu çalıştırın:

    flutter pub get

Adapty SDK’yı Yapılandırma

Daha önce Adapty SDK yapılandırması için Adapty-Info.plist ve AndroidManifest.xml dosyalarını kullanmanız gerekiyordu.

Artık ek dosyalara gerek yok. Bunun yerine, tüm gerekli parametreleri aktivasyon sırasında doğrudan sağlayabilirsiniz.

Adapty SDK’yı yalnızca bir kez yapılandırmanız gerekir; bunu genellikle uygulamanızın yaşam döngüsünün başında yapın.

Adapty SDK’nın Adapty Modülünü Etkinleştirme

  1. Uygulamanızdan AdaptyUI SDK importunu şu şekilde kaldırın:

    import 'package:adapty_flutter/adapty_flutter.dart';
    - import 'package:adapty_ui_flutter/adapty_ui_flutter.dart';
  2. Adapty SDK aktivasyonunu şu şekilde güncelleyin:

    try {
    -	Adapty().activate();  
    +    await Adapty().activate(
    +        configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
    +         ..withLogLevel(AdaptyLogLevel.debug)
    +         ..withObserverMode(false)
    +         ..withCustomerUserId(null)
    +         ..withIpAddressCollectionDisabled(false)
    +         ..withIdfaCollectionDisabled(false),
    +   );
    } catch (e) {
        // handle the error
    }

Parametreler:

ParametreZorunlulukAçıklama
PUBLIC_SDK_KEYzorunluAdapty’deki uygulama ayarlarınızın Public SDK key alanında bulabileceğiniz anahtar: App settings-> General sekmesi -> API keys alt bölümü
withLogLevelisteğe bağlıAdapty, uygulamanızın işleyişine dair bilgi sunmak için hataları ve diğer önemli verileri kaydeder. Kullanılabilir log seviyeleri şunlardır:
  • error: Yalnızca hatalar kaydedilir.
  • warn: Kritik hatalara yol açmayan ancak dikkat edilmesi gereken hatalar ve SDK mesajları kaydedilir.
  • info: Hatalar, uyarılar ve çeşitli modüllerin yaşam döngüsünü kaydeden önemli bilgi mesajları kaydedilir.
  • verbose: Hata ayıklama sırasında işe yarayabilecek fonksiyon çağrıları, API sorguları gibi ek bilgiler kaydedilir.
withObserverModeisteğe bağlı

Observer mode özelliğini kontrol eden bir boolean değer. Satın alma ve abonelik durumunu kendiniz yönetip Adapty’yi yalnızca abonelik etkinliklerini ve analizleri göndermek için kullanıyorsanız etkinleştirin.

Varsayılan değer false’tur.

🚧 Observer mode etkinken Adapty SDK hiçbir işlemi kapatmaz, bu nedenle bunu kendiniz yönettiğinizden emin olun.

withCustomerUserIdisteğe bağlıSisteminizdeki kullanıcı tanımlayıcısı. Etkinlikleri doğru profile bağlamak için abonelik ve analitik etkinliklerinde gönderilir. Ayrıca Profiles and Segments menüsünden customerUserId ile müşteri arayabilirsiniz.
withIdfaCollectionDisabledisteğe bağlı

IDFA toplama ve paylaşımını devre dışı bırakmak için true olarak ayarlayın.

Kullanıcı IP adresi paylaşımı.

Varsayılan değer false’tur.

IDFA toplama hakkında daha fazla bilgi için Analytics integration bölümüne bakın.

withIpAddressCollectionDisabledisteğe bağlı

Kullanıcı IP adresi toplama ve paylaşımını devre dışı bırakmak için true olarak ayarlayın.

Varsayılan değer false’tur.

Adapty SDK’nın AdaptyUI Modülünü Etkinleştirme

AdaptyUI modülünü yalnızca Paywall Builder kullanmayı planlıyorsanız yapılandırmanız gerekir:

try {
    final mediaCache = AdaptyUIMediaCacheConfiguration(
        memoryStorageTotalCostLimit: 100 * 1024 * 1024, // 100MB
        memoryStorageCountLimit: 2147483647, // 2^31 - 1, max int value in Dart
        diskStorageSizeLimit: 100 * 1024 * 1024, // 100MB
    );

    await AdaptyUI().activate(
        configuration: AdaptyUIConfiguration(mediaCache: mediaCache),
        observer: <AdaptyUIObserver Implementation>,
    );
} catch (e) {
    // handle the error
}

AdaptyUI yapılandırmasının isteğe bağlı olduğunu unutmayın; AdaptyUI modülünü config olmadan da etkinleştirebilirsiniz. Ancak config kullanıyorsanız, içindeki tüm parametreler zorunludur.

Parametreler:

ParametreZorunlulukAçıklama
memoryStorageTotalCostLimitzorunluDepolamanın bayt cinsinden toplam maliyet sınırı.
memoryStorageCountLimitzorunluBellek depolamasının öğe sayısı sınırı.
diskStorageSizeLimitzorunluDiskteki depolama için bayt cinsinden dosya boyutu sınırı. 0 değeri sınır olmadığı anlamına gelir.