diff --git a/zh-cn/OpenHarmony-Overview_zh.md b/zh-cn/OpenHarmony-Overview_zh.md
index a20a54b234aa6cc76ec2c62464fbe831d22b96ac..02fed89027a457f3f06e953e532c5929e618ff94 100644
--- a/zh-cn/OpenHarmony-Overview_zh.md
+++ b/zh-cn/OpenHarmony-Overview_zh.md
@@ -195,7 +195,7 @@ OpenHarmony支持如下几种系统类型:
升级服务
|
-可支持OpenHarmony设备的OTA(Over The Air)升级。
+ | 可支持OpenHarmony设备的OTA(Over The Air)升级。
|
标准系统
|
@@ -301,7 +301,7 @@ OpenHarmony支持如下几种系统类型:
分布式软总线
|
-分布式软总线旨在为OpenHarmony系统提供跨进程或跨设备的通信能力,主要包含软总线和进程间通信两部分。其中,软总线为应用和系统提供近场设备间分布式通信的能力,提供不区分通信方式的设备发现,连接,组网和传输功能;而进程间通信则提供不区分设备内或设备间的进程间通信能力。
+ | 分布式软总线旨在为OpenHarmony系统提供跨进程或跨设备的通信能力,主要包含软总线和进程间通信两部分。其中,软总线为应用和系统提供近场设备间分布式通信的能力,提供不区分通信方式的设备发现,连接,组网和传输功能;而进程间通信则提供了对设备内或设备间无差别的进程间通信能力。
|
所有系统
|
diff --git a/zh-cn/application-dev/Readme-CN.md b/zh-cn/application-dev/Readme-CN.md
index 4bdbbedd98c6c9a907e38700e91e9515fad3f8f3..395ccdf29dd656986c403c68310cd8fcb7228ccb 100644
--- a/zh-cn/application-dev/Readme-CN.md
+++ b/zh-cn/application-dev/Readme-CN.md
@@ -6,8 +6,14 @@
- [术语](../glossary.md)
- [版本说明](../release-notes/Readme.md)
- 快速开始
- - [应用开发快速入门](quick-start/Readme-CN.md)
- - [应用开发包结构说明](quick-start/package-structure.md)
+ - 快速入门
+ - [前言](quick-start/start-overview.md)
+ - [使用eTS语言开发](quick-start/start-with-ets.md)
+ - [使用JS语言开发(传统代码方式)](quick-start/start-with-js.md)
+ - [使用JS语言开发(低代码方式)](quick-start/start-with-js-low-code.md)
+ - 开发基础知识
+ - [应用开发包结构说明](quick-start/package-structure.md)
+ - [资源文件的分类](quick-start/basic-resource-file-categories.md)
- 开发
- [Ability开发](ability/Readme-CN.md)
- [UI开发](ui/Readme-CN.md)
diff --git a/zh-cn/application-dev/ability/ability-assistant-guidelines.md b/zh-cn/application-dev/ability/ability-assistant-guidelines.md
index 02ac9057198c5b78f334879c8fbbafd1cb1f2510..6a3745fe0b00273eb0b34efba10de4206f37690e 100644
--- a/zh-cn/application-dev/ability/ability-assistant-guidelines.md
+++ b/zh-cn/application-dev/ability/ability-assistant-guidelines.md
@@ -1,6 +1,6 @@
# Ability助手使用指导
-Ability assistant(Ability助手,简称为aa)是实现应用、原子化服务及测试用例启动功能,为开发者提供基本的调试及测试应用的工具。通过该工具,开发者可以在hdc shell中,发出命令以执行各种系统操作,比如启动Ability、强制停止进程、打印Ability相关信息等。
+Ability assistant(Ability助手,简称为aa)是实现应用、原子化服务、及测试用例启动功能的工具,为开发者提供基本的应用调试和测试的能力。通过该工具,开发者可以在hdc shell中,发送命令以执行各种系统操作,比如启动Ability、强制停止进程、打印Ability相关信息等。
## 开发指导
@@ -87,15 +87,15 @@ Ability assistant(Ability助手,简称为aa)是实现应用、原子化服
```
aa dump -a
```
- ![aa-dump-a](figures/aa-dump-a.png)
+ ![aa-dump-a](figures/aa-dump-a.PNG)
```
aa dump -l
```
- ![aa-dump-l](figures/aa-dump-l.png)
+ ![aa-dump-l](figures/aa-dump-l.PNG)
```
aa dump -i 12
```
-![aa-dump-i](figures/aa-dump-i.png)
+ ![aa-dump-i](figures/aa-dump-i.PNG)
- **force-stop**
通过bundle name强制停止一个进程。
diff --git a/zh-cn/application-dev/ability/ability-brief.md b/zh-cn/application-dev/ability/ability-brief.md
index 2deda438bf166380bedbf0d31b55ea2bc08c0f07..0f0d439389893952ac104a6cad59cb76c7f46b66 100644
--- a/zh-cn/application-dev/ability/ability-brief.md
+++ b/zh-cn/application-dev/ability/ability-brief.md
@@ -2,10 +2,10 @@
Ability是应用所具备能力的抽象,也是应用程序的重要组成部分。Ability是系统调度应用的最小单元,是能够完成一个独立功能的组件,一个应用可以包含一个或多个Ability。
- Ability框架模型结构具有两种形态:
+ Ability框架模型结构具有两种框架形态:
-- 第一种形态为FA模型。API 8及其更早版本的应用程序只能使用FA模型进行开发。 FA模型将Ability分为FA(Feature Ability)和PA(Particle Ability)两种类型,其中FA支持Page Ability,PA支持Service Ability、Data Ability、以及FormAbility;
-- 第二种形态为Stage模型。从API 9开始,Ability框架引入了Stage模型作为第二种应用形态,Stage模型将Ability分为Ability和ExtensionAbility两大类,其中ExtensionAbility又被扩展为ServiceExtensionAbility、FormExtensionAbility、DataShareExtensionAbility等等一系列ExtensionAbility,以便满足更多的使用场景。
+- 第一种形态为FA模型。API 8及其更早版本的应用程序只能使用FA模型进行开发。 FA模型将Ability分为FA(Feature Ability)和PA(Particle Ability)两种类型,其中FA支持Page Ability,PA支持Service Ability、Data Ability、以及FormAbility。
+- 第二种形态为Stage模型。从API 9开始,Ability框架引入了Stage模型作为第二种应用框架形态,Stage模型将Ability分为Ability和ExtensionAbility两大类,其中ExtensionAbility又被扩展为ServiceExtensionAbility、FormExtensionAbility、DataShareExtensionAbility等等一系列ExtensionAbility,以便满足更多的使用场景。
Stage模型的设计,主要是为了方便开发者更加方便地开发出分布式环境下的复杂应用。下表给出了两种模型在设计上的差异:
diff --git a/zh-cn/application-dev/ability/ability-delegator.md b/zh-cn/application-dev/ability/ability-delegator.md
index aab7f699807e8ff43b87ba84ab96bc1162e96ac0..3a470e83dff9e91607a42df6cd11317adbdeacaf 100755
--- a/zh-cn/application-dev/ability/ability-delegator.md
+++ b/zh-cn/application-dev/ability/ability-delegator.md
@@ -10,7 +10,11 @@ Delegator测试框架是OpenHarmony提供的一套开发者应用自测试框架
## 测试框架启动
-测试框架启动有两种方式,方式一:通过`aa test`命令启动,方式二:通过IDE启动。
+测试框架启动有两种方式:
+
+- 方式一:通过`aa test`命令启动。
+- 方式二:通过IDE启动。
+
### aa test启动
开发者可通过 `aa test` 命令启动启动测试框架,开发者可以自行指定使用的runner以及runner所在hap包的package name/module name,具体命令示例如下:
diff --git a/zh-cn/application-dev/ability/fa-brief.md b/zh-cn/application-dev/ability/fa-brief.md
index ee4bd1c1680d875b8189bf84fb4090f5b5cbec02..eac6bffa2660e173c847c5304f76ba207afd0ace 100644
--- a/zh-cn/application-dev/ability/fa-brief.md
+++ b/zh-cn/application-dev/ability/fa-brief.md
@@ -1,12 +1,12 @@
# FA模型综述
## 整体架构
-OpenHarmony用户程序的开发本质上就是开发Ability,OpenHarmony系统也是通过调度Ability,通过系统提供的一致性调度契约对Ability进行生命周期管理,从而实现对用户程序的调度。
+OpenHarmony用户程序的开发本质上就是开发Ability。OpenHarmony系统是通过对Ability调度,结合系统提供的一致性调度契约对Ability进行生命周期管理,从而实现对用户程序的调度。
Ability框架在API 8及更早版本使用FA模型。FA模型中Ability分为PageAbility、ServiceAbility、DataAbility、FormAbility几种类型。其中:
-- PageAbility是具备ArkUI实现的Ability,是用户具体可见并可以交互的Ability实例;
-- ServiceAbility也是Ability一种,但是没有UI,提供其他Ability调用自定义的服务,在后台运行;
-- DataAbility也是没有UI的Ability,提供其他Ability进行数据的增删查服务,在后台运行;
+- PageAbility是具备ArkUI实现的Ability,是用户具体可见并可以交互的Ability实例。
+- ServiceAbility也是Ability一种,但是没有UI,提供其他Ability调用自定义的服务,在后台运行。
+- DataAbility也是没有UI的Ability,提供其他Ability进行数据的增删查服务,在后台运行。
- FormAbility是卡片Ability,是一种界面展示形式。
## 应用包结构
@@ -14,7 +14,7 @@ Ability框架在API 8及更早版本使用FA模型。FA模型中Ability分为Pag
![fa-package-info](figures/fa-package-info.png)
-应用包结构的配置请参见[包结构说明](../quick-start/package-structure.md)。
+应用包结构的配置请参见[应用包结构配置文件的说明](../quick-start/package-structure.md)。
## 生命周期
diff --git a/zh-cn/application-dev/ability/fa-pageability.md b/zh-cn/application-dev/ability/fa-pageability.md
index 2f2dbb22f1a87cc8d0616ac0c993b701f6c55a5c..a02d237cc57c01c4f73d7051ac4928cc80eb65e7 100644
--- a/zh-cn/application-dev/ability/fa-pageability.md
+++ b/zh-cn/application-dev/ability/fa-pageability.md
@@ -2,28 +2,30 @@
## 概述
### 功能简介
-PageAbility是具备ArkUI实现的Ability,是开发者具体可见并可以交互的Ability实例,开发者通过IDE创建Ability时,IDE会自动创建相关模板代码。PageAbility相关能力通过单例featureAbility暴露,生命周期相关回调通过app.js/app.ets中回调函数暴露。
+PageAbility是具备ArkUI实现的Ability,是开发者具体可见并可以交互的Ability实例。开发者通过IDE创建Ability时,IDE会自动创建相关模板代码。PageAbility相关能力通过单独的featureAbility实现,生命周期相关回调则通过app.js/app.ets中各个回调函数实现。
### PageAbility的生命周期
-**Ability生命周期介绍**(Ability Life Cycle):
+**PageAbility生命周期介绍**(Ability Life Cycle):
-Ability生命周期是Ability被调度到INACTIVE、ACTIVE、BACKGROUND等各个状态的统称。PageAbility生命周期流转如下图所示:
+PageAbility生命周期是PageAbility被调度到INACTIVE、ACTIVE、BACKGROUND等各个状态的统称。
+
+PageAbility生命周期流转如下图所示:
![PageAbility-Lifecycle](figures/page-ability-lifecycle.png)
**Ability生命周期状态说明:**
- - **UNINITIALIZED**:未初始状态,为临时状态,Ability被创建后会由UNINITIALIZED状态进入INITIAL状态。
+ - **UNINITIALIZED**:未初始状态,为临时状态,PageAbility被创建后会由UNINITIALIZED状态进入INITIAL状态。
- - **INITIAL**:初始化状态,也表示停止状态,表示当前Ability未运行,Ability被启动后由INITIAL态进入INACTIVE状态。
+ - **INITIAL**:初始化状态,也表示停止状态,表示当前PageAbility未运行,PageAbility被启动后由INITIAL态进入INACTIVE状态。
- **INACTIVE**:失去焦点状态,表示当前窗口已显示但是无焦点状态。
- **ACTIVE**:前台激活状态,表示当前窗口已显示,并获取焦点。
- - **BACKGROUND**:后台状态,表示当前Ability退到后台,Ability在被销毁后由BACKGROUND状态进入INITIAL状态,或者重新被激活后由BACKGROUND状态进入ACTIVE状态。
+ - **BACKGROUND**:后台状态,表示当前PageAbility退到后台,PageAbility在被销毁后由BACKGROUND状态进入INITIAL状态,或者重新被激活后由BACKGROUND状态进入ACTIVE状态。
**PageAbility生命周期回调与生命周期状态的关系如下图所示:**
@@ -100,6 +102,7 @@ PageAbility提供命周期回调,开发者可以在`app.js/app.ets`中重写
```
`want`参数也可以使用parameters参数,使用key-value的方式输入。
+
**示例**
```javascript
@@ -148,6 +151,7 @@ PageAbility提供命周期回调,开发者可以在`app.js/app.ets`中重写
```
从DeviceManager获取`deviceId`,具体示例代码如下:
+
```ts
import deviceManager from '@ohos.distributedHardware.deviceManager';
let dmClass;
@@ -167,6 +171,7 @@ PageAbility提供命周期回调,开发者可以在`app.js/app.ets`中重写
```
在跨设备场景下,需要向用户申请数据同步的权限。具体示例代码如下:
+
```ts
import abilityAccessCtrl from "@ohos.abilityAccessCtrl";
import bundle from '@ohos.bundle';
@@ -204,6 +209,7 @@ PageAbility提供命周期回调,开发者可以在`app.js/app.ets`中重写
```
### 生命周期接口说明
+
**表2** 生命周期回调函数介绍
| 接口名 | 描述 |
@@ -216,6 +222,7 @@ PageAbility提供命周期回调,开发者可以在`app.js/app.ets`中重写
| onActive() | Ability切换到前台,并且已经获取焦点时调用onActive方法。 |
**示例**
+
开发者需要重写`app.js/app.ets`中相关生命周期回调函数,IDE模板默认生成`onCreate()`和`onDestroy()`方法,其他方法需要开发者自行实现。
```javascript
diff --git a/zh-cn/application-dev/quick-start/package-structure.md b/zh-cn/application-dev/quick-start/package-structure.md
index 2ee57571b1031ed0b6efaa5f9a8fc228408846a2..a09afe709143f5f74a35eda3383ea2d30dfd54ed 100644
--- a/zh-cn/application-dev/quick-start/package-structure.md
+++ b/zh-cn/application-dev/quick-start/package-structure.md
@@ -1,6 +1,6 @@
-# 包结构说明
+# 应用包结构配置文件的说明
在应用开发的工程中,需要在config.json配置文件中对应用的包结构进行声明。