前言

在鸿蒙（OpenHarmony）应用的高级感塑造中，微动效（Micro-animations） 起着画龙点睛的作用。特别是对于数据同步、系统加载等耗时操作，一个具有反馈感和韵律感的循环加载进度（Circular Loading Progress），能有效缓解用户的等待焦虑。

不同于简单的转圈动画，本文将探讨如何利用 CustomPainter 绘制复杂的路径动画，并结合分段反馈（Staged Feedback）逻辑，让进度条在循环中传达明确的状态转换信息。

目录

1. 路径几何：弧线段的参数化方程
2. 分段反馈：加载状态的离散映射
3. 核心代码：构建 HarmonyLoadingEngine
4. 鸿蒙适配：低功耗渲染与 Canvas 优化
5. 总结与展望

1. 路径几何：弧线段的参数化方程

循环进度的本质是圆周上不断变化的弧段。在 $t$ 时刻，弧段的起始角 ${\theta }_{start}$ 和结束角 ${\theta }_{end}$ 可由如下方程组描述：

其中 $f(t)$ 决定了旋转位移，$g(t)$ 决定了弧段的伸缩长度。为了产生“追逐”效果，$f(t)$ 和 $g(t)$ 通常采用不同的 Curve（如 Curves.fastOutSlowIn）。

1.1 动画周期流程图

2. 分段反馈：加载状态的离散映射

高质量的进度反馈应当是可感知的阶段性变化。我们将加载过程分为四个阶段：

1. Warm-up (预热)：进度条从一点缓慢生发。
2. Running (运行)：常规的循环追逐动画。
3. Finalizing (收尾)：当数据同步接近完成，弧段逐渐闭合为圆。
4. Success/Error (反馈)：通过颜色或形状的突变，提示最终结果。

3. 核心代码：构建 HarmonyLoadingEngine

以下是基于 CustomPainter 实现的分段加载逻辑。

class LoadingPainter extends CustomPainter {
  final double animationValue; // 0.0 -> 1.0
  final Color color;

  LoadingPainter({required this.animationValue, required this.color});

  @override
  void paint(Canvas canvas, Size size) {
    final Paint paint = Paint()
      ..color = color
      ..strokeWidth = 6
      ..style = PaintingStyle.stroke
      ..strokeCap = StrokeCap.round;

    final double startAngle = -pi / 2 + (animationValue * 2 * pi);
    // 动态计算扫描角，营造“拉伸”感
    final double sweepAngle = pi * (1 + sin(animationValue * pi)).abs() * 0.5;

    canvas.drawArc(
      Rect.fromLTWH(0, 0, size.width, size.height),
      startAngle,
      sweepAngle,
      false,
      paint,
    );
  }

  @override
  bool shouldRepaint(covariant LoadingPainter oldDelegate) => true;
}

4. 鸿蒙适配：低功耗渲染与 Canvas 优化

在移动设备中，持续运行的动画是功耗的大头。

• 裁剪优化：利用 canvas.clipPath 限制重绘区域，避免全屏 Canvas 刷新。
• 帧率控制：在数据同步的“非交互”阶段，可适当将 AnimationController 的频率通过 Interval 降至 30fps，以节省系统资源。
• 硬件加速：确保在鸿蒙的 hvigor 配置中启用了硬件加速渲染，使 CustomPainter 的指令集直接在 GPU 上执行。

5. 总结与展望

微动效是 UI 交互中的“润滑剂”。通过路径动画和分段反馈，我们让冰冷的进度条具备了生命的节奏。下一章，我们将挑战更高级的 “3D 透视：基于 Transform 的翻转循环”，让交互逻辑从 2D 路径演化为 3D 空间变换。

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net