Flutter开发:Bloc架构下上传进度过快 如何按10间隔调整进度增量
最优实现方案
核心解决思路
当前动画不流畅的本质原因是:onSendProgress回调触发频率远高于UI组件的动画可承接频率,每次细碎的进度更新都会打断CircularPercentIndicator正在运行的1200ms补间动画,导致动画永远卡在起步阶段,出现抖、卡的视觉效果。
最优的实现方式是在数据流入口处(上传回调触发Bloc事件前)做过滤,仅当实际进度跨过0.1(即10%)的固定步长阈值时,才向Bloc推送进度更新事件,从根源上减少高频无效更新,让UI组件的动画可以完整运行。
具体改造步骤
1. 在Bloc类中新增状态标记
需要在Bloc的成员变量中增加两个标记,记录已经推送过的进度步长、避免重复/无效事件触发:
// 记录上一次已经推送给UI的整十进度步长 double _lastReportedProgressStep = 0.0; // 标记上传是否已完成,避免重复推送完成态 bool _isUploadFinished = false;
2. 改造上传回调的进度触发逻辑
替换原来直接发事件的逻辑,增加步长判断:
onSendProgress: (int sent, int total) { // 计算原始真实进度 final rawProgress = sent / total; // 计算当前进度对应的0.1步长值(向下取整,实现每跨10%才触发一次) final currentStep = (rawProgress * 10).floor() / 10; // 仅当进度跨过新的10%阈值,且还未完成上传时,才推送更新事件 if (currentStep > _lastReportedProgressStep && !_isUploadFinished) { _lastReportedProgressStep = currentStep; // 推送被过滤后的步长进度值,限定在0-1范围内 add(ProgressUpdate(currentStep.clamp(0.0, 1.0))); } // 上传完成的边界兜底:强制推送1.0的满进度值 if (rawProgress >= 1.0 && !_isUploadFinished) { _isUploadFinished = true; add(const ProgressUpdate(1.0)); } }
方案优势
- 从数据源入口过滤无效高频事件,减少Bloc状态重建的性能损耗,不会因为进度回调太频繁导致页面卡顿
- 每次推送给UI的进度值固定增量10%,和
CircularPercentIndicator配置的1200ms动画时长完全适配:动画运行期间不会收到新的进度值打断,可以完整跑完一段过渡,视觉上是流畅的逐段增长效果 - 增加了完成态的边界兜底,不会出现卡在90%、上传完成后进度条不跳满的常见bug
注意事项
- 不要把整步取整的逻辑放到UI层处理:如果Bloc还是持续接收高频进度事件、触发状态重建,仅在UI取整显示的话,依然会打断组件动画,也无法减少性能损耗
- 可以根据实际视觉体验调整步长和动画时长的匹配关系:如果觉得10%的步长太大、进度条跳得太突兀,可以把步长改成0.05(5%间隔),或者适当缩短动画时长到和步长匹配的数值
- 触发上传重置逻辑时,记得把
_lastReportedProgressStep重置为0.0、_isUploadFinished重置为false,避免重新上传时进度不更新的问题 - 现有UI侧的
CircularPercentIndicator配置无需调整,组件自带的补间动画会自动适配传入的步长进度值
内容的提问来源于stack exchange,提问作者flutter
相关产品推荐
相关产品推荐

