更新记录

1.0.0（2026-09-17） 下载此版本

一个把文件保存到系统的 UTS 插件。 - Android：存到系统「下载」目录，Android 10+ 走 MediaStore。 - iOS：弹出系统「存储到文件」面板，自己选位置。

平台兼容性

uni-app(5.0)

zxj-file-save

一个把文件保存到系统的 UTS 插件。

• Android：存到系统「下载」目录，Android 10+ 走 MediaStore。
• iOS：弹出系统「存储到文件」面板，自己选位置。

使用

把本目录放到 uni_modules/zxj-file-save，App 端这样调：

// #ifdef APP-PLUS
import { saveFileToDownloads } from '@/uni_modules/zxj-file-save'

saveFileToDownloads({
  filePath: tempFilePath,
  // base64: '不含 data: 前缀的 Base64',
  fileName: '报告.pdf',
  success: (res) => console.log('保存成功', res.filePath),
  fail: (err) => console.error(err.errCode, err.errMsg),
})
// #endif

filePath 和 base64 传一个就行；fileName 记得带扩展名。目前只支持 App（Android / iOS），Web、小程序和鸿蒙不行。

错误码

说明

• 无广告。
• 不采集数据、不上传任何东西。
• Android 9 及以下可能需要在 manifest 里加 WRITE_EXTERNAL_STORAGE；Android 10+ 不用，直接走 MediaStore。
• iOS 用的是系统文件选择器，不加 Info.plist 权限。

发布前记得

1. 真机测 Android 10+ 和 9 及以下两个分支。
2. iOS 试一下保存、取消、重名文件。
3. 用最新自定义基座 / 原生联编验证，UTS 原生代码改了不会跟着 wgt 一起换。
4. 发布时选「UTS 插件 / API 插件」，把 uni_modules/zxj-file-save 里的内容传上去。