From 007e6f6a0e2411e6af6788bc5b2271d908180aac Mon Sep 17 00:00:00 2001 From: wangbo Date: Fri, 10 Jun 2022 16:04:58 +0800 Subject: [PATCH] =?UTF-8?q?=E7=9B=B8=E5=85=B3md=E6=96=87=E4=BB=B6=E4=BF=AE?= =?UTF-8?q?=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: wangbo --- .../reference/apis/js-apis-fileio.md | 10 ++----- .../reference/apis/js-apis-filemanager.md | 18 ++++++++---- .../reference/apis/js-apis-statfs.md | 29 ++++++++----------- .../reference/apis/js-apis-system-file.md | 2 +- .../reference/apis/js-apis-volumemanager.md | 2 +- 5 files changed, 28 insertions(+), 33 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-fileio.md b/zh-cn/application-dev/reference/apis/js-apis-fileio.md index f962577a5d..466a2c3736 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-fileio.md +++ b/zh-cn/application-dev/reference/apis/js-apis-fileio.md @@ -3,13 +3,7 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 -该模块提供文件存储管理能力，包括文件基本管理、文件目录管理、文件信息统计、文件流式读取等常用功能，向应用程序提供用于IO的JS接口，包括: - -- 用于管理文件的基本文件接口 -- 用于管理目录的基本目录接口 -- 用于获取文件信息的统计接口 -- 用于流式读写文件的流式接口 - +该模块提供文件存储管理能力，包括文件基本管理、文件目录管理、文件信息统计、文件流式读取等常用功能。 ## 导入模块 @@ -1192,7 +1186,7 @@ ftruncate(fd: number, len: number, callback:AsyncCallback<void>): void | -------- | ------------------------- | ---- | ---------------- | | fd | number | 是 | 待截断文件的文件描述符。 | | len | number | 是 | 文件截断后的长度，以字节为单位。 | - | callback | AsyncCallback<void> | 是 | 回调函数，本调用无返回值 | + | callback | AsyncCallback<void> | 是 | 回调函数，本调用无返回值。 | **示例：** ```js diff --git a/zh-cn/application-dev/reference/apis/js-apis-filemanager.md b/zh-cn/application-dev/reference/apis/js-apis-filemanager.md index a17aa78769..67bcaa59ea 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-filemanager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-filemanager.md @@ -63,13 +63,19 @@ getRoot(options? : {dev? : DevInfo}, callback : AsyncCallback<FileInfo[]>) - 示例 ```js - filemanager.getRoot((err, fileInfo) => { - if(Array.isArray(fileInfo)) { + let option = { + "dev":{ + name:"", + } + }; + filemanager.getRoot(option,(err, fileInfo)=>{ + if(Array.isArray(fileInfo)) { for (var i = 0; i < fileInfo.length; i++) { console.log("file:"+JSON.stringify(fileInfo)); } - } - }); + } + }); + ``` ## filemanager.listFile @@ -105,7 +111,7 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num ```js // 获取目录下所有文件 // 通过listFile、getRoot获取的文件uri - let media_path = file.uri + let media_path = file.path filemanager.listFile(media_path, "file") .then((fileInfo) => { if(Array.isArray(fileInfo)) { @@ -230,7 +236,7 @@ createFile(path : string, filename: string, options? : {dev? : DevInfo}, callbac ```js // 创建文件，返回文件uri // 通过listFile、getRoot获取的文件uri - let media_path = file.uri + let media_path = file.path // 待保存文件的后缀 let name = "xxx.jpg" filemanager.createFile(media_path, name, (err, uri) => { diff --git a/zh-cn/application-dev/reference/apis/js-apis-statfs.md b/zh-cn/application-dev/reference/apis/js-apis-statfs.md index af6d89fa86..d213902e4c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-statfs.md +++ b/zh-cn/application-dev/reference/apis/js-apis-statfs.md @@ -10,19 +10,6 @@ ```js import statfs from '@ohos.statfs'; ``` - -## 使用说明 - -使用该功能模块对文件/目录进行操作前，需要先获取其应用沙箱路径，获取方式及其接口用法请参考：[Context模块的接口getOrCreateLocalDir](js-apis-Context.md)。 - -“文件/目录的应用沙箱路径”=“应用目录路径”+“文件/目录名” - -通过上述接口获取到应用目录路径dir，以文件名“xxx.txt”为例，文件所在的应用沙箱路径为： - -```js -let path = dir + "xxx.txt"; -``` - ## statfs.getFreeBytes getFreeBytes(path:string):Promise<number> @@ -72,8 +59,12 @@ getFreeBytes(path:string, callback:AsyncCallback<number>): void - 示例： ```js - statfs.getFreeBytes(path, function(err, number){ - console.info("getFreeBytes callback successfully:"+ number); + import featureAbility from '@ohos.ability.featureAbility'; + let context = featureAbility.getContext(); + context.getFilesDir().then(function (path) { + statfs.getFreeBytes(path, function(err, number){ + console.info("getFreeBytes callback successfully:"+ number); + }); }); ``` @@ -126,8 +117,12 @@ getTotalBytes(path: string, callback: AsyncCallback<number>): void - 示例： ```js - statfs.getTotalBytes(path, function(err, number){ - console.info("getTotalBytes callback successfully:"+ number); + import featureAbility from '@ohos.ability.featureAbility'; + let context = featureAbility.getContext(); + context.getFilesDir().then(function (path) { + statfs.getTotalBytes(path, function(err, number){ + console.info("getTotalBytes callback successfully:"+ number); + }); }); ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-file.md b/zh-cn/application-dev/reference/apis/js-apis-system-file.md index a54f285181..20943aa085 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-file.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-file.md @@ -154,7 +154,7 @@ export default { file.list({ uri: 'internal://app/pic', success: function(data) { - console.log(data.fileList); + console.log(JSON.stringify(data.fileList)); }, fail: function(data, code) { console.error('call fail callback fail, code: ' + code + ', data: ' + data); diff --git a/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md b/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md index 9e0aac9d02..d08b879007 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-volumemanager.md @@ -54,7 +54,7 @@ getAllVolumes(callback: AsyncCallback<Array<Volume>>): void ```js let uuid = ""; - volumemanager.getAllVolumes(uuid, function(error, volumes){ + volumemanager.getAllVolumes(function(error, volumes){ // do something }); ``` -- GitLab