更新记录

1.1.15（2026-04-18）

• 优化 iOS 文件类型前置过滤：accept 到 UTI 的映射由“单值”升级为“多值集合”策略，补充 zip/rar 的兼容 UTI（如 com.pkware.zip-archive、public.archive），提升系统文件选择器命中率。
• 优化 iOS accept 解析去重逻辑：新增 appendUti 统一去重追加，避免重复 UTI 造成的过滤冗余。
• 修复 UTS 编译兼容细节：多处数组累加变量由 const 调整为 let，降低跨端桥接和编译阶段的可变集合处理风险。

1.1.14（2026-04-14）

• 修复 iOS 云打包编译失败：移除 toPickFilesOptions 中对 Any 的动态属性访问写法（obj.accept / obj.multiple / obj.maxCount / obj.maxSize / obj.filename / obj.success / obj.fail / obj.complete），避免 Swift 侧出现 value of type 'Any' has no member ... 编译错误。
• 修复 iOS 云打包编译失败：单文件包装链路中对 files[0] 显式收敛为 PickedFile，修复 cannot convert value of type 'Any?' to expected argument type 'PickedFile?'。
• 调整 pickFiles 桥接类型兼容策略：对外参数维持桥接可用性（PickFiles 放宽为 any），并统一多端单文件包装中的 files 回调形参为 Array<any>，降低 byJs 代理层类型不一致导致的崩溃风险。

1.1.3（2026-04-10）

• 修复 iOS 原生文件选择器主线程调用问题：pickFile/pickFiles 统一通过主线程调度拉起 UIDocumentPickerViewController，避免 Call must be made on main thread 异常。
• 修复 iOS 单文件选择稳定性问题：调整单文件桥接回调与参数归一化路径，避免运行时强制类型转换导致的闪退。
• 修复 iOS 多文件选择稳定性问题：优化 didPickDocumentsAt 回调处理，直接构建 PickedFile[] 返回，降低多文件场景崩溃风险。
• 修复 iOS 编译兼容问题：将控制器遍历与展示逻辑改为强类型 UIViewController，避免 Any 无成员导致的云打包编译失败。

平台兼容性

uni-app(4.84)

uni-app x(4.84)

lizhao-choose-file

lizhao-choose-file 是纯 UTS 文件选择 API 插件，统一通过 UTS 对外暴露 pickFiles 与 pickFile，支持 uni-app 与 uni-app x 多端调用。

支持平台

安装说明

import * as LizhaoChooseFile from '@/uni_modules/lizhao-choose-file'

说明：本插件为 API 插件，不提供 <lizhao-choose-file /> 组件标签。

目录结构说明

uni_modules/
└─ lizhao-choose-file/
   ├─ package.json
   ├─ readme.md
   ├─ changelog.md
   ├─ example/
   └─ utssdk/
      ├─ interface.uts
      ├─ unierror.uts
      ├─ index.uts
      ├─ common/
      │  └─ picker-core.uts
      ├─ app-android/
      │  └─ index.uts
      ├─ app-ios/
      │  └─ index.uts
      ├─ app-harmony/
      │  └─ index.uts
      ├─ web/
      │  └─ index.uts
      ├─ mp-weixin/
      │  └─ index.uts
      └─ mp-alipay/
         └─ index.uts

API 列表

• pickFiles(options)
• pickFile(options)

pickFiles(options)

说明 选择多个文件并返回统一文件结构。

支持平台 Android / iOS / Harmony / Web / 微信小程序 / 支付宝小程序

参数

返回值

pickFile(options)

说明 选择单个文件，成功回调返回 PickedFile | null。

支持平台 Android / iOS / Harmony / Web / 微信小程序 / 支付宝小程序

参数

错误码说明

权限说明

自定义基座说明

• 当前版本未接入三方原生 SDK。
• 当前版本未新增 Android/iOS 原生依赖与特殊清单配置。
• 常规使用无需自定义基座。

示例（uni-app）

import * as LizhaoChooseFile from '@/uni_modules/lizhao-choose-file'

LizhaoChooseFile.pickFiles({
  accept: '.pdf,.doc,.docx,image/*',
  multiple: true,
  maxCount: 3,
  maxSize: 10 * 1024 * 1024,
  filename: 'upload-file',
  success(files) {
    console.log('pickFiles success', files)
  },
  fail(err) {
    console.error('pickFiles fail', err)
  }
})

示例（uni-app x）

import * as LizhaoChooseFile from '@/uni_modules/lizhao-choose-file'

LizhaoChooseFile.pickFile({
  accept: '.pdf,.docx',
  maxSize: 5 * 1024 * 1024,
  success(file) {
    console.log('pickFile success', file)
  },
  fail(err) {
    console.error('pickFile fail', err)
  }
})

注意事项

1. 页面销毁前若仍有文件选择流程，建议在业务侧避免重复触发。
2. 小程序与 Web 的文件路径通常是临时路径，不保证长期可用。
3. filename 只改返回结果中的 name/ext，不会修改用户原始文件本体。