文件打开器
@capacitor-community/file-opener
电容文件打开器. 插件可以在 mimeType 和文件 uri 中打开文件 .
目录
维护者
| 维护者 | GitHub 图像 | 活动 |
|---|---|---|
| 尼亚a | 尼亚a | 对 |
关于
这个插件类似于cordova-plugin-file-opener2,但没有安装支持.
插件版本
| 电容版本 | 插件版本 |
|---|---|
| 8.x 电话 | 8.x 电话 |
| 7.x 电话 | 7.x 电话 |
| 6.x (单位:千美元) | 6.x (单位:千美元) |
| 5.x 电话 | 1.0.5 (简体中文) |
| 4.x (中文(简体) ) | 1.0.4 国家 |
安装
npm install @capacitor-community/file-opener
npx cap sync
使用量
import { FileOpener, FileOpenerOptions } from '@capacitor-community/file-opener';
try {
const fileOpenerOptions: FileOpenerOptions = {
filePath: 'file:///path/to/file',
contentType: 'application/pdf',
openWithDefault: true,
};
await FileOpener.open(fileOpenerOptions);
} catch (e) {
console.log('Error opening file', e);
}
或者请看 示例应用程序 一个完整的例子.
API 密码
打开(...)
open(options: FileOpenerOptions) => Promise<void>
打开文件的方法 .
| 参数 | 类型 |
|---|---|
options | FileOpenerOptions |
自: 1.0.0 (单位:千美元)
接口
文件打开选项
文件打开方法选项
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
filePath | string | 文件路径 | 1.0.0 (单位:千美元) |
contentType | string | MIME 类型( 可选) | 1.0.0 (单位:千美元) |
openWithDefault | boolean | 使用默认的平台选择器, 如果是真实的, 否则: On Android: 它会显示“ Open File in..” 选择器对话框的标题, 即使用户选择了默认的, 如果找不到处理文件的活动, 系统仍然会显示一个带有指定标题和错误消息的对话框 。 在 iOS 上, 应用程序无法执行此动作 : 它会提供一个菜单, 限制在能够打开当前文档的应用程序列表中 。 这种确定是基于所安装的应用程序所支持的文档类型和文档类型. 要支持一个或多个文档类型,一个app必须使用 CFBundleDocumentTypes 键在其Info.plist文件中注册这些类型. (可选)默认值为真 | 1.0.0 (单位:千美元) |
chooserPosition | { x: number; y: number; } | (仅iOS;仅iPad) 将选择者(ShareSheet)菜单锁定在视图中的位置(可选) 请注意,这只有在应用程序运行于iPad和打开With Default为虚假时才适用,否则会被忽略 | 1.0.3 (中文(简体) ) |
错误代码和含义列表
当一个错误被抛出时,将使用以下代码之一(作为字符串值).
| 代码 | 说明 |
|---|---|
| 一号 | INTERNAL_ERROR |
| 二号 | INVALID_ARGUMENT |
| 8号 | FILE_NOT_SUPPORTED |
| 9号 | FILE_NOT_FOUND |
| 10岁 | UNKNOWN |
机器人
如果您需要应用程序在外部目录中打开文件, 那么在您内部 AndroidManifest.xml 文件,修改如下:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example">
+ <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
</manifest>
iOS系统
您需要将 ios/ App/ Podfile 设置为 15 版本或更高版本( 详情请访问 见(中文(简体) )
platform :ios '15.0'
接下来 npx cap sync ios