BubblePager官方版

BubblePager官方版是一个基于 Jetpack Compose 的开源 Android 引导页（Onboarding）组件库。核心是实现气泡式灵动翻页动画，用于快速打造高质感的应用启动引导页。

BubblePager使用步骤

添加依赖（build.gradle）

// 需先配置 Compose 环境

implementation "com.google.accompanist:accompanist-pager:0.35.0-alpha"

implementation "com.google.accompanist:accompanist-pager-indicators:0.35.0-alpha"

// 引入 BubblePager 库（示例，以 GitHub 最新版为准）

implementation "com.github.xxx:bubblepager:1.0.0"

基础代码示例

BubblePager(

    pageCount = 3, // 总页数

    modifier = Modifier.fillMaxSize()

) { page ->

    // 每个页面的内容（Compose 组件）

    OnboardingPageContent(page = page)

}

自定义动画参数

BubblePager(

    pageCount = 3,

    bubbleScale = 1.2f, // 气泡放大比例

    animationDuration = 500, // 动画时长（毫秒）

    pageOffset = 0.1f // 页面偏移量

) { page ->

    OnboardingPageContent(page = page)

}

BubblePager 自定义动画参数模板

BubblePager(

    // 基础配置

    pageCount = 3, // 总页数

    modifier = Modifier.fillMaxSize(),

    state = rememberBubblePagerState(), // 页面状态

    // ========== 核心自定义动画参数 ==========

    bubbleScale = 1.15f,        // 气泡放大比例（1.0~1.5 最佳）

    animationDuration = 550,     // 动画时长（毫秒），越小越快

    pageOffset = 0.12f,         // 页面偏移量（控制重叠距离）

    fadeEnabled = true,         // 开启淡入淡出效果

    fadeFactor = 0.4f,         // 透明度变化强度

    elevationEnabled = true,    // 开启阴影立体效果

    bubbleElevation = 8.dp      // 气泡阴影高度

) { page ->

    // 你的页面内容

    OnboardingPage(page = page)

}

开发友好性

声明式 API：代码简洁，用 Kotlin 声明式语法即可快速构建，无需复杂布局与动画代码

状态自动管理：内置页面状态（当前页、总页数、滑动进度），自动同步 UI 与逻辑

轻量无依赖：仅依赖 Compose 基础库，体积小、集成快，不增加包体积负担

兼容广泛：支持 Android 5.0（API 21）及以上，适配绝大多数设备

适用人群

Android 开发者：追求高效开发、高质量 UI 的 Compose 项目开发者

产品 / 设计师：希望引导页有独特视觉效果、提升用户体验的团队

开源爱好者：学习 Compose 动画与自定义组件的优秀案例