Android SDK'da onboarding'leri sunma

Başlamadan önce şunların yapıldığından emin olun:

1. Adapty Android SDK 3.8.0 veya daha yeni bir sürümü yüklediniz.
2. Bir onboarding oluşturdunuz.
3. Onboarding’i bir placement’a eklediniz.

Onboarding Builder kullanarak bir onboarding özelleştirdiyseniz, bunu kullanıcıya göstermek için mobil uygulama kodunuzda ayrıca render etmenize gerek yoktur. Bu tür bir onboarding, hem neyin hem de nasıl gösterileceğini kendi içinde barındırır.

Görsel onboarding’i cihaz ekranında görüntüleyebilmek için önce yapılandırmanız gerekir. Bunun için AdaptyUI.getOnboardingView() metodunu çağırın ya da OnboardingView’ı doğrudan oluşturun:

val onboardingView = AdaptyUI.getOnboardingView(
    activity = this,
    viewConfig = onboardingConfig,
    eventListener = eventListener
)

val onboardingView = AdaptyOnboardingView(activity)
onboardingView.show(
    viewConfig = onboardingConfig,
    delegate = eventListener
)

AdaptyOnboardingView onboardingView = AdaptyUI.getOnboardingView(
    activity,
    onboardingConfig,
    eventListener
);

AdaptyOnboardingView onboardingView = new AdaptyOnboardingView(activity);
onboardingView.show(onboardingConfig, eventListener);

<com.adapty.ui.onboardings.AdaptyOnboardingView
        android:id="@+id/onboardingView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

View başarıyla oluşturulduktan sonra, bunu view hiyerarşisine ekleyip cihaz ekranında görüntüleyebilirsiniz.

İstek parametreleri:

Yükleme göstergesi rengini değiştirme

Yükleme göstergesinin varsayılan rengini şu şekilde geçersiz kılabilirsiniz:

<style name="AppTheme" parent="android:Theme.Material.Light.NoActionBar">
    
    <item name="adapty_progressIndicatorColor">@color/yourColor</item>
</style>

Splash ekranı ile onboarding arasına sorunsuz 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 akıcı hale getirmek istiyorsanız bunu özelleştirebilir; splash ekranını uzatabilir ya da başka bir şey gösterebilirsiniz.

Bunu yapmak için res/layout dizininde adapty_onboarding_placeholder_view.xml dosyası oluşturun ve onboarding yüklenirken gösterilecek yer tutucuyu orada tanımlayın.

Bir yer tutucu tanımladığınızda onboarding arka planda yüklenir ve hazır olduğunda otomatik olarak görüntülenir.

Güvenli alan dolgularını devre dışı bırakma

Varsayılan olarak, onboarding view durum çubuğu ve gezinme çubuğu gibi sistem arayüzü öğelerini önlemek amacıyla güvenli alan dolgularını otomatik olarak uygular. Ancak bu davranışı devre dışı bırakarak layout üzerinde tam kontrol sahibi olmak istiyorsanız safeAreaPaddings parametresini false olarak ayarlayabilirsiniz.

val onboardingView = AdaptyUI.getOnboardingView(
    activity = this,
    viewConfig = onboardingConfig,
    eventListener = eventListener,
    safeAreaPaddings = false
)

val onboardingView = AdaptyOnboardingView(activity)
onboardingView.show(
    viewConfig = onboardingConfig,
    delegate = eventListener,
    safeAreaPaddings = false
)

AdaptyOnboardingView onboardingView = AdaptyUI.getOnboardingView(
    activity,
    onboardingConfig,
    eventListener,
    false
);

AdaptyOnboardingView onboardingView = new AdaptyOnboardingView(activity);
onboardingView.show(onboardingConfig, eventListener, false);

Alternatif olarak, uygulamanıza bir boolean kaynağı ekleyerek bu davranışı genel düzeyde kontrol edebilirsiniz:

<resources>
    <bool name="adapty_onboarding_enable_safe_area_paddings">false</bool>
</resources>

safeAreaPaddings değeri false olarak ayarlandığında, onboarding otomatik dolgu ayarlaması yapılmadan tam ekrana uzanır; bu sayede layout üzerinde tam kontrol sağlanır ve onboarding içeriği ekranın tamamını kullanabilir.

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

Varsayılan olarak, onboarding’lerdeki bağlantılar uygulama içi tarayıcıda açılır. Bu sayede kullanıcılar uygulama değiştirmeden web sayfalarını doğrudan uygulamanız içinde görüntüleyebildiğinden kesintisiz bir deneyim yaşar.

Bağlantıları bunun yerine harici tarayıcıda açmayı tercih ediyorsanız externalUrlsPresentation parametresini AdaptyWebPresentation.ExternalBrowser olarak ayarlayarak bu davranışı özelleştirebilirsiniz:

val onboardingConfig = AdaptyUI.getOnboardingConfiguration(
    onboarding = onboarding,
    externalUrlsPresentation = AdaptyWebPresentation.ExternalBrowser // default – InAppBrowser
)

AdaptyOnboardingConfiguration onboardingConfig = AdaptyUI.getOnboardingConfiguration(
    onboarding,
    AdaptyWebPresentation.ExternalBrowser // default – InAppBrowser
);