ProgressButton的Handler动画机制逐行解读startAnimating与stopAnimating背后的实现逻辑【免费下载链接】progressbuttonA custom progress indicator with a tiny footprint.项目地址: https://gitcode.com/gh_mirrors/progre/progressbuttonProgressButton 是一款轻量级的 Android 自定义进度指示器组件仅用一个圆形图标就能同时表达下载进度与固定状态。它最核心的卖点——旋转的进度光弧效果——完全由一个几十行的Handler动画循环驱动。本文带你逐行读懂startAnimating()与stopAnimating()背后的完整实现逻辑彻底弄懂这个小体积、大能量的帧动画机制。先认识 ProgressButton一个只有几 KB 的进度指示器如图所示这是官方 Sample 应用的运行效果每个圆形按钮内嵌一个进度环蓝色部分表示已完成进度灰色部分表示剩余部分图标为图钉形状表示固定状态。组件的所有自定义属性定义在 attrs.xml 中默认样式在 styles.xml 中。它的核心实现只在一个文件里ProgressButton.java全文不到 500 行非常适合精读。Handler 动画机制的三要素在源码 第 66 行至 75 行四个成员变量构成了整个动画机制变量默认值作用mAnimatingfalse动画总开关onDraw是否画旋转弧的唯一依据mAnimationProgress0旋转光弧当前的进度值每帧累加mAnimationSpeed1每帧前进的步长值越大转得越快mAnimationDelay50毫秒两帧之间的间隔值越小转得越快真正驱动这一切的是一个匿名Handler实例第 88 行至 103 行。它没有使用Runnable postDelayed而是采用了经典的Message 消息循环写法每处理完一条消息就再发一条延时消息给自己形成自驱动的帧循环。startAnimating() 逐行解读三步点亮转轮这是启动动画的入口方法源码位于第 356 至 363 行public void startAnimating() { if (!mAnimating) { mAnimating true; mAnimationProgress mProgress; mAnimationHandler.sendEmptyMessage(0); } }逐行拆解if (!mAnimating)—— 防重复启动守卫。若已经在动画中直接返回。这一行保证了外部可以随意、高频地调用startAnimating()而不会叠加出多套消息循环是整段代码防抖的关键。mAnimating true—— 打开总开关。一旦为trueonDraw()就会画出旋转弧handleMessage()也会继续转发下一帧消息动画自然延续。mAnimationProgress mProgress—— 从真实进度处起步。光弧不是从 0° 开始转而是从当前实际进度mProgress对应的位置开始视觉上与进度环无缝衔接不会闪跳。mAnimationHandler.sendEmptyMessage(0)—— 发出第一帧。注意这里是sendEmptyMessage立即投递而不是sendEmptyMessageDelayed。第一帧不等延迟界面按下即转后续的帧才由handleMessage内部以mAnimationDelay毫秒间隔自我续接。handleMessage() 逐行解读帧循环的自驱动核心Override public void handleMessage(Message msg) { if (mAnimating) { invalidate(); mAnimationProgress mAnimationSpeed; if (mAnimationProgress mMax) { mAnimationProgress mProgress; } mAnimationHandler.sendEmptyMessageDelayed(0, mAnimationDelay); } }这是整个机制最精妙的部分每一行都有明确职责if (mAnimating)—— 帧循环的刹车检查。每帧到达时先确认开关仍开着如果动画已被stopAnimating()关闭本方法什么都不做也不再发消息循环就此自然终结。停止动画其实不需要杀死循环只需要让它不再自我续接。invalidate()—— 请求系统重新执行一次onDraw()即画一帧。注意顺序先重绘当前状态再推进进度。mAnimationProgress mAnimationSpeed—— 按步长前进。默认mAnimationSpeed 1、mMax 100意味着光弧绕一整圈恰好需要 100 帧 × 50ms 5 秒转速刚好与进度值一一对应。if (mAnimationProgress mMax)回卷—— 光弧超过 100 后不是回 0而是回mProgress。这个细节保证了光弧始终从真实进度位置重新启动一圈与静态进度环首尾相接视觉上浑然一体。sendEmptyMessageDelayed(0, mAnimationDelay)—— 帧循环的心脏为下一帧预约时间。这条语句放在if (mAnimating)块的最末尾意味着只要开关还开着循环就永远不会停。stopAnimating() 逐行解读停止比启动更讲究public void stopAnimating() { mAnimating false; mAnimationProgress mProgress; mAnimationHandler.removeMessages(0); invalidate(); }与startAnimating()相比这里多了一个清扫动作mAnimating false—— 先关总开关。之后即便还有残留消息到达handleMessage也会因if判断直接跳过形成双保险。mAnimationProgress mProgress—— 让光弧落回真实进度位置避免停止瞬间画面出现位置跳变。removeMessages(0)—— 清除队列中所有已排队、尚未执行的消息 0。没有这一步最坏情况下会多画出一帧僵尸帧动画停止会有可感知的延迟。invalidate()—— 立即重绘最后一帧确保静止画面干净利落。启动靠发一条消息停止靠清一批消息——这一对方法完美展示了 Handler 消息循环管理的最小范式。onDraw() 中那行画弧语句动画的终点动画每帧推进后最终落笔在 onDraw() 的第 403 至 406 行if (mAnimating) { canvas.drawArc(mTempRectF, -90 (360 * mAnimationProgress / mMax), mAnimationStripWidth, true, mProgressPaint); }起始角-90 360 × mAnimationProgress / mMax从 12 点方向-90°出发把当前动画进度换算成角度扫过角度mAnimationStripWidth默认 6°这就是那条细细的光尾只有mAnimating为真时才绘制——静态时画面只剩干净的进度环。自定义动画参数三个关键属性想调节动画手感只需修改三个属性attrs.xml 第 32 至 35 行或在代码中调用对应的 setter属性对应方法效果animationSpeedsetAnimationSpeed()每帧步长增大 转得更快animationDelaysetAnimationDelay()帧间隔毫秒数减小 转得更流畅animationStripWidthsetAnimationStripWidth()光弧扫过角度增大 尾巴更长三者都支持在 XML 布局中直接声明默认值集中定义于 ProgressButton.java 第 68 至 73 行。在 Sample 应用中实践一个开关按钮控制动画官方示例 MainActivity.java 第 126 至 142 行 演示了最典型的使用姿势一个ToggleButton控制两个按钮的动画启停——勾选时调用startAnimating()取消时调用stopAnimating()布局定义见 activity_main.xml 第 87 至 110 行。if (isChecked) { progressButton9.startAnimating(); progressButton10.startAnimating(); } else { progressButton9.stopAnimating(); progressButton10.stopAnimating(); }此外若希望按钮创建时就处于动画状态直接在 XML 中声明android:animatingtrue即可——init()方法第 180 至 182 行会检测该属性并自动调用startAnimating()。核心要点速查表机制点结论驱动方式匿名HandlerMessage自续接循环每帧结束预约下一帧启动打开mAnimating开关 立即投递第一帧停止关闭开关 removeMessages(0)清空排队消息 重绘末帧转速mAnimationDelay帧间隔与mAnimationSpeed步长共同决定无缝衔接光弧回卷点 真实进度mProgress而非 0防重复startAnimating()首行守卫可安全高频调用如果想完整跑一遍源码可以克隆仓库后打开progressbutton-samples/目录下的示例工程体验git clone https://gitcode.com/gh_mirrors/progre/progressbutton总结ProgressButton 用不到 50 行动画代码展示了 Android 早期帧动画的经典范式——开关变量 Handler 自续接消息循环 invalidate 重绘。读懂startAnimating()的三行启动逻辑与stopAnimating()的四步收尾动作你就掌握了这类自定义指示器的通用实现思路也理解了为什么现代组件会转向ValueAnimator或Choreographer它们本质上只是把这套帧循环 开关机制搬进了更规范的调度框架。【免费下载链接】progressbuttonA custom progress indicator with a tiny footprint.项目地址: https://gitcode.com/gh_mirrors/progre/progressbutton创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考