提交 677a9882 编写于 作者: Z zengyawen

update docs

Signed-off-by: Nzengyawen <zengyawen1@huawei.com>
上级 645277d8
...@@ -23,7 +23,7 @@ OpenHarmony自动化测试框架arkxtest,作为OpenHarmony工具集的重要 ...@@ -23,7 +23,7 @@ OpenHarmony自动化测试框架arkxtest,作为OpenHarmony工具集的重要
![](figures/UnitTest.PNG) ![](figures/UnitTest.PNG)
单元测试脚本的基础运行流程如下图所示,依赖aa test命令作为执行入口,该命令可具体参考[对应指南。](../ability-deprecated/ability-delegator.md) 单元测试脚本的基础运行流程如下图所示,依赖aa test命令作为执行入口
![](figures/TestFlow.PNG) ![](figures/TestFlow.PNG)
......
...@@ -84,14 +84,14 @@ ...@@ -84,14 +84,14 @@
- 将天气主页划分为9个基础区域,如: - 将天气主页划分为9个基础区域,如:
![home_full](figures/home_full.png) ![home_full](figures/home_full.png)
- 基础区域9仅在大设备上显示,基础区域1-8虽然在各设备上始终展示但其尺寸及区域内的布局基本保持不变,可以结合[自适应布局](adaptive-layout.md)能力以[自定义组件](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/ts-component-based-component.md)的形式分别实现这9个基础区域。 - 基础区域9仅在大设备上显示,基础区域1-8虽然在各设备上始终展示但其尺寸及区域内的布局基本保持不变,可以结合[自适应布局](adaptive-layout.md)能力以[自定义组件](../../ui/ts-component-based-component.md)的形式分别实现这9个基础区域。
| | 小设备 | 中设备 | 大设备 | | | 小设备 | 中设备 | 大设备 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| 主页 | ![Home_sm](figures/Home_sm.png) | ![Home_md_mark](figures/Home_md_mark.png) | ![Home_lg_mark](figures/Home_lg_mark.png) | | 主页 | ![Home_sm](figures/Home_sm.png) | ![Home_md_mark](figures/Home_md_mark.png) | ![Home_lg_mark](figures/Home_lg_mark.png) |
- 基础区域1-8之间的布局在不同设备上有较大差异,可以使用响应式布局中的[栅格布局](responsive-layout.md#栅格布局)能力实现组件间的布局效果。 - 基础区域1-8之间的布局在不同设备上有较大差异,可以使用响应式布局中的[栅格布局](responsive-layout.md#栅格布局)能力实现组件间的布局效果。
- 展开和隐藏侧边栏的功能可以通过[侧边栏组件](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-container-sidebarcontainer.md)来实现。侧边栏是大设备上独有的,借助响应式布局中的[媒体查询](responsive-layout.md#媒体查询)能力,控制仅在大设备上展示侧边栏即可。 - 展开和隐藏侧边栏的功能可以通过[侧边栏组件](../../reference/arkui-ts/ts-container-sidebarcontainer.md)来实现。侧边栏是大设备上独有的,借助响应式布局中的[媒体查询](responsive-layout.md#媒体查询)能力,控制仅在大设备上展示侧边栏即可。
### 主页基础区域 ### 主页基础区域
......
...@@ -5,7 +5,7 @@ ...@@ -5,7 +5,7 @@
- 在开发态,一个应用包含一个或者多个Module,可以在[DevEco Studio](https://developer.harmonyos.com/cn/develop/deveco-studio/)工程中[创建一个或者多个Module](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/ohos-adding-deleting-module-0000001218760594-V3)。Module是OpenHarmony应用/服务的基本功能单元,包含了源代码、资源文件、第三方库及应用/服务配置文件,每一个Module都可以独立进行编译和运行。Module分为“Ability”和“Library”两种类型,“Ability”类型的Module对应于编译后的HAP(Harmony Ability Package);“Library”类型的Module对应于[HAR](har-structure.md)(Harmony Ability Resources)包,即编译后的.tgz文件。 - 在开发态,一个应用包含一个或者多个Module,可以在[DevEco Studio](https://developer.harmonyos.com/cn/develop/deveco-studio/)工程中[创建一个或者多个Module](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/ohos-adding-deleting-module-0000001218760594-V3)。Module是OpenHarmony应用/服务的基本功能单元,包含了源代码、资源文件、第三方库及应用/服务配置文件,每一个Module都可以独立进行编译和运行。Module分为“Ability”和“Library”两种类型,“Ability”类型的Module对应于编译后的HAP(Harmony Ability Package);“Library”类型的Module对应于[HAR](har-structure.md)(Harmony Ability Resources)包,即编译后的.tgz文件。
一个Module可以包含一个或多个[UIAbility](../application-models/uiability-overview.md)组件,如[Module与UIAbility组件关系示意图](figures/ability-and-module.png)所示。 一个Module可以包含一个或多个[UIAbility](../application-models/uiability-overview.md)组件,如**Module与UIAbility组件关系示意图**所示。
**图1** Module与UIAbility组件关系示意图 **图1** Module与UIAbility组件关系示意图
![ability-and-module](figures/ability-and-module.png) ![ability-and-module](figures/ability-and-module.png)
......
# 多HAP构建视图 # 多HAP构建视图
IDE支持在一个应用工程中进行多个HAP的开发与构建,如[多HAP构建视图](figures/hap-multi-view.png)所示。 IDE支持在一个应用工程中进行多个HAP的开发与构建,如下图所示。
**图1** 多HAP构建视图   **图1** 多HAP构建视图  
......
...@@ -19,7 +19,7 @@ ...@@ -19,7 +19,7 @@
## 使用说明 ## 使用说明
通过appManager中[getProcessRunningInfos](js-apis-application-appManager.md##appManager.getProcessRunningInfos<sup>(deprecated)</sup>)方法来获取。 通过appManager中[getProcessRunningInfos](js-apis-application-appManager.md#appmanagergetprocessrunninginfosdeprecated)方法来获取。
**示例:** **示例:**
```ts ```ts
......
...@@ -16,7 +16,7 @@ import resourceManager from '@ohos.resourceManager'; ...@@ -16,7 +16,7 @@ import resourceManager from '@ohos.resourceManager';
## 使用说明 ## 使用说明
从API Version9开始,Stage模型通过context获取resourceManager对象的方式后,可直接调用其内部获取资源的接口,无需再导入包。此方式FA模型不适用,FA模型还需要先导入包,再调用[getResourceManager](#resourcemanagergetresourcemanager)接口获取资源对象。 从API Version9开始,Stage模型通过context获取resourceManager对象的方式后,可直接调用其内部获取资源的接口,无需再导入包。此方式FA模型不适用,FA模型还需要先导入包,再调用[getResourceManager](#resourcemanagergetresourcemanager)接口获取资源对象。
Stage模型下Context的引用方法请参考[Stage模型的Context详细介绍](../../application-models/application-context-stage.md) Stage模型下Context的引用方法请参考[Stage模型的Context详细介绍](../../application-models/application-context-stage.md)
```ts ```ts
import Ability from '@ohos.application.Ability'; import Ability from '@ohos.application.Ability';
......
...@@ -20,7 +20,7 @@ OpenHarmony将后台任务分为四种类型,并提供了一个资源申请的 ...@@ -20,7 +20,7 @@ OpenHarmony将后台任务分为四种类型,并提供了一个资源申请的
## 最佳后台任务选择 ## 最佳后台任务选择
![后台任务选择](public_sys-resources/bgtask_choice.png) ![后台任务选择](figures/bgtask_choice.png)
## 短时任务 ## 短时任务
......
...@@ -36,7 +36,7 @@ ...@@ -36,7 +36,7 @@
### 基于FA模型 ### 基于FA模型
基于FA的Service Ability使用,参考[ServiceAbility开发指导](../ability-deprecated/fa-serviceability.md) 基于FA的Service Ability使用,参考[ServiceAbility开发指导](../application-models/serviceability-overview.md)
当不需要与后台执行的长时任务交互时,可以采用startAbility()方法启动Service Ability。并在Service Ability的onStart回调方法中,调用长时任务的申请接口,声明此服务需要在后台长时运行。当任务执行完,再调用长时任务取消接口,及时释放资源。 当不需要与后台执行的长时任务交互时,可以采用startAbility()方法启动Service Ability。并在Service Ability的onStart回调方法中,调用长时任务的申请接口,声明此服务需要在后台长时运行。当任务执行完,再调用长时任务取消接口,及时释放资源。
...@@ -179,7 +179,7 @@ export default { ...@@ -179,7 +179,7 @@ export default {
### 基于Stage模型 ### 基于Stage模型
Stage模型的相关信息参考[Stage模型综述](../ability-deprecated/stage-brief.md) Stage模型的相关信息参考[Stage模型开发概述](../application-models/stage-model-development-overview.md)
1、新建Api Version 9的工程后,在工程目录中右键选择“New” -> “Ability” 快速创建Ability组件。并在module.json5文件中配置长时任务权限ohos.permission.KEEP_BACKGROUND_RUNNING、后台模式类型。 1、新建Api Version 9的工程后,在工程目录中右键选择“New” -> “Ability” 快速创建Ability组件。并在module.json5文件中配置长时任务权限ohos.permission.KEEP_BACKGROUND_RUNNING、后台模式类型。
...@@ -201,7 +201,7 @@ Stage模型的相关信息参考[Stage模型综述](../ability-deprecated/stage- ...@@ -201,7 +201,7 @@ Stage模型的相关信息参考[Stage模型综述](../ability-deprecated/stage-
} }
``` ```
2、在应用内执行长时任务时,由于元能力启动管控规则限制,不支持同应用通过startAbilityByCall的形式在后台创建并运行Ability。可以直接在page中,执行相应的代码。Stage模型的Ability使用参考[Ability开发指导](../ability-deprecated/stage-ability.md) 2、在应用内执行长时任务时,由于元能力启动管控规则限制,不支持同应用通过startAbilityByCall的形式在后台创建并运行Ability。可以直接在page中,执行相应的代码。Stage模型的Ability使用参考[Stage模型开发指导-UIAbility组件](../application-models/uiability-overview.md)
```ts ```ts
import wantAgent from '@ohos.wantAgent'; import wantAgent from '@ohos.wantAgent';
...@@ -290,7 +290,7 @@ struct Index { ...@@ -290,7 +290,7 @@ struct Index {
} }
``` ```
3、当需要跨设备或者跨应用在后台执行长时任务时,可以通过Call的方式在后台创建并运行Ability。使用方式参考[Call调用开发指](../ability-deprecated/stage-call.md) 3、当需要跨设备或者跨应用在后台执行长时任务时,可以通过Call的方式在后台创建并运行Ability。使用方式参考[Call调用开发指南(同设备)](uiability-intra-device-interaction.md#通过call调用实现uiability交互仅对系统应用开放)[Call调用开发指南(跨设备)](hop-multi-device-collaboration.md#通过跨设备call调用实现多端协同)
```ts ```ts
import Ability from '@ohos.application.Ability' import Ability from '@ohos.application.Ability'
......
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
## 接口说明 ## 接口说明
后台代理提醒功能主要提供后台提醒通知发布接口,开发者可调用这些接口创建定时提醒,包括倒计时、日历、闹钟三种提醒类型。[reminderAgentManager](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-reminderAgentManager.md)封装了发布、取消提醒通知的方法。 后台代理提醒功能主要提供后台提醒通知发布接口,开发者可调用这些接口创建定时提醒,包括倒计时、日历、闹钟三种提醒类型。[reminderAgentManager](../reference/apis/js-apis-reminderAgentManager.md)封装了发布、取消提醒通知的方法。
**表1** reminderAgentManager主要接口 **表1** reminderAgentManager主要接口
...@@ -19,7 +19,7 @@ ...@@ -19,7 +19,7 @@
## 开发步骤 ## 开发步骤
1. 申请`ohos.permission.PUBLISH_AGENT_REMINDER`权限,配置方式请参阅[访问控制授权申请指导](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/accesstoken-guidelines.md#stage%E6%A8%A1%E5%9E%8B) 1. 申请`ohos.permission.PUBLISH_AGENT_REMINDER`权限,配置方式请参阅[访问控制授权申请指导](../security/accesstoken-guidelines.md#stage模型)
2. [使能通知开关](../notification/notification-enable.md),获得用户授权后,才能使用代理提醒功能。 2. [使能通知开关](../notification/notification-enable.md),获得用户授权后,才能使用代理提醒功能。
...@@ -160,7 +160,7 @@ ...@@ -160,7 +160,7 @@
![zh-cn_image_0000001416585578](figures/zh-cn_image_0000001416585578.png) ![zh-cn_image_0000001416585578](figures/zh-cn_image_0000001416585578.png)
6. 若需要删除提醒任务,可以通过调用[reminderAgentManager.cancelReminder()](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-reminderAgentManager.md#reminderagentmanagercancelreminder)方法来实现。 6. 若需要删除提醒任务,可以通过调用[reminderAgentManager.cancelReminder()](../reference/apis/js-apis-reminderAgentManager.md#reminderagentmanagercancelreminder)方法来实现。
```js ```js
let reminderId = 0; // reminderId的值从发布提醒代理成功之后的回调中获得 let reminderId = 0; // reminderId的值从发布提醒代理成功之后的回调中获得
......
...@@ -61,7 +61,7 @@ import workScheduler from '@ohos.resourceschedule.workScheduler'; ...@@ -61,7 +61,7 @@ import workScheduler from '@ohos.resourceschedule.workScheduler';
import WorkSchedulerExtensionAbility from '@ohos.WorkSchedulerExtensionAbility'; import WorkSchedulerExtensionAbility from '@ohos.WorkSchedulerExtensionAbility';
``` ```
2、开发对应的ExtensionAbility,用于回调执行具体的延迟任务。关于ExtensionAbility的介绍,参考[ExtensionAbility机制](../ability-deprecated/stage-brief.md#extensionability机制) 2、开发对应的ExtensionAbility,用于回调执行具体的延迟任务。关于ExtensionAbility的介绍,参考[ExtensionAbility机制](../application-models/extensionability-overview.md)
```ts ```ts
import WorkSchedulerExtensionAbility from '@ohos.WorkSchedulerExtensionAbility'; import WorkSchedulerExtensionAbility from '@ohos.WorkSchedulerExtensionAbility';
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册