Skip to content

D
Docs

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

通知 161
Star 293
Fork 28
D
Docs
提交 c0f1d270 编写于 作者: D donglin
浏览文件
操作

modify describe 

Signed-off-by: Ndonglin <donglin9@huawei.com>
Change-Id: Id70d902abae76876843ce284afffb2e4bebd3c25
上级 926c2e84
显示空白变更内容
内联 并排
Showing with 530 addition and 166 deletion
zh-cn/application-dev/reference/apis/js-apis-ability-context.md
浏览文件 @ c0f1d270
...@@ -59,7 +59,8 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -59,7 +59,8 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -114,7 +115,8 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void& ...@@ -114,7 +115,8 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -177,7 +179,8 @@ startAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;; ...@@ -177,7 +179,8 @@ startAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -234,7 +237,8 @@ startAbilityForResult(want: Want, callback: AsyncCallback&lt;AbilityResult&gt;): ...@@ -234,7 +237,8 @@ startAbilityForResult(want: Want, callback: AsyncCallback&lt;AbilityResult&gt;):
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -290,7 +294,8 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback ...@@ -290,7 +294,8 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -356,7 +361,8 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise&lt;AbilityRes ...@@ -356,7 +361,8 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise&lt;AbilityRes
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -417,7 +423,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC ...@@ -417,7 +423,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -480,7 +487,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp ...@@ -480,7 +487,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -551,7 +559,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO ...@@ -551,7 +559,8 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -606,7 +615,8 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -606,7 +615,8 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -656,7 +666,8 @@ startServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -656,7 +666,8 @@ startServiceExtensionAbility(want: Want): Promise\<void>;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -710,7 +721,8 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -710,7 +721,8 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -764,7 +776,8 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ...@@ -764,7 +776,8 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -815,7 +828,8 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -815,7 +828,8 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -871,7 +885,8 @@ stopServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -871,7 +885,8 @@ stopServiceExtensionAbility(want: Want): Promise\<void>;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -931,7 +946,8 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -931,7 +946,8 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -991,7 +1007,8 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ...@@ -991,7 +1007,8 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1046,7 +1063,8 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void; ...@@ -1046,7 +1063,8 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1083,7 +1101,8 @@ terminateSelf(): Promise&lt;void&gt;; ...@@ -1083,7 +1101,8 @@ terminateSelf(): Promise&lt;void&gt;;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1119,7 +1138,8 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback&lt;voi ...@@ -1119,7 +1138,8 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback&lt;voi
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1180,7 +1200,8 @@ terminateSelfWithResult(parameter: AbilityResult): Promise&lt;void&gt;; ...@@ -1180,7 +1200,8 @@ terminateSelfWithResult(parameter: AbilityResult): Promise&lt;void&gt;;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1243,7 +1264,8 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; ...@@ -1243,7 +1264,8 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1301,7 +1323,8 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ...@@ -1301,7 +1323,8 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1353,7 +1376,8 @@ disconnectServiceExtensionAbility(connection: number): Promise\<void>; ...@@ -1353,7 +1376,8 @@ disconnectServiceExtensionAbility(connection: number): Promise\<void>;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1399,7 +1423,8 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\<vo ...@@ -1399,7 +1423,8 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\<vo
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1549,7 +1574,8 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< ...@@ -1549,7 +1574,8 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1611,7 +1637,8 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca ...@@ -1611,7 +1637,8 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1675,7 +1702,8 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): ...@@ -1675,7 +1702,8 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityConstant.md
浏览文件 @ c0f1d270
...@@ -43,11 +43,11 @@ Ability初次启动原因，该类型为枚举，可配合[Ability](js-apis-app- ...@@ -43,11 +43,11 @@ Ability初次启动原因，该类型为枚举，可配合[Ability](js-apis-app-
**示例：** **示例：**
```ts ```ts
import UIAbility form '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want, launchParam) {
if (launcherParam.launchReason == AbilityConstant.LaunchReason.START_ABILITY) { if (launchParam.launchReason === AbilityConstant.LaunchReason.START_ABILITY) {
console.log("The ability has been started by the way of startAbility."); console.log("The ability has been started by the way of startAbility.");
} }
} }
...@@ -69,11 +69,11 @@ Ability上次退出原因，该类型为枚举，可配合[Ability](js-apis-app- ...@@ -69,11 +69,11 @@ Ability上次退出原因，该类型为枚举，可配合[Ability](js-apis-app-
**示例：** **示例：**
```ts ```ts
import UIAbility form '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want, launchParam) {
if (launcherParam.lastExitReason == AbilityConstant.LastExitReason.ABILITY_NOT_RESPONDING) { if (launchParam.lastExitReason === AbilityConstant.LastExitReason.ABILITY_NOT_RESPONDING) {
console.log("The ability has exit last because the ability was not responding."); console.log("The ability has exit last because the ability was not responding.");
} }
} }
...@@ -95,7 +95,7 @@ Ability迁移结果，该类型为枚举，可配合[Ability](js-apis-app-abilit ...@@ -95,7 +95,7 @@ Ability迁移结果，该类型为枚举，可配合[Ability](js-apis-app-abilit
**示例：** **示例：**
```ts ```ts
import UIAbility form '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onContinue(wantParam) { onContinue(wantParam) {
...@@ -152,11 +152,11 @@ this.context.startAbility(want, option).then(()={ ...@@ -152,11 +152,11 @@ this.context.startAbility(want, option).then(()={
**示例：** **示例：**
```ts ```ts
import UIAbility form '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onMemoryLevel(level) { onMemoryLevel(level) {
if (level == AbilityConstant.MemoryLevel.MEMORY_LEVEL_CRITICAL) { if (level === AbilityConstant.MemoryLevel.MEMORY_LEVEL_CRITICAL) {
console.log("The memory of device is critical, please release some memory."); console.log("The memory of device is critical, please release some memory.");
} }
} }
...@@ -181,7 +181,7 @@ class MyAbility extends UIAbility { ...@@ -181,7 +181,7 @@ class MyAbility extends UIAbility {
**示例：** **示例：**
```ts ```ts
import UIAbility form '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onSaveState(reason, wantParam) { onSaveState(reason, wantParam) {
...@@ -204,11 +204,11 @@ class MyAbility extends UIAbility { ...@@ -204,11 +204,11 @@ class MyAbility extends UIAbility {
**示例：** **示例：**
```ts ```ts
import UIAbility form '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
class MyAbility extends UIAbility { class MyAbility extends UIAbility {
onSaveState(reason, wantParam) { onSaveState(reason, wantParam) {
if (reason == AbilityConstant.StateType.CONTINUATION) { if (reason === AbilityConstant.StateType.CONTINUATION) {
console.log("Save the ability data when the ability continuation."); console.log("Save the ability data when the ability continuation.");
} }
return AbilityConstant.OnSaveResult.ALL_AGREE; return AbilityConstant.OnSaveResult.ALL_AGREE;
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityDelegatorRegistry.md
浏览文件 @ c0f1d270
...@@ -53,8 +53,8 @@ let want = { ...@@ -53,8 +53,8 @@ let want = {
bundleName: "com.ohos.example", bundleName: "com.ohos.example",
abilityName: "MainAbility" abilityName: "MainAbility"
} }
abilityDelegator.startAbility(want, (err)=>{ abilityDelegator.startAbility(want, (err) => {
if (err.code != 0) { if (err.code !== 0) {
console.log("Success start ability."); console.log("Success start ability.");
} else { } else {
console.log("Failed start ability, error: " + JSON.stringify(err)); console.log("Failed start ability, error: " + JSON.stringify(err));
...@@ -81,7 +81,7 @@ getArguments(): AbilityDelegatorArgs ...@@ -81,7 +81,7 @@ getArguments(): AbilityDelegatorArgs
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry'; import AbilityDelegatorRegistry from '@ohos.app.ability.abilityDelegatorRegistry';
var args = AbilityDelegatorRegistry.getArguments(); let args = AbilityDelegatorRegistry.getArguments();
console.info("getArguments bundleName:" + args.bundleName); console.info("getArguments bundleName:" + args.bundleName);
console.info("getArguments parameters:" + JSON.stringify(args.parameters)); console.info("getArguments parameters:" + JSON.stringify(args.parameters));
console.info("getArguments testCaseNames:" + args.testCaseNames); console.info("getArguments testCaseNames:" + args.testCaseNames);
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityLifecycleCallback.md
浏览文件 @ c0f1d270
...@@ -29,6 +29,14 @@ onAbilityCreate(ability: UIAbility): void; ...@@ -29,6 +29,14 @@ onAbilityCreate(ability: UIAbility): void;
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
**示例：**
```ts
let abilityLifecycleCallback = {
onAbilityCreate(ability){
console.log("AbilityLifecycleCallback onAbilityCreate.");
}
}
```
## AbilityLifecycleCallback.onWindowStageCreate ## AbilityLifecycleCallback.onWindowStageCreate
...@@ -45,6 +53,14 @@ onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void; ...@@ -45,6 +53,14 @@ onWindowStageCreate(ability: UIAbility, windowStage: window.WindowStage): void;
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
| windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 | | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 |
**示例：**
```ts
let abilityLifecycleCallback = {
onWindowStageCreate(ability, windowStage){
console.log("AbilityLifecycleCallback onWindowStageCreate.");
}
}
```
## AbilityLifecycleCallback.onWindowStageActive ## AbilityLifecycleCallback.onWindowStageActive
...@@ -61,6 +77,14 @@ onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void; ...@@ -61,6 +77,14 @@ onWindowStageActive(ability: UIAbility, windowStage: window.WindowStage): void;
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
| windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 | | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 |
**示例：**
```ts
let abilityLifecycleCallback = {
onWindowStageActive(ability, windowStage){
console.log("AbilityLifecycleCallback onWindowStageActive.");
}
}
```
## AbilityLifecycleCallback.onWindowStageInactive ## AbilityLifecycleCallback.onWindowStageInactive
...@@ -77,6 +101,14 @@ onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void ...@@ -77,6 +101,14 @@ onWindowStageInactive(ability: UIAbility, windowStage: window.WindowStage): void
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
| windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 | | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 |
**示例：**
```ts
let abilityLifecycleCallback = {
onWindowStageInactive(ability, windowStage){
console.log("AbilityLifecycleCallback onWindowStageInactive.");
}
}
```
## AbilityLifecycleCallback.onWindowStageDestroy ## AbilityLifecycleCallback.onWindowStageDestroy
...@@ -93,6 +125,14 @@ onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void; ...@@ -93,6 +125,14 @@ onWindowStageDestroy(ability: UIAbility, windowStage: window.WindowStage): void;
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
| windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 | | windowStage | [window.WindowStage](js-apis-window.md#windowstage9) | 是 | 当前WindowStage对象 |
**示例：**
```ts
let abilityLifecycleCallback = {
onWindowStageDestroy(ability, windowStage){
console.log("AbilityLifecycleCallback onWindowStageDestroy.");
}
}
```
## AbilityLifecycleCallback.onAbilityDestroy ## AbilityLifecycleCallback.onAbilityDestroy
...@@ -108,6 +148,14 @@ onAbilityDestroy(ability: UIAbility): void; ...@@ -108,6 +148,14 @@ onAbilityDestroy(ability: UIAbility): void;
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
**示例：**
```ts
let abilityLifecycleCallback = {
onAbilityDestroy(ability){
console.log("AbilityLifecycleCallback onAbilityDestroy.");
}
}
```
## AbilityLifecycleCallback.onAbilityForeground ## AbilityLifecycleCallback.onAbilityForeground
...@@ -123,6 +171,14 @@ onAbilityForeground(ability: UIAbility): void; ...@@ -123,6 +171,14 @@ onAbilityForeground(ability: UIAbility): void;
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
**示例：**
```ts
let abilityLifecycleCallback = {
onAbilityForeground(ability){
console.log("AbilityLifecycleCallback onAbilityForeground.");
}
}
```
## AbilityLifecycleCallback.onAbilityBackground ## AbilityLifecycleCallback.onAbilityBackground
...@@ -138,6 +194,14 @@ onAbilityBackground(ability: UIAbility): void; ...@@ -138,6 +194,14 @@ onAbilityBackground(ability: UIAbility): void;
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
**示例：**
```ts
let abilityLifecycleCallback = {
onAbilityBackground(ability){
console.log("AbilityLifecycleCallback onAbilityBackground.");
}
}
```
## AbilityLifecycleCallback.onAbilityContinue ## AbilityLifecycleCallback.onAbilityContinue
...@@ -153,14 +217,25 @@ onAbilityContinue(ability: UIAbility): void; ...@@ -153,14 +217,25 @@ onAbilityContinue(ability: UIAbility): void;
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 | | ability | [UIAbility](js-apis-app-ability-uiAbility.md) | 是 | 当前Ability对象 |
**示例：**
```ts
let abilityLifecycleCallback = {
onAbilityContinue(ability){
console.log("AbilityLifecycleCallback onAbilityContinue.");
}
}
```
## AbilityLifecycleCallback使用
**示例：** **示例：**
MyAbilityStage.ts MyFirstAbility.ts
```ts ```ts
import AbilityLifecycleCallback from "@ohos.app.ability.AbilityLifecycleCallback"; import AbilityLifecycleCallback from "@ohos.app.ability.AbilityLifecycleCallback";
import AbilityStage from "@ohos.app.ability.AbilityStage" import AbilityStage from "@ohos.app.ability.AbilityStage";
import UIAbility from '@ohos.app.ability.UIAbility';
// 声明ability生命周期回调 // 声明ability生命周期回调，需配置所有回调后才可以在applicationContext注册
let abilityLifecycleCallback = { let abilityLifecycleCallback = {
onAbilityCreate(ability){ onAbilityCreate(ability){
console.log("AbilityLifecycleCallback onAbilityCreate."); console.log("AbilityLifecycleCallback onAbilityCreate.");
...@@ -191,7 +266,7 @@ let abilityLifecycleCallback = { ...@@ -191,7 +266,7 @@ let abilityLifecycleCallback = {
} }
} }
export default class MyAbilityStage extends AbilityStage { export default class MyFirstAbility extends UIAbility {
onCreate() { onCreate() {
console.log("MyAbilityStage onCreate"); console.log("MyAbilityStage onCreate");
// 1.通过context属性获取applicationContext // 1.通过context属性获取applicationContext
...@@ -207,11 +282,11 @@ export default class MyAbilityStage extends AbilityStage { ...@@ -207,11 +282,11 @@ export default class MyAbilityStage extends AbilityStage {
} }
``` ```
MyAbility.ts MySecondAbility.ts
```ts ```ts
import UIAbility from "ohos.app.ability.UIAbility" import UIAbility from "ohos.app.ability.UIAbility"
export default class MyAbility extends UIAbility { export default class MySecondAbility extends UIAbility {
onDestroy() { onDestroy() {
let applicationContext = this.context.getApplicationContext(); let applicationContext = this.context.getApplicationContext();
// 3.通过applicationContext注销监听应用内生命周期 // 3.通过applicationContext注销监听应用内生命周期
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-abilityManager.md
浏览文件 @ c0f1d270
...@@ -46,29 +46,37 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void ...@@ -46,29 +46,37 @@ updateConfiguration(config: Configuration, callback: AsyncCallback\<void>): void
| config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 新的配置项，仅需配置需要更新的项。 | | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 新的配置项，仅需配置需要更新的项。 |
| callback | AsyncCallback\<void> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 | | callback | AsyncCallback\<void> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例**： **示例**：
```ts ```ts
var config = { const config = {
language: 'Zh-Hans', language: 'Zh-Hans', // 简体中文
colorMode: COLOR_MODE_LIGHT, colorMode: COLOR_MODE_LIGHT, // 浅色模式
direction: DIRECTION_VERTICAL, direction: DIRECTION_VERTICAL, // 垂直方向
screenDensity: SCREEN_DENSITY_SDPI, screenDensity: SCREEN_DENSITY_SDPI, // 屏幕分辨率为"sdpi"
displayId: 1, displayId: 1, // 应用在Id为1的物理屏上显示
hasPointerDevice: true, hasPointerDevice: true, // 指针类型设备已连接
} }
try { try {
abilityManager.updateConfiguration(config, (err) => { abilityManager.updateConfiguration(config, (err) => {
if (err.code != 0) { if (err.code !== 0) {
console.log("updateConfiguration fail, err: " + JSON.stringify(err)); console.log("updateConfiguration fail, err: " + JSON.stringify(err));
} else { } else {
console.log("updateConfiguration success."); console.log("updateConfiguration success.");
} }
}) })
} catch (paramError) { } catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) + console.log('error.code: ' + JSON.stringify(paramError.code)
' error.message: ' + JSON.stringify(paramError.message)); + ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
...@@ -94,16 +102,24 @@ updateConfiguration(config: Configuration): Promise\<void> ...@@ -94,16 +102,24 @@ updateConfiguration(config: Configuration): Promise\<void>
| ---------------------------------------- | ------- | | ---------------------------------------- | ------- |
| Promise\<void> | 以Promise方式返回接口运行结果息，可进行错误处理或其他自定义处理。 | | Promise\<void> | 以Promise方式返回接口运行结果息，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例**： **示例**：
```ts ```ts
var config = { const config = {
language: 'Zh-Hans', language: 'Zh-Hans', // 简体中文
colorMode: COLOR_MODE_LIGHT, colorMode: COLOR_MODE_LIGHT, // 浅色模式
direction: DIRECTION_VERTICAL, direction: DIRECTION_VERTICAL, // 垂直方向
screenDensity: SCREEN_DENSITY_SDPI, screenDensity: SCREEN_DENSITY_SDPI, // 屏幕分辨率为"sdpi"
displayId: 1, displayId: 1, // 应用在Id为1的物理屏上显示
hasPointerDevice: true, hasPointerDevice: true, // 指针类型设备已连接
} }
try { try {
...@@ -113,8 +129,8 @@ try { ...@@ -113,8 +129,8 @@ try {
console.log('updateConfiguration fail, err: ' + JSON.stringify(err)); console.log('updateConfiguration fail, err: ' + JSON.stringify(err));
}) })
} catch (paramError) { } catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) + console.log('error.code: ' + JSON.stringify(paramError.code)
' error.message: ' + JSON.stringify(paramError.message)); + ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
...@@ -138,16 +154,16 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo ...@@ -138,16 +154,16 @@ getAbilityRunningInfos(callback: AsyncCallback\<Array\<AbilityRunningInfo>>): vo
```ts ```ts
try { try {
abilityManager.getAbilityRunningInfos((err,data) => { abilityManager.getAbilityRunningInfos((err, data) => {
if (err.code != 0) { if (err.code !== 0) {
console.log("getAbilityRunningInfos fail, error: " + JSON.stringify(err)); console.log("getAbilityRunningInfos fail, error: " + JSON.stringify(err));
} else { } else {
console.log("getAbilityRunningInfos success, data: " + JSON.stringify(data)); console.log("getAbilityRunningInfos success, data: " + JSON.stringify(data));
} }
}); });
} catch (paramError) { } catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) + console.log('error.code: ' + JSON.stringify(paramError.code)
' error.message: ' + JSON.stringify(paramError.message)); + ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
...@@ -167,6 +183,14 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>> ...@@ -167,6 +183,14 @@ getAbilityRunningInfos(): Promise\<Array\<AbilityRunningInfo>>
| ---------------------------------------- | ------- | | ---------------------------------------- | ------- |
| Promise\<Array\<[AbilityRunningInfo](js-apis-inner-application-abilityRunningInfo.md)>> | 以Promise方式返回接口运行结果及运行中的ability信息，可进行错误处理或其他自定义处理。 | | Promise\<Array\<[AbilityRunningInfo](js-apis-inner-application-abilityRunningInfo.md)>> | 以Promise方式返回接口运行结果及运行中的ability信息，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例**： **示例**：
```ts ```ts
...@@ -177,8 +201,8 @@ try { ...@@ -177,8 +201,8 @@ try {
console.log("getAbilityRunningInfos fail, err: " + JSON.stringify(err)); console.log("getAbilityRunningInfos fail, err: " + JSON.stringify(err));
}); });
} catch (paramError) { } catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) + console.log('error.code: ' + JSON.stringify(paramError.code)
' error.message: ' + JSON.stringify(paramError.message)); + ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
...@@ -196,25 +220,33 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext ...@@ -196,25 +220,33 @@ getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback\<Array\<Ext
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 | | upperLimit | number | 是 | 获取消息数量的最大限制，最大为2<sup>31</sup>-1。 |
| callback | AsyncCallback\<Array\<[ExtensionRunningInfo](js-apis-inner-application-extensionRunningInfo.md)>> | 是 | 以回调方式返回接口运行结果及运行中的extension信息，可进行错误处理或其他自定义处理。 | | callback | AsyncCallback\<Array\<[ExtensionRunningInfo](js-apis-inner-application-extensionRunningInfo.md)>> | 是 | 以回调方式返回接口运行结果及运行中的extension信息，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例**： **示例**：
```ts ```ts
var upperLimit = 0; let upperLimit = 10;
try { try {
abilityManager.getExtensionRunningInfos(upperLimit, (err,data) => { abilityManager.getExtensionRunningInfos(upperLimit, (err, data) => {
if (err.code != 0) { if (err.code !== 0) {
console.log("getExtensionRunningInfos fail, err: " + JSON.stringify(err)); console.log("getExtensionRunningInfos fail, err: " + JSON.stringify(err));
} else { } else {
console.log("getExtensionRunningInfos success, data: " + JSON.stringify(data)); console.log("getExtensionRunningInfos success, data: " + JSON.stringify(data));
} }
}); });
} catch (paramError) { } catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) + console.log('error.code: ' + JSON.stringify(paramError.code)
' error.message: ' + JSON.stringify(paramError.message)); + ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
...@@ -232,7 +264,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn ...@@ -232,7 +264,7 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| upperLimit | number | 是 | 获取消息数量的最大限制。 | | upperLimit | number | 是 | 获取消息数量的最大限制，最大为2<sup>31</sup>-1。 |
**返回值：** **返回值：**
...@@ -240,10 +272,18 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn ...@@ -240,10 +272,18 @@ getExtensionRunningInfos(upperLimit: number): Promise\<Array\<ExtensionRunningIn
| ---------------------------------------- | ------- | | ---------------------------------------- | ------- |
| Promise\<Array\<[ExtensionRunningInfo](js-apis-inner-application-extensionRunningInfo.md)>> | 以Promise方式返回接口运行结果及运行中的extension信息，可进行错误处理或其他自定义处理。 | | Promise\<Array\<[ExtensionRunningInfo](js-apis-inner-application-extensionRunningInfo.md)>> | 以Promise方式返回接口运行结果及运行中的extension信息，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例**： **示例**：
```ts ```ts
var upperLimit = 0; let upperLimit = 10;
try { try {
abilityManager.getExtensionRunningInfos(upperLimit).then((data) => { abilityManager.getExtensionRunningInfos(upperLimit).then((data) => {
...@@ -252,8 +292,8 @@ try { ...@@ -252,8 +292,8 @@ try {
console.log("getExtensionRunningInfos fail, err: " + JSON.stringify(err)); console.log("getExtensionRunningInfos fail, err: " + JSON.stringify(err));
}) })
} catch (paramError) { } catch (paramError) {
console.log('error.code: ' + JSON.stringify(paramError.code) + console.log('error.code: ' + JSON.stringify(paramError.code)
' error.message: ' + JSON.stringify(paramError.message)); + ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
...@@ -271,11 +311,19 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void; ...@@ -271,11 +311,19 @@ getTopAbility(callback: AsyncCallback\<ElementName>): void;
| --------- | ---------------------------------------- | ---- | -------------- | | --------- | ---------------------------------------- | ---- | -------------- |
| callback | AsyncCallback\<[ElementName](js-apis-bundleManager-elementName.md)> | 是 | 以回调方式返回接口运行结果及应用名，可进行错误处理或其他自定义处理。 | | callback | AsyncCallback\<[ElementName](js-apis-bundleManager-elementName.md)> | 是 | 以回调方式返回接口运行结果及应用名，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例**： **示例**：
```ts ```ts
abilityManager.getTopAbility((err,data) => { abilityManager.getTopAbility((err, data) => {
if (err.code != 0) { if (err.code !== 0) {
console.log("getTopAbility fail, err: " + JSON.stringify(err)); console.log("getTopAbility fail, err: " + JSON.stringify(err));
} else { } else {
console.log("getTopAbility success, data: " + JSON.stringify(data)); console.log("getTopAbility success, data: " + JSON.stringify(data));
...@@ -297,6 +345,14 @@ getTopAbility(): Promise\<ElementName>; ...@@ -297,6 +345,14 @@ getTopAbility(): Promise\<ElementName>;
| ---------------------------------------- | ------- | | ---------------------------------------- | ------- |
| Promise\<[ElementName](js-apis-bundleManager-elementName.md)>| 以Promise方式返回接口运行结果及应用名，可进行错误处理或其他自定义处理。 | | Promise\<[ElementName](js-apis-bundleManager-elementName.md)>| 以Promise方式返回接口运行结果及应用名，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例**： **示例**：
```ts ```ts
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-appManager.md
浏览文件 @ c0f1d270
...@@ -26,12 +26,20 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -26,12 +26,20 @@ static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void
| -------- | -------- | | -------- | -------- |
|AsyncCallback&lt;boolean&gt; |以回调方式返回接口运行结果及当前是否处于稳定性测试场景，可进行错误处理或其他自定义处理。true: 处于稳定性测试场景，false：处于非稳定性测试场景。 | |AsyncCallback&lt;boolean&gt; |以回调方式返回接口运行结果及当前是否处于稳定性测试场景，可进行错误处理或其他自定义处理。true: 处于稳定性测试场景，false：处于非稳定性测试场景。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
appManager.isRunningInStabilityTest((err, flag) => { appManager.isRunningInStabilityTest((err, flag) => {
if (err.code !== 0) { if (err.code !== 0) {
conseole.log("isRunningInStabilityTest faile, err: " + JSON.stringify(err)); console.log("isRunningInStabilityTest faile, err: " + JSON.stringify(err));
} else { } else {
console.log("The result of isRunningInStabilityTest is:" + JSON.stringify(flag)); console.log("The result of isRunningInStabilityTest is:" + JSON.stringify(flag));
} }
...@@ -53,6 +61,14 @@ static isRunningInStabilityTest(): Promise&lt;boolean&gt; ...@@ -53,6 +61,14 @@ static isRunningInStabilityTest(): Promise&lt;boolean&gt;
| -------- | -------- | | -------- | -------- |
| Promise&lt;boolean&gt; | 以Promise方式返回接口运行结果及当前是否处于稳定性测试场景，可进行错误处理或其他自定义处理。true: 处于稳定性测试场景，false：处于非稳定性测试场景。 | | Promise&lt;boolean&gt; | 以Promise方式返回接口运行结果及当前是否处于稳定性测试场景，可进行错误处理或其他自定义处理。true: 处于稳定性测试场景，false：处于非稳定性测试场景。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
...@@ -78,6 +94,14 @@ isRamConstrainedDevice(): Promise\<boolean>; ...@@ -78,6 +94,14 @@ isRamConstrainedDevice(): Promise\<boolean>;
| -------- | -------- | | -------- | -------- |
| Promise&lt;boolean&gt; | 以Promise方式返回接口运行结果及当前设备是否为ram受限设备，可进行错误处理或其他自定义处理。true：当前设备为ram受限设备，false：当前设备为非ram受限设备。 | | Promise&lt;boolean&gt; | 以Promise方式返回接口运行结果及当前设备是否为ram受限设备，可进行错误处理或其他自定义处理。true：当前设备为ram受限设备，false：当前设备为非ram受限设备。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
...@@ -102,6 +126,14 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void; ...@@ -102,6 +126,14 @@ isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void;
| -------- | -------- | | -------- | -------- |
| AsyncCallback&lt;boolean&gt; |以回调方式返回接口运行结果及当前设备是否为ram受限设备，可进行错误处理或其他自定义处理。true：当前设备为ram受限设备，false：当前设备为非ram受限设备。 | | AsyncCallback&lt;boolean&gt; |以回调方式返回接口运行结果及当前设备是否为ram受限设备，可进行错误处理或其他自定义处理。true：当前设备为ram受限设备，false：当前设备为非ram受限设备。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
...@@ -128,6 +160,14 @@ getAppMemorySize(): Promise\<number>; ...@@ -128,6 +160,14 @@ getAppMemorySize(): Promise\<number>;
| -------- | -------- | | -------- | -------- |
| Promise&lt;number&gt; | 以Promise方式返回接口运行结果及应用程序内存大小，可进行错误处理或其他自定义处理。 | | Promise&lt;number&gt; | 以Promise方式返回接口运行结果及应用程序内存大小，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
...@@ -152,6 +192,14 @@ getAppMemorySize(callback: AsyncCallback\<number>): void; ...@@ -152,6 +192,14 @@ getAppMemorySize(callback: AsyncCallback\<number>): void;
| -------- | -------- | | -------- | -------- |
|AsyncCallback&lt;number&gt; |以回调方式返回接口运行结果及应用程序内存大小，可进行错误处理或其他自定义处理。 | |AsyncCallback&lt;number&gt; |以回调方式返回接口运行结果及应用程序内存大小，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
...@@ -164,7 +212,7 @@ appManager.getAppMemorySize((err, data) => { ...@@ -164,7 +212,7 @@ appManager.getAppMemorySize((err, data) => {
}) })
``` ```
## appManager.getProcessRunningInformation<sup>9+</sup> ## appManager.getProcessRunningInformation
getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>; getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>;
...@@ -182,6 +230,14 @@ getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>; ...@@ -182,6 +230,14 @@ getProcessRunningInformation(): Promise\<Array\<ProcessRunningInformation>>;
| -------- | -------- | | -------- | -------- |
| Promise\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | 以Promise方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 | | Promise\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | 以Promise方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
...@@ -210,6 +266,14 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor ...@@ -210,6 +266,14 @@ getProcessRunningInformation(callback: AsyncCallback\<Array\<ProcessRunningInfor
| -------- | -------- | | -------- | -------- |
|AsyncCallback\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | 以回调方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 | |AsyncCallback\<Array\<[ProcessRunningInformation](js-apis-inner-application-processRunningInformation.md)>> | 以回调方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
...@@ -247,9 +311,17 @@ on(type: "applicationState", observer: ApplicationStateObserver): number; ...@@ -247,9 +311,17 @@ on(type: "applicationState", observer: ApplicationStateObserver): number;
| --- | --- | | --- | --- |
| number | 已注册观测器的数字代码，可用于off接口取消注册观测器。| | number | 已注册观测器的数字代码，可用于off接口取消注册观测器。|
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```js ```ts
let applicationStateObserver = { let applicationStateObserver = {
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`); console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
...@@ -268,8 +340,8 @@ let applicationStateObserver = { ...@@ -268,8 +340,8 @@ let applicationStateObserver = {
} }
} }
try { try {
const observerCode = appManager.on('applicationState', applicationStateObserver); const observerId = appManager.on('applicationState', applicationStateObserver);
console.log(`[appManager] observerCode: ${observerCode}`); console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) { } catch (paramError) {
console.log(`[appManager] error: ${paramError.code}, ${paramError.message} `); console.log(`[appManager] error: ${paramError.code}, ${paramError.message} `);
} }
...@@ -301,9 +373,17 @@ on(type: "applicationState", observer: ApplicationStateObserver, bundleNameList: ...@@ -301,9 +373,17 @@ on(type: "applicationState", observer: ApplicationStateObserver, bundleNameList:
| --- | --- | | --- | --- |
| number | 已注册观测器的数字代码，可用于off接口注销观测器。| | number | 已注册观测器的数字代码，可用于off接口注销观测器。|
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```js ```ts
let applicationStateObserver = { let applicationStateObserver = {
onForegroundApplicationChanged(appStateData) { onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`); console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
...@@ -323,8 +403,8 @@ let applicationStateObserver = { ...@@ -323,8 +403,8 @@ let applicationStateObserver = {
} }
let bundleNameList = ['bundleName1', 'bundleName2']; let bundleNameList = ['bundleName1', 'bundleName2'];
try { try {
const observerCode = appManager.on("applicationState", applicationStateObserver, bundleNameList); const observerId = appManager.on("applicationState", applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerCode}`); console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) { } catch (paramError) {
console.log(`[appManager] error: ${paramError.code}, ${paramError.message} `); console.log(`[appManager] error: ${paramError.code}, ${paramError.message} `);
} }
...@@ -350,11 +430,46 @@ off(type: "applicationState", observerId: number, callback: AsyncCallback\<void ...@@ -350,11 +430,46 @@ off(type: "applicationState", observerId: number, callback: AsyncCallback\<void
| observerId | number | 是 | 表示观测器的编号代码。 | | observerId | number | 是 | 表示观测器的编号代码。 |
| callback | AsyncCallback\<void> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 | | callback | AsyncCallback\<void> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
let observerId = 100; let observeId: int = 0;
// 1.注册应用状态监听器
let applicationStateObserver = {
onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
},
onAbilityStateChanged(abilityStateData) {
console.log(`[appManager] onAbilityStateChanged: ${JSON.stringify(abilityStateData)}`);
},
onProcessCreated(processData) {
console.log(`[appManager] onProcessCreated: ${JSON.stringify(processData)}`);
},
onProcessDied(processData) {
console.log(`[appManager] onProcessDied: ${JSON.stringify(processData)}`);
},
onProcessStateChanged(processData) {
console.log(`[appManager] onProcessStateChanged: ${JSON.stringify(processData)}`);
}
}
let bundleNameList = ['bundleName1', 'bundleName2'];
try {
observerId = appManager.on("applicationState", applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) {
console.log(`[appManager] error: ${paramError.code}, ${paramError.message} `);
}
// 2.注销应用状态监听器
function unregisterApplicationStateObserverCallback(err) { function unregisterApplicationStateObserverCallback(err) {
if (err.code !== 0) { if (err.code !== 0) {
console.log("unregisterApplicationStateObserverCallback faile, err: " + JSON.stringify(err)); console.log("unregisterApplicationStateObserverCallback faile, err: " + JSON.stringify(err));
...@@ -363,7 +478,7 @@ function unregisterApplicationStateObserverCallback(err) { ...@@ -363,7 +478,7 @@ function unregisterApplicationStateObserverCallback(err) {
} }
} }
try { try {
appManager.off(observerId, unregisterApplicationStateObserverCallback); appManager.off("applicationState", observerId, unregisterApplicationStateObserverCallback);
} catch (paramError) { } catch (paramError) {
console.log('error: ' + paramError.code + ', ' + paramError.message); console.log('error: ' + paramError.code + ', ' + paramError.message);
} }
...@@ -394,13 +509,48 @@ off(type: "applicationState", observerId: number): Promise\<void>; ...@@ -394,13 +509,48 @@ off(type: "applicationState", observerId: number): Promise\<void>;
| -------- | -------- | | -------- | -------- |
| Promise\<void> | 以Promise方式返回接口运行结果，可进行错误处理或其他自定义处理。 | | Promise\<void> | 以Promise方式返回接口运行结果，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
let observerId = 100; let observeId: int = 0;
// 1.注册应用状态监听器
let applicationStateObserver = {
onForegroundApplicationChanged(appStateData) {
console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`);
},
onAbilityStateChanged(abilityStateData) {
console.log(`[appManager] onAbilityStateChanged: ${JSON.stringify(abilityStateData)}`);
},
onProcessCreated(processData) {
console.log(`[appManager] onProcessCreated: ${JSON.stringify(processData)}`);
},
onProcessDied(processData) {
console.log(`[appManager] onProcessDied: ${JSON.stringify(processData)}`);
},
onProcessStateChanged(processData) {
console.log(`[appManager] onProcessStateChanged: ${JSON.stringify(processData)}`);
}
}
let bundleNameList = ['bundleName1', 'bundleName2'];
try { try {
appManager.off(observerId).then((data) => { observerId = appManager.on("applicationState", applicationStateObserver, bundleNameList);
console.log(`[appManager] observerCode: ${observerId}`);
} catch (paramError) {
console.log(`[appManager] error: ${paramError.code}, ${paramError.message} `);
}
// 2.注销应用状态监听器
try {
appManager.off("applicationState", observerId).then((data) => {
console.log("unregisterApplicationStateObserver success, data: " + JSON.stringify(data)); console.log("unregisterApplicationStateObserver success, data: " + JSON.stringify(data));
}).catch((err) => { }).catch((err) => {
console.log("unregisterApplicationStateObserver faile, err: " + JSON.stringify(err)); console.log("unregisterApplicationStateObserver faile, err: " + JSON.stringify(err));
...@@ -414,7 +564,7 @@ try { ...@@ -414,7 +564,7 @@ try {
getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void; getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
获取所有当前处于前台的应用信息。该应用信息由[AppStateData](js-apis-inner-application-appStateData.md)定义。 获取当前所有前台应用的信息。该应用信息由[AppStateData](js-apis-inner-application-appStateData.md)定义。
**需要权限**：ohos.permission.GET_RUNNING_INFO **需要权限**：ohos.permission.GET_RUNNING_INFO
...@@ -422,40 +572,13 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void; ...@@ -422,40 +572,13 @@ getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
**系统API**：该接口为系统接口，三方应用不支持调用。 **系统API**：该接口为系统接口，三方应用不支持调用。
**参数：** **错误码**：
| 参数名 | 类型 | 必填 | 说明 | | 错误码ID | 错误信息 |
| -------- | -------- | -------- | -------- | | ------- | -------- |
| callback | AsyncCallback\<Array\<[AppStateData](js-apis-inner-application-appStateData.md)>> | 是 | 以回调方式返回接口运行结果及应用状态数据数组，可进行错误处理或其他自定义处理。 | | 16000050 | Internal error. |
**示例：** 以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
```ts
function getForegroundApplicationsCallback(err, data) {
if (err.code !== 0) {
console.log("getForegroundApplicationsCallback fail, err: " + JSON.stringify(err));
} else {
console.log("getForegroundApplicationsCallback success, data: " + JSON.stringify(data));
}
}
try {
appManager.getForegroundApplications(getForegroundApplicationsCallback);
} catch (paramError) {
console.log("error: " + paramError.code + ", " + paramError.message);
}
```
## appManager.getForegroundApplications
getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void;
获取所有当前处于前台的应用信息。该应用信息由[AppStateData](js-apis-inner-application-appStateData.md)定义。
**需要权限**：ohos.permission.GET_RUNNING_INFO
**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
**系统API**：该接口为系统接口，三方应用不支持调用。
**参数：** **参数：**
...@@ -484,7 +607,7 @@ try { ...@@ -484,7 +607,7 @@ try {
getForegroundApplications(): Promise\<Array\<AppStateData>>; getForegroundApplications(): Promise\<Array\<AppStateData>>;
获取所有当前处于前台的应用信息。该应用信息由[AppStateData](js-apis-inner-application-appStateData.md)定义。 获取当前所有前台应用的信息。该应用信息由[AppStateData](js-apis-inner-application-appStateData.md)定义。
**需要权限**：ohos.permission.GET_RUNNING_INFO **需要权限**：ohos.permission.GET_RUNNING_INFO
...@@ -498,6 +621,14 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>; ...@@ -498,6 +621,14 @@ getForegroundApplications(): Promise\<Array\<AppStateData>>;
| -------- | -------- | | -------- | -------- |
| Promise\<Array\<[AppStateData](js-apis-inner-application-appStateData.md)>> | 返回前台进程应用程序的数组。 | | Promise\<Array\<[AppStateData](js-apis-inner-application-appStateData.md)>> | 返回前台进程应用程序的数组。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
...@@ -527,6 +658,14 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\> ...@@ -527,6 +658,14 @@ killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\>
| bundleName | string | 是 | 应用Bundle名称。 | | bundleName | string | 是 | 应用Bundle名称。 |
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 | | accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
...@@ -564,11 +703,19 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal ...@@ -564,11 +703,19 @@ killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCal
| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 | | accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 |
| callback | AsyncCallback\<void\> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 | | callback | AsyncCallback\<void\> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
var bundleName = 'bundleName'; let bundleName = 'bundleName';
var accountId = 0; let accountId = 0;
function killProcessWithAccountCallback(err, data) { function killProcessWithAccountCallback(err, data) {
if (err.code !== 0) { if (err.code !== 0) {
console.log("killProcessWithAccountCallback fail, err: " + JSON.stringify(err)); console.log("killProcessWithAccountCallback fail, err: " + JSON.stringify(err));
...@@ -598,10 +745,18 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>); ...@@ -598,10 +745,18 @@ killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>);
| bundleName | string | 是 | 表示Bundle名称。 | | bundleName | string | 是 | 表示Bundle名称。 |
| callback | AsyncCallback\<void> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 | | callback | AsyncCallback\<void> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
var bundleName = 'bundleName'; let bundleName = 'bundleName';
function killProcessesByBundleNameCallback(err, data) { function killProcessesByBundleNameCallback(err, data) {
if (err.code !== 0) { if (err.code !== 0) {
console.log("killProcessesByBundleNameCallback fail, err: " + JSON.stringify(err)); console.log("killProcessesByBundleNameCallback fail, err: " + JSON.stringify(err));
...@@ -640,6 +795,14 @@ killProcessesByBundleName(bundleName: string): Promise\<void>; ...@@ -640,6 +795,14 @@ killProcessesByBundleName(bundleName: string): Promise\<void>;
| -------- | -------- | | -------- | -------- |
| Promise\<void> | 返回执行结果。 | | Promise\<void> | 返回执行结果。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
...@@ -674,6 +837,14 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>); ...@@ -674,6 +837,14 @@ clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>);
| bundleName | string | 是 | 表示Bundle名称。 | | bundleName | string | 是 | 表示Bundle名称。 |
| callback | AsyncCallback\<void> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 | | callback | AsyncCallback\<void> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
...@@ -716,6 +887,14 @@ clearUpApplicationData(bundleName: string): Promise\<void>; ...@@ -716,6 +887,14 @@ clearUpApplicationData(bundleName: string): Promise\<void>;
| -------- | -------- | | -------- | -------- |
| Promise\<void> | 以Promise方式返回接口运行结果，可进行错误处理或其他自定义处理。 | | Promise\<void> | 以Promise方式返回接口运行结果，可进行错误处理或其他自定义处理。 |
**错误码**：
| 错误码ID | 错误信息 |
| ------- | -------- |
| 16000050 | Internal error. |
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
```ts ```ts
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md
浏览文件 @ c0f1d270
...@@ -68,7 +68,9 @@ enableAppRecovery(restart?: [RestartFlag](#apprecoveryrestartflag), saveOccasion ...@@ -68,7 +68,9 @@ enableAppRecovery(restart?: [RestartFlag](#apprecoveryrestartflag), saveOccasion
```ts ```ts
import AbilityStage from '@ohos.app.ability.AbilityStage'; import AbilityStage from '@ohos.app.ability.AbilityStage';
export default class MyAbilityStage extends AbilityStage { import UIAbility from '@ohos.app.ability.UIAbility';
export default class MyAbility extends UIAbility {
onCreate() { onCreate() {
appRecovery.enableAppRecovery(RestartFlag::ALWAYS_RESTART, SaveOccasionFlag::SAVE_WHEN_ERROR, SaveModeFlag::SAVE_WITH_FILE); appRecovery.enableAppRecovery(RestartFlag::ALWAYS_RESTART, SaveOccasionFlag::SAVE_WHEN_ERROR, SaveModeFlag::SAVE_WITH_FILE);
} }
...@@ -88,7 +90,8 @@ restartApp(): void; ...@@ -88,7 +90,8 @@ restartApp(): void;
```ts ```ts
import errorManager from '@ohos.app.ability.errorManager'; import errorManager from '@ohos.app.ability.errorManager';
var observer = {
let observer = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg) console.log('onUnhandledException, errorMsg: ', errorMsg)
appRecovery.restartApp(); appRecovery.restartApp();
...@@ -114,7 +117,8 @@ saveAppState(): boolean; ...@@ -114,7 +117,8 @@ saveAppState(): boolean;
```ts ```ts
import errorManager from '@ohos.app.ability.errorManager'; import errorManager from '@ohos.app.ability.errorManager';
var observer = {
let observer = {
onUnhandledException(errorMsg) { onUnhandledException(errorMsg) {
console.log('onUnhandledException, errorMsg: ', errorMsg) console.log('onUnhandledException, errorMsg: ', errorMsg)
appRecovery.saveAppState(); appRecovery.saveAppState();
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
浏览文件 @ c0f1d270
...@@ -332,7 +332,8 @@ call(method: string, data: rpc.Sequenceable): Promise&lt;void&gt;; ...@@ -332,7 +332,8 @@ call(method: string, data: rpc.Sequenceable): Promise&lt;void&gt;;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -412,7 +413,8 @@ callWithResult(method: string, data: rpc.Sequenceable): Promise&lt;rpc.MessagePa ...@@ -412,7 +413,8 @@ callWithResult(method: string, data: rpc.Sequenceable): Promise&lt;rpc.MessagePa
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -573,7 +575,8 @@ release(): void; ...@@ -573,7 +575,8 @@ release(): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -628,7 +631,8 @@ on(method: string, callback: CalleeCallback): void; ...@@ -628,7 +631,8 @@ on(method: string, callback: CalleeCallback): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -693,7 +697,8 @@ off(method: string): void; ...@@ -693,7 +697,8 @@ off(method: string): void;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-app-ability-wantAgent.md
浏览文件 @ c0f1d270
...@@ -52,7 +52,8 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void ...@@ -52,7 +52,8 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\<WantAgent\>): void
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -150,7 +151,8 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\> ...@@ -150,7 +151,8 @@ getWantAgent(info: WantAgentInfo): Promise\<WantAgent\>
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -345,7 +347,8 @@ getBundleName(agent: WantAgent): Promise\<string\> ...@@ -345,7 +347,8 @@ getBundleName(agent: WantAgent): Promise\<string\>
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -446,7 +449,8 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void ...@@ -446,7 +449,8 @@ getUid(agent: WantAgent, callback: AsyncCallback\<number\>): void
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -557,7 +561,8 @@ getUid(agent: WantAgent): Promise\<number\> ...@@ -557,7 +561,8 @@ getUid(agent: WantAgent): Promise\<number\>
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -660,7 +665,8 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void ...@@ -660,7 +665,8 @@ getWant(agent: WantAgent, callback: AsyncCallback\<Want\>): void
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -772,7 +778,8 @@ getWant(agent: WantAgent): Promise\<Want\> ...@@ -772,7 +778,8 @@ getWant(agent: WantAgent): Promise\<Want\>
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -873,7 +880,8 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void ...@@ -873,7 +880,8 @@ cancel(agent: WantAgent, callback: AsyncCallback\<void\>): void
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -983,7 +991,8 @@ cancel(agent: WantAgent): Promise\<void\> ...@@ -983,7 +991,8 @@ cancel(agent: WantAgent): Promise\<void\>
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1083,7 +1092,8 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: AsyncCallback\<Co ...@@ -1083,7 +1092,8 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: AsyncCallback\<Co
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1193,7 +1203,8 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\ ...@@ -1193,7 +1203,8 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\<boolean\
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1306,7 +1317,8 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\> ...@@ -1306,7 +1317,8 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\<boolean\>
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1407,7 +1419,8 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void; ...@@ -1407,7 +1419,8 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void;
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -1515,7 +1528,8 @@ getOperationType(agent: WantAgent): Promise\<number>; ...@@ -1515,7 +1528,8 @@ getOperationType(agent: WantAgent): Promise\<number>;
| 16000151 | Invalid wantagent object.| | 16000151 | Invalid wantagent object.|
| 16000152 | wantAgent object not found.| | 16000152 | wantAgent object not found.|
| 16000153 | wangAgent object canceled.| | 16000153 | wangAgent object canceled.|
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
......
zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md
浏览文件 @ c0f1d270
...@@ -52,7 +52,8 @@ createBundleContext(bundleName: string): Context; ...@@ -52,7 +52,8 @@ createBundleContext(bundleName: string): Context;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -91,7 +92,8 @@ createModuleContext(moduleName: string): Context; ...@@ -91,7 +92,8 @@ createModuleContext(moduleName: string): Context;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../errorcodes/errorcode-ability.md)
以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
**示例：** **示例：**
...@@ -129,7 +131,8 @@ createModuleContext(bundleName: string, moduleName: string): Context; ...@@ -129,7 +131,8 @@ createModuleContext(bundleName: string, moduleName: string): Context;
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 401 | If the input parameter is not valid parameter. | | 401 | If the input parameter is not valid parameter. |
其他ID见[元能力子系统错误码](../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.
先完成此消息的编辑！
想要评论请 注册 或