!5602 【翻译完成】#I5CCR5

Merge pull request !5602 from Annie_wang/PR5207

en/application-dev/reference/apis/js-apis-filemanager.md

@@ -63,13 +63,19 @@ Obtains information about the root album or directory in asynchronous mode. This
 - Example
 
   ```js
-  filemanager.getRoot((err, 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 @@ Obtains information about the second-level album or files in asynchronous mode.
   ```js
   // Obtain all files in the directory.
   // Call listFile() and getRoot() to obtain the file URI.
-  let media_path = file.uri
+  let media_path = file.path
   filemanager.listFile(media_path, "file")
   .then((fileInfo) => {
       if(Array.isArray(fileInfo)) {
@@ -114,10 +120,13 @@ Obtains information about the second-level album or files in asynchronous mode.
           }
       }
   }).catch((err) => {
-      console.log(err)
-  });
+     
+	  console.log(err)
+  });  
   ```
 
+  
+
 ## filemanager.listFile
 
 listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : number, count? : number}, callback : AsyncCallback&lt;FileInfo[]&gt;) : void
@@ -130,8 +139,8 @@ Obtains information about the second-level album or files in asynchronous mode.
 
   | Name  | Type                     | Mandatory| Description                                                        |
   | -------- | ------------------------- | ---- | ------------------------------------------------------------ |
-  | path     | string                   | Yes  | URI of the directory to query.                                               |
-  | type     | string                   | Yes  | Type of the files to query. The file type can be **file**, **image**, **audio**, or **video**.|
+  | path     | string                    | Yes  | URI of the directory to query.                                               |
+  | type     | string                    | Yes  | Type of the files to query. The file type can be **file**, **image**, **audio**, or **video**.|
   | options | Object | No| The options are as follows:<br>- &nbsp;**dev**: See [DevInfo](#devinfo). It is **dev = {name: "local"}** by default if not specified. Currently, only 'local' is supported.<br>- &nbsp;**offset**: position to start the query. The value is a number.<br>- &nbsp;**count**: number of files to query.|
   | callback | AsyncCallback&lt;[FileInfo](#fileinfo)[]&gt; | Yes  | Callback invoked to return the file information obtained.                                |
 - Error
@@ -145,14 +154,30 @@ Obtains information about the second-level album or files in asynchronous mode.
 - Example
 
   ```js
-  // Call listFile() and getRoot() to obtain the file URI.
-  let media_path = file.uri
-  filemanager.listFile(media_path, "file", (err, fileInfo) => {
-      if(Array.isArray(fileInfo)) {
-          for (var i = 0; i < fileInfo.length; i++) {
-              console.log("file:"+JSON.stringify(fileInfo));
-          }
-      }
+  // Call listFile() and getRoot() to obtain the file path.
+  let fileInfos = await filemanager.getRoot(); 
+  let media_path  = "";
+  for (let i = 0; i < fileInfos.length; i++) {
+	if (fileInfos[i].name == "image_album") {
+	  media_path = fileInfos[i].path;
+	} else if (fileInfos[i].name == "audio_album") {
+	  media_path = fileInfos[i].path;
+	} else if (fileInfos[i].name == "video_album") {
+	  media_path = fileInfos[i].path;
+	} else if (fileInfos[i].name == "file_folder") {
+	  media_path = fileInfos[i].path;
+	}
+  }
+
+  filemanager.listFile(media_path, "file")
+  .then((fileInfo) => {
+    if(Array.isArray(fileInfo)) {
+        for (var i = 0; i < fileInfo.length; i++) {
+            console.log("file:"+JSON.stringify(fileInfo));
+        }
+    }
+  }).catch((err) => {
+    console.log(err)
   });
   ```
 
@@ -211,8 +236,8 @@ Creates a file in the specified path in asynchronous mode. This API uses a callb
 
   | Name  | Type                     | Mandatory| Description                         |
   | -------- | ------------------------- | ---- | ----------------------------- |
-  | filename | string                   | Yes  | Name of the file to create.               |
-  | path     | string                   | Yes  | URI of the file to create.            |
+  | filename | string                    | Yes  | Name of the file to create.               |
+  | path     | string                    | Yes  | URI of the file to create.            |
   | options | Object | No| The options are as follows:<br>- &nbsp;**dev**: See [DevInfo](#devinfo). It is **dev = {name: "local"}** by default if not specified. Currently, only 'local' is supported.|
   | callback | AsyncCallback&lt;[FileInfo](#fileinfo)[]&gt; | Yes  | Callback invoked to return the file information obtained. |
 
@@ -230,7 +255,7 @@ Creates a file in the specified path in asynchronous mode. This API uses a callb
   ```js
   // Create a file.
   // Call listFile() and getRoot() to obtain the file URI.
-  let media_path = file.uri
+  let media_path = file.path
   // File to be saved.
   let name = "xxx.jpg"
   filemanager.createFile(media_path, name, (err, uri) => {

en/application-dev/reference/apis/js-apis-statfs.md

 # statfs
 
-> **NOTE**<br>
+> **NOTE:**<br>
 > The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
-This module provides information related to the file system. It provides JS APIs to obtain the total number of bytes and the number of idle bytes of the file system.
+Obtains file system information, including the total number of bytes and the number of idle bytes of the file system.
 
 ## Modules to Import
 
 ```js
 import statfs from '@ohos.statfs';
 ```
-
-## Guidelines
-
-Before using the APIs provided by this module to perform operations on a file or directory, obtain the path of the application sandbox. For details, see [getOrCreateLocalDir of the Context module](js-apis-Context.md).
-
-Application sandbox path of a file or directory = Application directory + File name or directory name
-
-For example, if the application directory obtained by using **getOrCreateLocalDir** is **dir** and the file name is **xxx.txt**, the application sandbox path of the file is as follows:
-
-```js
-let path = dir + "xxx.txt";
-```
-
 ## statfs.getFreeBytes
 
 getFreeBytes(path:string):Promise&lt;number&gt;
@@ -72,8 +59,12 @@ Obtains the number of free bytes of the specified file system in asynchronous mo
 - Example
 
   ```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,7 +117,11 @@ Obtains the total number of bytes of the specified file system in asynchronous m
 - Example
 
   ```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);
+      });
   });
   ```

en/application-dev/reference/apis/js-apis-system-cipher.md

@@ -25,11 +25,11 @@ Encrypts or decrypts data using RSA.
 
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| action | string | Yes| Action to perform. The options are as follows:<br>-&nbsp;encrypt<br>-&nbsp;decrypt|
-| text | string | Yes| Text to be encrypted or decrypted.<br> The text to be encrypted must be common text that meets the following requirement:<br> Maximum text length = Key length/8 - 66<br>For example, if the key is of 1024 bytes, the text to be encrypted cannot exceed 62 bytes (1024/8 -66 = 62).<br> The text to be decrypted must be binary text encoded in Base64. The default format is used for Base64 encoding.|
+| action | string | Yes| Action to perform. The options are as follows:<br>-&nbsp;encrypt<br/>-&nbsp;decrypt|
+| text   | string | Yes| Text to be encrypted or decrypted.<br> The text to be encrypted must be common text that meets the following requirement:<br> Maximum text length = Key length/8 - 66<br>For example, if the key is of 1024 bytes, the text to be encrypted cannot exceed 62 bytes (1024/8 -66 = 62).<br> The text to be decrypted must be binary text encoded in Base64. The default format is used for Base64 encoding.|
 | key | string | Yes| RSA key. The key is used as a public key in encryption and a private key in decryption.|
 | transformation | string | No| RSA padding. The default value is **RSA/None/OAEPWithSHA256AndMGF1Padding**.|
-| success | Function | No| Called when data is encrypted or decrypted successful.|
+| success | Function | No| Called when data is encrypted or decrypted successfully.|
 | fail | Function | No| Called when data fails to be encrypted or decrypted.|
 | complete | Function | No| Called when the execution is complete.|
 
@@ -104,14 +104,14 @@ Encrypts or decrypts data using AES.
 
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| action | string | Yes| Action to perform. The options are as follows:<br>-&nbsp;encrypt<br>-&nbsp;decrypt|
-| text | string | Yes| Text to be encrypted or decrypted.<br> The text to be encrypted must be common text. The text to be decrypted must be binary text encoded in Base64. The default format is used for Base64 encoding.|
+| action | string | Yes| Action to perform. The options are as follows:<br>-&nbsp;encrypt<br/>-&nbsp;decrypt|
+| text   | string | Yes| Text to be encrypted or decrypted.<br> The text to be encrypted must be common text. The text to be decrypted must be binary text encoded in Base64. The default format is used for Base64 encoding.|
 | key | string | Yes| Key used for encryption or decryption. It is a string encoded in Base64.|
 | transformation | string | No| Encryption mode and padding of the AES algorithm. The default value is **AES/CBC/PKCS5Padding**.|
 | iv | string | No| Initialization vector (IV) for AES-based encryption and decryption. The value is a string encoded in Base64. The default value is the key value.|
 | ivOffset | string | No| Offset of the IV for AES-based encryption and decryption. The default value is **0**.|
 | ivLen | string | No| Length of the IV for AES-based encryption and decryption, in bytes. The default value is **16**.|
-| success | Function | No| Called when data is encrypted or decrypted successful.|
+| success | Function | No| Called when data is encrypted or decrypted successfully.|
 | fail | Function | No| Called when data fails to be encrypted or decrypted.|
 | complete | Function | No| Called when the execution is complete.|
 

en/application-dev/reference/apis/js-apis-volumemanager.md

@@ -6,7 +6,7 @@
 > - API version 9 is a canary version for trial use. The APIs of this version may be unstable.
 > - The APIs of this module are system APIs and cannot be called by third-party applications.
 
-This module provides APIs to implement volume and disk management, including obtaining volume information, mounting and unmounting volumes, partitioning disks, and formatting volumes.
+Performs volume and disk management, including obtaining volume information, mounting and unmounting volumes, partitioning disks, and formatting volumes.
 
 ## Modules to Import
 
@@ -54,7 +54,7 @@ Asynchronously obtains information about all available volumes. This API uses a
 
   ```js
   let uuid = "";
-  volumemanager.getAllVolumes(uuid, function(error, volumes){
+  volumemanager.getAllVolumes(function(error, volumes){
       // do something
   });
   ```