更新记录

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 线程)。

安装

  1. 在 DCloud 插件市场 搜索 zl-bigdown 导入 uni_modules。
  2. 在 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 并发、后台通知)。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

网络访问权限(下载文件)与本地存储权限(写入下载文件)。权限用途与数据采集说明见插件文档。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

本插件仅下载用户主动指定的远程文件到本机沙盒,不读取、不上传、不收集任何用户隐私数据;下载链接由接入方自行提供。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。