Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
8082e768
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,发现更多精彩内容 >>
提交
8082e768
编写于
9月 17, 2022
作者:
H
HuangXW
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
extension context文档整改
Signed-off-by:
N
HuangXW
<
huangxinwei4@huawei.com
>
上级
a8add1ca
变更
4
隐藏空白更改
内联
并排
Showing
4 changed file
with
101 addition
and
11 deletion
+101
-11
zh-cn/application-dev/reference/apis/figures/zh_cn_image_ExtensionContext_Example.png
...nce/apis/figures/zh_cn_image_ExtensionContext_Example.png
+0
-0
zh-cn/application-dev/reference/apis/js-apis-ability-context.md
...application-dev/reference/apis/js-apis-ability-context.md
+3
-3
zh-cn/application-dev/reference/apis/js-apis-extension-context.md
...plication-dev/reference/apis/js-apis-extension-context.md
+96
-6
zh-cn/application-dev/reference/apis/js-apis-service-extension-context.md
...n-dev/reference/apis/js-apis-service-extension-context.md
+2
-2
未找到文件。
zh-cn/application-dev/reference/apis/figures/zh_cn_image_ExtensionContext_Example.png
0 → 100644
浏览文件 @
8082e768
19.8 KB
zh-cn/application-dev/reference/apis/js-apis-ability-context.md
浏览文件 @
8082e768
...
...
@@ -2,12 +2,12 @@
AbilityContext是Ability的上下文环境,继承自Context。
AbilityContext模块提供允许访问特定
于a
bility的资源的能力,包括对Ability的启动、停止的设置、获取caller通信接口、拉起弹窗请求用户授权等。
AbilityContext模块提供允许访问特定
A
bility的资源的能力,包括对Ability的启动、停止的设置、获取caller通信接口、拉起弹窗请求用户授权等。
> **说明:**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
>
-
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>
-
本模块接口仅可在Stage模型下使用。
## 使用说明
...
...
zh-cn/application-dev/reference/apis/js-apis-extension-context.md
浏览文件 @
8082e768
...
...
@@ -2,12 +2,12 @@
ExtensionContext是Extension的上下文环境,继承自Context。
ExtensionContext模块提供
扩展的上下文的能力,包括允许访问特定于扩展的资源
。
ExtensionContext模块提供
访问特定Extension的资源的能力,对于拓展的Extension,可直接将ExtensionContext作为上下文环境,或者定义一个继承自ExtensionContext的类型作为上下文环境。如:ServiceExtension提供了ServiceExtensionContext,它在ExtensionContext的基础上扩展了启动、停止、绑定、解绑Ability的能力,详见
[
ServiceExtensionContext
](
js-apis-service-extension-context.md
)
。
> **说明:**
>
>
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
>
- 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>
-
本模块接口仅可在Stage模型下使用。
## 属性
...
...
@@ -15,8 +15,98 @@ ExtensionContext模块提供扩展的上下文的能力,包括允许访问特
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| currentHapModuleInfo | HapModuleInfo | 是 | 否 |
当前Hap包的信息。 |
| config | Configuration | 是 | 否 |
模块的配置信息。
|
| extensionAbilityInfo |
[
ExtensionAbilityInfo
](
js-apis-bundle-ExtensionAbilityInfo.md
)
| 是 | 否 |
服务扩展信息。
|
| currentHapModuleInfo | HapModuleInfo | 是 | 否 |
所属Hap包的信息。
<br>
(详见SDK目录下的
`api\bundle\hapModuleInfo.d.ts`
) |
| config | Configuration | 是 | 否 |
所属Module的配置信息。
<br>
(详见SDK目录下的
`api\@ohos.application.Configuration.d.ts`
)
|
| extensionAbilityInfo |
[
ExtensionAbilityInfo
](
js-apis-bundle-ExtensionAbilityInfo.md
)
| 是 | 否 |
所属Extension的信息。
<br>
(详见SDK目录下的
`api\bundle\extensionAbilityInfo.d.ts`
)
|
## 使用场景
ExtensionContext主要用于查询所属Extension的信息、Module的配置信息以及Hap包的信息,开发者可根据自身业务需求使用对应的信息。此处以ServiceExtension为例,展示ExtensionContext的一种使用场景。
**场景说明:**
一个应用为了适配不同性能的设备,提供了highPerformance、midPerformance、lowPerformance三个Module,这三个Module均提供了一个ServiceExtension给entry使用。安装应用时,应用市场会根据设备的性能,选择对应Module的Hap包与entry的Hap包进行打包安装,实际运行应用时,entry将解析ServiceExtensionContext.HapModuleInfo获取Hap包信息,根据不同的Hap包执行不同的业务逻辑。
![
Example
](
figures/zh_cn_image_ExtensionContext_Example.png
)
**示例:**
三个Module内都定义一个相同名称的ServiceExtension:
```
js
import
ServiceExtension
from
'
@ohos.application.ServiceExtensionAbility
'
import
Want
from
'
@ohos.application.Want
'
;
export
default
class
TheServiceExtension
extends
ServiceExtension
{
onCreate
(
want
:
Want
)
{
console
.
log
(
'
ServiceAbility onCreate, want:
'
+
want
.
abilityName
);
// 通过globalThis传递ExtensionContext给entry
globalThis
.
ExtensionContext
=
this
.
context
;
}
onRequest
(
want
,
startId
)
{
console
.
log
(
'
ServiceAbility onRequest, want:
'
+
want
.
abilityName
+
'
, startId:
'
+
startId
);
}
onConnect
(
want
)
{
console
.
log
(
'
ServiceAbility onConnect, want:
'
+
want
.
abilityName
);
return
null
;
}
onDisconnect
(
want
)
{
console
.
log
(
'
ServiceAbility onDisconnect, want:
'
+
want
.
abilityName
);
}
onDestroy
()
{
console
.
log
(
'
ServiceAbility onDestroy
'
);
}
}
```
在entry的MainAbility的onCreate回调内启动ServiceExtension
```
js
import
Ability
from
'
@ohos.application.Ability
'
export
default
class
MainAbility
extends
Ability
{
onCreate
(
want
,
launchParam
)
{
console
.
log
(
"
[Demo] MainAbility onCreate
"
);
let
wantExt
=
{
deviceId
:
""
,
bundleName
:
"
com.example.TheServiceExtension
"
,
abilityName
:
"
TheServiceExtension
"
,
};
this
.
context
.
startServiceExtensionAbility
(
wantExt
);
}
};
```
在entry内新建一个ServiceModule.ts,专用于执行业务逻辑
```
js
export
default
class
ServiceModel
{
moduleName
:
string
;
constructor
()
{}
executeTask
()
{
if
(
globalThis
.
ExtensionContext
==
undefined
)
{
console
.
log
(
"
ERROR, ServiceExtension does not exist
"
);
return
;
}
var
moduleInfo
=
globalThis
.
ExtensionContext
.
currentHapModuleInfo
;
this
.
moduleName
=
moduleInfo
.
name
;
// 根据moduleName执行不同的业务逻辑,实现对不同性能设备的区分
switch
(
this
.
moduleName
)
{
case
"
highPerformance
"
:
console
.
log
(
"
This is high performance device.
"
);
// 执行对应业务逻辑
break
;
case
"
midPerformance
"
:
console
.
log
(
"
This is mid performance device.
"
);
// 执行对应业务逻辑
break
;
case
"
lowPerformance
"
:
console
.
log
(
"
This is low performance device.
"
);
// 执行对应业务逻辑
break
;
default
:
console
.
log
(
"
ERROR, invalid moduleName.
"
);
break
;
}
}
}
```
zh-cn/application-dev/reference/apis/js-apis-service-extension-context.md
浏览文件 @
8082e768
...
...
@@ -6,8 +6,8 @@ ServiceExtensionContext模块提供ServiceExtensionAbility具有的能力和接
> **说明:**
>
>
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
>
- 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>
-
本模块接口仅可在Stage模型下使用。
## 使用说明
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录