Presentar onboardings en el SDK de Android

Antes de empezar, 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 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>

Agrega 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 se haya cargado por completo. Sin embargo, si quieres que la transición sea más suave, puedes personalizarla y ampliar la pantalla de inicio o mostrar otra cosa.

Para ello, crea adapty_onboarding_placeholder_view.xml en res/layout y define ahí un marcador de posición (lo que se mostrará mientras el onboarding se está cargando). Si defines un placeholder, el onboarding se cargará en segundo plano y se mostrará automáticamente cuando esté listo.

Desactivar los márgenes del área segura

Por defecto, la vista de onboarding aplica automáticamente márgenes del área segura para evitar elementos de la interfaz 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);

Alternativamente, 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 se establece en false, el onboarding se extenderá a pantalla completa sin ajustes automáticos de padding, dándote control total sobre el diseño y permitiendo que el contenido del onboarding ocupe todo el espacio de 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 las 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
);