Skip to content

D
Docs

OpenHarmony / Docs
大约 1 年 前同步成功

通知 159
Star 292
Fork 28
D
Docs

体验新版 GitCode，发现更多精彩内容 >>

提交 1d6177a2 编写于 作者: Y yxn
浏览文件
操作

改掉里面media媒体库相关的字段 

Signed-off-by: Nyxn <yexinnian2@huawei.com>
上级 b3ca8ada
隐藏空白更改
内联 并排
Showing with 70 addition and 64 deletion
zh-cn/application-dev/file-management/dev-user-file-manager.md
浏览文件 @ 1d6177a2
......@@ -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 {
......
zh-cn/application-dev/reference/apis/js-apis-fileAccess.md
浏览文件 @ 1d6177a2
# @ohos.file.fileAccess (公共文件访问与管理)
fileAccess模块是基于extension机制实现的一个对公共文件访问和操作的框架。该模块一方面对接各类文件管理服务，如媒体库、外置存储管理服务等，另一方面为系统应用提供一套统一的文件访问管理接口。其中，媒体库服务提供本地设备、分布式设备等公共文件访问服务；外置存储管理服务可以提供共享盘、U盘、SD卡等设备的公共文件访问服务。
fileAccess模块是基于extension机制实现的一个对公共文件访问和操作的框架。该模块一方面对接各类文件管理服务，如存储管理服务等，另一方面为系统应用提供一套统一的文件访问管理接口。存储管理服务可以管理内置存储部分目录，以及共享盘、U盘、SD卡等设备上的资源。
>**说明：**
>
......@@ -124,10 +124,9 @@ createFileAccessHelper(context: Context, wants: Array&lt;Want&gt;) : 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&lt;string&gt;
**示例：**
```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&lt;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&lt;string&gt;
**示例：**
```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&lt;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&lt;number&gt;
**示例：**
```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&lt;number&gt;) :
**示例：**
```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&lt;number&gt;
**示例：**
```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&lt;number&gt;) : 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&lt;string&gt;
**示例：**
```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&lt;string&gt;
**示例：**
```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&lt;string&gt;
**示例：**
```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&lt;string&gt;)
**示例：**
```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&lt;boolean&gt;
**示例：**
```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&lt;boolean&gt;) : 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\<FileInfo>
**示例：**
```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\<FileInfo>) : 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\<FileInfo>
**示例：**
```js
// 以媒体库relativePath为例
// 示例代码relativePath表示Download目录，该relativePath是对应的fileInfo中relativePath
// 开发者应根据自己实际获取的relativePath进行开发
let relativePath = "Download/";
......@@ -1374,7 +1372,6 @@ getFileInfoFromRelativePath(relativePath: string, callback: AsyncCallback\<FileI
**示例：**
```js
// 以媒体库relativePath为例
// 示例代码relativePath表示Download目录，该relativePath是对应的fileInfo中relativePath
// 开发者应根据自己实际获取的relativePath进行开发
let relativePath = "Download/";
......@@ -1418,7 +1415,7 @@ query(uri:string, metaJson: string) : Promise&lt;string&gt;
**示例：**
```js
var imageFileRelativePath = "Download/queryTest/image/01.jpg";
var imageFileRelativePath = "/storage/Users/currentUser/Download/queryTest/image/01.jpg";
var jsonStrSingleRelativepath = JSON.stringify({ [fileAccess.FileKey.RELATIVE_PATH]: "" });
try {
// fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取
......@@ -1451,7 +1448,7 @@ query(uri:string, metaJson: string, callback: AsyncCallback&lt;string&gt;) : voi
**示例：**
```js
var imageFileRelativePath = "Download/queryTest/image/01.jpg";
var imageFileRelativePath = "/storage/Users/currentUser/Download/queryTest/image/01.jpg";
var jsonStrSingleRelativepath = JSON.stringify({ [fileAccess.FileKey.RELATIVE_PATH]: "" });
try {
// fileAccessHelper 参考 fileAccess.createFileAccessHelper 示例代码获取
......@@ -1482,8 +1479,8 @@ copy(sourceUri: string, destUri: string, force?: boolean) : Promise&lt;Array&lt;
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------- | ---- | ------------------------------------------------------------ |
| 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 时不强制覆盖文件 |
**返回值：**
......@@ -1495,11 +1492,11 @@ copy(sourceUri: string, destUri: string, force?: boolean) : Promise&lt;Array&lt;
**示例 1：force 为空**
```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 示例代码获取
let copyResult = await fileAccessHelper.copy(sourceFile, destFile);
......@@ -1521,11 +1518,11 @@ try {
**示例 2：force 为 true**
```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 示例代码获取
let copyResult = await fileAccessHelper.copy(sourceFile, destFile, true);
......@@ -1558,18 +1555,18 @@ copy(sourceUri: string, destUri: string, callback: AsyncCallback&lt;Array&lt;Cop
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------------------------------------ | ---- | ------------------------------------------------------------ |
| 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 |
| callback | AsyncCallback&lt;Array&lt;[CopyResult](#copyresult10)&gt;&gt; | 是 | 返回 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, async (err, copyResult) => {
......@@ -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&lt;Array&lt;[CopyResult](#copyresult10)&gt;&gt; | 是 | 返回 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) => {
......
zh-cn/release-notes/changelogs/OpenHarmony_4.0.9.5/changelogs-filemanagement.md
浏览文件 @ 1d6177a2
# 文件管理子系统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 接口下架
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或