diff --git a/zh-cn/application-dev/file-management/dev-user-file-manager.md b/zh-cn/application-dev/file-management/dev-user-file-manager.md index 084cb9521167ae0ed19ac0dacd914cc263d20ae6..8aef15fe41151238f88c7d18781d6e9322f8ae26 100644 --- a/zh-cn/application-dev/file-management/dev-user-file-manager.md +++ b/zh-cn/application-dev/file-management/dev-user-file-manager.md @@ -128,7 +128,7 @@ OpenHarmony预置了FileManager文件管理器。系统应用开发者也可以 // 创建文件 // 示例代码sourceUri是Download目录的fileinfo中的URI // 开发者应根据自己实际获取fileinfo的URI进行开发 - let sourceUri = "file://media/file/6"; + let sourceUri = "file://docs/storage/Users/currentUser/Download"; let displayName = "file1"; let fileUri = null; try { diff --git a/zh-cn/application-dev/reference/apis/js-apis-fileAccess.md b/zh-cn/application-dev/reference/apis/js-apis-fileAccess.md index a8fc1059a782ea024c2865797d4bfc8d77a428c8..7792224ec4e9af4c6e76feb087e80828abc5c03a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-fileAccess.md +++ b/zh-cn/application-dev/reference/apis/js-apis-fileAccess.md @@ -1,6 +1,6 @@ # @ohos.file.fileAccess (公共文件访问与管理) -fileAccess模块是基于extension机制实现的一个对公共文件访问和操作的框架。该模块一方面对接各类文件管理服务，如媒体库、外置存储管理服务等，另一方面为系统应用提供一套统一的文件访问管理接口。其中，媒体库服务提供本地设备、分布式设备等公共文件访问服务；外置存储管理服务可以提供共享盘、U盘、SD卡等设备的公共文件访问服务。 +fileAccess模块是基于extension机制实现的一个对公共文件访问和操作的框架。该模块一方面对接各类文件管理服务，如存储管理服务等，另一方面为系统应用提供一套统一的文件访问管理接口。存储管理服务可以管理内置存储部分目录，以及共享盘、U盘、SD卡等设备上的资源。 >**说明：** > @@ -124,10 +124,9 @@ createFileAccessHelper(context: Context, wants: Array<Want>) : FileAccessH createFileAccessHelper() { let fileAccessHelper = null; // wantInfos 从getFileAccessAbilityInfo()获取 - // 创建只连接媒体库服务的helper对象 let wantInfos = [ { - "bundleName": "com.ohos.medialibrary.medialibrarydata", + "bundleName": "com.ohos.UserFile.ExternalFileManager", "abilityName": "FileExtensionAbility", }, ] @@ -651,10 +650,10 @@ createFile(uri: string, displayName: string) : Promise<string> **示例：** ```js - // 以媒体库uri为例 + // 以内置存储目录为例 // 示例代码sourceUri表示Download目录，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let sourceUri = "file://media/file/6"; + let sourceUri = "file://docs/storage/Users/currentUser/Download"; let displayName = "file1" let fileUri = null; try { @@ -695,10 +694,10 @@ createFile(uri: string, displayName: string, callback: AsyncCallback<string&g **示例：** ```js - // 以媒体库uri为例 + // 以内置存储目录为例 // 示例代码sourceUri表示Download目录，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let sourceUri = "file://media/file/6"; + let sourceUri = "file://docs/storage/Users/currentUser/Download"; let displayName = "file1" try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 @@ -744,10 +743,10 @@ mkDir(parentUri: string, displayName: string) : Promise<string> **示例：** ```js - // 以媒体库uri为例 + // 以内置存储目录为例 // 示例代码sourceUri表示Download目录，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let sourceUri = "file://media/file/6"; + let sourceUri = "file://docs/storage/Users/currentUser/Download"; let dirName = "dirTest" let dirUri = null; try { @@ -788,10 +787,10 @@ mkDir(parentUri: string, displayName: string, callback: AsyncCallback<string& **示例：** ```js - // 以媒体库uri为例 + // 以内置存储目录为例 // 示例代码sourceUri表示Download目录，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let sourceUri = "file://media/file/6"; + let sourceUri = "file://docs/storage/Users/currentUser/Download"; let dirName = "dirTest" try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 @@ -837,10 +836,10 @@ openFile(uri: string, flags: OPENFLAGS) : Promise<number> **示例：** ```js - // 以媒体库uri为例 + // 以内置存储目录为例 // 示例代码targetUri表示Download目录下文件，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let targetUri = "file://media/file/100"; + let targetUri = "file://docs/storage/Users/currentUser/Download/1.txt"; try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 let fd = await fileAccessHelper.openFile(targetUri, fileAccess.OPENFLAGS.READ); @@ -874,10 +873,10 @@ openFile(uri: string, flags: OPENFLAGS, callback: AsyncCallback<number>) : **示例：** ```js - // 以媒体库uri为例 + // 以内置存储目录为例 // 示例代码targetUri表示Download目录下文件，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let targetUri = "file://media/file/100"; + let targetUri = "file://docs/storage/Users/currentUser/Download/1.txt"; try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 fileAccessHelper.openFile(targetUri, fileAccess.OPENFLAGS.READ, function (err, fd) { @@ -921,10 +920,10 @@ delete(uri: string) : Promise<number> **示例：** ```js - // 以媒体库uri为例 + // 以内置存储目录为例 // 示例代码targetUri表示Download目录下文件，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let targetUri = "file://media/file/100"; + let targetUri = "file://docs/storage/Users/currentUser/Download/1.txt"; try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 let code = await fileAccessHelper.delete(targetUri); @@ -959,10 +958,10 @@ delete(uri: string, callback: AsyncCallback<number>) : void **示例：** ```js - // 以媒体库uri为例 + // 以内置存储目录为例 // 示例代码targetUri表示Download目录下文件，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let targetUri = "file://media/file/100"; + let targetUri = "file://docs/storage/Users/currentUser/Download/1.txt"; try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 fileAccessHelper.delete(targetUri, function (err, code) { @@ -1007,11 +1006,11 @@ move(sourceFile: string, destFile: string) : Promise<string> **示例：** ```js - // 以媒体库uri为例 - // 示例代码sourceFile destFile表示Download目录下文件或文件夹，该uri是对应的fileInfo中uri + // 以内置存储目录为例 + // 示例代码sourceFile destFile表示Download目录下文件和文件夹，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let sourceFile = "file://media/file/102"; - let destFile = "file://media/file/101"; + let sourceFile = "file://docs/storage/Users/currentUser/Download/1.txt"; + let destFile = "file://docs/storage/Users/currentUser/Download/test"; try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 let fileUri = await fileAccessHelper.move(sourceFile, destFile); @@ -1046,11 +1045,11 @@ move(sourceFile: string, destFile: string, callback: AsyncCallback<string> **示例：** ```js - // 以媒体库uri为例 - // 示例代码sourceFile destFile表示Download目录下文件或文件夹，该uri是对应的fileInfo中uri + // 以内置存储目录为例 + // 示例代码sourceFile destFile表示Download目录下文件和文件夹，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let sourceFile = "file://media/file/102"; - let destFile = "file://media/file/101"; + let sourceFile = "file://docs/storage/Users/currentUser/Download/1.txt"; + let destFile = "file://docs/storage/Users/currentUser/Download/test"; try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 fileAccessHelper.move(sourceFile, destFile, function (err, fileUri) { @@ -1095,10 +1094,10 @@ rename(uri: string, displayName: string) : Promise<string> **示例：** ```js - // 以媒体库uri为例 + // 以内置存储目录为例 // 示例代码sourceDir表示Download目录下文件，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let sourceDir = "file://media/file/100"; + let sourceDir = "file://docs/storage/Users/currentUser/Download/1.txt"; try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 let DestDir = await fileAccessHelper.rename(sourceDir, "testDir"); @@ -1133,10 +1132,10 @@ rename(uri: string, displayName: string, callback: AsyncCallback<string>) **示例：** ```js - // 以媒体库uri为例 + // 以内置存储目录为例 // 示例代码sourceDir表示Download目录下文件，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let sourceDir = "file://media/file/100"; + let sourceDir = "file://docs/storage/Users/currentUser/Download/1.txt"; try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 fileAccessHelper.rename(sourceDir, "testDir", function (err, DestDir) { @@ -1180,10 +1179,10 @@ access(sourceFileUri: string) : Promise<boolean> **示例：** ```js - // 以媒体库uri为例 + // 以内置存储目录为例 // 示例代码sourceDir表示Download目录下文件，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let sourceDir = "file://media/file/100"; + let sourceDir = "file://docs/storage/Users/currentUser/Download/1.txt"; try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 let existJudgment = await fileAccessHelper.access(sourceDir); @@ -1220,10 +1219,10 @@ access(sourceFileUri: string, callback: AsyncCallback<boolean>) : void **示例：** ```js - // 以媒体库uri为例 - // 示例代码sourceDir表示Download目录下文件，该uri是对应的fileInfo中uri + // 以内置存储目录为例 + // 示例代码sourceDir表示Download目录下文件夹，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let sourceDir = "file://media/file/100"; + let sourceDir = "file://docs/storage/Users/currentUser/Download/test"; try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 fileAccessHelper.access(sourceDir, function (err, existJudgment) { @@ -1266,10 +1265,10 @@ getFileInfoFromUri(uri: string) : Promise\ **示例：** ```js - // 以媒体库uri为例 + // 以内置存储目录为例 // 示例代码sourceUri表示Download目录，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let sourceUri = "file://media/file/6"; + let sourceUri = "file://docs/storage/Users/currentUser/Download"; try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 let fileInfo = await fileAccessHelper.getFileInfoFromUri(sourceUri); @@ -1298,10 +1297,10 @@ getFileInfoFromUri(uri: string, callback: AsyncCallback\) : void **示例：** ```js - // 以媒体库uri为例 + // 以内置存储目录为例 // 示例代码sourceUri表示Download目录，该uri是对应的fileInfo中uri // 开发者应根据自己实际获取的uri进行开发 - let sourceUri = "file://media/file/6"; + let sourceUri = "file://docs/storage/Users/currentUser/Download"; try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 fileAccessHelper.getFileInfoFromUri(sourceUri, function (err, fileInfo) { @@ -1342,7 +1341,6 @@ getFileInfoFromRelativePath(relativePath: string) : Promise\ **示例：** ```js - // 以媒体库relativePath为例 // 示例代码relativePath表示Download目录，该relativePath是对应的fileInfo中relativePath // 开发者应根据自己实际获取的relativePath进行开发 let relativePath = "Download/"; @@ -1374,7 +1372,6 @@ getFileInfoFromRelativePath(relativePath: string, callback: AsyncCallback\ { @@ -1607,19 +1604,19 @@ copy(sourceUri: string, destUri: string, force: boolean, callback: AsyncCallback | 参数名 | 类型 | 必填 | 说明 | | --------- | ------------------------------------------------ | ---- | ------------------------------------------------------------ | -| sourceUri | string | 是 | 待拷贝的源文件(夹)的 uri，例如：file://media/file/102 | -| destUri | string | 是 | 目标文件夹的 uri，例如：file://media/file/101 | +| sourceUri | string | 是 | 待拷贝的源文件(夹)的 uri，例如：file://docs/storage/Users/currentUser/Download/1.txt | +| destUri | string | 是 | 目标文件夹的 uri，例如：file://docs/storage/Users/currentUser/Download/test | | force | boolean | 是 | 含有同名文件时是否强制覆盖文件，force 为 true 时强制覆盖文件，force 为空或 false 时不强制覆盖文件 | | callback | AsyncCallback<Array<[CopyResult](#copyresult10)>> | 是 | 返回 copyresult 数组，copyResult 为复制操作失败的返回信息，复制成功无返回信息 | **示例：** ```js -// 以媒体库uri为例 +// 以内置存储目录为例 // 示例代码中的sourceFile表示Download目录下的源文件(夹)，destFile表示Download目录下的目标文件夹，该uri对应fileInfo中的uri // 开发者应根据自己实际获取的uri进行开发 -let sourceFile = "file://media/file/102"; -let destFile = "file://media/file/101"; +let sourceFile = "file://docs/storage/Users/currentUser/Download/1.txt"; +let destFile = "file://docs/storage/Users/currentUser/Download/test"; try { // fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取 fileAccessHelper.copy(sourceFile, destFile, true, async (err, copyResult) => { diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.9.5/changelogs-filemanagement.md b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.9.5/changelogs-filemanagement.md index fe8a138de08225d8740733fee5a45ab96952e4b9..7e859b402b509c2778316e9e57dd5a35a249b95b 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.9.5/changelogs-filemanagement.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.9.5/changelogs-filemanagement.md @@ -1,6 +1,15 @@ # 文件管理子系统ChangeLog ## c1.filemanager.1 fileAccess 模块变更 -fileAccess 将不支持获取缩略图和媒体资源的部分查询 +1. fileAccess 将不支持获取缩略图和媒体资源的部分属性查询。 +2. uri格式发生变化，开发者无需解析具体格式。如需获取文件名、路径等属性，使用[fileuri接口](../../../application-dev/reference/apis/js-apis-file-fileuri.md)。 +3. 文件访问框架管理的资源范围发生变化，不再支持访问媒体库管理的资源。目前文件访问框架支持以下目录： +- 外部存储目录 +- Docs目录 +- Download目录 +- Desktop目录 +- Documents目录 +- Share共享盘目录 +4. 从文件访问框架获取的uri， 推荐使用[fs接口](../../../application-dev/reference/apis/js-apis-file-fs.md)打开。 **变更影响** 1. getThumbnail 接口下架