【HarmonyOS NEXT】鸿蒙系统用户文件uri

最新推荐文章于 2025-06-05 14:24:06 发布

ConneyWu

最新推荐文章于 2025-06-05 14:24:06 发布

阅读量1.8k

点赞数 11

CC 4.0 BY-SA版权

分类专栏： harmony 文章标签： java 前端 harmonyos 鸿蒙 javascript

用户文件uri是文件的唯一标识，在对用户文件进行访问与修改等操作时往往都会使用到uri，不建议开发者解析uri中的片段用于业务代码开发，不同类型的uri使用方式将在下文详细介绍。

uri类型可以归纳为文档类uri和媒体文件uri两类

文档类uri：由picker拉起文件管理器选择或保存返回，以及通过fileAccess模块获取。具体获取方式参见文档类uri获取方式。
媒体文件uri：由picker通过拉起图库选择图片或者视频返回，通过photoAccessHelper模块获取图片或者视频文件的uri，以及通过userFileManager模块获取图片、视频或者音频文件的uri。具体获取方式参见媒体文件uri获取方式。

文档类uri的格式类型为：

'file://docs/storage/Users/currentUser/<relative_path>/test.txt'

其中各个字段表示的含义为：

uri字段	说明
'file://docs/storage/Users/currentUser/'	文件管理器的根目录。
'<relative_path>/'	文件在根目录下的相对路径。例如：'Download/'和'Documents/'。
'test.txt'	用户文件系统中存储的文件名，支持的文件类型为文件管理器支持的所有类型，以文件管理器为准，例如txt、jpg、mp4和mp3等格式的文件。