!2552 测试问题修改+示例代码修改+文档格式整改

Merge pull request !2552 from LiAn/master

zh-cn/application-dev/device/Readme-CN.md

@@ -11,5 +11,5 @@
   - [传感器开发概述](sensor-overview.md)
   - [传感器开发指导](sensor-guidelines.md)
 - 振动
-  - [振动开发概述](vibrator-guidelines.md)
+  - [振动开发概述](vibrator-overview.md)
   - [振动开发指导](vibrator-guidelines.md)

zh-cn/application-dev/device/vibrator-overview.md

@@ -9,6 +9,7 @@
 Vibrator属于控制类小器件，主要包含以下四个模块：Vibrator API，Vibrator Framework，Vibrator Service和HD_IDL层。
 
   **图1** 控制类小器件中的Vibrator
+
   ![zh-cn_image_0000001180249428](figures/zh-cn_image_0000001180249428.png)
 
 - Vibrator API：提供振动器基础的API，主要包含振动器的列表查询，振动器的振动器效果查询，触发/关闭振动器等接口。

zh-cn/application-dev/reference/apis/js-apis-basic-features-animator.md

@@ -97,7 +97,7 @@ update(options: AnimatorOptions): void
 
 **示例：**
 ```
-animator.update(options)；
+animator.update(options);
 ```
 
 ### play
@@ -110,7 +110,7 @@ play(): void
 
 **示例：**
 ```
-animator.play()；
+animator.play();
 ```
 
 ### finish
@@ -123,7 +123,7 @@ finish(): void
 
 **示例：**
 ```
-animator.finish()；
+animator.finish();
 ```
 
 ### pause
@@ -136,7 +136,7 @@ pause(): void
 
 **示例：**
 ```
-animator.pause()；
+animator.pause();
 ```
 
 ### cancel
@@ -149,7 +149,7 @@ cancel(): void
 
 **示例：**
 ```
-animator.cancel()；
+animator.cancel();
 ```
 
 ### reverse
@@ -162,7 +162,7 @@ reverse(): void
 
 **示例：**
 ```
-animator.reverse()；
+animator.reverse();
 ```
 
 ### onframe
@@ -180,7 +180,7 @@ onframe: (progress: number) => void
 
 **示例：**
 ```
-animator.onframe()；
+animator.onframe();
 ```
 
 ### onfinish
@@ -193,7 +193,7 @@ onfinish: () => void
 
 **示例：**
 ```
-animator.onfinish()；
+animator.onfinish();
 ```
 
 ### oncancel
@@ -206,7 +206,7 @@ oncancel: () => void
 
 **示例：**
 ```
-animator.oncancel()；
+animator.oncancel();
 ```
 
 ### onrepeat
@@ -217,7 +217,7 @@ onrepeat: () => void
 
 **示例：**
 ```
-animator.onrepeat()；
+animator.onrepeat();
 ```
 
 动画将重复。

zh-cn/application-dev/reference/apis/js-apis-inputdevice.md

@@ -102,7 +102,7 @@ getDevice(deviceId: number, callback: AsyncCallback<InputDeviceData>): voi
 
 ```
 export default {
-    InputDeviceData {
+    InputDeviceData: {
         deviceId : 0,
         name : "NA",
         sources : Array,
@@ -138,7 +138,7 @@ function getDevice(deviceId: number): Promise<InputDeviceData>
 
 ```
 export default {
-    InputDeviceData {
+    InputDeviceData: {
         deviceId : 0,
         name : "NA",
         sources : Array,

zh-cn/application-dev/reference/apis/js-apis-mediaquery.md

@@ -80,16 +80,18 @@ off(type: 'change', callback?: Callback<MediaQueryResult>): void
 
 - 示例
   ```
-  listener = mediaquery.matchMediaSync('(orientation: landscape)'); //监听横屏事件
-  onPortrait(mediaQueryResult) {
+    import mediaquery from '@ohos.mediaquery'
+    
+    let listener = mediaquery.matchMediaSync('(orientation: landscape)'); //监听横屏事件
+    function onPortrait(mediaQueryResult) {
         if (mediaQueryResult.matches) {
             // do something here
         } else {
             // do something here
         }
     }
-  listener.on('change', onPortrait) // 注册回调
-  listener.off('change', onPortrait) // 去注册回调
+    this.listener.on('change', this.onPortrait) // 注册回调
+    this.listener.off('change', this.onPortrait) // 去注册回调
   ```
 
 
@@ -141,5 +143,3 @@ struct MediaQueryExample {
   }
 }
 ```
\ No newline at end of file
-
-![zh-cn_image_0000001174422920](figures/zh-cn_image_0000001174422920.gif)

zh-cn/application-dev/reference/apis/js-apis-system-app.md

@@ -81,45 +81,95 @@ requestFullWindow(options?: RequestFullWindowOptions): void
   }
  ```
 
-## app.setImageCacheCount
+## app.setImageCacheCount<sup>7+</sup>
 
 setImageCacheCount(value: number): void
 
-设置解码图像计数的图像缓存容量。如果未设置，应用程序将不会缓存任何解码图像。
+设置内存中缓存解码后图片的数量上限，提升再次加载同源图片的加载速度。如果不设置则默认为0，不进行缓存。缓存采用内置的LRU策略，新图片加载后，如果超过缓存上限，会删除最久未再次加载的缓存。建议根据应用内存需求，设置合理缓存数量，数字过大可能导致内存使用过高。
 
 **系统能力：** SystemCapability.ArkUI.ArkUI.Full
 
 **参数：**
 | 参数名 | 类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| value | number | 否 | 解码图像计数的值容量。 |
+| value | number | 否 | 内存中解码后图片的缓存数量。 |
 
-## app.setImageRawDataCacheSize
+**示例：**
+
+  ```
+  // app.ets
+  import app from '@system.app';
+  
+  export default {
+      onCreate() { 
+          app.setImageCacheCount(100)    // 设置解码后图片内存缓存上限为100张
+          console.info('Application onCreate')
+      },
+      onDestroy() {
+          console.info('Application onDestroy')
+      },
+  }
+  ```
+
+## app.setImageRawDataCacheSize<sup>7+</sup>
 
 setImageRawDataCacheSize(value: number): void
 
-在解码前设置原始图像数据大小的图像缓存容量（以字节为单位）。如果未设置，应用程序将不会缓存任何原始图像数据。
+设置内存中缓存解码前图片数据的大小上限，单位为字节，提升再次加载同源图片的加载速度。如果不设置则默认为0，不进行缓存。缓存采用内置的LRU策略，新图片加载后，如果解码前数据超过缓存上限，会删除最久未再次加载的图片数据缓存。建议根据应用内存需求，设置合理缓存上限，过大可能导致应用内存使用过高。
 
 **系统能力：** SystemCapability.ArkUI.ArkUI.Full
 
 **参数：**
 | 参数名 | 类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| value | number | 否 | 原始图像数据大小的值容量（以字节为单位）。 |
+| value | number | 否 | 内存中解码前图片数据的缓存大小，单位为字节。 |
 
+**示例：**
 
-## app.setImageFileCacheSize
+  ```
+  // app.ets
+  import app from '@system.app';
+  
+  export default {
+      onCreate() {
+          app.setImageRawDataCacheSize(104,857,600) // 设置解码前图片数据内存缓存上限为100MB
+          console.info('Application onCreate')
+      },
+      onDestroy() {
+          console.info('Application onDestroy')
+      },
+  }
+  ```
+
+## app.setImageFileCacheSize<sup>7+</sup>
 
 setImageFileCacheSize(value: number): void
 
-在解码前设置磁盘上的图像文件缓存大小（以字节为单位）。如果未设置，应用程序将在磁盘上缓存100MB图像文件。
+设置图片文件缓存的大小上限，单位为字节，提升再次加载同源图片的加载速度，特别是对网络图源、缩略图会有较明显提升。如果不设置则默认为100MB。缓存采用内置的LRU策略，新图片加载后，如果超过文件缓存上限，会按照时间由远到近删除缓存图片文件直到缓存图片大小满足缓存上限。建议根据应用实际需求，设置合理文件缓存上限，数字过大可能导致磁盘空间占用过高。
 
 **系统能力：** SystemCapability.ArkUI.ArkUI.Full
 
 **参数：**
 | 参数名 | 类型 | 必填 | 说明 |
 | -------- | -------- | -------- | -------- |
-| value | number | 否 | 原始图像数据大小的值容量（以字节为单位）。 |
+| value | number | 否 | 图片文件的缓存大小，单位为字节。 |
+
+**示例：**
+
+  ```
+  // app.ets
+  import app from '@system.app';
+  
+  export default {  
+      onCreate() {    
+          app.setImageFileCacheSize(209,715,200) // 设置图片文件数据缓存上限为200MB   
+          console.info('Application onCreate')
+      },  
+      onDestroy() {
+          console.info('Application onDestroy')
+      },
+  }
+  ```
 
 ## AppResponse
 

zh-cn/application-dev/reference/apis/js-apis-system-bluetooth.md

@@ -48,7 +48,7 @@ ohos.permission.MANAGE_BLUETOOTH
       console.log('call bluetooth.startBLEScan success.');
     },
     fail(code, data) {
-      console.log('call bluetooth.startBLEScan failed, code: ${code}, data: ${data}.`);
+      console.log('call bluetooth.startBLEScan failed, code: ${code}, data: ${data}.');
     },
     complete() {
       console.log('call bluetooth.startBLEScan complete.');
@@ -82,7 +82,7 @@ ohos.permission.MANAGE_BLUETOOTH
       console.log('call bluetooth.stopBLEScan success.');
     },
     fail(data, code) {
-      console.log(`call bluethooth.stopBLEScan fail, code: ${code}, data: ${data}.`);
+      console.log('call bluethooth.stopBLEScan fail, code: ${code}, data: ${data}.');
     },
     complete() {
       console.log('call bluethooth.stopBLEScan complete.');
@@ -138,7 +138,7 @@ ohos.permission.MANAGE_BLUETOOTH
       });
     },
     fail(code, data) {
-      console.log('Failed to start BLE device scan, code: ${code}, data: ${data}`);
+      console.log('Failed to start BLE device scan, code: ${code}, data: ${data}');
     }
   });
   ```

zh-cn/application-dev/reference/arkui-ts/ts-container-list.md

@@ -119,5 +119,3 @@ struct ListExample {
 ```
 
 ![zh-cn_image_0000001174264378](figures/zh-cn_image_0000001174264378.gif)
-
-◤otherprops:internal:◢

zh-cn/application-dev/ui/ts-application-resource-access.md

@@ -24,9 +24,9 @@
 
 ## 资源引用
 
-在工程中，通过**“$r('app.type.name')”**的形式引用应用资源。app代表是应用内resources目录中定义的资源；type代表资源类型（或资源的存放位置），可以取“color”、“float”、“string”、“plural”、“media”，name代表资源命名，由开发者定义资源时确定。
+在工程中，通过"$r('app.type.name')"的形式引用应用资源。app代表是应用内resources目录中定义的资源；type代表资源类型（或资源的存放位置），可以取“color”、“float”、“string”、“plural”、“media”，name代表资源命名，由开发者定义资源时确定。
 
-引用rawfile下资源时使用**“$rawfile('filename')”**的形式**，**当前$rawfile仅支持Image控件引用图片资源，filename需要表示为rawfile目录下的文件相对路径，文件名需要包含后缀，路径开头不可以以"/"开头。
+引用rawfile下资源时使用"$rawfile('filename')" 的形式，当前$rawfile仅支持Image控件引用图片资源，filename需要表示为rawfile目录下的文件相对路径，文件名需要包含后缀，路径开头不可以以"/"开头。
 
 > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
 > 资源描述符不能拼接使用。

zh-cn/application-dev/ui/ts-framework-directory.md

@@ -11,7 +11,7 @@ FA应用的eTS模块(entry/src/main)的典型开发目录结构如下：
 **目录结构中文件分类如下：**
 
 
-- .ets结尾的eTS（extended TypeScript）文件，这个文件用于描述UI布局、样式、事件交互和页面逻辑。
+.ets结尾的eTS（extended TypeScript）文件，这个文件用于描述UI布局、样式、事件交互和页面逻辑。
 
 
 **各个文件夹和文件的作用：**
@@ -26,4 +26,6 @@ FA应用的eTS模块(entry/src/main)的典型开发目录结构如下：
 
 > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
 > 
+> - 资源目录resources文件夹位于src/main下，此目录下资源文件的详细规范以及子目录结构规范参看[资源文件的分类](../quick-start/basic-resource-file-categories.md)。
+>
 > - 页面支持导入TypeScript和JavaScript文件。

zh-cn/application-dev/ui/ts-media-resource-type.md

@@ -11,3 +11,13 @@
   | SVG | .svg | 
   | WEBP | .webp | 
   | BMP | .bmp |
+
+- 开发框架支持的图片资源类型说明
+  | 格式 | 支持的文件类型 | 
+  | -------- | -------- |
+  | H.263 | .3gp <br>.mp4 | 
+  | H.264 AVC <br> Baseline Profile (BP) | .3gp <br>.mp4 | 
+  | MPEG-4 SP | .3gp | 
+  | VP8 | .webm <br> .mkv | 
+
+

zh-cn/application-dev/ui/ts-types.md

@@ -60,7 +60,7 @@
 
 资源引用类型，用于设置组件属性的值。
 
-可以通过$r或者$rawfile创建Resource类型对象，详见[资源访问](ts-media-resource-type.md)。
+可以通过$r或者$rawfile创建Resource类型对象，详见[资源访问](ts-application-resource-access.md)。
 
 - $r('belonging.type.name')
   belonging：系统资源或者应用资源，相应的取值为'sys'和'app'；

zh-cn/application-dev/ui/ui-js-overview.md

@@ -5,7 +5,6 @@
 
 ## 基础能力
 
-- **类Web范式编程**
   采用类HTML和CSS Web编程语言作为页面布局和页面样式的开发语言，页面业务逻辑则支持ECMAScript规范的JavaScript语言。方舟开发框架提供的类Web编程范式，可以让开发者避免编写UI状态切换的代码，视图配置信息更加直观。
 
 

zh-cn/application-dev/website.md

@@ -254,7 +254,7 @@
         - [传感器开发概述](device/sensor-overview.md)
         - [传感器开发指导](device/sensor-guidelines.md)
       - 振动
-        - [振动开发概述](device/vibrator-guidelines.md)
+        - [振动开发概述](device/vibrator-overview.md)
         - [振动开发指导](device/vibrator-guidelines.md)
     - 设备使用信息统计
       - [设备使用信息统计概述](device-usage-statistics/device-usage-statistics-overview.md)

zh-cn/application-dev/work-scheduler/work-scheduler-dev-guide.md

@@ -39,8 +39,8 @@ function isLastWorkTimeOut(workId: number): Promise<boolean>;| 获取上次任
 workId | 延迟任务Id（必填）|number
 bundleName | 延迟任务包名（必填）|string
 abilityName | 延迟任务回调通知的组件名（必填）|string
-networkType | 网络条件 | NetworkType
-isCharging | 是否充电 | bool
+networkType | 网络类型 | NetworkType
+isCharging | 是否充电 | boolean
 chargerType | 充电类型 | ChargingType
 batteryLevel | 电量| number
 batteryStatus| 电池状态|    BatteryStatus