在 Android SDK 中展示用户引导

在开始之前，请确保：

您已安装 Adapty Android SDK 3.8.0 或更高版本。
您已创建用户引导。
您已将用户引导添加到版位。

如果您已使用 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" />

视图成功创建后，您可以将其添加到视图层级中并在设备屏幕上显示。

请求参数：

参数	是否必填	描述
viewConfig	必填	从 `AdaptyUI.getOnboardingConfiguration()` 获取的用户引导配置
eventListener	必填	`AdaptyOnboardingEventListener` 的实现，用于处理用户引导事件。详情请参考处理用户引导事件。

更改加载指示器颜色

您可以通过以下方式覆盖加载指示器的默认颜色：


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

在启动页和用户引导之间添加流畅过渡

默认情况下，在启动页和用户引导之间，你会看到加载画面，直到用户引导完全加载完毕。但如果你想让过渡更流畅，可以自定义过渡效果——延长启动页的显示时间，或显示其他内容。

为此，在 res/layout 目录下创建 adapty_onboarding_placeholder_view.xml，并在其中定义一个占位视图（即用户引导加载期间显示的内容）。如果您定义了版位，用户引导将在后台加载，并在准备就绪后自动显示。

禁用安全区域内边距

默认情况下，用户引导视图会自动应用安全区域内边距，以避免与状态栏、导航栏等系统 UI 元素重叠。如果你希望禁用此行为并完全控制布局，可以将 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 时，用户引导将扩展至全屏，不会进行任何自动内边距调整，从而让你完全掌控布局，使用户引导内容得以占用整个屏幕空间。

自定义用户引导中链接的打开方式

自定义用户引导中链接的打开方式需要 Adapty SDK v3.15.1 及以上版本。

默认情况下，用户引导中的链接会在应用内浏览器中打开。这种方式能为用户提供无缝体验，让用户无需切换应用即可在应用内查看网页。

如果你希望改为在外部浏览器中打开链接，可以将 externalUrlsPresentation 参数设置为 AdaptyWebPresentation.ExternalBrowser 来自定义此行为：

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

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