Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
“98e103366b1908bd81c0e2aa5a2b6ad53dbb2e47”上不存在“doc/design/git@gitcode.net:s920243400/PaddleDetection.git”
未验证 提交 66ddadf2 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!20267 Fix error code of ability 

Merge pull request !20267 from yuyaozhi/master
上级 884002ba 9cabe48c
显示空白变更内容
内联 并排
Showing with 354 addition and 196 deletion
zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md
浏览文件 @ 66ddadf2
...@@ -46,7 +46,7 @@ want操作的常数。用于表示要执行的通用操作。 ...@@ -46,7 +46,7 @@ want操作的常数。用于表示要执行的通用操作。
| ACTION_FILE_SELECT<sup>7+</sup> | ohos.action.fileSelect | 指示选择文件的操作。 | | ACTION_FILE_SELECT<sup>7+</sup> | ohos.action.fileSelect | 指示选择文件的操作。 |
| PARAMS_STREAM<sup>7+</sup> | ability.params.stream | 指示发送数据时与目标关联的数据流的URI。对应的value必须是string类型的数组。 | | PARAMS_STREAM<sup>7+</sup> | ability.params.stream | 指示发送数据时与目标关联的数据流的URI。对应的value必须是string类型的数组。 |
| ACTION_APP_ACCOUNT_OAUTH <sup>8+</sup> | ohos.account.appAccount.action.oauth | 指示提供oauth服务的操作。 | | ACTION_APP_ACCOUNT_OAUTH <sup>8+</sup> | ohos.account.appAccount.action.oauth | 指示提供oauth服务的操作。 |
| DLP_PARAMS_INDEX<sup>9+</sup> |ohos.dlp.params.index |指示DLP索引参数的操作。 <br>**系统API**：该接口为系统接口，三方应用不支持调用。 |
## wantConstant.Entity ## wantConstant.Entity
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
浏览文件 @ 66ddadf2
...@@ -64,7 +64,7 @@ Ability上次退出原因，该类型为枚举，可配合[Ability](js-apis-app- ...@@ -64,7 +64,7 @@ Ability上次退出原因，该类型为枚举，可配合[Ability](js-apis-app-
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------------------------- | ---- | ------------------------------------------------------------ | | ----------------------------- | ---- | ------------------------------------------------------------ |
| UNKNOWN | 0 | 未知原因。 | | UNKNOWN | 0 | 未知原因。 |
| ABILITY_NOT_RESPONDING<sup>deprecated</sup> | 1 | ability未响应。从API version 9 开始支持，从API version 10 开始废弃，建议使用APP_FREEZE替代。 | | ABILITY_NOT_RESPONDING | 1 | ability未响应。从API version 9 开始支持，从API version 10 开始废弃，建议使用APP_FREEZE替代。 |
| NORMAL | 2 | 用户主动关闭，应用程序正常退出。 | | NORMAL | 2 | 用户主动关闭，应用程序正常退出。 |
| CPP_CRASH<sup>10+</sup> | 3 | 本机异常信号，导致应用程序退出。 | | CPP_CRASH<sup>10+</sup> | 3 | 本机异常信号，导致应用程序退出。 |
| JS_ERROR<sup>10+</sup> | 4 | 当应用存在JS语法错误并未被开发者捕获时，触发JS_ERROR故障，导致应用程序退出。 | | JS_ERROR<sup>10+</sup> | 4 | 当应用存在JS语法错误并未被开发者捕获时，触发JS_ERROR故障，导致应用程序退出。 |
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md
浏览文件 @ 66ddadf2
...@@ -22,9 +22,9 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -22,9 +22,9 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void
**参数：** **参数：**
| 类型| 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | | -------- | -------- | -------- | -------- |
|AsyncCallback&lt;boolean&gt; |以回调方式返回接口运行结果及当前是否处于稳定性测试场景，可进行错误处理或其他自定义处理。true: 处于稳定性测试场景，false：处于非稳定性测试场景。 | | callback | AsyncCallback&lt;boolean&gt; | 是 |以回调方式返回接口运行结果及当前是否处于稳定性测试场景，可进行错误处理或其他自定义处理。true: 处于稳定性测试场景，false：处于非稳定性测试场景。 |
**错误码**： **错误码**：
...@@ -128,9 +128,9 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void; ...@@ -128,9 +128,9 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void;
**参数：** **参数：**
| 类型 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | | -------- | -------- | -------- | -------- |
| AsyncCallback&lt;boolean&gt; |以回调方式返回接口运行结果及当前设备是否为ram受限设备，可进行错误处理或其他自定义处理。true：当前设备为ram受限设备，false：当前设备为非ram受限设备。 | | callback | AsyncCallback&lt;boolean&gt; | 是 |以回调方式返回接口运行结果及当前设备是否为ram受限设备，可进行错误处理或其他自定义处理。true：当前设备为ram受限设备，false：当前设备为非ram受限设备。 |
**错误码**： **错误码**：
...@@ -198,9 +198,9 @@ getAppMemorySize(callback: AsyncCallback\<number>): void; ...@@ -198,9 +198,9 @@ getAppMemorySize(callback: AsyncCallback\<number>): void;
**参数：** **参数：**
| 类型 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | | -------- | -------- | -------- | -------- |
|AsyncCallback&lt;number&gt; |以回调方式返回接口运行结果及应用程序内存大小，可进行错误处理或其他自定义处理。 | | callback | AsyncCallback&lt;number&gt; | 是 |以回调方式返回接口运行结果及应用程序内存大小，可进行错误处理或其他自定义处理。 |
**错误码**： **错误码**：
...@@ -272,9 +272,9 @@ getRunningProcessInformation(callback: AsyncCallback\<Array\<ProcessInformation> ...@@ -272,9 +272,9 @@ getRunningProcessInformation(callback: AsyncCallback\<Array\<ProcessInformation>
**参数：** **参数：**
| 类型 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | | -------- | -------- | -------- | -------- |
|AsyncCallback\<Array\<[ProcessInformation](js-apis-inner-application-processInformation.md)>> | 以回调方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 | | callback | AsyncCallback\<Array\<[ProcessInformation](js-apis-inner-application-processInformation.md)>> | 是 |以回调方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 |
**错误码**： **错误码**：
...@@ -762,7 +762,7 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\> ...@@ -762,7 +762,7 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\>
> >
> 当accountId为当前用户时，不需要校验ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限。 > 当accountId为当前用户时，不需要校验ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限。
**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES, ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS **需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -812,7 +812,7 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal ...@@ -812,7 +812,7 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal
> >
> 当accountId为当前用户时，不需要校验ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限。 > 当accountId为当前用户时，不需要校验ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限。
**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES, ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS **需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-dialogRequest.md
浏览文件 @ 66ddadf2
...@@ -262,7 +262,8 @@ getRequestCallback(want: Want): RequestCallback ...@@ -262,7 +262,8 @@ getRequestCallback(want: Want): RequestCallback
console.info(TAG, `onRequest, want: ${want.abilityName}`); console.info(TAG, `onRequest, want: ${want.abilityName}`);
try { try {
var requestInfo = dialogRequest.getRequestInfo(want); var requestInfo = dialogRequest.getRequestInfo(want);
window.bindDialogTarget(requestInfo, () => { let windowClass = null;
windowClass.bindDialogTarget(requestInfo, () => {
console.info('Dialog Window Need Destroy.'); console.info('Dialog Window Need Destroy.');
}, (err) => { }, (err) => {
if (err.code) { if (err.code) {
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md
浏览文件 @ 66ddadf2
...@@ -257,7 +257,7 @@ revokeQuickFix(bundleName: string, callback: AsyncCallback\<void>): void; ...@@ -257,7 +257,7 @@ revokeQuickFix(bundleName: string, callback: AsyncCallback\<void>): void;
撤销快速修复的接口，使用callback方式返回结果。 撤销快速修复的接口，使用callback方式返回结果。
**需要权限**：ohos.permission.INSTALL_BUNDLE, ohos.permission.GET_BUNDLE_INFO_PRIVILEGED **需要权限**：ohos.permission.GET_BUNDLE_INFO_PRIVILEGED, ohos.permission.INSTALL_BUNDLE
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.QuickFix **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.QuickFix
...@@ -302,7 +302,7 @@ revokeQuickFix(bundleName: string): Promise\<void>; ...@@ -302,7 +302,7 @@ revokeQuickFix(bundleName: string): Promise\<void>;
撤销快速修复的接口，使用Promise方式返回结果。 撤销快速修复的接口，使用Promise方式返回结果。
**需要权限**：ohos.permission.INSTALL_BUNDLE, ohos.permission.GET_BUNDLE_INFO_PRIVILEGED **需要权限**：ohos.permission.GET_BUNDLE_INFO_PRIVILEGED, ohos.permission.INSTALL_BUNDLE
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.QuickFix **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.QuickFix
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
浏览文件 @ 66ddadf2
...@@ -362,7 +362,7 @@ UIAbility生命周期回调，当系统预关闭开关打开后（配置系统 ...@@ -362,7 +362,7 @@ UIAbility生命周期回调，当系统预关闭开关打开后（配置系统
onPrepareToTerminate() { onPrepareToTerminate() {
// 开发者定义预关闭动作 // 开发者定义预关闭动作
// 例如拉起另一个ability，根据ability处理结果执行异步关闭 // 例如拉起另一个ability，根据ability处理结果执行异步关闭
let want:Want = { let want = {
bundleName: "com.example.myapplication", bundleName: "com.example.myapplication",
moduleName: "entry", moduleName: "entry",
abilityName: "SecondAbility" abilityName: "SecondAbility"
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md
浏览文件 @ 66ddadf2
...@@ -31,7 +31,7 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void ...@@ -31,7 +31,7 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
|-----------|--------------------| |-----------|--------------------|
| 16000007 | Service busyness. There are concurrent tasks, waiting for retry.| | 16000007 | Service busy, there are concurrent tasks, waiting for retry.|
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md) 错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
...@@ -110,7 +110,7 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\> ...@@ -110,7 +110,7 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\>
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
|-----------|--------------------| |-----------|--------------------|
| 16000007 | Service busyness. There are concurrent tasks, waiting for retry.| | 16000007 | Service busy, there are concurrent tasks, waiting for retry.|
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md) 错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
...@@ -179,7 +179,7 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void ...@@ -179,7 +179,7 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\<string\>): void
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
|-----------|--------------------| |-----------|--------------------|
| 16000007 | Service busyness. There are concurrent tasks, waiting for retry.| | 16000007 | Service busy, there are concurrent tasks, waiting for retry.|
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md) 错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
...@@ -271,7 +271,7 @@ getBundleName(agent: WantAgent): Promise\<string\> ...@@ -271,7 +271,7 @@ getBundleName(agent: WantAgent): Promise\<string\>
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
|-----------|--------------------| |-----------|--------------------|
| 16000007 | Service busyness. There are concurrent tasks, waiting for retry.| | 16000007 | Service busy, there are concurrent tasks, waiting for retry.|
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md) 错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
...@@ -354,7 +354,7 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void ...@@ -354,7 +354,7 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
|-----------|--------------------| |-----------|--------------------|
| 16000007 | Service busyness. There are concurrent tasks, waiting for retry.| | 16000007 | Service busy, there are concurrent tasks, waiting for retry.|
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md) 错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
...@@ -447,7 +447,7 @@ getUid(agent: WantAgent): Promise\<number\> ...@@ -447,7 +447,7 @@ getUid(agent: WantAgent): Promise\<number\>
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
|-----------|--------------------| |-----------|--------------------|
| 16000007 | Service busyness. There are concurrent tasks, waiting for retry.| | 16000007 | Service busy, there are concurrent tasks, waiting for retry.|
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md) 错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
...@@ -531,7 +531,7 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void ...@@ -531,7 +531,7 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
|-----------|--------------------| |-----------|--------------------|
| 16000007 | Service busyness. There are concurrent tasks, waiting for retry.| | 16000007 | Service busy, there are concurrent tasks, waiting for retry.|
| 16000015 | Service timeout.| | 16000015 | Service timeout.|
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
...@@ -626,7 +626,7 @@ getWant(agent: WantAgent): Promise\<Want\> ...@@ -626,7 +626,7 @@ getWant(agent: WantAgent): Promise\<Want\>
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
|-----------|--------------------| |-----------|--------------------|
| 16000007 | Service busyness. There are concurrent tasks, waiting for retry.| | 16000007 | Service busy, there are concurrent tasks, waiting for retry.|
| 16000015 | Service timeout.| | 16000015 | Service timeout.|
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
...@@ -710,7 +710,7 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void ...@@ -710,7 +710,7 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
|-----------|--------------------| |-----------|--------------------|
| 16000007 | Service busyness. There are concurrent tasks, waiting for retry.| | 16000007 | Service busy, there are concurrent tasks, waiting for retry.|
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md) 错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
...@@ -802,7 +802,7 @@ cancel(agent: WantAgent): Promise\<void\> ...@@ -802,7 +802,7 @@ cancel(agent: WantAgent): Promise\<void\>
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
|-----------|--------------------| |-----------|--------------------|
| 16000007 | Service busyness. There are concurrent tasks, waiting for retry.| | 16000007 | Service busy, there are concurrent tasks, waiting for retry.|
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md) 错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
...@@ -1127,7 +1127,7 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void; ...@@ -1127,7 +1127,7 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
|-----------|--------------------| |-----------|--------------------|
| 16000007 | Service busyness. There are concurrent tasks, waiting for retry.| | 16000007 | Service busy, there are concurrent tasks, waiting for retry.|
| 16000015 | Service timeout.| | 16000015 | Service timeout.|
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
...@@ -1218,7 +1218,7 @@ getOperationType(agent: WantAgent): Promise\<number>; ...@@ -1218,7 +1218,7 @@ getOperationType(agent: WantAgent): Promise\<number>;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
|-----------|--------------------| |-----------|--------------------|
| 16000007 | Service busyness. There are concurrent tasks, waiting for retry.| | 16000007 | Service busy, there are concurrent tasks, waiting for retry.|
| 16000015 | Service timeout.| | 16000015 | Service timeout.|
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
......
zh-cn/application-dev/reference/apis/js-apis-app-form-formBindingData.md
浏览文件 @ 66ddadf2
...@@ -21,8 +21,8 @@ import formBindingData from '@ohos.app.form.formBindingData'; ...@@ -21,8 +21,8 @@ import formBindingData from '@ohos.app.form.formBindingData';
| 名称 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 是 | 卡片代理刷新的订阅标识，与数据发布者保持一致。| | key<sup>10+</sup> | string | 是 | 卡片代理刷新的订阅标识，与数据发布者保持一致。|
| subscriberId | string | 否 | 卡片代理刷新的订阅条件，默认值为当前卡片的formId。| | subscriberId<sup>10+</sup> | string | 否 | 卡片代理刷新的订阅条件，默认值为当前卡片的formId。|
## FormBindingData ## FormBindingData
......
zh-cn/application-dev/reference/apis/js-apis-app-form-formHost.md
浏览文件 @ 66ddadf2
...@@ -1682,7 +1682,7 @@ formHost.on('formRemove', callback, bundleName); ...@@ -1682,7 +1682,7 @@ formHost.on('formRemove', callback, bundleName);
## off('formRemove')<sup>10+</sup> ## off('formRemove')<sup>10+</sup>
off(type: "formRemove", observerCallback?: Callback&lt;formInfo.RunningFormInfo&gt;, bundleName?: string): void off(type: "formRemove", observerCallback?: Callback&lt;formInfo.RunningFormInfo&gt;, bundleName?: string): void
取消订阅卡片删除事件。使用callback异步回调，返回当前删除卡片的[RunningFormInfo](js-apis-app-form-formInfo.md)。 取消订阅卡片删除事件。使用callback异步回调，返回当前删除卡片的[RunningFormInfo](js-apis-app-form-formInfo.md)。
...@@ -2333,7 +2333,7 @@ try { ...@@ -2333,7 +2333,7 @@ try {
## getRunningFormInfoById<sup>10+</sup> ## getRunningFormInfoById<sup>10+</sup>
function getRunningFormInfoById(formId: string): Promise&lt;formInfo.RunningFormInfo&gt; getRunningFormInfoById(formId: string): Promise&lt;formInfo.RunningFormInfo&gt;
根据formId查询卡片已有的使用方列表信息。使用Promise异步回调。 根据formId查询卡片已有的使用方列表信息。使用Promise异步回调。
......
zh-cn/application-dev/reference/apis/js-apis-app-form-formInfo.md
浏览文件 @ 66ddadf2
...@@ -25,7 +25,7 @@ import formInfo from '@ohos.app.form.formInfo'; ...@@ -25,7 +25,7 @@ import formInfo from '@ohos.app.form.formInfo';
| abilityName | string | 是 | 否 | 卡片所属的Ability名称。 | | abilityName | string | 是 | 否 | 卡片所属的Ability名称。 |
| name | string | 是 | 否 | 卡片名称。 | | name | string | 是 | 否 | 卡片名称。 |
| description | string | 是 | 否 | 卡片描述。 | | description | string | 是 | 否 | 卡片描述。 |
| descriptionId | number | 是 | 否 | 卡片描述id。 | | descriptionId<sup>10+</sup> | number | 是 | 否 | 卡片描述id。 |
| type | [FormType](#formtype) | 是 | 否 | 卡片类型。当前支持JS卡片。 | | type | [FormType](#formtype) | 是 | 否 | 卡片类型。当前支持JS卡片。 |
| jsComponentName | string | 是 | 否 | js卡片的组件名。 | | jsComponentName | string | 是 | 否 | js卡片的组件名。 |
| colorMode | [ColorMode](#colormode) | 是 | 否 | 卡片颜色模式。 | | colorMode | [ColorMode](#colormode) | 是 | 否 | 卡片颜色模式。 |
...@@ -154,12 +154,12 @@ import formInfo from '@ohos.app.form.formInfo'; ...@@ -154,12 +154,12 @@ import formInfo from '@ohos.app.form.formInfo';
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | -------- | -------- | -------------------- | ------------------------------------------------------------ | | ----------- | -------- | -------- | -------------------- | ------------------------------------------------------------ |
| formId | string | 是 | 否 | 卡片标识。 | | formId | string | 是 | 否 | 卡片标识。 |
| bundleName | string | 是 | 否 | 提供方卡片所属包的Bundle名称。 | | bundleName<sup>10+</sup> | string | 是 | 否 | 提供方卡片所属包的Bundle名称。 |
| hostBundleName | string | 是 | 否 | 使用方卡片所属包的Bundle名称。 | | hostBundleName | string | 是 | 否 | 使用方卡片所属包的Bundle名称。 |
| visibilityType | [VisibilityType](#visibilitytype) | 是 | 否 | 卡片当前可见类型枚举。 | | visibilityType | [VisibilityType](#visibilitytype) | 是 | 否 | 卡片当前可见类型枚举。 |
| moduleName | string | 是 | 否 | 卡片所属模块的模块名称。 | | moduleName<sup>10+</sup> | string | 是 | 否 | 卡片所属模块的模块名称。 |
| abilityName | string | 是 | 否 | 卡片所属的Ability名称。 | | abilityName<sup>10+</sup> | string | 是 | 否 | 卡片所属的Ability名称。 |
| formName | string | 是 | 否 | 卡片名称。 | | formName<sup>10+</sup> | string | 是 | 否 | 卡片名称。 |
| dimension | number | 是 | 否 | 卡片规格。 | | dimension | number | 是 | 否 | 卡片规格。 |
## formProviderFilter<sup>10+</sup> ## formProviderFilter<sup>10+</sup>
......
zh-cn/application-dev/reference/apis/js-apis-application-StaticSubscriberExtensionContext.md
浏览文件 @ 66ddadf2
...@@ -37,6 +37,8 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -37,6 +37,8 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
- 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限
- 跨应用场景下，目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：该接口为系统接口，三方应用不支持调用。 **系统API**：该接口为系统接口，三方应用不支持调用。
...@@ -104,6 +106,8 @@ startAbility(want: Want): Promise&lt;void&gt;; ...@@ -104,6 +106,8 @@ startAbility(want: Want): Promise&lt;void&gt;;
- 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限 - 调用方应用位于后台时，使用该接口启动Ability需申请`ohos.permission.START_ABILITIES_FROM_BACKGROUND`权限
- 跨应用场景下，目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的visible属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：该接口为系统接口，三方应用不支持调用。 **系统API**：该接口为系统接口，三方应用不支持调用。
......
zh-cn/application-dev/reference/apis/js-apis-application-configuration.md
浏览文件 @ 66ddadf2
...@@ -10,7 +10,7 @@ ...@@ -10,7 +10,7 @@
## 导入模块 ## 导入模块
```ts ```ts
import Configuration from '@ohos.app.application.Configuration'; import Configuration from '@ohos.application.Configuration';
``` ```
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
......
zh-cn/application-dev/reference/apis/js-apis-application-dataShareExtensionAbility.md
浏览文件 @ 66ddadf2
...@@ -285,8 +285,7 @@ export default class DataShareExtAbility extends DataShareExtensionAbility { ...@@ -285,8 +285,7 @@ export default class DataShareExtAbility extends DataShareExtensionAbility {
callback(err, ret); callback(err, ret);
} }
}); });
}); };
}
}; };
``` ```
......
zh-cn/application-dev/reference/apis/js-apis-application-formProvider.md
浏览文件 @ 66ddadf2
...@@ -31,8 +31,6 @@ setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback&l ...@@ -31,8 +31,6 @@ setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback&l
**示例：** **示例：**
```ts ```ts
import formProvider from '@ohos.app.form.formProvider';
let formId = '12400633174999288'; let formId = '12400633174999288';
formProvider.setFormNextRefreshTime(formId, 5, (error, data) => { formProvider.setFormNextRefreshTime(formId, 5, (error, data) => {
if (error.code) { if (error.code) {
...@@ -65,8 +63,6 @@ setFormNextRefreshTime(formId: string, minute: number): Promise&lt;void&gt; ...@@ -65,8 +63,6 @@ setFormNextRefreshTime(formId: string, minute: number): Promise&lt;void&gt;
**示例：** **示例：**
```ts ```ts
import formProvider from '@ohos.app.form.formProvider';
let formId = '12400633174999288'; let formId = '12400633174999288';
formProvider.setFormNextRefreshTime(formId, 5).then(() => { formProvider.setFormNextRefreshTime(formId, 5).then(() => {
console.log('formProvider setFormNextRefreshTime success'); console.log('formProvider setFormNextRefreshTime success');
...@@ -95,7 +91,6 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData,call ...@@ -95,7 +91,6 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData,call
```ts ```ts
import formBindingData from '@ohos.app.form.formBindingData'; import formBindingData from '@ohos.app.form.formBindingData';
import formProvider from '@ohos.app.form.formProvider';
let formId = '12400633174999288'; let formId = '12400633174999288';
let obj = formBindingData.createFormBindingData({temperature:'22c', time:'22:00'}); let obj = formBindingData.createFormBindingData({temperature:'22c', time:'22:00'});
...@@ -131,7 +126,6 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr ...@@ -131,7 +126,6 @@ updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Pr
```ts ```ts
import formBindingData from '@ohos.application.formBindingData'; import formBindingData from '@ohos.application.formBindingData';
import formProvider from '@ohos.app.form.formProvider';
let formId = '12400633174999288'; let formId = '12400633174999288';
let obj = formBindingData.createFormBindingData({temperature:'22c', time:'22:00'}); let obj = formBindingData.createFormBindingData({temperature:'22c', time:'22:00'});
......
zh-cn/application-dev/reference/apis/js-apis-inner-app-context.md
浏览文件 @ 66ddadf2
...@@ -1366,17 +1366,17 @@ context.printDrawnCompleted().then((data) => { ...@@ -1366,17 +1366,17 @@ context.printDrawnCompleted().then((data) => {
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 读写属性 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| ---- | ---- | ------ | ---- | ----- | | ---- | ------ | ---- | ----- |
| pid | 只读 | number | 否 | 进程id。 | | pid |number | 否 | 进程id。 |
| uid | 只读 | number | 否 | 用户id。 | | uid |number | 否 | 用户id。 |
## PermissionRequestResult<sup>7+</sup> ## PermissionRequestResult<sup>7+</sup>
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 读写属性 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| ----------- | ---- | -------------- | ---- | ---------- | | ----------- |-------------- | ---- | ---------- |
| requestCode | 只读 | number | 是 | 用户传入的请求代码。 | | requestCode | number | 是 | 用户传入的请求代码。 |
| permissions | 只读 | Array\<string> | 是 | 用户传入的权限。 | | permissions | Array\<string> | 是 | 用户传入的权限。 |
| authResults | 只读 | Array\<number> | 是 | 请求权限的结果。 | | authResults | Array\<number> | 是 | 请求权限的结果。 |
\ No newline at end of file \ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-inner-application-abilityDelegator.md
浏览文件 @ 66ddadf2
...@@ -27,7 +27,7 @@ addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): void ...@@ -27,7 +27,7 @@ addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): void
添加AbilityMonitor实例（callback形式） 添加AbilityMonitor实例（callback形式）
**系统能力：**SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -70,7 +70,7 @@ addAbilityMonitor(monitor: AbilityMonitor): Promise\<void>; ...@@ -70,7 +70,7 @@ addAbilityMonitor(monitor: AbilityMonitor): Promise\<void>;
添加AbilityMonitor实例（promise形式） 添加AbilityMonitor实例（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -118,7 +118,7 @@ removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): v ...@@ -118,7 +118,7 @@ removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<void>): v
删除已经添加的AbilityMonitor实例（callback形式） 删除已经添加的AbilityMonitor实例（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -161,7 +161,7 @@ removeAbilityMonitor(monitor: AbilityMonitor): Promise\<void>; ...@@ -161,7 +161,7 @@ removeAbilityMonitor(monitor: AbilityMonitor): Promise\<void>;
删除已经添加的AbilityMonitor实例（promise形式） 删除已经添加的AbilityMonitor实例（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -209,7 +209,7 @@ waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<UIAbility>) ...@@ -209,7 +209,7 @@ waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\<UIAbility>)
等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期，并返回ability实例（callback形式） 等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期，并返回ability实例（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -256,14 +256,14 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCall ...@@ -256,14 +256,14 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCall
设置等待时间，等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期，并返回ability实例（callback形式） 设置等待时间，等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期，并返回ability实例（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| monitor | [AbilityMonitor](js-apis-inner-application-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-inner-application-abilityMonitor.md#AbilityMonitor)实例 | | monitor | [AbilityMonitor](js-apis-inner-application-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-inner-application-abilityMonitor.md#AbilityMonitor)实例 |
| timeout | number | 否 | 最大等待时间，单位毫秒（ms） | | timeout | number | 是 | 最大等待时间，单位毫秒（ms） |
| callback | AsyncCallback\<[UIAbility](js-apis-app-ability-uiAbility.md)> | 是 | 表示指定的回调方法 | | callback | AsyncCallback\<[UIAbility](js-apis-app-ability-uiAbility.md)> | 是 | 表示指定的回调方法 |
**错误码**： **错误码**：
...@@ -307,7 +307,7 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise\<UIAbilit ...@@ -307,7 +307,7 @@ waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise\<UIAbilit
设置等待时间，等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期，并返回ability实例（promise形式） 设置等待时间，等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期，并返回ability实例（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -356,7 +356,7 @@ getAppContext(): Context; ...@@ -356,7 +356,7 @@ getAppContext(): Context;
获取应用Context 获取应用Context
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**返回值：** **返回值：**
...@@ -379,7 +379,7 @@ getAbilityState(ability: UIAbility): number; ...@@ -379,7 +379,7 @@ getAbilityState(ability: UIAbility): number;
获取指定ability的生命周期状态 获取指定ability的生命周期状态
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -414,7 +414,7 @@ getCurrentTopAbility(callback: AsyncCallback\<UIAbility>): void; ...@@ -414,7 +414,7 @@ getCurrentTopAbility(callback: AsyncCallback\<UIAbility>): void;
获取当前应用顶部ability（callback形式） 获取当前应用顶部ability（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -449,7 +449,7 @@ getCurrentTopAbility(): Promise\<UIAbility>; ...@@ -449,7 +449,7 @@ getCurrentTopAbility(): Promise\<UIAbility>;
获取当前应用顶部ability（promise形式） 获取当前应用顶部ability（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**返回值：** **返回值：**
...@@ -484,7 +484,7 @@ startAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -484,7 +484,7 @@ startAbility(want: Want, callback: AsyncCallback\<void>): void;
启动指定ability（callback形式） 启动指定ability（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -506,6 +506,8 @@ startAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -506,6 +506,8 @@ startAbility(want: Want, callback: AsyncCallback\<void>): void;
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -534,7 +536,7 @@ startAbility(want: Want): Promise\<void>; ...@@ -534,7 +536,7 @@ startAbility(want: Want): Promise\<void>;
启动指定ability（promise形式） 启动指定ability（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -561,6 +563,8 @@ startAbility(want: Want): Promise\<void>; ...@@ -561,6 +563,8 @@ startAbility(want: Want): Promise\<void>;
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -589,7 +593,7 @@ doAbilityForeground(ability: UIAbility, callback: AsyncCallback\<void>): void; ...@@ -589,7 +593,7 @@ doAbilityForeground(ability: UIAbility, callback: AsyncCallback\<void>): void;
调度指定ability生命周期状态到Foreground状态（callback形式） 调度指定ability生命周期状态到Foreground状态（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -628,7 +632,7 @@ doAbilityForeground(ability: UIAbility): Promise\<void>; ...@@ -628,7 +632,7 @@ doAbilityForeground(ability: UIAbility): Promise\<void>;
调度指定ability生命周期状态到Foreground状态（promise形式） 调度指定ability生命周期状态到Foreground状态（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -672,7 +676,7 @@ doAbilityBackground(ability: UIAbility, callback: AsyncCallback\<void>): void; ...@@ -672,7 +676,7 @@ doAbilityBackground(ability: UIAbility, callback: AsyncCallback\<void>): void;
调度指定ability生命周期状态到Background状态（callback形式） 调度指定ability生命周期状态到Background状态（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -711,7 +715,7 @@ doAbilityBackground(ability: UIAbility): Promise\<void>; ...@@ -711,7 +715,7 @@ doAbilityBackground(ability: UIAbility): Promise\<void>;
调度指定ability生命周期状态到Background状态（promise形式） 调度指定ability生命周期状态到Background状态（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -755,7 +759,7 @@ printSync(msg: string): void; ...@@ -755,7 +759,7 @@ printSync(msg: string): void;
打印日志信息到单元测试终端控制台 打印日志信息到单元测试终端控制台
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -779,7 +783,7 @@ print(msg: string, callback: AsyncCallback\<void>): void; ...@@ -779,7 +783,7 @@ print(msg: string, callback: AsyncCallback\<void>): void;
打印日志信息到单元测试终端控制台（callback形式） 打印日志信息到单元测试终端控制台（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -806,7 +810,7 @@ print(msg: string): Promise\<void>; ...@@ -806,7 +810,7 @@ print(msg: string): Promise\<void>;
打印日志信息到单元测试终端控制台（promise形式） 打印日志信息到单元测试终端控制台（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -876,7 +880,7 @@ executeShellCommand(cmd: string, timeoutSecs: number, callback: AsyncCallback\<S ...@@ -876,7 +880,7 @@ executeShellCommand(cmd: string, timeoutSecs: number, callback: AsyncCallback\<S
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------------------------------------------------------------ | ---- | ----------------------------- | | ----------- | ------------------------------------------------------------ | ---- | ----------------------------- |
| cmd | string | 是 | shell命令字符串 | | cmd | string | 是 | shell命令字符串 |
| timeoutSecs | number | 否 | 设定命令超时时间，单位秒（s） | | timeoutSecs | number | 是 | 设定命令超时时间，单位秒（s） |
| callback | AsyncCallback\<[ShellCmdResult](js-apis-inner-application-shellCmdResult.md#ShellCmdResult)> | 是 | 表示指定的回调方法 | | callback | AsyncCallback\<[ShellCmdResult](js-apis-inner-application-shellCmdResult.md#ShellCmdResult)> | 是 | 表示指定的回调方法 |
**示例：** **示例：**
...@@ -934,7 +938,7 @@ finishTest(msg: string, code: number, callback: AsyncCallback\<void>): void; ...@@ -934,7 +938,7 @@ finishTest(msg: string, code: number, callback: AsyncCallback\<void>): void;
结束测试并打印日志信息到单元测试终端控制台（callback形式） 结束测试并打印日志信息到单元测试终端控制台（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -970,7 +974,7 @@ finishTest(msg: string, code: number): Promise\<void>; ...@@ -970,7 +974,7 @@ finishTest(msg: string, code: number): Promise\<void>;
结束测试并打印日志信息到单元测试终端控制台（promise形式） 结束测试并打印日志信息到单元测试终端控制台（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -1011,7 +1015,7 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\<vo ...@@ -1011,7 +1015,7 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\<vo
添加一个AbilityStageMonitor对象，用于监视指定abilityStage的生命周期状态更改。（callback形式） 添加一个AbilityStageMonitor对象，用于监视指定abilityStage的生命周期状态更改。（callback形式）
**系统能力：**SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -1050,7 +1054,7 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\<void>; ...@@ -1050,7 +1054,7 @@ addAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\<void>;
添加一个AbilityStageMonitor对象，用于监视指定abilityStage的生命周期状态更改。（promise形式） 添加一个AbilityStageMonitor对象，用于监视指定abilityStage的生命周期状态更改。（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -1094,7 +1098,7 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\ ...@@ -1094,7 +1098,7 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\
从应用程序内存中删除指定的AbilityStageMonitor对象。（callback形式） 从应用程序内存中删除指定的AbilityStageMonitor对象。（callback形式）
**系统能力：**SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -1133,7 +1137,7 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\<void>; ...@@ -1133,7 +1137,7 @@ removeAbilityStageMonitor(monitor: AbilityStageMonitor): Promise\<void>;
从应用程序内存中删除指定的AbilityStageMonitor对象。（promise形式） 从应用程序内存中删除指定的AbilityStageMonitor对象。（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -1177,7 +1181,7 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\<A ...@@ -1177,7 +1181,7 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, callback: AsyncCallback\<A
等待并返回与给定AbilityStageMonitor中设置的条件匹配的AbilityStage对象。（callback形式） 等待并返回与给定AbilityStageMonitor中设置的条件匹配的AbilityStage对象。（callback形式）
**系统能力：**SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -1220,7 +1224,7 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout?: number): Promise ...@@ -1220,7 +1224,7 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout?: number): Promise
等待并返回与给定AbilityStageMonitor中设置的条件匹配的AbilityStage对象。（promise形式） 等待并返回与给定AbilityStageMonitor中设置的条件匹配的AbilityStage对象。（promise形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -1269,7 +1273,7 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout: number, callback: ...@@ -1269,7 +1273,7 @@ waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout: number, callback:
等待并返回与给定AbilityStageMonitor中设置的条件匹配的AbilityStage对象。（callback形式） 等待并返回与给定AbilityStageMonitor中设置的条件匹配的AbilityStage对象。（callback形式）
**系统能力：** SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-appStateData.md
浏览文件 @ 66ddadf2
...@@ -2,6 +2,10 @@ ...@@ -2,6 +2,10 @@
定义应用状态信息，可以通过[getForegroundApplications](js-apis-app-ability-appManager.md#appmanagergetforegroundapplications)获取当前应用的相关信息。 定义应用状态信息，可以通过[getForegroundApplications](js-apis-app-ability-appManager.md#appmanagergetforegroundapplications)获取当前应用的相关信息。
> **说明：**
>
> 本模块首批接口从API version 8 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
```ts ```ts
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-applicationContext.md
浏览文件 @ 66ddadf2
...@@ -134,7 +134,7 @@ export default class EntryAbility extends UIAbility { ...@@ -134,7 +134,7 @@ export default class EntryAbility extends UIAbility {
## ApplicationContext.off(type: 'abilityLifecycle', callbackId: number) ## ApplicationContext.off(type: 'abilityLifecycle', callbackId: number)
off(type: 'abilityLifecycle', callbackId: **number**): **void**; off(type: 'abilityLifecycle', callbackId: number): Promise\<void>;
取消监听应用内生命周期 取消监听应用内生命周期
...@@ -390,12 +390,8 @@ getRunningProcessInformation(): Promise\<Array\<ProcessInformation>>; ...@@ -390,12 +390,8 @@ getRunningProcessInformation(): Promise\<Array\<ProcessInformation>>;
获取有关运行进程的信息。 获取有关运行进程的信息。
**需要权限**：ohos.permission.GET_RUNNING_INFO
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口，三方应用不支持调用。
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -427,12 +423,8 @@ getRunningProcessInformation(callback: AsyncCallback\<Array\<ProcessInformation> ...@@ -427,12 +423,8 @@ getRunningProcessInformation(callback: AsyncCallback\<Array\<ProcessInformation>
获取有关运行进程的信息。 获取有关运行进程的信息。
**需要权限**：ohos.permission.GET_RUNNING_INFO
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口，三方应用不支持调用。
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md
浏览文件 @ 66ddadf2
...@@ -45,7 +45,7 @@ createBundleContext(bundleName: string): Context; ...@@ -45,7 +45,7 @@ createBundleContext(bundleName: string): Context;
**参数：** **参数：**
| 名称 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------- | | -------- | ---------------------- | ---- | ------------- |
| bundleName | string | 是 | Bundle名称。 | | bundleName | string | 是 | Bundle名称。 |
...@@ -76,7 +76,7 @@ createModuleContext(moduleName: string): Context; ...@@ -76,7 +76,7 @@ createModuleContext(moduleName: string): Context;
**参数：** **参数：**
| 名称 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------- | | -------- | ---------------------- | ---- | ------------- |
| moduleName | string | 是 | 模块名。 | | moduleName | string | 是 | 模块名。 |
...@@ -109,7 +109,7 @@ createModuleContext(bundleName: string, moduleName: string): Context; ...@@ -109,7 +109,7 @@ createModuleContext(bundleName: string, moduleName: string): Context;
**参数：** **参数：**
| 名称 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ------------- | | -------- | ---------------------- | ---- | ------------- |
| bundleName | string | 是 | Bundle名称。 | | bundleName | string | 是 | Bundle名称。 |
| moduleName | string | 是 | 模块名。 | | moduleName | string | 是 | 模块名。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-errorObserver.md
浏览文件 @ 66ddadf2
...@@ -24,7 +24,7 @@ onUnhandledException(errMsg: string): void; ...@@ -24,7 +24,7 @@ onUnhandledException(errMsg: string): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| errMsg | string | 否 | 有关异常的消息和错误堆栈跟踪。 | | errMsg | string | 是 | 有关异常的消息和错误堆栈跟踪。 |
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-eventHub.md
浏览文件 @ 66ddadf2
...@@ -124,7 +124,7 @@ emit(event: string, ...args: Object[]): void; ...@@ -124,7 +124,7 @@ emit(event: string, ...args: Object[]): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| event | string | 是 | 事件名称。 | | event | string | 是 | 事件名称。 |
| ...args | Object[] | 是 | 可变参数，事件触发时，传递给回调函数的参数。 | | ...args | Object[] | 否 | 可变参数，事件触发时，传递给回调函数的参数。 |
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-extensionRunningInfo.md
浏览文件 @ 66ddadf2
...@@ -21,6 +21,8 @@ import abilityManager from '@ohos.app.ability.abilityManager'; ...@@ -21,6 +21,8 @@ import abilityManager from '@ohos.app.ability.abilityManager';
**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
**系统API**：以下各项对应的接口均为系统接口，三方应用不支持调用。
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| extension | [ElementName](js-apis-bundleManager-elementName.md) | 是 | 否 | Extension信息。 | | extension | [ElementName](js-apis-bundleManager-elementName.md) | 是 | 否 | Extension信息。 |
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-formExtensionContext.md
浏览文件 @ 66ddadf2
...@@ -15,28 +15,6 @@ FormExtensionContext模块提供FormExtensionAbility具有的接口和能力。 ...@@ -15,28 +15,6 @@ FormExtensionContext模块提供FormExtensionAbility具有的接口和能力。
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
``` ```
## 使用说明
在使用FormExtensionContext的功能前，需要通过FormExtensionAbility获取。
```ts
import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
import formBindingData from '@ohos.app.form.formBindingData';
export default class MyFormExtensionAbility extends FormExtensionAbility {
onAddForm(want) {
let formContext = this.context; // 获取FormExtensionContext
// ...
let dataObj1 = {
temperature: '11c',
'time': '11:00'
};
let obj1 = formBindingData.createFormBindingData(dataObj1);
return obj1;
}
};
```
## startAbility ## startAbility
startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void
...@@ -57,7 +35,8 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void ...@@ -57,7 +35,8 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void
| 16500100 | Failed to obtain the configuration information. | | 16500100 | Failed to obtain the configuration information. |
| 16500101 | The application is not a system application. | | 16500101 | The application is not a system application. |
| 16501000 | An internal functional error occurred. | | 16501000 | An internal functional error occurred. |
|以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。||
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**参数：** **参数：**
...@@ -126,7 +105,8 @@ startAbility(want: Want): Promise&lt;void&gt; ...@@ -126,7 +105,8 @@ startAbility(want: Want): Promise&lt;void&gt;
| 16500100 | Failed to obtain the configuration information. | | 16500100 | Failed to obtain the configuration information. |
| 16500101 | The application is not a system application. | | 16500101 | The application is not a system application. |
| 16501000 | An internal functional error occurred. | | 16501000 | An internal functional error occurred. |
|以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。||
以上错误码的详细介绍请参见[卡片错误码](../errorcodes/errorcode-form.md)。
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-serviceExtensionContext.md
浏览文件 @ 66ddadf2
...@@ -46,7 +46,7 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -46,7 +46,7 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | Want类型参数，传入需要启动的ability的信息，如Ability名称，Bundle名称等。 | | want | [Want](js-apis-application-want.md) | 是 | Want类型参数，传入需要启动的ability的信息，如Ability名称，Bundle名称等。 |
| callback | AsyncCallback&lt;void&gt; | 否 | 回调函数，返回接口调用是否成功的结果。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数，返回接口调用是否成功的结果。 |
**错误码：** **错误码：**
...@@ -61,6 +61,8 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -61,6 +61,8 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -107,7 +109,7 @@ startAbility(want: Want, options?: StartOptions): Promise\<void>; ...@@ -107,7 +109,7 @@ startAbility(want: Want, options?: StartOptions): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | Want类型参数，传入需要启动的ability的信息，如Ability名称，Bundle名称等。 | | want | [Want](js-apis-application-want.md) | 是 | Want类型参数，传入需要启动的ability的信息，如Ability名称，Bundle名称等。 |
| options | [StartOptions](js-apis-app-ability-startOptions.md) | 是 | 启动Ability所携带的参数。 | | options | [StartOptions](js-apis-app-ability-startOptions.md) | 否 | 启动Ability所携带的参数。 |
**返回值：** **返回值：**
...@@ -128,6 +130,8 @@ startAbility(want: Want, options?: StartOptions): Promise\<void>; ...@@ -128,6 +130,8 @@ startAbility(want: Want, options?: StartOptions): Promise\<void>;
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -193,6 +197,8 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void& ...@@ -193,6 +197,8 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -239,6 +245,8 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< ...@@ -239,6 +245,8 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<
- 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
- 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)
**需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
...@@ -264,6 +272,8 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< ...@@ -264,6 +272,8 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -308,6 +318,8 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca ...@@ -308,6 +318,8 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
- 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
- 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)
**需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
...@@ -318,7 +330,7 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca ...@@ -318,7 +330,7 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 | | want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 | | accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
| options | [StartOptions](js-apis-app-ability-startOptions.md) | 否 | 启动Ability所携带的参数。 | | options | [StartOptions](js-apis-app-ability-startOptions.md) | 是 | 启动Ability所携带的参数。 |
| callback | AsyncCallback\<void\> | 是 | 启动Ability的回调函数。 | | callback | AsyncCallback\<void\> | 是 | 启动Ability的回调函数。 |
**错误码：** **错误码：**
...@@ -334,6 +346,8 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca ...@@ -334,6 +346,8 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -382,6 +396,8 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): ...@@ -382,6 +396,8 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
- 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
- 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)
**需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
...@@ -413,6 +429,8 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): ...@@ -413,6 +429,8 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -472,10 +490,13 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -472,10 +490,13 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000008 | The crowdtesting application expires. | | 16000008 | The crowdtesting application expires. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
...@@ -534,10 +555,13 @@ startServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -534,10 +555,13 @@ startServiceExtensionAbility(want: Want): Promise\<void>;
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000008 | The crowdtesting application expires. | | 16000008 | The crowdtesting application expires. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
...@@ -574,7 +598,11 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -574,7 +598,11 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
启动一个新的ServiceExtensionAbility（callback形式）。 启动一个新的ServiceExtensionAbility（callback形式）。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -594,10 +622,13 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -594,10 +622,13 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000008 | The crowdtesting application expires. | | 16000008 | The crowdtesting application expires. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
...@@ -636,7 +667,11 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ...@@ -636,7 +667,11 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
启动一个新的ServiceExtensionAbility（Promise形式）。 启动一个新的ServiceExtensionAbility（Promise形式）。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -661,10 +696,13 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ...@@ -661,10 +696,13 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000008 | The crowdtesting application expires. | | 16000008 | The crowdtesting application expires. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
...@@ -719,6 +757,7 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -719,6 +757,7 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
...@@ -780,6 +819,7 @@ stopServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -780,6 +819,7 @@ stopServiceExtensionAbility(want: Want): Promise\<void>;
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
...@@ -819,7 +859,11 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -819,7 +859,11 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
使用帐户停止同一应用程序内的服务（callback形式）。 使用帐户停止同一应用程序内的服务（callback形式）。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -839,6 +883,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -839,6 +883,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
...@@ -879,7 +924,11 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ...@@ -879,7 +924,11 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
使用帐户停止同一应用程序内的服务（Promise形式）。 使用帐户停止同一应用程序内的服务（Promise形式）。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -904,6 +953,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ...@@ -904,6 +953,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
...@@ -952,7 +1002,7 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void; ...@@ -952,7 +1002,7 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;void&gt; | 否 | 回调函数，返回接口调用是否成功的结果。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数，返回接口调用是否成功的结果。 |
**错误码：** **错误码：**
...@@ -1049,10 +1099,15 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; ...@@ -1049,10 +1099,15 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | Input error. The specified ability name does not exist. | | 16000001 | The specified ability does not exist. |
| 16000005 | The specified process does not have the permission. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000006 | Cross-user operations are not allowed. |
| 16000008 | The crowdtesting application expires. |
| 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000050 | Internal Error. | | 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
...@@ -1087,6 +1142,8 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ...@@ -1087,6 +1142,8 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
使用AbilityInfo.AbilityType.SERVICE模板和account将当前能力连接到一个能力。 使用AbilityInfo.AbilityType.SERVICE模板和account将当前能力连接到一个能力。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**: 此接口为系统接口，三方应用不支持调用。 **系统API**: 此接口为系统接口，三方应用不支持调用。
...@@ -1097,7 +1154,7 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ...@@ -1097,7 +1154,7 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 | | want | [Want](js-apis-application-want.md) | 是 | 启动Ability的want信息。 |
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 | | accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
| options | ConnectOptions | 否 | 远端对象实例。 | | options | ConnectOptions | 是 | 远端对象实例。 |
**返回值：** **返回值：**
...@@ -1109,10 +1166,15 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ...@@ -1109,10 +1166,15 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | Input error. The specified ability name does not exist. | | 16000001 | The specified ability does not exist. |
| 16000005 | The specified process does not have the permission. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000006 | Cross-user operations are not allowed. |
| 16000008 | The crowdtesting application expires. |
| 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000050 | Internal Error. | | 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
...@@ -1158,14 +1220,14 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback&lt; ...@@ -1158,14 +1220,14 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback&lt;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| connection | number | 是 | 在connectServiceExtensionAbility中返回的number。 | | connection | number | 是 | 在connectServiceExtensionAbility中返回的number。 |
| callback | AsyncCallback&lt;void&gt; | 否 | 回调函数，返回接口调用是否成功的结果。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数，返回接口调用是否成功的结果。 |
**错误码：** **错误码：**
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000050 | Internal Error. | | 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
...@@ -1220,7 +1282,7 @@ disconnectServiceExtensionAbility(connection: number): Promise&lt;void&gt;; ...@@ -1220,7 +1282,7 @@ disconnectServiceExtensionAbility(connection: number): Promise&lt;void&gt;;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000050 | Internal Error. | | 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
...@@ -1260,6 +1322,8 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;; ...@@ -1260,6 +1322,8 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
- 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
- 同设备与跨设备场景下，该接口的使用规则存在差异，详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) - 同设备与跨设备场景下，该接口的使用规则存在差异，详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)
**需要权限**: ohos.permission.ABILITY_BACKGROUND_COMMUNICATION
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：此接口为系统接口，三方应用不支持调用。 **系统API**：此接口为系统接口，三方应用不支持调用。
...@@ -1280,14 +1344,14 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;; ...@@ -1280,14 +1344,14 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | Input error. The specified ability name does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Visibility verification failed. | | 16000004 | Can not start invisible component. |
| 16000005 | Static permission denied. The specified process does not have the permission. | | 16000005 | Static permission denied. The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000008 | Crowdtest App Expiration. | | 16000008 | The crowdtesting application expires. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000050 | Internal Error. | | 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
...@@ -1356,7 +1420,7 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;; ...@@ -1356,7 +1420,7 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
``` ```
## UIAbilityContext.startRecentAbility ## UIAbilityContext.startRecentAbility
startRecentAbility(want: Want, callback: AsyncCallback&lt;void&lt;): void; startRecentAbility(want: Want, callback: AsyncCallback\<void>): void;
启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的那个实例。启动结果以callback的形式返回开发者。 启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的那个实例。启动结果以callback的形式返回开发者。
...@@ -1421,7 +1485,7 @@ try { ...@@ -1421,7 +1485,7 @@ try {
``` ```
## UIAbilityContext.startRecentAbility ## UIAbilityContext.startRecentAbility
startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&lt;): void; startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback\<void>): void;
启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的那个实例。启动结果以callback的形式返回开发者。 启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的那个实例。启动结果以callback的形式返回开发者。
当开发者需要携带启动参数时可以选择此API。 当开发者需要携带启动参数时可以选择此API。
...@@ -1492,7 +1556,7 @@ try { ...@@ -1492,7 +1556,7 @@ try {
``` ```
## UIAbilityContext.startRecentAbility ## UIAbilityContext.startRecentAbility
startRecentAbility(want: Want, options?: StartOptions): Promise&lt;void&lt;; startRecentAbility(want: Want, options?: StartOptions): Promise\<void>;
启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的那个实例。 启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的那个实例。
当开发者期望启动结果以Promise形式返回时可以选择此API。 当开发者期望启动结果以Promise形式返回时可以选择此API。
...@@ -1572,6 +1636,8 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller& ...@@ -1572,6 +1636,8 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller&
- 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
- 同设备与跨设备场景下，该接口的使用规则存在差异，详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) - 同设备与跨设备场景下，该接口的使用规则存在差异，详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)
**需要权限**: ohos.permission.ABILITY_BACKGROUND_COMMUNICATION, ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：此接口为系统接口，三方应用不支持调用。 **系统API**：此接口为系统接口，三方应用不支持调用。
...@@ -1595,14 +1661,16 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller& ...@@ -1595,14 +1661,16 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller&
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | Input error. The specified ability name does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Visibility verification failed. | | 16000004 | Can not start invisible component. |
| 16000005 | Static permission denied. The specified process does not have the permission. | | 16000005 | Static permission denied. The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000008 | Crowdtest App Expiration. | | 16000008 | The crowdtesting application expires. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000050 | Internal Error. | | 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md
浏览文件 @ 66ddadf2
...@@ -60,6 +60,8 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -60,6 +60,8 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -114,6 +116,7 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void& ...@@ -114,6 +116,7 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&
**错误码：** **错误码：**
| 错误码ID | 错误信息 |
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
...@@ -125,6 +128,8 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void& ...@@ -125,6 +128,8 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -199,6 +204,8 @@ startAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;; ...@@ -199,6 +204,8 @@ startAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;;
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -462,7 +469,11 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC ...@@ -462,7 +469,11 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC
- 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
- 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -489,6 +500,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC ...@@ -489,6 +500,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -534,7 +547,11 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp ...@@ -534,7 +547,11 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp
- 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
- 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -562,6 +579,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp ...@@ -562,6 +579,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -610,7 +629,11 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO ...@@ -610,7 +629,11 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO
- 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
- 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -643,6 +666,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO ...@@ -643,6 +666,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -701,10 +726,13 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -701,10 +726,13 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000008 | The crowdtesting application expires. | | 16000008 | The crowdtesting application expires. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
...@@ -757,10 +785,13 @@ startServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -757,10 +785,13 @@ startServiceExtensionAbility(want: Want): Promise\<void>;
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000008 | The crowdtesting application expires. | | 16000008 | The crowdtesting application expires. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
...@@ -797,7 +828,11 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -797,7 +828,11 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
启动一个新的ServiceExtensionAbility（callback形式）。 启动一个新的ServiceExtensionAbility（callback形式）。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -817,10 +852,13 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -817,10 +852,13 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000008 | The crowdtesting application expires. | | 16000008 | The crowdtesting application expires. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
...@@ -858,7 +896,11 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ...@@ -858,7 +896,11 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
启动一个新的ServiceExtensionAbility（Promise形式）。 启动一个新的ServiceExtensionAbility（Promise形式）。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -877,10 +919,13 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ...@@ -877,10 +919,13 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000008 | The crowdtesting application expires. | | 16000008 | The crowdtesting application expires. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
...@@ -937,6 +982,8 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -937,6 +982,8 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
...@@ -989,9 +1036,12 @@ stopServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -989,9 +1036,12 @@ stopServiceExtensionAbility(want: Want): Promise\<void>;
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
...@@ -1028,7 +1078,11 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -1028,7 +1078,11 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
停止同一应用程序内指定账户的服务（callback形式）。 停止同一应用程序内指定账户的服务（callback形式）。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -1048,6 +1102,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -1048,6 +1102,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
...@@ -1088,7 +1143,11 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ...@@ -1088,7 +1143,11 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
停止同一应用程序内指定账户的服务（Promise形式）。 停止同一应用程序内指定账户的服务（Promise形式）。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -1107,6 +1166,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ...@@ -1107,6 +1166,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000005 | The specified process does not have the permission. | | 16000005 | The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
...@@ -1383,7 +1443,12 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; ...@@ -1383,7 +1443,12 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000005 | The specified process does not have the permission. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000006 | Cross-user operations are not allowed. |
| 16000008 | The crowdtesting application expires. |
| 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
...@@ -1427,7 +1492,11 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ...@@ -1427,7 +1492,11 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
将当前Ability连接到一个使用AbilityInfo.AbilityType.SERVICE模板的指定account的Ability。 将当前Ability连接到一个使用AbilityInfo.AbilityType.SERVICE模板的指定account的Ability。
**需要权限：** ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限：** ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -1452,7 +1521,12 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ...@@ -1452,7 +1521,12 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | The specified ability does not exist. | | 16000001 | The specified ability does not exist. |
| 16000005 | The specified process does not have the permission. | | 16000002 | Incorrect ability type. |
| 16000004 | Can not start invisible component. |
| 16000006 | Cross-user operations are not allowed. |
| 16000008 | The crowdtesting application expires. |
| 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
...@@ -1621,6 +1695,8 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;; ...@@ -1621,6 +1695,8 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
- 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
- 同设备与跨设备场景下，该接口的使用规则存在差异，详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) - 同设备与跨设备场景下，该接口的使用规则存在差异，详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)
**需要权限：** ohos.permission.ABILITY_BACKGROUND_COMMUNICATION
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**参数：** **参数：**
...@@ -1646,6 +1722,8 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;; ...@@ -1646,6 +1722,8 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000008 | The crowdtesting application expires. | | 16000008 | The crowdtesting application expires. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
...@@ -1725,7 +1803,11 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< ...@@ -1725,7 +1803,11 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<
- 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
- 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限：** ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -1752,6 +1834,8 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< ...@@ -1752,6 +1834,8 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -1797,7 +1881,11 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca ...@@ -1797,7 +1881,11 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
- 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
- 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限：** ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -1825,6 +1913,8 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca ...@@ -1825,6 +1913,8 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -1873,7 +1963,11 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): ...@@ -1873,7 +1963,11 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
- 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
- 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) - 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)
**需要权限**: ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS，当accountId为当前用户时，不需要校验该权限。 > **说明：**
>
> 当accountId为当前用户时，不需要校验该权限。
**需要权限：** ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
...@@ -1900,6 +1994,8 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): ...@@ -1900,6 +1994,8 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -2129,7 +2225,7 @@ restoreWindowStage(localStorage: LocalStorage) : void; ...@@ -2129,7 +2225,7 @@ restoreWindowStage(localStorage: LocalStorage) : void;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| localStorage | image.LocalStorage | 是 | 用于恢复window stage的存储数据。 | | localStorage | LocalStorage | 是 | 用于恢复window stage的存储数据。 |
**错误码：** **错误码：**
...@@ -2209,6 +2305,8 @@ requestDialogService(want: Want, result: AsyncCallback&lt;dialogRequest.RequestR ...@@ -2209,6 +2305,8 @@ requestDialogService(want: Want, result: AsyncCallback&lt;dialogRequest.RequestR
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -2282,6 +2380,8 @@ requestDialogService(want: Want): Promise&lt;dialogRequest.RequestResult&gt;; ...@@ -2282,6 +2380,8 @@ requestDialogService(want: Want): Promise&lt;dialogRequest.RequestResult&gt;;
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -2316,7 +2416,7 @@ try { ...@@ -2316,7 +2416,7 @@ try {
``` ```
## UIAbilityContext.startRecentAbility ## UIAbilityContext.startRecentAbility
startRecentAbility(want: Want, callback: AsyncCallback&lt;void&lt;): void; startRecentAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的那个实例。启动结果以callback的形式返回开发者。 启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的那个实例。启动结果以callback的形式返回开发者。
...@@ -2351,6 +2451,8 @@ startRecentAbility(want: Want, callback: AsyncCallback&lt;void&lt;): void; ...@@ -2351,6 +2451,8 @@ startRecentAbility(want: Want, callback: AsyncCallback&lt;void&lt;): void;
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -2381,7 +2483,7 @@ try { ...@@ -2381,7 +2483,7 @@ try {
``` ```
## UIAbilityContext.startRecentAbility ## UIAbilityContext.startRecentAbility
startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&lt;): void; startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&gt;): void;
启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的那个实例。启动结果以callback的形式返回开发者。 启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的那个实例。启动结果以callback的形式返回开发者。
当开发者需要携带启动参数时可以选择此API。 当开发者需要携带启动参数时可以选择此API。
...@@ -2418,6 +2520,8 @@ startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt ...@@ -2418,6 +2520,8 @@ startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -2452,7 +2556,7 @@ try { ...@@ -2452,7 +2556,7 @@ try {
``` ```
## UIAbilityContext.startRecentAbility ## UIAbilityContext.startRecentAbility
startRecentAbility(want: Want, options?: StartOptions): Promise&lt;void&lt;; startRecentAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;;
启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的那个实例。 启动一个指定的Ability，如果这个Ability有多个实例，将拉起最近启动的那个实例。
当开发者期望启动结果以Promise形式返回时可以选择此API。 当开发者期望启动结果以Promise形式返回时可以选择此API。
...@@ -2488,6 +2592,8 @@ startRecentAbility(want: Want, options?: StartOptions): Promise&lt;void&lt;; ...@@ -2488,6 +2592,8 @@ startRecentAbility(want: Want, options?: StartOptions): Promise&lt;void&lt;;
| 16000009 | An ability cannot be started or stopped in Wukong mode. | | 16000009 | An ability cannot be started or stopped in Wukong mode. |
| 16000010 | The call with the continuation flag is forbidden. | | 16000010 | The call with the continuation flag is forbidden. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. | | 16000050 | Internal error. |
| 16000053 | The ability is not on the top of the UI. | | 16000053 | The ability is not on the top of the UI. |
| 16000055 | Installation-free timed out. | | 16000055 | Installation-free timed out. |
...@@ -2520,7 +2626,7 @@ try { ...@@ -2520,7 +2626,7 @@ try {
} }
``` ```
## UIAbilityContext.startAbilityByCallWithAccount ## UIAbilityContext.startAbilityByCallWithAccount<sup>10+</sup>
startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller&gt;; startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller&gt;;
...@@ -2532,6 +2638,8 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller& ...@@ -2532,6 +2638,8 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller&
- 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限 - 跨应用场景下，目标Ability的exported属性若配置为false，调用方应用需申请`ohos.permission.START_INVISIBLE_ABILITY`权限
- 同设备与跨设备场景下，该接口的使用规则存在差异，详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md) - 同设备与跨设备场景下，该接口的使用规则存在差异，详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)
**需要权限**: ohos.permission.ABILITY_BACKGROUND_COMMUNICATION, ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：此接口为系统接口，三方应用不支持调用。 **系统API**：此接口为系统接口，三方应用不支持调用。
...@@ -2553,14 +2661,16 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller& ...@@ -2553,14 +2661,16 @@ startAbilityByCallWithAccount(want: Want, accountId: number): Promise&lt;Caller&
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 16000001 | Input error. The specified ability name does not exist. | | 16000001 | The specified ability does not exist. |
| 16000002 | Incorrect ability type. | | 16000002 | Incorrect ability type. |
| 16000004 | Visibility verification failed. | | 16000004 | Can not start invisible component. |
| 16000005 | Static permission denied. The specified process does not have the permission. | | 16000005 | Static permission denied. The specified process does not have the permission. |
| 16000006 | Cross-user operations are not allowed. | | 16000006 | Cross-user operations are not allowed. |
| 16000008 | Crowdtest App Expiration. | | 16000008 | The crowdtesting application expires. |
| 16000011 | The context does not exist. | | 16000011 | The context does not exist. |
| 16000050 | Internal Error. | | 16000012 | The application is controlled. |
| 16000013 | The application is controlled by EDM. |
| 16000050 | Internal error. |
| 16200001 | The caller has been released. | | 16200001 | The caller has been released. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或