diff --git a/zh-cn/application-dev/application-models/ability-startup-with-explicit-want.md b/zh-cn/application-dev/application-models/ability-startup-with-explicit-want.md index 725014c2d27fd578e2d27ecd8a8d949ea35b41a6..67dc2e9a44c57cabb5e4cff1ecd69779016890ba 100644 --- a/zh-cn/application-dev/application-models/ability-startup-with-explicit-want.md +++ b/zh-cn/application-dev/application-models/ability-startup-with-explicit-want.md @@ -69,4 +69,4 @@ ``` 5. 至此，当您点击CLICKME按钮时，应看到页面的跳转。 - ![startAbilityWtExplicitWant](figures/startAbilityWtExplicitWant.PNG) + startAbilityWtExplicitWant diff --git a/zh-cn/application-dev/application-models/ability-startup-with-implicit-want.md b/zh-cn/application-dev/application-models/ability-startup-with-implicit-want.md index 0e1a4c52378b5b82e548f96bc1f05a162a30e1d2..f2c0bb04b0d1454a2d8a02d4f53a08e13a9ff2c7 100644 --- a/zh-cn/application-dev/application-models/ability-startup-with-implicit-want.md +++ b/zh-cn/application-dev/application-models/ability-startup-with-implicit-want.md @@ -78,4 +78,4 @@ 4. want内type不为空，且被skills内type包含，匹配成功。 -2. 当有多个匹配应用时，会被应用选择器展示给用户进行选择。![stage-want1](figures/stage-want1.png) +2. 当有多个匹配应用时，会被应用选择器展示给用户进行选择。stage-want1 diff --git a/zh-cn/application-dev/application-models/application-context-stage.md b/zh-cn/application-dev/application-models/application-context-stage.md index 7f9f667b9ae825362c054416683cee654072023b..0aa8235cc593142b1747e5bd46a4edce12040387 100644 --- a/zh-cn/application-dev/application-models/application-context-stage.md +++ b/zh-cn/application-dev/application-models/application-context-stage.md @@ -6,10 +6,10 @@ [Context](../reference/apis/js-apis-application-context.md)是应用中对象的上下文，其提供了应用的一些基础信息，例如resourceManager（资源管理）、applicationInfo（当前应用信息）、dir（应用开发路径）、area（文件分区）等，以及应用的一些基本方法，例如createBundleContext()、getApplicationContext()等。UIAbility组件和各种ExtensionAbility派生类组件都有各自不同的Context类。分别有基类Context、ApplicationContext、AbilityStageContext、UIAbilityContext、ExtensionContext、ServiceExtensionContext等Context。 - 各类Context的继承关系 - ![context-inheritance](figures/context-inheritance.png) + context-inheritance - 各类Context的持有关系 - ![context-holding](figures/context-holding.png) + context-holding - 各类Context的获取方式 - 获取[UIAbilityContext](../reference/apis/js-apis-ability-context.md)。每个UIAbility中都包含了一个Context属性，提供操作Ability、获取Ability的配置信息、应用向用户申请授权等能力。 @@ -93,8 +93,8 @@ 获取路径的能力是基类Context中提供的能力，因此在ApplicationContext、AbilityStageContext、UIAbilityContext和ExtensionContext中均可以获取，在各类Context中获取到的路径会有一些差别，具体差别如下图所示。 - **图1** Context中获取的应用开发路径   -![context-dir](figures/context-dir.png) + **图1** Context中获取的应用开发路径 +context-dir - 通过ApplicationContext获取的应用级别路径。应用全局信息建议存放的路径，存放在此路径的文件内容仅在应用卸载时会被删除。 | 属性 | 路径 | @@ -306,5 +306,4 @@ export default class EntryAbility extends UIAbility { 应用需要获取用户的隐私信息或使用系统能力时，例如获取位置信息、访问日历、使用相机拍摄照片或录制视频等，需要向用户申请授权，示意效果如下图所示。具体使用请参见[访问控制授权申请指导](../security/accesstoken-guidelines.md)。 **图2** 向用户申请日历访问授权 - -![application-context-stage](figures/application-context-stage.png) \ No newline at end of file +application-context-stage \ No newline at end of file diff --git a/zh-cn/application-dev/application-models/data-share-via-want.md b/zh-cn/application-dev/application-models/data-share-via-want.md index f686fc3e29b541e0440925207c64482b0161c180..7ae2b4b8c3aa94cda0fadc6c6f8b2d31339e3133 100644 --- a/zh-cn/application-dev/application-models/data-share-via-want.md +++ b/zh-cn/application-dev/application-models/data-share-via-want.md @@ -64,10 +64,11 @@ - "ability.picker.fileSizes"：应用选择器根据该字段展示文件大小。以字节为单位。 - "ability.picker.fileNames"与"ability.picker.fileSizes"为数组，其有一一对应关系。 - 例如：当"ability.picker.type"为“application/pdf”，"ability.picker.fileNames"为“["接口文档.pdf"]”，"ability.picker.fileSizes"为“[350 \* 1024]”时，应用选择器将以下形式展示。![stage-want2](figures/stage-want2.png) - + 例如：当"ability.picker.type"为“application/pdf”，"ability.picker.fileNames"为“["接口文档.pdf"]”，"ability.picker.fileSizes"为“[350 \* 1024]”时，应用选择器将以下形式展示。 + stage-want2 + 示例代码中“ability.want.params.INTENT”字段是一个嵌套Want，内部所含action、type等字段将由应用选择器进行隐式匹配，具体隐式匹配规则可参考[隐式Want匹配原理详解](explicit-implicit-want-mappings.md#隐式want匹配原理详解)。当用户选择具体应用后，“ability.want.params.INTENT”字段的嵌套Want将传递至所选应用。 - + - 被分享方： 1. 上文中提到，应用选择器通过“ability.want.params.INTENT”字段进行隐式匹配。因此被分享方Ability配置文件内（stage模型下的module.json5）skills字段需配置如下。 diff --git a/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md b/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md index 0e7484e97eea79d548caf22e68db606ea09cf9cc..ab6878dc57b170c1eac98c6482a497189a0b7765 100644 --- a/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md +++ b/zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md @@ -59,9 +59,7 @@ - 调用方传入的want参数的action不为空，待匹配Ability的skills配置中的actions不为空且不包含调用方传入的want参数的action，则action匹配失败。 - **图1** want参数的action匹配规则   - -![want-action](figures/want-action.png) + **图1** want参数的action匹配规则  want-action ### want参数的entities匹配规则 @@ -78,16 +76,16 @@ - 调用方传入的want参数的entities不为空，待匹配Ability的skills配置中的entities不为空且不完全包含调用方传入的want参数的entities，则entities匹配失败。 - **图2** want参数的entities匹配规则   -![want-entities](figures/want-entities.png) + **图2** want参数的entities匹配规则 +want-entities ### want参数的uri和type匹配规则 调用方传入的want参数中设置uri和type参数发起组件启动请求，系统会遍历当前系统已安装的组件列表，并逐个匹配待匹配Ability的skills配置中的uris数组，如果待匹配Ability的skills配置中的uris数组中只要有一个可以匹配调用方传入的want参数中设置的uri和type即为匹配成功。 - **图3** want参数中uri和type皆不为空时的匹配规则   -![want-uri-type1](figures/want-uri-type1.png) + **图3** want参数中uri和type皆不为空时的匹配规则 +want-uri-type1 实际应用中，uri和type共存在四种情况，下面将讲解四种情况的具体匹配规则： @@ -112,8 +110,8 @@ 下图为了简化描述，称want中传入的uri为w_uri，称want中传入的type为w_type, 待匹配Ability的skills配置中uris为s_uris，其中每个元素为s_uri；按自上而下顺序匹配。 - **图4** want参数中uri和type的具体匹配规则   -![want-uri-type2](figures/want-uri-type2.png) + **图4** want参数中uri和type的具体匹配规则 +want-uri-type2 ### uri匹配规则 diff --git a/zh-cn/application-dev/application-models/inter-device-interaction-hop-overview.md b/zh-cn/application-dev/application-models/inter-device-interaction-hop-overview.md index 1e3b529bbc5be8ff495bb26a5cbc2b516f9d4c4a..ebed9309715fb41bfda47bf8ff6555dea63c483d 100644 --- a/zh-cn/application-dev/application-models/inter-device-interaction-hop-overview.md +++ b/zh-cn/application-dev/application-models/inter-device-interaction-hop-overview.md @@ -35,8 +35,8 @@ OpenHarmony流转提供了一组API库，可让用户应用程序更轻松、快 流转架构如下图所示。 - **图1** 流转架构图   -![hop-structure](figures/hop-structure.png) + **图1** 流转架构图 +hop-structure - 跨端迁移任务管理：在迁移发起端，接受用户迁移的意图，提供迁移流转入口，迁移结果显示等能力。（该能力尚未构建。） diff --git a/zh-cn/application-dev/application-models/uiability-data-sync-with-ui.md b/zh-cn/application-dev/application-models/uiability-data-sync-with-ui.md index 49a088a9b23454f2f25115b92476d3d4a05f5ff4..1e8bf471f36cde6fbba62820d03befcf2a2314be 100644 --- a/zh-cn/application-dev/application-models/uiability-data-sync-with-ui.md +++ b/zh-cn/application-dev/application-models/uiability-data-sync-with-ui.md @@ -91,9 +91,8 @@ EventHub提供了UIAbility组件/ExtensionAbility组件级别的事件机制， globalThis是ArkTS引擎实例内部的一个全局对象，引擎内部的UIAbility/ExtensionAbility/Page都可以使用，因此可以使用globalThis全局对象进行数据同步。 - **图1** 使用globalThis进行数据同步 -![globalThis1](figures/globalThis1.png) +globalThis1 如上图所示，下面从如下三个场景和一个注意点来介绍globalThis的使用： diff --git a/zh-cn/application-dev/application-models/uiability-intra-device-interaction.md b/zh-cn/application-dev/application-models/uiability-intra-device-interaction.md index 3e2066ac91492b97751b8b3c85ba9f2fa5c70be1..d40848647471a8f3618f05c2ccde3dd37d095daa 100644 --- a/zh-cn/application-dev/application-models/uiability-intra-device-interaction.md +++ b/zh-cn/application-dev/application-models/uiability-intra-device-interaction.md @@ -195,8 +195,9 @@ UIAbility是系统调度的最小单元。在设备内的功能模块之间跳 }) ``` - 效果示意如下图所示，点击“打开PDF文档”时，会弹出选择框供用户选择。![uiability-intra-device-interaction](figures/uiability-intra-device-interaction.png) - + 效果示意如下图所示，点击“打开PDF文档”时，会弹出选择框供用户选择。 + uiability-intra-device-interaction + 3. 在文档应用使用完成之后，如需要停止当前UIAbility实例，通过调用terminateSelf()方法实现。 ```ts @@ -441,7 +442,7 @@ Call调用的使用场景主要包括： Call调用示意图如下所示。 **图1** Call调用示意图 -![call](figures/call.png) +call - CallerAbility调用startAbilityByCall接口获取Caller，并使用Caller对象的call方法向CalleeAbility发送数据。 diff --git a/zh-cn/application-dev/application-models/uiability-launch-type.md b/zh-cn/application-dev/application-models/uiability-launch-type.md index 10dfb55e26e8a9268ae03a6de2b25a249ab0de9f..0f99f58149920630de0aeba2058b6ec40ea3d7c4 100644 --- a/zh-cn/application-dev/application-models/uiability-launch-type.md +++ b/zh-cn/application-dev/application-models/uiability-launch-type.md @@ -18,7 +18,7 @@ singleton启动模式为单实例模式，也是默认情况下的启动模式 每次调用startAbility()方法时，如果应用进程中该类型的UIAbility实例已经存在，则复用系统中的UIAbility实例。系统中只存在唯一一个该UIAbility实例，即在最近任务列表中只存在一个该类型的UIAbility实例。 **图1** 单实例模式演示效果 -![uiability-launch-type1](figures/uiability-launch-type1.png) +uiability-launch-type1 > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 应用的UIAbility实例已创建，该UIAbility配置为单实例模式，再次调用startAbility()方法启动该UIAbility实例，此时只会进入该UIAbility的[onNewWant()](../reference/apis/js-apis-application-ability.md#abilityonnewwant)回调，不会进入其onCreate()和onWindowStageCreate()生命周期回调。 @@ -46,7 +46,7 @@ singleton启动模式为单实例模式，也是默认情况下的启动模式 standard启动模式为标准实例模式，每次调用startAbility()方法时，都会在应用进程中创建一个新的该类型UIAbility实例。即在最近任务列表中可以看到有多个该类型的UIAbility实例。这种情况下可以将UIAbility配置为standard（标准实例模式）。 **图2** 标准实例模式演示效果 -![standard-mode](figures/standard-mode.png) +standard-mode standard启动模式的开发使用，在[module.json5配置文件](../quick-start/module-configuration-file.md)中的"launchType"字段配置为"standard"即可。 @@ -73,7 +73,7 @@ specified启动模式为指定实例模式，针对一些特殊场景使用（ 在UIAbility实例创建之前，允许开发者为该实例创建一个唯一的字符串Key，创建的UIAbility实例绑定Key之后，后续每次调用startAbility()方法时，都会询问应用使用哪个Key对应的UIAbility实例来响应startAbility()请求。运行时由UIAbility内部业务决定是否创建多实例，如果匹配有该UIAbility实例的Key，则直接拉起与之绑定的UIAbility实例，否则创建一个新的UIAbility实例。 **图3** 指定实例模式演示效果 -![uiability-launch-type2](figures/uiability-launch-type2.png) +uiability-launch-type2 > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 应用的UIAbility实例已创建，该UIAbility配置为指定实例模式，再次调用startAbility()方法启动该UIAbility实例，且[AbilityStage](abilitystage.md)的[onAcceptWant()](../reference/apis/js-apis-application-abilitystage.md#abilitystageonacceptwant)回调匹配到一个已创建的UIAbility实例。此时，再次启动该UIAbility时，只会进入该UIAbility的[onNewWant()](../reference/apis/js-apis-application-ability.md#abilityonnewwant)回调，不会进入其onCreate()和onWindowStageCreate()生命周期回调。 diff --git a/zh-cn/application-dev/application-models/want-overview.md b/zh-cn/application-dev/application-models/want-overview.md index 832d5af8e26275006a7360cb33c3d441e015aa62..17c77bf5b44b15647bbe2a49916e5fb160eeef21 100644 --- a/zh-cn/application-dev/application-models/want-overview.md +++ b/zh-cn/application-dev/application-models/want-overview.md @@ -5,8 +5,8 @@ [Want](../reference/apis/js-apis-application-Want.md)是对象间信息传递的载体，可以用于应用组件间的信息传递。其使用场景之一是作为startAbility()的参数，包含了指定的启动目标以及启动时需携带的相关数据，如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当UIAbilityA启动UIAbilityB并需要传入一些数据给UIAbilityB时，Want可以作为一个载体将数据传给UIAbilityB。 - **图1** Want用法示意   -![usage-of-want](figures/usage-of-want.png) + **图1** Want用法示意 +usage-of-want ## Want的类型