Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
842bd563
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看板
提交
842bd563
编写于
7月 15, 2022
作者:
Y
yuyaozhi
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Fix master document problems of ability
Signed-off-by:
N
yuyaozhi
<
yuyaozhi@huawei.com
>
上级
c813679f
变更
16
隐藏空白更改
内联
并排
Showing
16 changed file
with
1294 addition
and
229 deletion
+1294
-229
zh-cn/application-dev/reference/apis/js-apis-Context.md
zh-cn/application-dev/reference/apis/js-apis-Context.md
+322
-26
zh-cn/application-dev/reference/apis/js-apis-ability-context.md
...application-dev/reference/apis/js-apis-ability-context.md
+265
-1
zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md
...cation-dev/reference/apis/js-apis-ability-wantConstant.md
+2
-0
zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegator.md
...ev/reference/apis/js-apis-application-abilityDelegator.md
+3
-3
zh-cn/application-dev/reference/apis/js-apis-application-context.md
...ication-dev/reference/apis/js-apis-application-context.md
+7
-1
zh-cn/application-dev/reference/apis/js-apis-appmanager.md
zh-cn/application-dev/reference/apis/js-apis-appmanager.md
+139
-1
zh-cn/application-dev/reference/apis/js-apis-dataAbilityHelper.md
...plication-dev/reference/apis/js-apis-dataAbilityHelper.md
+8
-4
zh-cn/application-dev/reference/apis/js-apis-errorManager.md
zh-cn/application-dev/reference/apis/js-apis-errorManager.md
+127
-0
zh-cn/application-dev/reference/apis/js-apis-extension-context.md
...plication-dev/reference/apis/js-apis-extension-context.md
+3
-0
zh-cn/application-dev/reference/apis/js-apis-featureAbility.md
.../application-dev/reference/apis/js-apis-featureAbility.md
+0
-24
zh-cn/application-dev/reference/apis/js-apis-formextension.md
...n/application-dev/reference/apis/js-apis-formextension.md
+1
-1
zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md
...cation-dev/reference/apis/js-apis-formextensioncontext.md
+4
-74
zh-cn/application-dev/reference/apis/js-apis-formprovider.md
zh-cn/application-dev/reference/apis/js-apis-formprovider.md
+12
-8
zh-cn/application-dev/reference/apis/js-apis-missionManager.md
.../application-dev/reference/apis/js-apis-missionManager.md
+82
-0
zh-cn/application-dev/reference/apis/js-apis-service-extension-ability.md
...n-dev/reference/apis/js-apis-service-extension-ability.md
+1
-1
zh-cn/application-dev/reference/apis/js-apis-service-extension-context.md
...n-dev/reference/apis/js-apis-service-extension-context.md
+318
-85
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-Context.md
浏览文件 @
842bd563
...
...
@@ -296,6 +296,220 @@ context.getBundleName().then((data) => {
});
```
## Context.getDisplayOrientation<sup>7+</sup>
getDisplayOrientation(callback: AsyncCallback
\<
bundle.DisplayOrientation>): void
获取此能力的当前显示方向(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ----------------------------- |
| callback | AsyncCallback
\<
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
> | 是 | 表示屏幕显示方向。 |
**示例:**
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getDisplayOrientation
()
```
## Context.getDisplayOrientation<sup>7+</sup>
getDisplayOrientation(): Promise
\<
bundle.DisplayOrientation>;
获取此能力的当前显示方向(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**返回值:**
| 类型 | 说明 |
| ---------------- | ------------------------- |
| Promise
\<
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
> | 表示屏幕显示方向。 |
**示例:**
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
getDisplayOrientation
().
then
((
data
)
=>
{
console
.
info
(
"
=======================>getDisplayOrientationCallback====================>
"
);
console
.
info
(
"
====>data====>
"
+
JSON
.
stringify
(
data
));
});
```
## Context.setDisplayOrientation<sup>7+</sup>
setDisplayOrientation(orientation: bundle.DisplayOrientation, callback: AsyncCallback
\<
void>): void
设置当前能力的显示方向(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ----------------------------- |
| orientation |
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
| 是 | 指示当前能力的新方向。。 |
| callback | AsyncCallback
\<
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
> | 是 | 表示屏幕显示方向。 |
**示例:**
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
var
orientation
=
"
UNSPECIFIED
"
context
.
setDisplayOrientation
(
orientation
,
(
err
)
=>
{
console
.
log
(
'
---------- setDisplayOrientation fail, err: -----------
'
,
err
);
});
```
## Context.setDisplayOrientation<sup>7+</sup>
setDisplayOrientation(orientation: bundle.DisplayOrientation): Promise
\<
void>;
设置当前能力的显示方向(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**返回值:**
| 类型 | 说明 |
| ---------------- | ------------------------- |
| orientation |
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
| 是 | 指示当前能力的新方向。。 |
| Promise
\<
[
bundle.DisplayOrientation
](
js-apis-bundle.md#displayorientation
)
> | 表示屏幕显示方向。 |
**示例:**
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
setDisplayOrientation
().
then
((
data
)
=>
{
console
.
info
(
"
=======================>setDisplayOrientationCallback====================>
"
);
console
.
info
(
"
====>data====>
"
+
JSON
.
stringify
(
data
));
});
```
## Context.setShowOnLockScreen<sup>7+</sup>
setShowOnLockScreen(show: boolean, callback: AsyncCallback
\<
void>): void
设置每当显示锁屏时是否在锁屏顶部显示此功能,使该功能保持激活状态(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ----------------------------- |
| show | boolean | 是 | 指定是否在锁屏顶部显示此功能。值true表示在锁屏上显示,值false表示不显示。 |
| callback | AsyncCallback
\<
void> | 是 | 返回回调结果。 |
**示例:**
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
var
show
=
true
context
.
setShowOnLockScreen
(
show
,
(
err
)
=>
{
console
.
log
(
'
---------- setShowOnLockScreen fail, err: -----------
'
,
err
);
});
```
## Context.setShowOnLockScreen<sup>7+</sup>
setShowOnLockScreen(show: boolean): Promise
\<
void>;
设置每当显示锁屏时是否在锁屏顶部显示此功能,使该功能保持激活状态(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ----------------------------- |
| show | boolean | 是 | 指定是否在锁屏顶部显示此功能。值true表示在锁屏上显示,值false表示不显示。 |
**返回值:**
| 类型 | 说明 |
| ---------------- | ------------------------- |
| Promise
\<
void>| 使用Promise形式返回结果 |
**示例:**
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
setShowOnLockScreen
().
then
((
data
)
=>
{
console
.
info
(
"
=======================>setShowOnLockScreenCallback====================>
"
);
console
.
info
(
"
====>data====>
"
+
JSON
.
stringify
(
data
));
});
```
## Context.setWakeUpScreen<sup>7+</sup>
setWakeUpScreen(wakeUp: boolean, callback: AsyncCallback
\<
void>): void
设置恢复此功能时是否唤醒屏幕。(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ----------------------------- |
| wakeUp | boolean | 是 | 指定是否唤醒屏幕。值true表示唤醒它,值false表示不唤醒它。 |
| callback | AsyncCallback
\<
void> | 是 | 返回回调结果。 |
**示例:**
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
var
wakeUp
=
true
context
.
setWakeUpScreen
(
show
,
(
err
)
=>
{
console
.
log
(
'
---------- setWakeUpScreen fail, err: -----------
'
,
err
);
});
```
## Context.setWakeUpScreen<sup>7+</sup>
setWakeUpScreen(wakeUp: boolean): Promise
\<
void>;
设置恢复此功能时是否唤醒屏幕。(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ----------------------------- |
| wakeUp | boolean | 是 | 指定是否唤醒屏幕。值true表示唤醒它,值false表示不唤醒它。 |
**返回值:**
| 类型 | 说明 |
| ---------------- | ------------------------- |
| Promise
\<
void>| 使用Promise形式返回结果 |
**示例:**
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
setWakeUpScreen
().
then
((
data
)
=>
{
console
.
info
(
"
=======================>setWakeUpScreenCallback====================>
"
);
console
.
info
(
"
====>data====>
"
+
JSON
.
stringify
(
data
));
});
```
## Context.getProcessInfo<sup>7+</sup>
...
...
@@ -728,7 +942,7 @@ getHapModuleInfo(callback: AsyncCallback\<HapModuleInfo>): void
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ------------------------- |
| callback | AsyncCallback
\<
[
HapModuleInfo
](
#hapmoduleinfo
)
> | 是 | 回调函数,可以在回调函数中处理接口返回值,返回应用的ModuleInfo对象。|
| callback | AsyncCallback
\<
[
HapModuleInfo
](
js-apis-bundle-HapModuleInfo.md
)
> | 是 | 回调函数,可以在回调函数中处理接口返回值,返回应用的ModuleInfo对象。|
**示例:**
...
...
@@ -756,7 +970,7 @@ getHapModuleInfo(): Promise\<HapModuleInfo>
| 类型 | 说明 |
| --------------- | ------------------------- |
| Promise
\<
[
HapModuleInfo
](
#hapmoduleinfo
)
> | 返回应用的ModuleInfo对象。 |
| Promise
\<
[
HapModuleInfo
](
js-apis-bundle-HapModuleInfo.md
)
> | 返回应用的ModuleInfo对象。 |
**示例:**
...
...
@@ -770,7 +984,7 @@ context.getHapModuleInfo().then((data) => {
## Context.getAppVersionInfo<sup>7+</sup>
getAppVersionInfo(callback: AsyncCallback
\<
HapModule
Info>): void
getAppVersionInfo(callback: AsyncCallback
<AppVersion
Info>
): void
获取应用的版本信息(callback形式)。
...
...
@@ -893,6 +1107,111 @@ import featureAbility from '@ohos.ability.featureAbility'
var
context
=
featureAbility
.
getContext
().
getApplicationContext
();
```
## Context.isUpdatingConfigurations<sup>7+</sup>
isUpdatingConfigurations(callback: AsyncCallback
\<
boolean>): void;
检查此能力的配置是否正在更改(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ------------------------- |
| callback | AsyncCallback
\<
boolean> | 是 | 如果该能力的配置正在更改,则为true,否则为false。|
**示例:**
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
isUpdatingConfigurations
((
err
,
data
)
=>
{
if
(
err
)
{
console
.
error
(
'
Operation failed. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
}
console
.
info
(
'
Operation successful. Data:
'
+
JSON
.
stringify
(
data
));
});
```
## Context.isUpdatingConfigurations<sup>7+</sup>
isUpdatingConfigurations(): Promise
\<
boolean>;
检查此能力的配置是否正在更改(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**返回值:**
| 类型 | 说明 |
| --------------- | ------------------------- |
|Promise
\<
boolean> | 如果该能力的配置正在更改,则为true,否则为false。 |
**示例:**
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
isUpdatingConfigurations
().
then
((
data
)
=>
{
console
.
info
(
"
====>data====>
"
+
JSON
.
stringify
(
data
));
});
```
## Context.printDrawnCompleted<sup>7+</sup>
printDrawnCompleted(callback: AsyncCallback
\<
void>): void;
通知系统绘制此页面功能所需的时间(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | ---------------------- | ---- | ------------------------- |
| callback | AsyncCallback
\<
void> | 是 | 表示被指定的回调方法。|
**示例:**
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
printDrawnCompleted
((
err
,
data
)
=>
{
if
(
err
)
{
console
.
error
(
'
Operation failed. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
}
console
.
info
(
'
Operation successful. Data:
'
+
JSON
.
stringify
(
data
));
});
```
## Context.printDrawnCompleted<sup>7+</sup>
printDrawnCompleted(): Promise
\<
void>;
通知系统绘制此页面功能所需的时间(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**返回值:**
| 类型 | 说明 |
| --------------- | ------------------------- |
|Promise
\<
void> | 以Promise形式返回结果。 |
**示例:**
```
js
import
featureAbility
from
'
@ohos.ability.featureAbility
'
var
context
=
featureAbility
.
getContext
();
context
.
printDrawnCompleted
().
then
((
data
)
=>
{
console
.
info
(
"
====>data====>
"
+
JSON
.
stringify
(
data
));
});
```
## PermissionOptions<sup>7+</sup>
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
...
...
@@ -912,29 +1231,6 @@ var context = featureAbility.getContext().getApplicationContext();
| permissions | 只读 | Array
\<
string> | 是 | 用户传入的权限。 |
| authResults | 只读 | Array
\<
number> | 是 | 请求权限的结果。 |
## HapModuleInfo<sup>7+</sup>
Hap模块信息
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| name | string | 是 | 否 | 模块名称。 |
| description | string | 是 | 否 | 模块描述信息。 |
| descriptionId | number | 是 | 否 | 描述信息ID。 |
| icon | string | 是 | 否 | 模块图标。 |
| label | string | 是 | 否 | 模块标签。 |
| labelId | number | 是 | 否 | 模块标签ID。 |
| iconId | number | 是 | 否 | 模块图标ID。 |
| backgroundImg | string | 是 | 否 | 模块背景图片。 |
| supportedModes | number | 是 | 否 | 模块支持的模式。 |
| reqCapabilities | Array
\<
string> | 是 | 否 | 模块运行需要的能力。 |
| deviceTypes | Array
\<
string> | 是 | 否 | 支持运行的设备类型。 |
| abilityInfo | Array
\<
AbilityInfo> | 是 | 否 | Ability信息。 |
| moduleName | string | 是 | 否 | 模块名。 |
| mainAbilityName | string | 是 | 否 | 入口Ability名称。 |
| installationFree | boolean | 是 | 否 | 是否支持免安装。 |
| mainElementName | string | 是 | 否 | 入口ability信息。 |
## AppVersionInfo<sup>7+</sup>
| 名称 | 类型 | 可读 | 可写 | 说明 |
...
...
zh-cn/application-dev/reference/apis/js-apis-ability-context.md
浏览文件 @
842bd563
...
...
@@ -306,7 +306,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp
```
## AbilityContext.startAbilityForResultWithAccount
## AbilityContext.startAbilityForResultWithAccount
startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartOptions): Promise
\<
AbilityResult
\>
;
...
...
@@ -352,7 +352,271 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO
console
.
log
(
'
---------- startAbilityForResultWithAccount fail, err: -----------
'
,
err
);
})
```
## AbilityContext.startServiceExtensionAbility
startServiceExtensionAbility(want: Want, callback: AsyncCallback
\<
void>): void;
启动一个新的ServiceExtensionAbility(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
| callback | AsyncCallback
\<
void
\>
| 是 | 启动Ability的回调函数。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
this
.
context
.
startServiceExtensionAbility
(
want
,
(
err
)
=>
{
console
.
log
(
'
---------- startServiceExtensionAbility fail, err: -----------
'
,
err
);
});
```
## AbilityContext.startServiceExtensionAbility
startServiceExtensionAbility(want: Want): Promise
\<
void>;
启动一个新的ServiceExtensionAbility(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
this
.
context
.
startServiceExtensionAbility
(
want
)
.
then
((
data
)
=>
{
console
.
log
(
'
---------- startServiceExtensionAbility success, data: -----------
'
,
data
);
})
.
catch
((
err
)
=>
{
console
.
log
(
'
---------- startServiceExtensionAbility fail, err: -----------
'
,
err
);
})
```
## AbilityContext.startServiceExtensionAbilityWithAccount
startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback
\<
void>): void;
启动一个新的ServiceExtensionAbility(callback形式)。
**需要权限**
: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 需要启动的accountId。 |
| callback | AsyncCallback
\<
void
\>
| 是 | 启动Ability的回调函数。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
var
accountId
=
100
;
this
.
context
.
startServiceExtensionAbilityWithAccount
(
want
,
accountId
,
(
err
)
=>
{
console
.
log
(
'
---------- startServiceExtensionAbilityWithAccount fail, err: -----------
'
,
err
);
});
```
## AbilityContext.startServiceExtensionAbilityWithAccount
startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise
\<
void>;
启动一个新的ServiceExtensionAbility(Promise形式)。
**需要权限**
: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 需要启动的accountId。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
var
accountId
=
100
;
this
.
context
.
startServiceExtensionAbilityWithAccount
(
want
,
accountId
)
.
then
((
data
)
=>
{
console
.
log
(
'
---------- startServiceExtensionAbilityWithAccount success, data: -----------
'
,
data
);
})
.
catch
((
err
)
=>
{
console
.
log
(
'
---------- startServiceExtensionAbilityWithAccount fail, err: -----------
'
,
err
);
})
```
## AbilityContext.stopServiceExtensionAbility
stopServiceExtensionAbility(want: Want, callback: AsyncCallback
\<
void>): void;
停止同一应用程序内的服务(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
| callback | AsyncCallback
\<
void
\>
| 是 | 启动Ability的回调函数。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
this
.
context
.
stopServiceExtensionAbility
(
want
,
(
err
)
=>
{
console
.
log
(
'
---------- stopServiceExtensionAbility fail, err: -----------
'
,
err
);
});
```
## AbilityContext.stopServiceExtensionAbility
stopServiceExtensionAbility(want: Want): Promise
\<
void>;
停止同一应用程序内的服务(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
this
.
context
.
stopServiceExtensionAbility
(
want
)
.
then
((
data
)
=>
{
console
.
log
(
'
---------- stopServiceExtensionAbility success, data: -----------
'
,
data
);
})
.
catch
((
err
)
=>
{
console
.
log
(
'
---------- stopServiceExtensionAbility fail, err: -----------
'
,
err
);
})
```
## AbilityContext.stopServiceExtensionAbilityWithAccount
stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback
\<
void>): void;
使用帐户停止同一应用程序内的服务(callback形式)。
**需要权限**
: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 需要启动的accountId。 |
| callback | AsyncCallback
\<
void
\>
| 是 | 启动Ability的回调函数。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
var
accountId
=
100
;
this
.
context
.
stopServiceExtensionAbilityWithAccount
(
want
,
accountId
,
(
err
)
=>
{
console
.
log
(
'
---------- stopServiceExtensionAbilityWithAccount fail, err: -----------
'
,
err
);
});
```
## AbilityContext.stopServiceExtensionAbilityWithAccount
stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise
\<
void>;
使用帐户停止同一应用程序内的服务(Promise形式)。
**需要权限**
: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 需要启动的accountId。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
var
accountId
=
100
;
this
.
context
.
stopServiceExtensionAbilityWithAccount
(
want
,
accountId
)
.
then
((
data
)
=>
{
console
.
log
(
'
---------- stopServiceExtensionAbilityWithAccount success, data: -----------
'
,
data
);
})
.
catch
((
err
)
=>
{
console
.
log
(
'
---------- stopServiceExtensionAbilityWithAccount fail, err: -----------
'
,
err
);
})
```
## AbilityContext.terminateSelf
...
...
zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md
浏览文件 @
842bd563
...
...
@@ -46,6 +46,8 @@ want操作的常数。
| ACTION_FILE_SELECT
<sup>
7+
</sup>
| ohos.action.fileSelect | 指示选择文件的操作。 |
| PARAMS_STREAM
<sup>
7+
</sup>
| ability.params.stream | 指示与连接发送数据一起使用时,包含与意图相关联的数据流的URI。 |
| ACTION_APP_ACCOUNT_OAUTH
<sup>
8+
</sup>
| ohos.account.appAccount.action.oauth | 指示提供oauth服务的操作。 |
| ACTION_MARKER_DOWNLOAD
<sup>
9+
</sup>
| ohos.want.action.marketDownload | 表示从应用程序市场下载应用程序的的操作。 |
## wantConstant.Entity
...
...
zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegator.md
浏览文件 @
842bd563
...
...
@@ -628,7 +628,7 @@ abilityDelegator.getCurrentTopAbility((err : any, data : any) => {
### printSync
### printSync
<sup>9+</sup>
printSync(msg: string): void
...
...
@@ -654,7 +654,7 @@ abilityDelegator.printSync(msg);
### print
### print
<sup>9+</sup>
print(msg: string, callback: AsyncCallback
\<
void>): void
...
...
@@ -683,7 +683,7 @@ abilityDelegator.print(msg, (err : any) => {
### print
### print
<sup>9+</sup>
print(msg: string): Promise
\<
void>
...
...
zh-cn/application-dev/reference/apis/js-apis-application-context.md
浏览文件 @
842bd563
...
...
@@ -27,7 +27,7 @@ import AbilityContext from '@ohos.application.Ability'
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| resourceManager | resmgr.ResourceManager; | 是 | 否 | ResourceManager对象。 |
| applicationInfo | ApplicationInfo | 是 | 否 | 当前应用信息。 |
...
...
@@ -47,8 +47,12 @@ createBundleContext(bundleName: string): Context;
创建指定应用上下文。
**需要权限**
:ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -117,6 +121,8 @@ createModuleContext(bundleName: string, moduleName: string): Context;
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
zh-cn/application-dev/reference/apis/js-apis-appmanager.md
浏览文件 @
842bd563
...
...
@@ -348,7 +348,7 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
## appManager.getForegroundApplications<sup>8+</sup>
get
ProcessRunningInfos(): Promise
\<
Array
\<
ProcessRunningInfo
>>;
get
ForegroundApplications(): Promise
\<
Array
\<
AppStateData
>>;
获取前台进程的应用程序。
...
...
@@ -588,6 +588,144 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
```
## ApplicationStateObserver.onForegroundApplicationChanged<sup>8+</sup>
onForegroundApplicationChanged(appStateData: AppStateData): void;
将在前台或后台应用程序更改时调用。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
:该接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| appStateData |
[
AppStateData
](
#appstatedata
)
| 否 | 状态更改的应用程序信息。 |
**示例:**
```
js
import
ApplicationStateObserver
from
'
@ohos.application.ApplicationStateObserver
'
const
foregroundApplicationInfo
=
ApplicationStateObserver
.
onForegroundApplicationChanged
();
console
.
log
(
'
-------- foregroundApplicationInfo: ---------
'
,
foregroundApplicationInfo
);
```
## ApplicationStateObserver.onAbilityStateChanged<sup>8+</sup>
onAbilityStateChanged(abilityStateData: AbilityStateData): void;
将在能力状态更改时调用。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
:该接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| abilityStateData |
[
AbilityStateData
](
#abilitystatedata
)
| 否 | 状态更改的能力信息。 |
**示例:**
```
js
import
ApplicationStateObserver
from
'
@ohos.application.ApplicationStateObserver
'
const
abilityStateChangedInfo
=
ApplicationStateObserver
.
onAbilityStateChanged
();
console
.
log
(
'
-------- abilityStateChangedInfo: ---------
'
,
abilityStateChangedInfo
);
```
## ApplicationStateObserver.onProcessCreated<sup>8+</sup>
onProcessCreated(processData: ProcessData): void;
将在创建进程时调用。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
:该接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| processData |
[
ProcessData
](
#processdata
)
| 否 | 进程信息。 |
**示例:**
```
js
import
ApplicationStateObserver
from
'
@ohos.application.ApplicationStateObserver
'
const
processCreatedInfo
=
ApplicationStateObserver
.
onProcessCreated
();
console
.
log
(
'
-------- processCreatedInfo: ---------
'
,
processCreatedInfo
);
```
## ApplicationStateObserver.onProcessDied<sup>8+</sup>
onProcessDied(processData: ProcessData): void;
将在进程终止时调用。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
:该接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| processData | ProcessData | 否 | 进程信息。 |
**示例:**
```
js
import
ApplicationStateObserver
from
'
@ohos.application.ApplicationStateObserver
'
const
processDiedInfo
=
ApplicationStateObserver
.
onProcessDied
();
console
.
log
(
'
-------- processDiedInfo: ---------
'
,
processDiedInfo
);
```
## AppStateData
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
**系统API**
:该接口为系统接口,三方应用不支持调用。
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ |
| bundleName
<sup>
8+
</sup>
| 只读 | string | 否 | 包名。 |
| uid
<sup>
8+
</sup>
| 只读 | number | 否 | 用户ID。 |
| state
<sup>
8+
</sup>
| 只读 | number | 否 | 进程信息。 |
## AbilityStateData
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
**系统API**
:该接口为系统接口,三方应用不支持调用。
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------------- | ---------| ---- | ---- | ------------------------- |
| pid
<sup>
8+
</sup>
| number | 是 | 否 | 进程ID。 |
| bundleName
<sup>
8+
</sup>
| string | 是 | 否 | 应用包名。 |
| abilityName
<sup>
8+
</sup>
| string | 是 | 否 | Ability名称。 |
| uid
<sup>
8+
</sup>
| number | 是 | 否 | 用户ID。 |
| state
<sup>
8+
</sup>
| number | 是 | 否 | 应用程序信息。 |
| moduleName
<sup>
9+
</sup>
| string | 是 | 否 | Ability所属的HAP包的名称。 |
| abilityType
<sup>
8+
</sup>
| string | 是 | 否 | 能力类型、页面或服务等。 |
## ProcessData
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
**系统API**
:该接口为系统接口,三方应用不支持调用。
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------------- | ---------| ---- | ---- | ------------------------- |
| pid
<sup>
8+
</sup>
| number | 是 | 否 | 进程ID。 |
| bundleName
<sup>
8+
</sup>
| string | 是 | 否 | 应用包名。 |
| uid
<sup>
8+
</sup>
| number | 是 | 否 | 用户ID。 |
## ProcessRunningInfo
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...
...
zh-cn/application-dev/reference/apis/js-apis-dataAbilityHelper.md
浏览文件 @
842bd563
...
...
@@ -662,7 +662,7 @@ DAHelper.delete(
## DataAbilityHelper.delete
delete(uri: string, predicates
: dataAbility.DataAbilityPredicates): Promise
\<
number>
delete(uri: string, predicates
?: dataAbility.DataAbilityPredicates): Promise
\<
number>;
从数据库中删除一个或多个数据记录(Promise形式)。
...
...
@@ -741,7 +741,7 @@ DAHelper.update(
## DataAbilityHelper.update
update(uri: string, valuesBucket: rdb.ValuesBucket, predicates
: dataAbility.DataAbilityPredicates): Promise
\<
number>
update(uri: string, valuesBucket: rdb.ValuesBucket, predicates
?: dataAbility.DataAbilityPredicates): Promise
\<
number>;
更新数据库中的数据记录(Promise形式)。
...
...
@@ -825,7 +825,7 @@ DAHelper.query(
## DataAbilityHelper.query
query(uri: string, columns
: Array
\<
string>, predicates: dataAbility.DataAbilityPredicates): Promise
\<
ResultSet>
query(uri: string, columns
?: Array
<string>
, predicates?: dataAbility.DataAbilityPredicates): Promise
\<
ResultSet>;
查询数据库中的数据(Promise形式)。
...
...
@@ -934,6 +934,10 @@ dataAbilityHelper.call("dataability:///com.example.jsapidemo.UserDataAbility", "
```
## PacMap
[
key: string
]:
number
| string | boolean | Array
\<
string | number | boolean> | null;
**系统能力**
:SystemCapability.Ability.AbilityRuntime.FAModel
| 名称 | 参数类型 | 必填 | 说明 |
| ------ | ------ | ------ | ------ |
| [key: string] | number
\|
string
\|
boolean
\|
Array
\<
string
\|
number
\|
boolean
\>
\|
null | 是 | 数据存储在键值对中。 |
\ No newline at end of file
| [key: string] | number
\|
string
\|
boolean
\|
Array
\<
string
\|
number
\|
boolean
\>
\|
null | Yes| 数据存储在键值对中。|
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-errorManager.md
0 → 100644
浏览文件 @
842bd563
# ErrorManager
ErrorManager模块提供对错误观察器的注册和注销的能力。
> **说明:**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
import errorManager from '@ohos.application.errorManager'
```
## ErrorManager.registerErrorObserver
registerErrorObserver(observer: ErrorObserver): number;
注册错误观测器。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| observer |
[
ErrorObserver
](
#errorobserver
)
| 否 | 返回观察者的数字代码。 |
**示例:**
```
js
var
observer
=
"
12345
"
;
errorManager
.
registerErrorObserver
(
observer
)
.
then
((
data
)
=>
{
console
.
log
(
'
----------- registerErrorObserver success ----------
'
,
data
);
})
.
catch
((
err
)
=>
{
console
.
log
(
'
----------- registerErrorObserver fail ----------
'
,
err
);
})
```
## ErrorManager.unregisterErrorObserver
unregisterErrorObserver(observerId: number, callback: AsyncCallback
\<
void>): void;
注销错误观测器。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| observerId | number | 否 | 返回观察者的数字代码。 |
| callback | AsyncCallback
\<
void> | 否 | 表示指定的回调方法。 |
**示例:**
```
js
var
observerId
=
100
;
function
unregisterErrorObserver
(
err
)
{
if
(
err
)
{
console
.
log
(
'
------------ unregisterErrorObserverCallback ------------
'
,
err
);
}
}
errorManager
.
unregisterErrorObserver
(
observerId
,
unregisterErrorObserverCallback
);
```
## ErrorManager.unregisterErrorObserver
unregisterErrorObserver(observerId: number): Promise
\<
void>;
注销错误观测器。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| observerId | number | 否 | 返回观察者的数字代码。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
\<
void> | 返回执行结果。 |
**示例:**
```
js
var
observerId
=
100
;
errorManager
.
unregisterErrorObserver
(
observerId
)
.
then
((
data
)
=>
{
console
.
log
(
'
----------- unregisterErrorObserver success ----------
'
,
data
);
})
.
catch
((
err
)
=>
{
console
.
log
(
'
----------- unregisterErrorObserver fail ----------
'
,
err
);
})
```
## ErrorObserver
onUnhandledException(errMsg: string): void;
将在js运行时引发用户未捕获的异常时调用。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| errMsg | string | 否 | 有关异常的消息和错误堆栈跟踪。 |
**示例:**
```
js
var
errMsg
=
"
12345
"
;
errorManager
.
onUnhandledException
(
errMsg
,
(
error
)
=>
{
console
.
log
(
"
error.code =
"
+
error
.
code
)
})
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-extension-context.md
浏览文件 @
842bd563
...
...
@@ -17,3 +17,6 @@ ExtensionContext模块提供扩展的上下文的能力,包括允许访问特
| -------- | -------- | -------- | -------- | -------- |
| currentHapModuleInfo | HapModuleInfo | 是 | 否 | 当前Hap包的信息。 |
| config | Configuration | 是 | 否 | 模块的配置信息。 |
| extensionAbilityInfo |
[
ExtensionAbilityInfo
](
js-apis-bundle-ExtensionAbilityInfo.md
)
| 是 | 否 | 服务扩展信息。 |
zh-cn/application-dev/reference/apis/js-apis-featureAbility.md
浏览文件 @
842bd563
...
...
@@ -327,8 +327,6 @@ featureAbility.terminateSelfWithResult(
});
```
## featureAbility.hasWindowFocus<sup>7+<sup>
hasWindowFocus(callback: AsyncCallback
\<
boolean>): void
...
...
@@ -350,8 +348,6 @@ import featureAbility from '@ohos.ability.featureAbility';
featureAbility
.
hasWindowFocus
()
```
## featureAbility.hasWindowFocus<sup>7+<sup>
hasWindowFocus(): Promise
\<
boolean>
...
...
@@ -375,8 +371,6 @@ featureAbility.hasWindowFocus().then((data) => {
});
```
## featureAbility.getWant
getWant(callback: AsyncCallback
\<
Want>): void
...
...
@@ -398,8 +392,6 @@ import featureAbility from '@ohos.ability.featureAbility';
featureAbility
.
getWant
()
```
## featureAbility.getWant
getWant(): Promise
\<
Want>
...
...
@@ -445,8 +437,6 @@ var context = featureAbility.getContext()
context
.
getBundleName
()
```
## featureAbility.terminateSelf<sup>7+</sup>
terminateSelf(callback: AsyncCallback
\<
void>): void
...
...
@@ -468,8 +458,6 @@ import featureAbility from '@ohos.ability.featureAbility';
featureAbility
.
terminateSelf
()
```
## featureAbility.terminateSelf<sup>7+</sup>
terminateSelf(): Promise
\<
void>
...
...
@@ -508,18 +496,6 @@ connectAbility(request: Want, options:ConnectOptions): number
| request |
[
Want
](
js-apis-application-Want.md
)
| 是 | 表示被连接的ServiceAbility。 |
| options |
[
ConnectOptions
](
#connectoptions
)
| 是 | 被指定的回调方法。 |
## Want
want类型说明
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| ----------- | ---- | ------ | ---- | ---------------------------------------- |
| deviceId | 只读 | string | 否 | 表示被连接的ServiceAbility的设备id,缺省表示连接本地的ServiceAbility。 |
| bundleName | 只读 | string | 是 | 表示被连接的ServiceAbility的包名。 |
| abilityName | 只读 | string | 是 | 表示被连接的ServiceAbility的类名。 |
## ConnectOptions
ConnectOptions类型说明
...
...
zh-cn/application-dev/reference/apis/js-apis-formextension.md
浏览文件 @
842bd563
...
...
@@ -225,7 +225,7 @@ onConfigurationUpdated(config: Configuration): void;
}
```
## FormExtension.onAcquireFormState
## FormExtension.onAcquireFormState
onAcquireFormState?(want: Want): formInfo.FormState;
...
...
zh-cn/application-dev/reference/apis/js-apis-formextensioncontext.md
浏览文件 @
842bd563
...
...
@@ -13,80 +13,6 @@ FormExtensionContext模块提供FormExtension具有的接口和能力。
FormExtensionContext模块是FormExtension的上下文环境,继承自ExtensionContext。
## FormExtensionContext.updateForm
updateForm(formId: string, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback
\<
void>): void
主动更新卡片。
**系统能力**
:SystemCapability.Ability.Form
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| --------------- | ------------------------------------------------------------ | ---- | -------------------------------------- |
| formId | string | 是 | 请求更新的卡片ID。 |
| formBindingData |
[
formBindingData.FormBindingData
](
js-apis-formbindingdata.md#formbindingdata
)
| 是 | 卡片新的数据。 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数,返回接口调用是否成功的结果。 |
**示例:**
```
js
import
formBindingData
from
'
@ohos.application.formBindingData
'
import
FormExtension
from
'
@ohos.application.FormExtension
'
export
default
class
MyFormExtension
extends
FormExtension
{
onUpdate
(
formId
)
{
console
.
log
(
'
FormExtension onUpdate, formId:
'
+
formId
);
let
obj2
=
formBindingData
.
createFormBindingData
({
temperature
:
"
22c
"
,
time
:
"
22:00
"
});
this
.
context
.
updateForm
(
formId
,
obj2
,
(
data
)
=>
{
console
.
log
(
'
FormExtension context updateForm, data:
'
+
data
);
});
}
}
```
## FormExtensionContext.updateForm
updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Promise
\<
void>
更新卡片。
**系统能力**
:SystemCapability.Ability.Form
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| --------------- | ------------------------------------------------------------ | ---- | ------------------ |
| formId | string | 是 | 请求更新的卡片ID。 |
| formBindingData |
[
formBindingData.FormBindingData
](
js-apis-formbindingdata.md#formbindingdata
)
| 是 | 卡片新的数据。 |
**返回值:**
| 类型 | 说明 |
| -------------- | --------------------------------- |
| Promise
\<
void> | 返回一个Promise,包含接口的结果。 |
**示例:**
```
js
import
formBindingData
from
'
@ohos.application.formBindingData
'
import
FormExtension
from
'
@ohos.application.FormExtension
'
export
default
class
MyFormExtension
extends
FormExtension
{
onUpdate
(
formId
)
{
console
.
log
(
'
FormExtension onUpdate, formId:
'
+
formId
);
let
obj2
=
formBindingData
.
createFormBindingData
({
temperature
:
"
22c
"
,
time
:
"
22:00
"
});
this
.
context
.
updateForm
(
formId
,
obj2
)
.
then
((
data
)
=>
{
console
.
log
(
'
FormExtension context updateForm, data:
'
+
data
);
}).
catch
((
error
)
=>
{
console
.
error
(
'
Operation updateForm failed. Cause:
'
+
error
);});
}
}
```
## FormExtensionContext.startAbility
startAbility(want: Want, callback: AsyncCallback
<
void
>
): void
...
...
@@ -95,6 +21,8 @@ startAbility(want: Want, callback: AsyncCallback<void>): void
**系统能力**
:SystemCapability.Ability.Form
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -126,6 +54,8 @@ startAbility(want: Want): Promise<void>
**系统能力**
:SystemCapability.Ability.Form
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
zh-cn/application-dev/reference/apis/js-apis-formprovider.md
浏览文件 @
842bd563
...
...
@@ -238,13 +238,13 @@ formProvider.getFormsInfo(filter).then((data) => {
## requestPublishForm<sup>9+</sup>
requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback
<
string
>
):
<
void
>
;
requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback
\<
string>): void
;
请求发布一张卡片到使用方。
**系统能力:**
**系统能力:**
SystemCapability.Ability.Form
SystemCapability.Ability.Form
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
...
...
@@ -278,13 +278,13 @@ SystemCapability.Ability.Form
## requestPublishForm<sup>9+</sup>
requestPublishForm(want: Want, callback: AsyncCallback
<
string
>
):
<
void
>
;
requestPublishForm(want: Want, callback: AsyncCallback
<
string
>
):
void
;
请求发布一张卡片到使用方。
**系统能力:**
**系统能力:**
SystemCapability.Ability.Form
SystemCapability.Ability.Form
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
...
...
@@ -319,9 +319,9 @@ requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData
请求发布一张卡片到使用方。
**系统能力:**
**系统能力:**
SystemCapability.Ability.Form
SystemCapability.Ability.Form
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
...
...
@@ -362,6 +362,8 @@ isRequestPublishFormSupported(callback: AsyncCallback<boolean>): void;
**系统能力:**
SystemCapability.Ability.Form
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -404,6 +406,8 @@ isRequestPublishFormSupported(): Promise<boolean>;
**系统能力:**
SystemCapability.Ability.Form
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**返回值:**
| 类型 | 说明 |
...
...
zh-cn/application-dev/reference/apis/js-apis-missionManager.md
浏览文件 @
842bd563
...
...
@@ -362,6 +362,88 @@ getMissionSnapShot(deviceId: string, missionId: number): Promise<MissionSnaps
});
```
## missionManager.getLowResolutionMissionSnapShot
getLowResolutionMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback
\<
MissionSnapshot>): void;
使用给定的任务ID获取任务低分辨率快照。
**需要权限**
:ohos.permission.MANAGE_MISSIONS
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Mission
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| deviceId | string | 是 | 设备ID,本机默认为空字符串。 |
| missionId | number | 是 | 任务ID。 |
| callback | AsyncCallback
<
[MissionSnapshot](js-apis-application-MissionSnapshot.md)
>
| 是 | 执行结果回调函数,返回任务快照信息。 |
**示例:**
```
js
import
missionManager
from
'
@ohos.application.missionManager
'
missionManager
.
getMissionInfos
(
""
,
10
,
(
error
,
missions
)
=>
{
console
.
log
(
"
getMissionInfos is called, error.code =
"
+
error
.
code
);
console
.
log
(
"
size =
"
+
missions
.
length
);
console
.
log
(
"
missions =
"
+
JSON
.
stringify
(
missions
));
var
id
=
missions
[
0
].
missionId
;
missionManager
.
getLowResolutionMissionSnapShot
(
""
,
id
,
(
error
,
snapshot
)
=>
{
console
.
log
(
"
getLowResolutionMissionSnapShot is called, error.code =
"
+
error
.
code
);
console
.
log
(
"
bundleName =
"
+
snapshot
.
ability
.
bundleName
);
})
})
```
## missionManager.getLowResolutionMissionSnapShot
getLowResolutionMissionSnapShot(deviceId: string, missionId: number): Promise
\<
MissionSnapshot>;
使用给定的任务ID获取任务低分辨率快照。
**需要权限**
:ohos.permission.MANAGE_MISSIONS
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Mission
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| deviceId | string | 是 | 设备ID,本机默认为空字符串。 |
| missionId | number | 是 | 任务ID。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
[MissionSnapshot](js-apis-application-MissionSnapshot.md)
>
| 任务快照信息。 |
**示例:**
```
js
import
missionManager
from
'
@ohos.application.missionManager
'
var
allMissions
;
missionManager
.
getMissionInfos
(
""
,
10
).
then
(
function
(
res
){
allMissions
=
res
;
}).
catch
(
function
(
err
){
console
.
log
(
err
);});
console
.
log
(
"
size =
"
+
allMissions
.
length
);
console
.
log
(
"
missions =
"
+
JSON
.
stringify
(
allMissions
));
var
id
=
allMissions
[
0
].
missionId
;
var
snapshot
=
missionManager
.
getLowResolutionMissionSnapShot
(
""
,
id
).
catch
(
function
(
err
){
console
.
log
(
err
);
});
```
## missionManager.lockMission
...
...
zh-cn/application-dev/reference/apis/js-apis-service-extension-ability.md
浏览文件 @
842bd563
...
...
@@ -230,7 +230,7 @@ dump(params: Array\<string>): Array\<string>;
转储客户端信息时调用。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统能力**
:SystemCapability.Ability.AbilityRuntime.
Ability
Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
...
...
zh-cn/application-dev/reference/apis/js-apis-service-extension-context.md
浏览文件 @
842bd563
# ServiceExtensionContext
ServiceExtensionContext模块是ServiceExtension的上下文环境,继承自ExtensionContext。
ServiceExtensionContext模块是ServiceExtension
Ability
的上下文环境,继承自ExtensionContext。
ServiceExtensionContext模块提供ServiceExtension具有的能力和接口,包括启动、停止、绑定、解绑Ability。
ServiceExtensionContext模块提供ServiceExtension
Ability
具有的能力和接口,包括启动、停止、绑定、解绑Ability。
> **说明:**
>
...
...
@@ -11,15 +11,16 @@ ServiceExtensionContext模块提供ServiceExtension具有的能力和接口,
## 使用说明
ServiceExtensionContext模块是ServiceExtension的上下文环境,继承自ExtensionContext
。
在使用ServiceExtensionContext的功能前,需要通过ServiceExtensionAbility子类实例获取
。
## 属性
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| extensionAbilityInfo |
[
ExtensionAbilityInfo
](
js-apis-bundle-ExtensionAbilityInfo.md
)
| 是 | 否 | 服务扩展信息。 |
```
js
import
ServiceExtensionAbility
from
'
@ohos.application.ServiceExtensionAbility
'
;
class
MainAbility
extends
ServiceExtensionAbility
{
onCreate
()
{
let
context
=
this
.
context
;
}
}
```
## startAbility
...
...
@@ -41,18 +42,12 @@ startAbility(want: Want, callback: AsyncCallback<void>): void;
**示例:**
```
js
import
ExtensionContext
from
'
@ohos.application.ServiceExtensionAbility
'
;
class
MainAbility
extends
ExtensionContext
{
onWindowStageCreate
(
windowStage
)
{
let
want
=
{
"
bundleName
"
:
"
com.example.myapp
"
,
"
abilityName
"
:
"
MyAbility
"
};
this
.
context
.
startAbility
(
want
,
(
err
)
=>
{
console
.
log
(
'
startAbility result:
'
+
JSON
.
stringify
(
err
));
});
}
}
let
want
=
{
"
bundleName
"
:
"
com.example.myapp
"
,
"
abilityName
"
:
"
MyAbility
"
};
this
.
context
.
startAbility
(
want
,
(
err
)
=>
{
console
.
log
(
'
startAbility result:
'
+
JSON
.
stringify
(
err
));
});
```
## startAbility
...
...
@@ -81,20 +76,16 @@ startAbility(want: Want, options?: StartOptions): Promise\<void>;
**示例:**
```
js
import
ExtensionContext
from
'
@ohos.application.ServiceExtensionAbility
'
;
class
MainAbility
extends
ExtensionContext
{
onWindowStageCreate
(
windowStage
)
{
let
want
=
{
"
bundleName
"
:
"
com.example.myapp
"
,
"
abilityName
"
:
"
MyAbility
"
};
this
.
context
.
startAbility
(
want
).
then
((
data
)
=>
{
console
.
log
(
'
success:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
console
.
log
(
'
failed:
'
+
JSON
.
stringify
(
error
));
});
}
}
let
want
=
{
"
bundleName
"
:
"
com.example.myapp
"
,
"
abilityName
"
:
"
MyAbility
"
};
this
.
context
.
startAbility
(
want
).
then
((
data
)
=>
{
console
.
log
(
'
success:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
console
.
log
(
'
failed:
'
+
JSON
.
stringify
(
error
));
});
```
## startAbility
...
...
@@ -127,13 +118,13 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void&
windowMode
:
0
,
};
this
.
context
.
startAbility
(
want
,
options
,
(
error
)
=>
{
console
.
log
(
"
error.code =
"
+
error
.
code
)
console
.
log
(
"
error.code =
"
+
error
.
code
)
})
```
## ServiceExtensionContext.startAbilityWithAccount
startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback
\<
void
\
>
): void;
startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback
\<
void>): void;
根据account启动Ability(callback形式)。
...
...
@@ -203,7 +194,7 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
## ServiceExtensionContext.startAbilityWithAccount
startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise
\<
void
\
>
;
startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise
\<
void>;
根据account启动Ability(Promise形式)。
...
...
@@ -240,6 +231,273 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
})
```
## ServiceExtensionContext.startServiceExtensionAbility
startServiceExtensionAbility(want: Want, callback: AsyncCallback
\<
void>): void;
启动一个新的ServiceExtensionAbility(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
| callback | AsyncCallback
\<
void
\>
| 是 | 启动Ability的回调函数。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
this
.
context
.
startServiceExtensionAbility
(
want
,
(
err
)
=>
{
console
.
log
(
'
---------- startServiceExtensionAbility fail, err: -----------
'
,
err
);
});
```
## ServiceExtensionContext.startServiceExtensionAbility
startServiceExtensionAbility(want: Want): Promise
\<
void>;
启动一个新的ServiceExtensionAbility(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
this
.
context
.
startServiceExtensionAbility
(
want
)
.
then
((
data
)
=>
{
console
.
log
(
'
---------- startServiceExtensionAbility success, data: -----------
'
,
data
);
})
.
catch
((
err
)
=>
{
console
.
log
(
'
---------- startServiceExtensionAbility fail, err: -----------
'
,
err
);
})
```
## ServiceExtensionContext.startServiceExtensionAbilityWithAccount
startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback
\<
void>): void;
启动一个新的ServiceExtensionAbility(callback形式)。
**需要权限**
: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 需要启动的accountId。 |
| callback | AsyncCallback
\<
void
\>
| 是 | 启动Ability的回调函数。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
var
accountId
=
100
;
this
.
context
.
startServiceExtensionAbilityWithAccount
(
want
,
accountId
,
(
err
)
=>
{
console
.
log
(
'
---------- startServiceExtensionAbilityWithAccount fail, err: -----------
'
,
err
);
});
```
## ServiceExtensionContext.startServiceExtensionAbilityWithAccount
startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise
\<
void>;
启动一个新的ServiceExtensionAbility(Promise形式)。
**需要权限**
: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 需要启动的accountId。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
var
accountId
=
100
;
this
.
context
.
startServiceExtensionAbilityWithAccount
(
want
,
accountId
)
.
then
((
data
)
=>
{
console
.
log
(
'
---------- startServiceExtensionAbilityWithAccount success, data: -----------
'
,
data
);
})
.
catch
((
err
)
=>
{
console
.
log
(
'
---------- startServiceExtensionAbilityWithAccount fail, err: -----------
'
,
err
);
})
```
## ServiceExtensionContext.stopServiceExtensionAbility
stopServiceExtensionAbility(want: Want, callback: AsyncCallback
\<
void>): void;
停止同一应用程序内的服务(callback形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
| callback | AsyncCallback
\<
void
\>
| 是 | 启动Ability的回调函数。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
this
.
context
.
stopServiceExtensionAbility
(
want
,
(
err
)
=>
{
console
.
log
(
'
---------- stopServiceExtensionAbility fail, err: -----------
'
,
err
);
});
```
## ServiceExtensionContext.stopServiceExtensionAbility
stopServiceExtensionAbility(want: Want): Promise
\<
void>;
停止同一应用程序内的服务(Promise形式)。
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
this
.
context
.
stopServiceExtensionAbility
(
want
)
.
then
((
data
)
=>
{
console
.
log
(
'
---------- stopServiceExtensionAbility success, data: -----------
'
,
data
);
})
.
catch
((
err
)
=>
{
console
.
log
(
'
---------- stopServiceExtensionAbility fail, err: -----------
'
,
err
);
})
```
## ServiceExtensionContext.stopServiceExtensionAbilityWithAccount
stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback
\<
void>): void;
使用帐户停止同一应用程序内的服务(callback形式)。
**需要权限**
: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 需要启动的accountId。 |
| callback | AsyncCallback
\<
void
\>
| 是 | 启动Ability的回调函数。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
var
accountId
=
100
;
this
.
context
.
stopServiceExtensionAbilityWithAccount
(
want
,
accountId
,
(
err
)
=>
{
console
.
log
(
'
---------- stopServiceExtensionAbilityWithAccount fail, err: -----------
'
,
err
);
});
```
## ServiceExtensionContext.stopServiceExtensionAbilityWithAccount
stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise
\<
void>;
使用帐户停止同一应用程序内的服务(Promise形式)。
**需要权限**
: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**
:SystemCapability.Ability.AbilityRuntime.Core
**系统API**
: 此接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| want |
[
Want
](
js-apis-application-Want.md
)
| 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 需要启动的accountId。 |
**示例:**
```
js
var
want
=
{
"
deviceId
"
:
""
,
"
bundleName
"
:
"
com.extreme.test
"
,
"
abilityName
"
:
"
MainAbility
"
};
var
accountId
=
100
;
this
.
context
.
stopServiceExtensionAbilityWithAccount
(
want
,
accountId
)
.
then
((
data
)
=>
{
console
.
log
(
'
---------- stopServiceExtensionAbilityWithAccount success, data: -----------
'
,
data
);
})
.
catch
((
err
)
=>
{
console
.
log
(
'
---------- stopServiceExtensionAbilityWithAccount fail, err: -----------
'
,
err
);
})
```
## ServiceExtensionContext.terminateSelf
...
...
@@ -260,19 +518,11 @@ terminateSelf(callback: AsyncCallback<void>): void;
**示例:**
```
js
import
ExtensionContext
from
'
@ohos.application.ServiceExtensionAbility
'
;
class
MainAbility
extends
ExtensionContext
{
onWindowStageCreate
(
windowStage
)
{
this
.
context
.
terminateSelf
((
err
)
=>
{
console
.
log
(
'
terminateSelf result:
'
+
JSON
.
stringify
(
err
));
});
}
}
this
.
context
.
terminateSelf
((
err
)
=>
{
console
.
log
(
'
terminateSelf result:
'
+
JSON
.
stringify
(
err
));
});
```
## ServiceExtensionContext.terminateSelf
terminateSelf(): Promise
<
void
>
;
...
...
@@ -292,17 +542,11 @@ terminateSelf(): Promise<void>;
**示例:**
```
js
import
ExtensionContext
from
'
@ohos.application.ServiceExtensionAbility
'
;
class
MainAbility
extends
ExtensionContext
{
onWindowStageCreate
(
windowStage
)
{
this
.
context
.
terminateSelf
().
then
((
data
)
=>
{
console
.
log
(
'
success:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
console
.
log
(
'
failed:
'
+
JSON
.
stringify
(
error
));
});
}
}
this
.
context
.
terminateSelf
().
then
((
data
)
=>
{
console
.
log
(
'
success:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
console
.
log
(
'
failed:
'
+
JSON
.
stringify
(
error
));
});
```
## ServiceExtensionContext.connectAbility
...
...
@@ -332,13 +576,13 @@ connectAbility(want: Want, options: ConnectOptions): number;
```
js
let
want
=
{
"
bundleName
"
:
"
com.example.myapp
"
,
"
abilityName
"
:
"
MyAbility
"
"
bundleName
"
:
"
com.example.myapp
"
,
"
abilityName
"
:
"
MyAbility
"
};
let
options
=
{
onConnect
:
function
(
elementName
,
proxy
)
{
},
onDisConnect
:
function
(
elementName
)
{
},
onFailed
:
function
(
code
)
{
}
onConnect
(
elementName
,
remote
)
{
console
.
log
(
'
----------- onConnect -----------
'
)
},
onDisconnect
(
elementName
)
{
console
.
log
(
'
----------- onDisconnect -----------
'
)
},
onFailed
(
code
)
{
console
.
log
(
'
----------- onFailed -----------
'
)
}
}
let
connection
=
this
.
context
.
connectAbility
(
want
,
options
);
```
...
...
@@ -405,17 +649,11 @@ disconnectAbility(connection: number, callback:AsyncCallback<void>): void;
**示例:**
```
js
import
ExtensionContext
from
'
@ohos.application.ServiceExtensionAbility
'
;
class
MainAbility
extends
ExtensionContext
{
onWindowStageCreate
(
windowStage
)
{
let
connection
=
1
this
.
context
.
disconnectAbility
(
connection
,
(
err
)
=>
{
let
connection
=
1
this
.
context
.
disconnectAbility
(
connection
,
(
err
)
=>
{
// connection为connectAbility中的返回值
console
.
log
(
'
terminateSelf result:
'
+
JSON
.
stringify
(
err
));
});
}
}
});
```
## ServiceExtensionContext.disconnectAbility
...
...
@@ -443,16 +681,11 @@ disconnectAbility(connection: number): Promise<void>;
**示例:**
```
js
import
ExtensionContext
from
'
@ohos.application.ServiceExtensionAbility
'
;
class
MainAbility
extends
ExtensionContext
{
onWindowStageCreate
(
windowStage
)
{
let
connection
=
1
this
.
context
.
disconnectAbility
(
connection
).
then
((
data
)
=>
{
// connection为connectAbility中的返回值
let
connection
=
1
this
.
context
.
disconnectAbility
(
connection
).
then
((
data
)
=>
{
// connection为connectAbility中的返回值
console
.
log
(
'
success:
'
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
log
(
'
failed:
'
+
JSON
.
stringify
(
error
));
});
}
}
});
```
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录