Android SDK'da onboarding'leri göster

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

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

Onboarding Builder ile bir onboarding özelleştirdiyseniz, bunu kullanıcıya göstermek için mobil uygulama kodunuzda render işlemiyle uğraşmanıza gerek yok. Bu tür bir onboarding, hem ne gösterileceğini hem de nasıl gösterileceğini içerir. Cihaz ekranında görsel onboarding’i gösterebilmek için önce yapılandırmanız gerekir. Bunu yapmak için AdaptyUI.getOnboardingView() metodunu çağırın veya 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, onu görünüm hiyerarşisine ekleyebilir ve 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.

Onboardinglerde linklerin nasıl açılacağını özelleştirme

Varsayılan olarak, onboardinglerdeki linkler uygulama içi bir tarayıcıda açılır. Bu, web sayfalarını uygulamanızın içinde göstererek kullanıcıların uygulamalar arasında geçiş yapmadan görüntülemesine olanak tanır ve kesintisiz bir kullanıcı deneyimi sunar.

Linklerin bunun yerine harici bir tarayıcıda açılmasını tercih ederseniz, 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
);