更新记录

1.1.0（2026-07-13） 下载此版本

Android App 文件下载插件：将内存中的文本或二进制文件写入系统「下载」目录，支持网络 URL 下载、单文件/批量导出、保存后预览打开。

平台兼容性

uni-app(5.07)

android-download

Android App 文件下载插件：将内存文本/二进制写入用户可见的系统「下载」目录，支持网络 URL 下载、单文件/批量导出及预览打开。

支持平台

安装

将 uni_modules/android-download 复制到目标项目的 uni_modules 目录。

引入

import {
  writeExportFile,
  singleExport,
  batchExport,
  isAndroidDownloadSupported,
  AndroidDownloadManager
} from '@/uni_modules/android-download/js_sdk/index.js'

API

isAndroidDownloadSupported()

检测当前是否为 Android App 环境。

writeExportFile(payload, options?)

将内存中的文件数据写入系统「下载」目录。

singleExport(payload, options?)

单文件导出；open=true 自动打开预览，open=false 弹窗提示保存路径。

batchExport(tasks, globalOptions?)

批量导出，内置并发控制。

AndroidDownloadManager

底层 Android 下载管理器：

await AndroidDownloadManager.download(url, 'file.pdf')
await AndroidDownloadManager.saveTextToFile('hello', 'test.txt')
await AndroidDownloadManager.saveBufferToFile(buffer, 'data.zip')

目录结构

uni_modules/android-download/
├── package.json
├── readme.md
├── changelog.md
└── js_sdk/
    ├── index.js
    ├── export.js
    └── androidDownload.js

注意事项

1. 需在 Android 真机/模拟器 的 App 环境运行。
2. Android 10 以下可能需要存储权限。
3. HTTP 响应解析不在插件内，业务侧自行解析后传入 payload。