Presentar onboardings en Android SDK

Antes de comenzar, asegúrate de que:

1. Has instalado el SDK de Adapty para Android 3.8.0 o posterior.
2. Has creado un onboarding.
3. Has añadido el onboarding a un placement.

Si has personalizado un onboarding con el Onboarding Builder, no necesitas preocuparte por renderizarlo en el código de tu app móvil para mostrárselo al usuario. Ese onboarding ya contiene tanto qué mostrar como cómo mostrarlo.

Para mostrar el onboarding visual en la pantalla del dispositivo, primero debes configurarlo. Para ello, llama al método AdaptyUI.getOnboardingView() o crea el OnboardingView directamente:

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" />

Una vez que la vista se haya creado correctamente, puedes añadirla a la jerarquía de vistas y mostrarla en la pantalla del dispositivo.

Parámetros de la solicitud:

Cambiar el color del indicador de carga

Puedes sobreescribir el color por defecto del indicador de carga de la siguiente manera:

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

Añadir transiciones suaves entre la pantalla de inicio y el onboarding

Por defecto, entre la pantalla de inicio y el onboarding verás la pantalla de carga hasta que el onboarding esté completamente cargado. Sin embargo, si quieres que la transición sea más fluida, puedes personalizarla y bien extender la pantalla de inicio o mostrar algo diferente.

Para ello, crea adapty_onboarding_placeholder_view.xml en res/layout y define ahí un placeholder (lo que se mostrará mientras se carga el onboarding).

Si defines un placeholder, el onboarding se cargará en segundo plano y se mostrará automáticamente cuando esté listo.

Desactivar los márgenes de área segura

Por defecto, la vista del onboarding aplica automáticamente márgenes de área segura para evitar elementos del sistema como la barra de estado y la barra de navegación. Sin embargo, si quieres desactivar este comportamiento y tener control total sobre el diseño, puedes hacerlo estableciendo el parámetro safeAreaPaddings en false.

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);

También puedes controlar este comportamiento de forma global añadiendo un recurso booleano a tu app:

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

Cuando safeAreaPaddings está en false, el onboarding se extenderá a pantalla completa sin ajustes automáticos de márgenes, dándote control total sobre el diseño y permitiendo que el contenido del onboarding use todo el espacio de la pantalla.

Personalizar cómo se abren los enlaces en los onboardings

Por defecto, los enlaces en los onboardings se abren en un navegador integrado en la app. Esto ofrece una experiencia fluida al mostrar páginas web dentro de tu aplicación, sin que el usuario tenga que cambiar de app.

Si prefieres abrir los enlaces en un navegador externo, puedes personalizar este comportamiento estableciendo el parámetro externalUrlsPresentation en AdaptyWebPresentation.ExternalBrowser:

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

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