IO模块管理本地文件系统，用于对文件系统的目录浏览、文件的读取、文件的写入等操作。通过plus.io可获取文件系统管理对象

最新推荐文章于 2025-06-06 10:16:54 发布

低吟~浅唱

最新推荐文章于 2025-06-06 10:16:54 发布

阅读量3.4k

点赞数

CC 4.0 BY-SA版权

分类专栏：编程小技能文章标签： javascript

本文链接：https://blog.csdn.net/qq_40575646/article/details/122819151

为了安全管理应用的资源目录，规范对文件系统的操作，5+ API在系统应用目录的基础设计了应用沙盒目录，分为私有目录和公共目录两种类型，私有目录仅应用自身可以访问，公共目录在多应用环境时（如小程序SDK）所有应用都可访问。

应用私有资源目录，对应常量plus.io.PRIVATE_WWW，仅应用自身可读
应用私有文档目录，对应常量plus.io.PRIVATE_DOC，仅应用自身可读写
应用公共文档目录，对应常量plus.io.PUBLIC_DOCUMENTS，多应用时都可读写，常用于保存应用间共享文件
应用公共下载目录，对应常量plus.io.PUBLIC_DOWNLOADS，多应用时都可读写，常用于保存下载文件

调用5+ API时通常需要传入文件路径，为了方便理解，分为以下类型：

相对路径URL，对应类型plus.io.RelativeURL，以“_”开头，用于访问5+ API定义的应用沙盒目录
本地绝对路径URL，对应类型plus.io.LocalURL，以“file://”开头，后面跟随系统的绝对路径，用于访问应用沙盒外的目录，如系统相册等
网络路径URL，对应类型plus.io.RemoteURL，以“http://”或“https://”开头，用于访问网络资源

常量：

PRIVATE_WWW: 应用私有资源目录常量
PRIVATE_DOC: 应用私有文档目录常量
PUBLIC_DOCUMENTS: 应用公共文档目录常量
PUBLIC_DOWNLOADS: 应用公共下载目录常量

方法：

requestFileSystem: 请求本地文件系统对象
resolveLocalFileSystemURL: 通过URL参数获取目录对象或文件对象
convertLocalFileSystemURL: 将本地URL路径转换成平台绝对路径
convertAbsoluteFileSystem: 将平台绝对路径转换成本地URL路径
getAudioInfo: 获取音频文件信息
getFileInfo: 获取文件信息
getImageInfo: 获取图片信息
getVideoInfo: 获取视频文件信息

对象：

DirectoryEntry: 文件系统中的目录对象，用于管理特定的本地目录
DirectoryReader: 读取目录信息对象，用于获取目录中包含的文件及子目录
File: 文件系统中的文件数据对象，用于获取文件的数据
FileEntry: 文件系统中的文件对象，用于管理特定的本地文件
FileReader: 文件系统中的读取文件对象，用于获取文件的内容
FileWriter: 文件系统中的写文件对象，用于写入文件内容
FileSystem: 文件系统对象，用于管理特定本地文件目录
Flags: JSON对象，获取文件操作的参数
Metadata: JSON对象，保存文件或目录的状态信息对象
FileEvent: 文件或目录操作事件对象
RelativeURL: 相对路径URL
LocalURL: 本地绝对路径URL
RemoteURL: 网络路径URL
AudioInfo: JSON对象，音频文件信息对象
FileInfo: JSON对象，文件信息对象
ImageInfo: JSON对象，图片信息对象
VideoInfo: JSON对象，视频文件信息对象

回调方法：

FileEventCallback: 文件事件回调
FileSystemSuccessCallback: 请求文件系统成功的回调函数
FileResolveSuccessCallback: 通过URL参数获取目录或文件对象成功的回调函数
MetadataSuccessCallback: 获取文件或目录状态信息成功的回调函数
EntrySuccessCallback: 操作文件或目录对象成功的回调函数
EntrysSuccessCallback: 操作文件或目录对象数组成功的回调函数
FileWriterSuccessCallback: 写文件操作成功的回调函数
FileSuccessCallback: 文件操作成功的回调函数
FileErrorCallback: 文件操作失败的回调函数
IOSuccessCallback: 成功回调函数
IOFailCallback: 失败回调函数
IOCompleteCallback: 操作完成回调函数

权限：

5+功能模块（permissions）

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#ffffff">{</span>
<span style="color:#87ceeb">// ...</span>
<span style="color:#ffa0a0">"permissions"</span><span style="color:#ffffff">:{</span>
	<span style="color:#87ceeb">// ...</span>
	<span style="color:#ffa0a0">"File"</span><span style="color:#ffffff">:</span> <span style="color:#ffffff">{</span>
		<span style="color:#ffa0a0">"description"</span><span style="color:#ffffff">:</span> <span style="color:#ffa0a0">"文件系统"</span>
	<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
			</code></span></span>

convertLocalFileSystemURL

将本地URL路径转换成平台绝对路径

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#98fb98">String</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">io</span><span style="color:#ffffff">.</span><span style="color:#ffffff">convertLocalFileSystemURL</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> url </span><span style="color:#ffffff">);</span>
				</code></span></span>

说明：

绝对路径符合各平台文件路径格式，通常用于Native.JS调用系统原生文件操作API，也可以在前面添加“file://”后在html页面中直接使用。

参数：

url: ( String ) 必选 要转换的文件或目录URL地址
URL地址必须是合法的路径，如果地址不合法则返回null。

返回值：

String : 转换后在平台路径，在不同平台或者不同设备返回的值可能存在差异，如输入url为“_doc/a.png”： Android平台转换后的路径为“/storage/sdcard0/Android/data/io.dcloud.HBuilder/.HBuilder/apps/HBuilder/doc/ａ.png”；在iOS平台转换后的路径为“/var/mobile/Containers/Data/Application/757966CF-345C-4348-B07F-EEF83CF9A369/Library/Pandora/apps/HBuilder/doc/a.png”。

示例：

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span>
	<span style="color:#f0e68c"><strong><head></strong></span>
	<span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span>
	<span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">File Example</span><span style="color:#f0e68c"><strong></title></strong></span>
	<span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#87ceeb">// 扩展API加载完毕后调用onPlusReady回调函数 </span><span style="color:#ffffff">
document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"plusready"</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> onPlusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>false</strong></span> <span style="color:#ffffff">);</span>
<span style="color:#87ceeb">// 扩展API加载完毕，现在可以正常调用扩展API</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> onPlusReady</span><span style="color:#ffffff">(){</span>
	<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> url</span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"_www/index.html"</span><span style="color:#ffffff">;</span>
	<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> path</span><span style="color:#ffffff">=</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">io</span><span style="color:#ffffff">.</span><span style="color:#ffffff">convertLocalFileSystemURL</span><span style="color:#ffffff">(</span><span style="color:#ffffff">url</span><span style="color:#ffffff">);</span><span style="color:#ffffff">
	alert</span><span style="color:#ffffff">(</span><span style="color:#ffffff">path</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
	<span style="color:#f0e68c"><strong></script></strong></span>
	<span style="color:#f0e68c"><strong></head></strong></span>
	<span style="color:#f0e68c"><strong><body></strong></span><span style="color:#ffffff">
		convertLocalFileSystemURL
	</span><span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span>
				</code></span></span>

uni-app使用plus注意事项

convertAbsoluteFileSystem

将平台绝对路径转换成本地URL路径

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#98fb98">String</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">io</span><span style="color:#ffffff">.</span><span style="color:#ffffff">convertAbsoluteFileSystem</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> path </span><span style="color:#ffffff">);</sp