更新记录
1.0.0(2026-11-05)
- 分片并发 + 断点续传下载引擎(App 端原生实现)。
- 完整性校验(crc32 / fnv1a)。
- 实时速度 / 剩余时间 / 百分比进度。
- 断网自动暂停、暂停/恢复/重试/取消。
- Pro 付费闸门(并发数、后台通知)。
平台兼容性
uni-app(4.0)
| Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
| × |
√ |
- |
- |
× |
× |
√ |
√ |
× |
| 微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
小红书小程序 |
快应用-华为 |
快应用-联盟 |
| - |
- |
× |
× |
× |
× |
× |
× |
× |
× |
× |
× |
大文件下载器 Pro(zl-bigdown)
uni-app 大文件下载引擎:原生分片并发 + 断点续传 + 后台通知进度 + 校验和完整性校验。1GB 文件断网恢复不重传、进度不丢,支持暂停/恢复/重试与速度/剩余时间实时反馈。
特性
- 分片并发:按线程数均分文件,多线程并行下载,吞吐量随线程提升。
- 断点续传:基于 HTTP
Range 记录各分片已写偏移,断网/暂停后仅续传剩余部分,绝不重传。
- 后台通知进度:App 端支持通知栏进度(需原生实现),用户离开页面仍可感知。
- 完整性校验:下载完成按
crc32 / fnv1a 比对期望校验和,防止文件损坏。
- 实时反馈:速度(B/s)、剩余时间(ETA)、百分比进度条,断网自动暂停并提示。
- Pro 闸门:并发数 > 3 与后台通知为付费功能,未激活时本地兼容(默认 3 线程)。
安装
- 在 DCloud 插件市场 搜索
zl-bigdown 导入 uni_modules。
- 在
manifest.json 为 App(Android/iOS)勾选该模块,云端打包或通过 HBuilderX 自定义基座运行。
快速开始
<template>
<zl-bigdown :max-threads="5" :enable-checksum="true" />
</template>
<script>
import zlBigdown from '@/uni_modules/zl-bigdown/components/zl-bigdown/zl-bigdown.vue'
export default { components: { zlBigdown } }
</script>
// 付费激活(可选)
import { configureLicense } from '@/uni_modules/zl-bigdown/utils/license'
configureLicense({ enablePro: true, licenseKey: 'YOUR_KEY', licenseApi: 'https://your-api/verify' })
API
| API |
说明 |
startDownload(opts, onProgress) |
启动下载;opts={url,destPath,threads,chunkSize,checksum,resume,headers} |
pauseDownload(taskId) |
暂停 |
resumeDownload(taskId) |
续传(不重传已完成部分) |
cancelDownload(taskId) |
取消并清理 |
进度回调 DownloadProgress
{ taskId, received, total, speed, eta, percent }
性能与验收
| 指标 |
目标 |
验收 |
| 1GB 断网恢复 |
不重传 |
仅续传剩余字节,进度不丢 |
| 分片并发吞吐 |
随线程提升 |
3 线程较单线程提速 ≥2x |
| 校验和比对 |
100% 一致 |
损坏文件检测率 100% |
| 内存 |
流控无泄漏 |
长任务无 OOM |
合规说明
- 仅下载用户主动指定的远程文件到本机沙盒,不读取、不上传、不收集任何用户隐私数据。
- 下载链接由接入方自行提供,插件不内置任何采集行为。
- 权限最小化:仅网络访问与本地存储写文件。
- 全自研实现,无第三方侵权。
付费说明
普通授权版 / 源码授权版双版本。Pro 功能(>3 并发、后台通知)需激活授权后启用;未配置远端校验接口时本地兼容运行。
更新说明
- 1.0.0 首发:大文件分片并发下载、断点续传(HTTP Range)、完整性校验(crc32 / fnv1a)、后台通知进度、Pro 闸门(>3 并发、后台通知)。