Présenter des onboardings dans le SDK Android

Warning

Les onboardings sont dépréciés à partir du SDK Adapty v4. Créez des flows à la place : contrairement aux onboardings, qui s’exécutent dans une WebView, les flows s’affichent nativement sur l’appareil — animations plus fluides, aspect natif cohérent, temps de chargement réduits et aucune dépendance à l’environnement WebView.

Avant de commencer, assurez-vous que :

Vous avez installé le SDK Android Adapty version 3.8.0 ou ultérieure.
Vous avez créé un onboarding.
Vous avez ajouté l’onboarding à un placement.

Si vous avez personnalisé un onboarding avec l’Onboarding Builder, vous n’avez pas à vous soucier de son rendu dans le code de votre application mobile pour l’afficher à l’utilisateur. Un tel onboarding contient à la fois ce qui doit être affiché et comment cela doit être affiché.

Pour afficher l’onboarding visuel sur l’écran de l’appareil, vous devez d’abord le configurer. Pour ce faire, appelez la méthode AdaptyUI.getOnboardingView() ou créez directement l’OnboardingView :

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

Une fois la vue créée avec succès, vous pouvez l’ajouter à la hiérarchie des vues et l’afficher à l’écran.

Paramètres de la requête :

Paramètre	Présence	Description
viewConfig	required	La configuration de l’onboarding obtenue depuis `AdaptyUI.getOnboardingConfiguration()`
eventListener	required	Une implémentation de `AdaptyOnboardingEventListener` pour gérer les événements d’onboarding. Consultez Gestion des événements d’onboarding pour plus de détails.

Modifier la couleur de l’indicateur de chargement

Vous pouvez remplacer la couleur par défaut de l’indicateur de chargement de la façon suivante :


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

Ajouter des transitions fluides entre l’écran de démarrage et l’onboarding

Par défaut, entre l’écran de démarrage et l’onboarding, un écran de chargement s’affiche jusqu’à ce que l’onboarding soit entièrement chargé. Si vous souhaitez rendre cette transition plus fluide, vous pouvez la personnaliser en prolongeant l’écran de démarrage ou en affichant autre chose.

Pour ce faire, créez adapty_onboarding_placeholder_view.xml dans res/layout et définissez-y un placeholder (ce qui sera affiché pendant le chargement de l’onboarding).

Si vous définissez un placeholder, l’onboarding sera chargé en arrière-plan et affiché automatiquement une fois prêt.

Désactiver les marges de zone de sécurité

Par défaut, la vue d’onboarding applique automatiquement des marges de zone de sécurité pour éviter les éléments d’interface système tels que la barre d’état et la barre de navigation. Cependant, si vous souhaitez désactiver ce comportement et avoir un contrôle total sur la mise en page, vous pouvez le faire en définissant le paramètre safeAreaPaddings sur 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);

Vous pouvez également contrôler ce comportement globalement en ajoutant une ressource booléenne à votre application :


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

Lorsque safeAreaPaddings est défini sur false, l’onboarding s’étend sur la totalité de l’écran sans aucun ajustement automatique des marges, ce qui vous donne un contrôle total sur la mise en page et permet au contenu de l’onboarding d’utiliser tout l’espace disponible à l’écran.

Personnaliser l’ouverture des liens dans les onboardings

Important

La personnalisation de l’ouverture des liens dans les onboardings est prise en charge à partir du SDK Adapty v3.15.1.

Par défaut, les liens dans les onboardings s’ouvrent dans un navigateur intégré à l’application. Cela offre une expérience utilisateur fluide en affichant les pages web directement dans votre application, sans que les utilisateurs aient besoin de changer d’app.

Si vous préférez ouvrir les liens dans un navigateur externe, vous pouvez personnaliser ce comportement en définissant le paramètre externalUrlsPresentation sur AdaptyWebPresentation.ExternalBrowser :

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

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