iOS SDK'da onboardingları sunma

SDK v4 (beta) itibarıyla, onboarding’lere daha güçlü bir alternatif olarak flow’lar oluşturabilirsiniz. Onboarding’ler WebView içinde çalışırken, flow’lar cihazda doğrudan native olarak render edilir — bu sayede daha akıcı animasyonlar, tutarlı bir iOS görünümü, daha hızlı yükleme süreleri ve WebView runtime bağımlılığından kurtulma gibi avantajlar elde edersiniz. Başlamak için Flow’ları ve paywall’ları getir ve Flow’ları ve paywall’ları göster sayfalarına göz atın.

Builder ile bir onboarding özelleştirdiyseniz, bunu kullanıcıya göstermek için mobil uygulama kodunuzda ayrıca render etmenize gerek yoktur. Böyle bir onboarding, hem onboarding içinde ne gösterileceğini hem de nasıl gösterileceğini içerir.

Başlamadan önce şunları sağlayın:

Adapty iOS SDK 3.8.0 veya üzerini yüklemiş olun.
Bir onboarding oluşturmuş olun.
Onboardingı bir placement’a eklemiş olun.

Swift’te onboardingları sunma

Görsel onboardingı cihaz ekranında göstermek için şu adımları izleyin:

.getOnboardingConfiguration metodunu kullanarak onboarding görünüm yapılandırmasını alın.

Görüntülemek istediğiniz görsel onboardingı .onboardingController metodunu kullanarak başlatın:

İstek parametreleri:

Parametre	Zorunluluk	Açıklama
onboarding configuration	zorunlu	Tüm onboarding özelliklerini içeren bir `AdaptyUI.OnboardingConfiguration` nesnesi. Bunu elde etmek için `AdaptyUI.getOnboardingConfiguration` metodunu kullanın.
delegate	zorunlu	Onboarding olaylarını dinlemek için bir `AdaptyOnboardingControllerDelegate`.

Döndürür:

Nesne	Açıklama
AdaptyOnboardingController	İstenen onboarding ekranını temsil eden bir nesne

Nesne başarıyla oluşturulduktan sonra cihaz ekranında görüntüleyebilirsiniz:

import Adapty
import AdaptyUI

// 0. Get an onboarding if you haven't done it yet     
let onboarding = try await Adapty.getOnboarding(placementId: "YOUR_PLACEMENT_ID")

// 1. Obtain the onboarding view configuration:
let configuration = try AdaptyUI.getOnboardingConfiguration(forOnboarding: onboarding)

// 2. Create Onboarding View Controller
let onboardingController = try AdaptyUI.onboardingController(
    with: configuration,
    delegate: <AdaptyOnboardingControllerDelegate>
) 

// 3. Present it to the user
present(onboardingController, animated: true)

SwiftUI’da onboardingları sunma

SwiftUI’da görsel onboardingı cihaz ekranında göstermek için:

// 1. Obtain the onboarding view configuration:
let configuration = try AdaptyUI.getOnboardingConfiguration(forOnboarding: onboarding)

// 2. Display the Onboarding View within your view hierarchy
AdaptyOnboardingView(
    configuration: configuration,
    placeholder: { Text("Your Placeholder View") },
    onCloseAction: { action in
        // hide the onboarding view
    },
    onError: { error in
         // handle the error
    }
)

Splash ekranı ile onboarding arasına yumuşak geçiş ekleme

Varsayılan olarak, splash ekranı ile onboarding arasında onboarding tam olarak yüklenene kadar yükleme ekranı görünür. Ancak geçişi daha pürüzsüz hale getirmek istiyorsanız, bunu özelleştirebilir; splash ekranını uzatabilir ya da başka bir şey gösterebilirsiniz.

Bunun için bir placeholder tanımlayın (onboarding yüklenirken tam olarak ne gösterileceğini belirleyin). Bir placeholder tanımlarsanız, onboarding arka planda yüklenir ve hazır olduğunda otomatik olarak gösterilir.


extension YourOnboardingManagerClass: AdaptyOnboardingControllerDelegate {
   func onboardingsControllerLoadingPlaceholder(
      _ controller: AdaptyOnboardingController
      ) -> UIView? {
         // instantiate and return the UIView which will be presented while onboarding is being loaded
   }
}

AdaptyOnboardingView(
    configuration: configuration,
    placeholder: { 
        // define your placeholder view, which will be presented while onboarding is being loaded
    },
    // the rest of the implementation
)

Onboarding’lerdeki bağlantıların nasıl açılacağını özelleştirme

Onboarding’lerdeki bağlantıların nasıl açılacağını özelleştirme özelliği Adapty SDK v3.15.1 sürümünden itibaren desteklenmektedir.

Varsayılan olarak, onboarding’lerdeki bağlantılar uygulama içi bir tarayıcıda açılır. Bu, kullanıcıların uygulama değiştirmeden web sayfalarını görüntüleyebilmesini sağlayarak kesintisiz bir kullanıcı deneyimi sunar.

Bağlantıların bunun yerine harici bir tarayıcıda açılmasını tercih ederseniz, externalUrlsPresentation parametresini .externalBrowser olarak ayarlayarak bu davranışı özelleştirebilirsiniz:


let configuration = try AdaptyUI.getOnboardingConfiguration(
    forOnboarding: onboarding,
    externalUrlsPresentation: .externalBrowser // default – .inAppBrowser
)