Отображение онбординга в Android SDK

Прежде чем начать, убедитесь, что:

1. Вы установили Adapty Android SDK версии 3.8.0 или выше.
2. Вы создали онбординг.
3. Вы добавили онбординг в плейсмент.

Если вы настроили онбординг с помощью Onboarding Builder, вам не нужно беспокоиться о его отрисовке в коде мобильного приложения — всё, что должно отображаться и как именно, уже определено внутри онбординга.

Чтобы показать визуальный онбординг на экране устройства, необходимо сначала его сконфигурировать. Для этого вызовите метод AdaptyUI.getOnboardingView() или создайте 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" />

После успешного создания представления вы можете добавить его в иерархию и отобразить на экране устройства.

Параметры запроса:

Изменение цвета индикатора загрузки

Вы можете переопределить цвет индикатора загрузки по умолчанию следующим образом:

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

Плавный переход между заставкой и онбордингом

По умолчанию между заставкой и онбордингом отображается экран загрузки, пока онбординг полностью не загрузится. Если вы хотите сделать переход более плавным, вы можете настроить его: либо продлить показ заставки, либо отобразить что-то иное.

Для этого создайте файл adapty_onboarding_placeholder_view.xml в папке res/layout и задайте в нём плейсхолдер — то, что будет показано, пока онбординг загружается.

Если плейсхолдер определён, онбординг будет загружаться в фоне и автоматически отобразится, когда будет готов.

Отключение отступов безопасной зоны

По умолчанию представление онбординга автоматически применяет отступы безопасной зоны, чтобы избежать перекрытия системными элементами интерфейса (строка состояния, навигационная панель). Если вы хотите отключить это поведение и полностью контролировать разметку, установите параметр safeAreaPaddings в 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);

Кроме того, вы можете управлять этим поведением глобально, добавив булев ресурс в приложение:

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

Когда safeAreaPaddings установлен в false, онбординг растягивается на весь экран без автоматических отступов, предоставляя вам полный контроль над разметкой и позволяя контенту онбординга использовать всё пространство экрана.

Настройка открытия ссылок в онбордингах

По умолчанию ссылки в онбордингах открываются во встроенном браузере. Это обеспечивает бесшовный пользовательский опыт: веб-страницы отображаются внутри приложения, и пользователю не нужно переключаться между приложениями.

Если вы предпочитаете открывать ссылки во внешнем браузере, вы можете настроить это поведение, установив параметр externalUrlsPresentation в AdaptyWebPresentation.ExternalBrowser:

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

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