iOS SDK'da onboardingları sunma

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:

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

Swift’te onboardingları sunma

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

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

2. 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ülen değer:

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

3. Nesne başarıyla oluşturulduktan sonra cihaz ekranında gösterebilirsiniz:

   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
)

Onboardinglardaki linklerin açılma şeklini özelleştirme

Varsayılan olarak, onboardinglardaki linkler uygulama içi tarayıcıda açılır. Bu, web sayfalarını uygulamanızın içinde göstererek kullanıcıların başka bir uygulamaya geçmeden görüntüleyebileceği sorunsuz bir deneyim sağlar.

Linklerin bunun yerine harici bir tarayıcıda açılmasını tercih ediyorsanız, externalUrlsPresentation parametresini .externalBrowser olarak ayarlayarak bu davranışı özelleştirebilirsiniz:

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