iOS SDK'yı yükle ve yapılandır

Adapty SDK, mobil uygulamanıza sorunsuz entegrasyon için iki temel modül içerir:

• Core Adapty: Bu temel SDK, Adapty’nin uygulamanızda düzgün çalışması için gereklidir.
• AdaptyUI: Bu isteğe bağlı modül, platformlar arası paywall’lar kolayca oluşturmak için kullanılan, kod gerektirmeyen kullanıcı dostu bir araç olan Adapty Paywall Builder’ı kullanıyorsanız gereklidir.

Tam bir uygulama adım adım anlatımı için şu videoları da izleyebilirsiniz:

Gereksinimler

SDK teknik olarak çekirdek modül için iOS 13.0+‘ı desteklese de, pratikte iOS 15.0+ zorunludur:

• Tüm StoreKit 2 özellikleri iOS 15.0+ gerektirir
• AdaptyUI modülü yalnızca iOS 15.0+ ile çalışır

Adapty SDK’yı Yükle

Adapty SDK, Swift Package Manager aracılığıyla yüklenir. Xcode’da File -> Add Package Dependency… yolunu izleyin. Paket bağımlılığı ekleme adımları Xcode sürümüne göre farklılık gösterebileceğinden gerekirse Xcode belgelerine başvurun.

1. Depo URL’sini girin:

   https://github.com/adaptyteam/AdaptySDK-iOS.git

2. Sürümü seçin (en son kararlı sürüm önerilir) ve Add Package düğmesine tıklayın.
3. Choose Package Products penceresinde ihtiyaç duyduğunuz modülleri seçin:
   • Adapty (temel modül)
   • AdaptyUI (isteğe bağlı - yalnızca Paywall Builder kullanmayı planlıyorsanız)
   Not:

   • Kids modunu etkinleştirmek için Adapty yerine Adapty_KidsMode seçin.
   • Listeden başka paket seçmeyin – bunlara ihtiyacınız olmayacak.
4. Kurulumu tamamlamak için Add Package düğmesine tıklayın.
5. Kurulumu doğrulayın: Proje gezgininde Package Dependencies altında “Adapty” (ve seçildiyse “AdaptyUI”) görünmelidir.

Adapty SDK’nın Adapty modülünü etkinleştirin

Adapty SDK’yı uygulama kodunuzda etkinleştirin.

Public SDK Key’inizi almak için:

1. Adapty Kontrol Paneli’ne gidin ve App settings → General sayfasına geçin.
2. Api keys bölümünden Public SDK Key’i kopyalayın (Secret Key’i değil).
3. Koddaki "YOUR_PUBLIC_SDK_KEY" ifadesini bununla değiştirin.

@main
struct YourApp: App {
  init() {
    // Configure Adapty SDK
    let configurationBuilder = AdaptyConfiguration
      .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY") // Get from Adapty dashboard

   Adapty.logLevel = .verbose // recommended for development and the first production release

    let config = configurationBuilder.build()

    // Activate Adapty SDK asynchronously
    Task {
      do {
        try await Adapty.activate(with: config)
      } catch {
        // Handle error appropriately for your app
        print("Adapty activation failed: ", error)
      }
    }

    var body: some Scene {
      WindowGroup {
        // Your content view
      }
    }
  }
}

// In your AppDelegate class:
// If you only use an AppDelegate, place the following code in the
// application(_:didFinishLaunchingWithOptions:) method.

// If you use a SceneDelegate, place the following code in the
// scene(_:willConnectTo:options:) method.


Task {
  do {
    let configurationBuilder = AdaptyConfiguration
      .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY") // Get from Adapty dashboard
      .with(logLevel: .verbose) // recommended for development and the first production release

    let config = configurationBuilder.build()
    try await Adapty.activate(with: config)
  } catch {
    // Handle error appropriately for your app
    print("Adapty activation failed: ", error)
  }
}

Şimdi uygulamanızda paywallları ayarlayın:

• Adapty Paywall Builder kullanıyorsanız, önce aşağıdaki AdaptyUI modülünü etkinleştirin, ardından Paywall Builder hızlı başlangıç kılavuzunu izleyin.
• Kendi paywall arayüzünüzü oluşturuyorsanız özel paywalllar için hızlı başlangıç kılavuzuna bakın.

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

Paywall Builder kullanmayı planlıyorsanız ve AdaptyUI modülünü kurduysanız, AdaptyUI’ı da etkinleştirmeniz gerekir.

@main
struct YourApp: App {
  init() {
    // ...ConfigurationBuilder adımları

    // Adapty SDK'yı asenkron olarak etkinleştir
    Task {
      do {
        try await Adapty.activate(with: config)
        try await AdaptyUI.activate()
      } catch {
        // Uygulamanıza uygun şekilde hatayı işleyin
        print("Adapty aktivasyonu başarısız oldu: ", error)
      }
    }

    // ana gövde...
  }
}

// Yalnızca AppDelegate kullanıyorsanız, aşağıdaki kodu
// application(_:didFinishLaunchingWithOptions:) metoduna yerleştirin.

// SceneDelegate kullanıyorsanız, aşağıdaki kodu
// scene(_:willConnectTo:options:) metoduna yerleştirin.


Task {
   do {
      let configurationBuilder = AdaptyConfiguration
         .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY") // Adapty kontrol panelinden alın
         .with(logLevel: .verbose) // geliştirme aşamasında önerilir

   let config = configurationBuilder.build()
   try await Adapty.activate(with: config)
   try await AdaptyUI.activate()
      } catch {
      // Uygulamanıza uygun şekilde hatayı ele alın
      print("Adapty aktivasyonu başarısız oldu: ", error)
   }
}

İsteğe Bağlı Kurulum

Günlük Kaydı

Günlük kaydı sistemini ayarlama

Adapty, neler olduğunu anlamanıza yardımcı olmak için hataları ve diğer önemli bilgileri günlüğe kaydeder. Aşağıdaki seviyeler mevcuttur:

 let configurationBuilder = AdaptyConfiguration
         .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
         .with(logLevel: .verbose) // recommended for development

Log sistemi mesajlarını yönlendirin

Adapty’nin log mesajlarını kendi sisteminize göndermek veya bir dosyaya kaydetmek istiyorsanız setLogHandler metodunu kullanın ve özel log mantığınızı bu metodun içine uygulayın. Bu handler, mesaj içeriği ve önem düzeyi içeren log kayıtları alır.

Adapty.setLogHandler { record in
    writeToLocalFile("Adapty \(record.level): \(record.message)")
}

Veri politikaları

Adapty, açıkça göndermedikçe kullanıcılarınızın kişisel verilerini saklamaz. Ancak mağaza veya ülke yönergelerine uymak için ek veri güvenliği politikaları uygulayabilirsiniz.

IDFA toplama ve paylaşımını devre dışı bırakma

Adapty modülünü etkinleştirirken, IDFA toplama ve paylaşımını devre dışı bırakmak için idfaCollectionDisabled değerini true olarak ayarlayın. App Store İnceleme Yönergelerine uymak veya IDFA uygulamanız için gerekli olmadığında App Tracking Transparency istemini tetiklemekten kaçınmak için bu parametreyi kullanın. Varsayılan değer false’tur. IDFA toplama hakkında daha fazla ayrıntı için Analytics entegrasyonu bölümüne bakın.

let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
        .with(idfaCollectionDisabled: true)

IP toplama ve paylaşımını devre dışı bırakma

Adapty modülünü etkinleştirirken, kullanıcı IP adresi toplama ve paylaşımını devre dışı bırakmak için ipAddressCollectionDisabled değerini true olarak ayarlayın. Varsayılan değer false’tur.

Bu parametreyi; kullanıcı gizliliğini artırmak, bölgesel veri koruma düzenlemelerine (GDPR veya CCPA gibi) uymak ya da IP tabanlı özelliklere ihtiyaç duymadığınızda gereksiz veri toplamayı azaltmak için kullanabilirsiniz.

let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
        .with(ipAddressCollectionDisabled: true)

AdaptyUI’da paywall’lar için medya önbelleği yapılandırması

AdaptyUI yapılandırmasının isteğe bağlı olduğunu unutmayın. AdaptyUI modülünü yapılandırma olmadan da etkinleştirebilirsiniz. Ancak yapılandırmayı kullanıyorsanız tüm parametreler zorunludur.

// Configure AdaptyUI
        let adaptyUIConfiguration = AdaptyUI.Configuration(
            mediaCacheConfiguration: .init(
                memoryStorageTotalCostLimit: 100 * 1024 * 1024,
                memoryStorageCountLimit: .max,
                diskStorageSizeLimit: 100 * 1024 * 1024
            )
        )

        // Activate AdaptyUI
        AdaptyUI.activate(configuration: adaptyUIConfiguration)

Parametreler:

İşlem tamamlama davranışı

Adapty, varsayılan olarak başarılı doğrulamanın ardından işlemleri otomatik olarak tamamlar. Ancak gelişmiş işlem doğrulamasına ihtiyaç duyuyorsanız (sunucu taraflı makbuz doğrulama, dolandırıcılık tespiti veya özel iş mantığı gibi), SDK’yı manuel işlem tamamlamayı kullanacak şekilde yapılandırabilirsiniz.

let configurationBuilder = AdaptyConfiguration
    .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
    .with(transactionsFinishBehavior: .manual) // .auto is the default

İşlemlerin nasıl tamamlanacağına dair daha fazla ayrıntı için kılavuza bakın.

Yedekten geri yüklemede verileri temizle

clearDataOnBackup değeri true olarak ayarlandığında, SDK uygulamanın bir iCloud yedeğinden geri yüklendiğini algılar ve önbelleğe alınmış profil bilgileri, ürün ayrıntıları ve paywalllar dahil olmak üzere yerel olarak depolanan tüm SDK verilerini siler. SDK ardından temiz bir durumla başlatılır. Varsayılan değer false’tur.

let configurationBuilder = AdaptyConfiguration
    .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
    .with(clearDataOnBackup: true) // default – false

Sorun Giderme

Tuist ile Swift 6 eşzamanlılık hatası

Tuist ile derleme yaparken Swift 6 katı eşzamanlılık derleme hataları görebilirsiniz. Tipik belirtiler arasında AdaptyUIBuilderLogic içinde @Sendable nitelik uyumsuzlukları veya benzer modüller arası Sendability hataları yer alır. Bu durum, Tuist’in SPM paketlerinden Xcode projeleri oluştururken swift-tools-version: 6.0 ayarını korumamasından kaynaklanır. Bunun sonucunda bazı Adapty hedefleri (Adapty, AdaptyUI, AdaptyUIBuilder) Swift 5 kurallarıyla, diğerleri ise Swift 6 ile derlenir ve bu da modüller arası @Sendable uyumsuzluklarına yol açar.

Çözüm: Adapty SDK 3.15.5 veya üzeri sürüme yükseltin; bu, karışık Swift dil sürümlerinden bağımsız olarak sorunu çözer.

Geçici çözüm: Yükseltemiyorsanız, Tuist yapılandırmanızda üç Adapty hedefinin tamamı için Swift 6’yı açıkça ayarlayın:

targetSettings: [
  "Adapty": .init().swiftVersion("6"),
  "AdaptyUI": .init().swiftVersion("6"),
  "AdaptyUIBuilder": .init().swiftVersion("6"),
]