App端必须使用plus.downloader.createDownload而非uni.downloadFile，因其支持实时进度回调；需双监听statechanged和progress事件，Android通知栏进度条需满足id唯一、ongoing:true等条件，并配合节流与交互锁确保体验。
App端必须用 plus.downloader.createDownload，uni.downloadFile 不行
很多人一上来就写 uni.downloadFile 并绑 onProgressUpdate，结果在 App 端完全不触发——这不是你代码写错了，是它本来就不支持。App（Android/iOS）环境里，只有 H5+ 的 plus.downloader.createDownload 能稳定拿到每秒 1–3 次的实时进度回调。
常见错误现象：onProgressUpdate 在 H5 上好使、小程序上偶尔生效、App 端完全静默；有人转而轮询 tempFilePath 文件大小，结果报 file system error 或路径不可读。
-
plus.downloader.createDownload返回的是downloadTask对象，必须调用start()才真正发起请求 - 回调靠
downloadTask.addEventListener('statechanged', ...)和downloadTask.addEventListener('progress', ...)双监听：前者管状态（如开始、完成、失败），后者管进度（含loaded和total） -
progress回调里total初期可能为 0（服务器没返回Content-Length），得加判断：if (total > 0) { percent = Math.round(loaded / total * 100) } - 别直接用小数算百分比，四舍五入取整——避免视图频繁重绘卡顿
通知栏进度条只支持 Android，且必须设 ongoing: true 和唯一 id
iOS 根本不支持通知栏进度条，这点不用挣扎。Android 上想让进度出现在下拉通知栏，不能靠 uni.showToast 或 uni.showLoading，它们压根不进通知栏，也不支持 progress 字段。
核心动作是用 plus.notification.createNotification 配合 progress 字段，但有硬性约束：
- 首次创建时必须传
id（数字或字符串均可，但要全局唯一），后续所有更新都靠它匹配原通知 -
options中必须含ongoing: true，否则用户一划就关掉，进度中断 - 每次更新进度都要调
notification.setOptions({ progress: 45 })，不是“追加”，是覆盖式刷新 -
progress必须是 0–100 的整数，传"50"或0.5都无效 - Android 8.0+ 需权限
android.permission.POST_NOTIFICATIONS，HBuilderX 3.7.0+ 已自动处理，旧版得手动加到manifest.json
进度更新要节流，别在 progress 回调里直接改 UI 或发通知
progress 回调触发频率高（毫秒级），如果每次回调都执行 this.progress = ... + notification.setOptions(...)，轻则 UI 卡顿，重则 Android ANR。
真实场景下推荐两级节流：
- 数值节流：只在进度变化 ≥ 1% 时才更新，比如当前 23%，下次回调是 23.6% 就忽略，等到了 24% 再动
- 时间节流：用
setTimeout或requestAnimationFrame控制 UI 更新频率，避免连续重绘 - 通知栏更新更保守：建议每 3–5 秒或每 5% 进度才调一次
setOptions，减少系统调用开销 - 别在回调里做文件 I/O、网络请求或复杂计算——这些会拖慢主线程，导致进度“跳变”甚至卡死
强制更新场景下，进度条和操作锁必须同步生效
弹个模态框不叫强制更新。用户点返回、切后台、点空白区域，都得拦住——这和进度条展示是同一套控制流。
关键点在于：下载开始前就要锁死交互，而不是等进度到 100% 才弹窗。
- 用
cover-view实现全局遮罩，必须放在App.vue底部，配合v-if="isUpdating"控制显隐；放子页面里会被原生组件（如map、video）盖住 - 安卓上
cover-view默认不响应点击，需显式加bindtap="noop"阻断穿透 - iOS 真机上
cover-view渲染时机敏感，同步挂载常“闪一下就消失”，建议延迟 100ms：setTimeout(() => { this.isUpdating = true }, 100) - 下载失败时，要主动释放锁、清空通知栏条目（
plus.notification.clear(id)），否则用户卡在灰屏界面
进度条本身不难，难的是把下载、通知、UI、交互锁四者串成一条不掉链子的流水线。漏掉任意一环，用户就会看到“进度停在 99%”“通知栏不动”“点了关闭还能继续用 App”这类问题。
