更新记录

1.0.0（2026-04-14）

1. 新增 Android / iOS 外部文件导入插件
2. 支持从系统共享、用其他应用打开导入文件
3. 支持复制到应用缓存目录并返回稳定路径
4. 返回文件名、大小、后缀、MIME、来源信息
5. 新增 Demo 页面与使用文档

平台兼容性

uni-app(4.75)

uni-app x(4.75)

austin-import-files

austin-import-files 是一个 App 外部文件导入 UTS 插件，兼容 Android / iOS 实现。

它解决的不是“我自己在 App 里选文件”，而是“别的 App 已经有文件了，用户要把文件直接导进我的 App”。

典型场景：

• 微信里收到 PDF / Word / Excel，选择“用其他应用打开”，导入你的 App
• iPhone 文件 App 或 Android 文件管理器里已有文件，直接共享到你的 App
• Safari / 浏览器下载的合同、课件、压缩包，直接用你的 App 打开
• 邮件附件、钉钉、飞书、企业微信文档，直接导入你的资料库

点击试用插件

当前目录下的 index.vue 是完整模板页，点击试用后包含：

• 当前平台能力展示
• 当前待处理导入数量
• 导入到应用缓存目录开关
• 调用 consumePendingImportFiles
• 导入后用 uni.openDocument 预览

功能

• 支持 Android / iOS 通过系统共享或“用其他应用打开”导入文件
• Android 支持单文件和多文件导入
• iOS 当前首版按单文件导入为主
• 支持复制到应用缓存目录
• 返回统一文件信息

优势

• 不只返回原始 uri，会尽量转成业务侧更容易继续处理的稳定路径
• Android 导入时会优先复制到应用缓存，避免第三方 content:// 授权过期后无法继续读取
• 返回结构统一，直接给出 path、nativePath、name、size、ext、mimeType、sourceApp
• 更适合做上传、归档、解析、附件接入；插件核心是“把文件稳定导入 App”

接入说明

这个插件依赖系统注册能力，所以你安装后需要打自定义基座，让：

• Android 的 AndroidManifest.xml
• iOS 的 Info.plist

生效后，系统共享列表或“用其他应用打开”里才能出现你的 App。

API

getImportFilesCapabilities()

返回当前平台能力对象。

hasPendingImportFiles()

返回当前是否有待处理导入文件。

getPendingImportCount()

返回当前待处理导入文件数量。

consumePendingImportFiles(options?)

参数配置

clearPendingImportFiles()

清空当前待处理导入记录。

返回结果

单个文件项

完整结果

最小示例

import {
  getPendingImportCount,
  consumePendingImportFiles,
} from '@/uni_modules/austin-import-files'

const pendingCount = getPendingImportCount()

if (pendingCount > 0) {
  const res = consumePendingImportFiles({
    copyToCache: true,
  })
  console.log('import-files-result', res)
}

注意

• 这是“外部文件导入到 App”，不是普通文件选择器
• Android / iOS 的系统入口名字不完全相同，常见为“共享”、“用其他应用打开”、“拷贝到”
• 安装插件后需要重新运行或重新打包，系统注册信息才会生效
• 插件重点是“导入并返回稳定路径”；是否预览、如何预览，取决于文件类型和你的业务处理方式