WelcomeCoordinator 架构全景图：核心组件协作与数据流深度解读-北京尧图网络

【免费下载链接】welcome-coordinatorWelcome Coordinator for Android项目地址https://gitcode.com/gh_mirrors/we/welcome-coordinator点击查看免费下载WelcomeCoordinator是一款来自 Redbooth 开源团队的 Android 引导页库Welcome Wizard / Onboarding 组件它把多页欢迎向导、表单向导变成一行 XML 一段回调就能实现的体验。本文带你用一张架构图拆解它的 5 个核心组件如何协作以及从手指滑动到视差动画帧的完整数据流。项目结构两个模块职责分明整个仓库由 Gradle 声明为两个模块见 settings.gradle模块路径职责WelcomeCoordinatorWelcomeCoordinator/核心库容器、分页、行为扩展框架appapp/Demo 应用四页火箭启程引导动画核心库的全部源码只有 5 个 Java 文件 1 个属性定义文件非常适合逐行阅读WelcomeCoordinatorLayout.java —— 顶层容器WelcomeCoordinatorTouchController.java —— 手势与翻页引擎WelcomeCoordinatorPageInflater.java —— 页面膨胀器WelcomePageLayout.java —— 单页容器WelcomePageBehavior.java —— 行为基类attrs.xml —— 自定义属性定义┌─────────────────────────────────────────────────────────┐ │ WelcomeCoordinatorLayout (HorizontalScrollView) │ │ ┌───────────────┐ ┌───────────────┐ ┌──────────────┐ │ │ │ WelcomePage1 │ │ WelcomePage2 │ │ ...Page N │ │ │ │ WelcomePageLayout (RelativeLayout) │ │ │ │ ├─ view_behavior.ParallaxTitleBehaviour │ │ │ │ ├─ app:destinyid/android_destiny │ │ │ └───────────────┘ └───────────────┘ └──────────────┘ │ │ [TouchController 拦截手势] → [ScrollChanged] │ │ → notifyProgressScroll() → 每个 Behavior 同步帧 │ │ [dispatchDraw 绘制底部指示圆点] │ └─────────────────────────────────────────────────────────┘️ 核心组件一WelcomeCoordinatorLayout —— 指挥中枢WelcomeCoordinatorLayout 继承自HorizontalScrollView是整个库的总指挥它管理四类状态页面列表内部FrameLayout mainContentView承载所有页面页面之间用左外边距屏幕宽 × 序号的方式横向排开而不是堆叠这让滚动位置天然是连续的见configurePageLayoutWelcomeCoordinatorLayout.java手势处理onTouchEvent优先交给WelcomeCoordinatorTouchController处理吸附逻辑失败才回落到系统默认滚动WelcomeCoordinatorLayout.java指示圆点dispatchDraw里逐帧绘制未选中/选中的圆点选中点位置由scrollX插值得出实现圆点滑动效果WelcomeCoordinatorLayout.java行为注册表behaviors列表保存所有页面的WelcomePageBehavior滚动时统一分发进度。它对外暴露的 XML 属性定义在 attrs.xml属性作用默认值indicatorUnselected未选中圆点颜色白色indicatorSelected选中圆点颜色黑色showIndicators是否显示圆点指示器truescrollingEnabled是否允许手动滑动true️ 核心组件二TouchController —— 翻页吸附引擎WelcomeCoordinatorTouchController 用VelocityTracker跟踪手势是松手后自动对齐到整页的关键数据流如下ACTION_DOWN ──记录 currentScrollX / 初始触点 X ACTION MOVE ──scrollLimited() 钳制边界 → view.setScrollX() → ViewTreeObserver.OnScrollChangedListener 触发 → view.notifyProgressScroll(progress, scrollX) ACTION UP ──computeCurrentVelocity() → moveToPagePosition()吸附决策在 moveToPagePosition 中规则非常直白速度 -300快速左滑→ 翻到下一页速度 300快速右滑→ 回到当前页否则看新页可见比例超过 50% 进下一页否则回弹。翻页动画由ObjectAnimator在 300ms 内平滑修改scrollX完成结束后回调onPageSelected(page)Demo 里每个页面的入场动画就是靠这个回调触发的。核心组件三PageInflater PageLayout —— 页面装载管线调用coordinator.addPage(R.layout.welcome_page_1, ...)时数据流是addPage(layoutResIds) └─ 逆序循环保证第一页在最左 ├─ PageInflater.inflate() ── 仅解析 XML得到 ViewGroup ├─ extractPageBehaviors() ── 遍历子 View收集 view_behavior │ └─ WelcomePageLayout.getBehaviors() 逐一绑定 │ coordinator / target / page 三要素 └─ mainContentView.addView(pageView)addPage 是唯一的注页入口WelcomeCoordinatorPageInflater 只是LayoutInflater的薄封装WelcomePageLayout 继承RelativeLayout每页 XML 的根节点必须是它。它的自定义LayoutParams会解析出两个关键属性app:view_behavior类名字符串通过反射实例化行为对象parseBehaviorapp:destiny目标视图 id供行为做跨页面飞行动画。核心组件四WelcomePageBehavior —— 视差动画扩展点这是整个库最精妙的设计把页面元素如何动从页面中解耦为可插拔的行为。基类 WelcomePageBehavior 只有两个抽象方法生命周期触发时机典型用途onCreate(coordinator)布局首次完成时一次性预建ObjectAnimator计算起止值onPlaytimeChange(coordinator, progress, scrollX)每次滚动用setCurrentPlayTime()手动推进动画帧关键技巧是**动画不播放只定位帧Behavior 在onCreate里创建一个时长等于整个滚动区宽度的ObjectAnimator但从不 start滚动时每帧调用setCurrentPlayTime(scrollX)于是动画进度与手指位置严格同步**——这正是欢迎页视差效果的原理可参考 Demo 的 ParallaxTitleBehaviour。跨页面飞行动画则依靠destiny属性getDestinyView 按 id 在 Coordinator 全局查找目标视图AnimationFlightTo 据此计算位移向量让星星飞到下一页的指定位置。数据流全景一次滑动的 5 个阶段① 手指拖动 TouchController.setScrollX → 页面位移 ② 滚动监听 OnScrollChangedListener → notifyProgressScroll() ③ 行为同步遍历 behaviors → onPlaytimeChange(逐帧驱动视差) ④ 事件回调 OnPageScrollListener.onScrollPage(progress, maximum) → Demo 用它同步整屏背景色渐变 ⑤ 松手吸附 moveToPagePosition → 300ms 平滑动画 → 结束回调 onPageSelected → 触发该页入场动画其中第④步对应 setOnPageScrollListenerDemo 的 MainActivity 用它做了两件事onScrollPage驱动四色背景渐变onPageSelected按页码播放火箭、头像、图表等入场动画switch (pageSelected)分支。️ 三步接入你自己的 App引入依赖在build.gradle中添加compile com.redbooth:WelcomeCoordinator:1.0.1依赖仓库配置见 buildsystem/dependencies.gradle布局声明参考 activity_main.xml放置WelcomeCoordinatorLayout并设置指示器样式注册页面在onCreate中调用coordinator.addPage(...)每页 XML 以WelcomePageLayout为根模板见 welcome_page_1.xml需要动效的子 View 加上app:view_behavior即可。阅读源码建议路径先跑app模块拖动四页感受视差与吸附效果从addPage→extractPageBehaviors顺藤摸瓜理解页面装载再看TouchController的边界钳制与速度判定最后实现一个自己的WelcomePageBehavior把滚动进度换算成你需要的动画帧。WelcomeCoordinator 用不到 600 行核心代码演示了容器—手势—行为三权分离的经典架构是学习 Android 自定义 ViewGroup 与动画同步机制的优秀样板赞分享【免费下载链接】welcome-coordinatorWelcome Coordinator for Android项目地址https://gitcode.com/gh_mirrors/we/welcome-coordinator点击查看免费下载相关推荐Higress网关架构深度解析三大核心组件与数据流转全景Higress网关架构深度解析三大核心组件与数据流转全景还在为API网关的复杂配置和性能瓶颈头疼吗Higress作为下一代云原生网关基于Envoy和IsAPI网关后端云原生微服务LLM 网关人工智能MCP 服务Hubble架构深度剖析理解核心组件与数据流向Hubble架构深度剖析理解核心组件与数据流向 Hubble作为云原生网络和安全可观测性平台通过其创新的架构设计为Kubernetes环境提供了前所未有的深云原生运维cheat 源码架构深度解析8 个核心 internal 包全景图与数据流梳理cheat 源码架构深度解析8 个核心 internal 包全景图与数据流梳理 cheat 源码架构一文读懂cheat 是一款让你在命令行中创建和查开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

WelcomeCoordinator 架构全景图：核心组件协作与数据流深度解读

相关推荐

Dify初始化与模型供应商配置：让AI平台真正可用

OpCore-Simplify 一键生成可用的 OpenCore EFI：黑苹果自动化配置五步指南

WinPythondot-32bit 3.10.5.0 发行版解析：dot 风味的精简型 Python 3.10 便携发行包

更多资讯

嵌入式驱动开发：量产级工程化实战第 21 篇：配置管理与远程升级

如何快速获取 gemma-2-2b_rai_1.8.0_medusa_1.0_npu：ModelScope SDK + Git Clone 双方式下载教程

instagram-private-api 评论响应接口 MediaRepositoryCommentResponse 深度解析：结构、字段与实战调用

Octopus 实空间 TDDFT 模拟：从光吸收谱到电子动力学实战指南

导弹打飞机贪心算法：最少拦截系统与偏序链覆盖详解

OpenCore Legacy Patcher 指南：老 Mac 装新 macOS 的完整流程

今日更新

Cephadm实战指南：Linux系统工程师的生产级Ceph集群部署与排障

不想再被 Token 额度卡脖子？把免费 API 接入 WorkBuddy 的完整教程

ITK中SpatialObject几何体系解析：坐标系、变换与管道集成

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？