Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
579dc27a
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
579dc27a
编写于
12月 03, 2022
作者:
zyjhandsome
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
提交几张图片缩放的修改
Signed-off-by:
zyjhandsome
<
zyjhandsome@126.com
>
上级
a8b25043
变更
10
显示空白变更内容
内联
并排
Showing
10 changed file
with
30 addition
and
32 deletion
+30
-32
zh-cn/application-dev/application-models/ability-startup-with-explicit-want.md
.../application-models/ability-startup-with-explicit-want.md
+1
-1
zh-cn/application-dev/application-models/ability-startup-with-implicit-want.md
.../application-models/ability-startup-with-implicit-want.md
+1
-1
zh-cn/application-dev/application-models/application-context-stage.md
...ation-dev/application-models/application-context-stage.md
+5
-6
zh-cn/application-dev/application-models/data-share-via-want.md
...application-dev/application-models/data-share-via-want.md
+4
-3
zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md
...dev/application-models/explicit-implicit-want-mappings.md
+7
-9
zh-cn/application-dev/application-models/inter-device-interaction-hop-overview.md
...plication-models/inter-device-interaction-hop-overview.md
+2
-2
zh-cn/application-dev/application-models/uiability-data-sync-with-ui.md
...ion-dev/application-models/uiability-data-sync-with-ui.md
+1
-2
zh-cn/application-dev/application-models/uiability-intra-device-interaction.md
.../application-models/uiability-intra-device-interaction.md
+4
-3
zh-cn/application-dev/application-models/uiability-launch-type.md
...plication-dev/application-models/uiability-launch-type.md
+3
-3
zh-cn/application-dev/application-models/want-overview.md
zh-cn/application-dev/application-models/want-overview.md
+2
-2
未找到文件。
zh-cn/application-dev/application-models/ability-startup-with-explicit-want.md
浏览文件 @
579dc27a
...
...
@@ -69,4 +69,4 @@
```
5.
至此,当您点击CLICKME按钮时,应看到页面的跳转。
!
[
startAbilityWtExplicitWant
](
figures/startAbilityWtExplicitWant.PNG
)
<img
src=
"figures/startAbilityWtExplicitWant.PNG"
alt=
"startAbilityWtExplicitWant"
style=
"zoom: 80%;"
/>
zh-cn/application-dev/application-models/ability-startup-with-implicit-want.md
浏览文件 @
579dc27a
...
...
@@ -78,4 +78,4 @@
4.
want内type不为空,且被skills内type包含,匹配成功。
2.
当有多个匹配应用时,会被应用选择器展示给用户进行选择。
!
[
stage-want1
](
figures/stage-want1.png
)
2.
当有多个匹配应用时,会被应用选择器展示给用户进行选择。
<img
src=
"figures/stage-want1.png"
alt=
"stage-want1"
style=
"zoom:50%;"
/>
zh-cn/application-dev/application-models/application-context-stage.md
浏览文件 @
579dc27a
...
...
@@ -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
)
<img
src=
"figures/context-inheritance.png"
alt=
"context-inheritance"
style=
"zoom: 50%;"
/>
-
各类Context的持有关系
!
[
context-holding
](
figures/context-holding.png
)
<img
src=
"figures/context-holding.png"
alt=
"context-holding"
style=
"zoom:50%;"
/>
-
各类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中获取的应用开发路径
<img
src=
"figures/context-dir.png"
alt=
"context-dir"
style=
"zoom: 50%;"
/>
-
通过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
<img
src=
"figures/application-context-stage.png"
alt=
"application-context-stage"
style=
"zoom:50%;"
/>
\ No newline at end of file
zh-cn/application-dev/application-models/data-share-via-want.md
浏览文件 @
579dc27a
...
...
@@ -64,7 +64,8 @@
- "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]”时,应用选择器将以下形式展示。
<img src="figures/stage-want2.png" alt="stage-want2" style="zoom:50%;" />
示例代码中“ability.want.params.INTENT”字段是一个嵌套Want,内部所含action、type等字段将由应用选择器进行隐式匹配,具体隐式匹配规则可参考[隐式Want匹配原理详解](explicit-implicit-want-mappings.md#隐式want匹配原理详解)。当用户选择具体应用后,“ability.want.params.INTENT”字段的嵌套Want将传递至所选应用。
...
...
zh-cn/application-dev/application-models/explicit-implicit-want-mappings.md
浏览文件 @
579dc27a
...
...
@@ -59,9 +59,7 @@
-
调用方传入的want参数的action不为空,待匹配Ability的skills配置中的actions不为空且不包含调用方传入的want参数的action,则action匹配失败。
**图1**
want参数的action匹配规则
![
want-action
](
figures/want-action.png
)
**图1**
want参数的action匹配规则
<img
src=
"figures/want-action.png"
alt=
"want-action"
style=
"zoom:80%;"
/>
### 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匹配规则
<img
src=
"figures/want-entities.png"
alt=
"want-entities"
style=
"zoom:80%;"
/>
### 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皆不为空时的匹配规则
<img
src=
"figures/want-uri-type1.png"
alt=
"want-uri-type1"
style=
"zoom: 80%;"
/>
实际应用中,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的具体匹配规则
<img
src=
"figures/want-uri-type2.png"
alt=
"want-uri-type2"
style=
"zoom:80%;"
/>
### uri匹配规则
...
...
zh-cn/application-dev/application-models/inter-device-interaction-hop-overview.md
浏览文件 @
579dc27a
...
...
@@ -35,8 +35,8 @@ OpenHarmony流转提供了一组API库,可让用户应用程序更轻松、快
流转架构如下图所示。
**图1**
流转架构图
![
hop-structure
](
figures/hop-structure.png
)
**图1**
流转架构图
<img
src=
"figures/hop-structure.png"
alt=
"hop-structure"
style=
"zoom:80%;"
/>
-
跨端迁移任务管理:在迁移发起端,接受用户迁移的意图,提供迁移流转入口,迁移结果显示等能力。(该能力尚未构建。)
...
...
zh-cn/application-dev/application-models/uiability-data-sync-with-ui.md
浏览文件 @
579dc27a
...
...
@@ -91,9 +91,8 @@ EventHub提供了UIAbility组件/ExtensionAbility组件级别的事件机制,
globalThis是ArkTS引擎实例内部的一个全局对象,引擎内部的UIAbility/ExtensionAbility/Page都可以使用,因此可以使用globalThis全局对象进行数据同步。
**图1**
使用globalThis进行数据同步
![
globalThis1
](
figures/globalThis1.png
)
<img
src=
"figures/globalThis1.png"
alt=
"globalThis1"
style=
"zoom:67%;"
/>
如上图所示,下面从如下三个场景和一个注意点来介绍globalThis的使用:
...
...
zh-cn/application-dev/application-models/uiability-intra-device-interaction.md
浏览文件 @
579dc27a
...
...
@@ -195,7 +195,8 @@ UIAbility是系统调度的最小单元。在设备内的功能模块之间跳
})
```
效果示意如下图所示,点击“打开PDF文档”时,会弹出选择框供用户选择。!
[
uiability-intra-device-interaction
](
figures/uiability-intra-device-interaction.png
)
效果示意如下图所示,点击“打开PDF文档”时,会弹出选择框供用户选择。
<img
src=
"figures/uiability-intra-device-interaction.png"
alt=
"uiability-intra-device-interaction"
style=
"zoom:50%;"
/>
3.
在文档应用使用完成之后,如需要停止当前UIAbility实例,通过调用terminateSelf()方法实现。
...
...
@@ -441,7 +442,7 @@ Call调用的使用场景主要包括:
Call调用示意图如下所示。
**图1**
Call调用示意图
![
call
](
figures/call.png
)
<img
src=
"figures/call.png"
alt=
"call"
style=
"zoom:67%;"
/>
-
CallerAbility调用startAbilityByCall接口获取Caller,并使用Caller对象的call方法向CalleeAbility发送数据。
...
...
zh-cn/application-dev/application-models/uiability-launch-type.md
浏览文件 @
579dc27a
...
...
@@ -18,7 +18,7 @@ singleton启动模式为单实例模式,也是默认情况下的启动模式
每次调用startAbility()方法时,如果应用进程中该类型的UIAbility实例已经存在,则复用系统中的UIAbility实例。系统中只存在唯一一个该UIAbility实例,即在最近任务列表中只存在一个该类型的UIAbility实例。
**图1**
单实例模式演示效果
![
uiability-launch-type1
](
figures/uiability-launch-type1.png
)
<img
src=
"figures/uiability-launch-type1.png"
alt=
"uiability-launch-type1"
style=
"zoom:50%;"
/>
> ![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
)
<img
src=
"figures/standard-mode.png"
alt=
"standard-mode"
style=
"zoom:50%;"
/>
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
)
<img
src=
"figures/uiability-launch-type2.png"
alt=
"uiability-launch-type2"
style=
"zoom:50%;"
/>
> ![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()生命周期回调。
...
...
zh-cn/application-dev/application-models/want-overview.md
浏览文件 @
579dc27a
...
...
@@ -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用法示意
<img
src=
"figures/usage-of-want.png"
alt=
"usage-of-want"
style=
"zoom:80%;"
/>
## Want的类型
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录