@capgo/capacitor文件

Capacitor 文件插件

概述

Capacitor 文件插件

- 请求文件系统

requestFileSystem - 获取文件入口
resolveLocalFileSystemURL - 将文件 URL 解析为入口。
getFile 开始使用
getDirectory - 获取一个目录项。

Public API

方法	描述
`requestFileSystem`	请求一个文件系统。
`resolveLocalFileSystemURL`	将一个文件 URL 解析为一个项。
`getFile`	获取一个文件项。
`getDirectory`	获取一个目录项。
`readFile`	以文本或 base64 格式读取一个文件。
`readAsDataURL`	以 base64 格式（带 MIME 类型前缀）读取一个文件。
`writeFile`	将数据写入一个文件。
`appendFile`	添加文件内容。
`deleteFile`	删除文件。
`mkdir`	创建目录。
`rmdir`	删除目录。
`readdir`	读取目录内容。
`stat`	获取文件或目录的元数据。
`getMetadata`	获取文件或目录的元数据。stat()的别名。
`rename`	重命名或移动文件或目录。
`move`	移动文件或目录。rename()的别名。
`copy`	复制文件或目录。
`exists`	检查文件或目录是否存在。
`getUri`	获取文件的 URI。
`truncate`	简化文件大小。
`getDirectories`	获取已知的文件系统目录。
`getFreeDiskSpace`	获取可用磁盘空间（以字节为单位）。
`addListener`	监听读取进度事件。
`addListener`	监听写入进度事件。
`removeAllListeners`	移除所有事件监听器。
`getPluginVersion`	获取插件版本。
`checkPermissions`	检查当前文件操作权限状态。Android 上检查外部存储权限，iOS 和 web 上始终返回 '已授权'，因为不需要特殊权限。
`requestPermissions`	请求文件操作权限。Android 上请求外部存储权限，以便访问应用私有目录外的文件。iOS 和 web 上始终返回 '已授权'，因为不需要特殊权限。

参考值

在选择存储位置、编码文本或处理文件错误时使用这些值。

值	用户会发现
`DOCUMENTS`	持久的用户可见文档。在 Android 上，这映射到应用程序文件目录。
`DATA`	持久的私有应用程序数据。
`LIBRARY`	持久的应用程序数据，不可见于用户。在 Android 上，这映射到应用程序文件目录。
`CACHE`	操作系统可能清除的临时缓存数据。
`EXTERNAL`	Android外部存储根目录，例如SD卡或共享外部存储。
`EXTERNAL_STORAGE`	Android外部存储数据目录。
`APPLICATION`	只读的应用程序包或资产目录。

编码

Value	Use
`utf8`	UTF-8 文本.
`ascii`	ASCII 文本.
`utf16`	UTF-16 文本.

文件错误代码

Value	Code	含义
`NOT_FOUND_ERR`	`1`	找不到文件或目录。
`SECURITY_ERR`	`2`	操作被安全规则或权限阻止。
`ABORT_ERR`	`3`	操作被中止。
`NOT_READABLE_ERR`	`4`	无法读取文件或目录。
`ENCODING_ERR`	`5`	编码无效或不受支持。
`NO_MODIFICATION_ALLOWED_ERR`	`6`	目标无法修改。
`INVALID_STATE_ERR`	`7`	对象状态无效，无法执行此操作。
`SYNTAX_ERR`	`8`	路径或输入语法无效。
`INVALID_MODIFICATION_ERR`	`9`	请求的更改与目标无效。
`QUOTA_EXCEEDED_ERR`	`10`	存储配额已超出。
`TYPE_MISMATCH_ERR`	`11`	值类型与预期类型不符。
`PATH_EXISTS_ERR`	`12`	目标路径已存在。

真实来源

此参考资料是从 src/definitions.ts 在 capacitor文件.

继续从@capgo/capacitor文件

如果您正在使用 @capgo/capacitor文件 来规划存储和文件处理，连接它使用@capgo/capacitor文件为使用@capgo/capacitor文件的本机功能 @capgo/capacitor-sqlite-数据存储为 @capgo/capacitor-data-storage-sqlite 的实现细节使用 @capgo/capacitor-data-storage-sqlite 为 @capgo/capacitor-data-storage-sqlite 的本机能力 @capgo/capacitor-上传器为 @capgo/capacitor-uploader 的实现细节, 和使用 @capgo/capacitor-uploader 为 @capgo/capacitor-uploader 的本机能力