From 236f7d59bcbc19225202e9f74d2dcf10c723bc09 Mon Sep 17 00:00:00 2001 From: xuzhihao Date: Sat, 20 Apr 2024 11:55:37 +0800 Subject: [PATCH 1/2] =?UTF-8?q?Bugfix:=20=E5=85=83=E8=83=BD=E5=8A=9B?= =?UTF-8?q?=E9=97=AE=E9=A2=98=E5=8D=95=E5=A4=84=E7=90=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: xuzhihao --- .../napi/use-napi-ark-runtime.md | 2 +- ...-inner-application-abilityStartCallback.md | 40 +-- ...apis-inner-application-uiAbilityContext.md | 271 +++++++++++++----- 3 files changed, 218 insertions(+), 95 deletions(-) diff --git a/zh-cn/application-dev/napi/use-napi-ark-runtime.md b/zh-cn/application-dev/napi/use-napi-ark-runtime.md index 23da8a2522..c6097c21e5 100644 --- a/zh-cn/application-dev/napi/use-napi-ark-runtime.md +++ b/zh-cn/application-dev/napi/use-napi-ark-runtime.md @@ -81,7 +81,7 @@ // 2. 加载自定义模块 napi_value objUtils; - ret = napi_load_module_with_info(env, "ets/pages/ObjectUtils", "com.exmaple.myapplication/entry", &objUtils); + ret = napi_load_module_with_info(env, "entry/main/src/ets/pages/ObjectUtils", "com.exmaple.myapplication/entry", &objUtils); if (ret != napi_ok) { return nullptr; } diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-abilityStartCallback.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-abilityStartCallback.md index 04d5edb9ef..05cc22c31b 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-abilityStartCallback.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-abilityStartCallback.md @@ -25,26 +25,32 @@ import common from '@ohos.app.ability.common'; **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; import common from '@ohos.app.ability.common'; import { BusinessError } from '@ohos.base'; - let context = getContext(this) as common.UIAbilityContext; - let wantParam: Record = { - 'time':'2023-10-23 20:45', - }; - let abilityStartCallback: common.AbilityStartCallback = { - onError: (code: number, name: string, message: string) => { - console.log(`code:` + code + `name:` + name + `message:` + message); - }, - onResult: (abilityResult: common.AbilityResult) => { - console.log(`resultCode:` + abilityResult.resultCode + `bundleName:` + abilityResult.want?.bundleName); + + export default class EntryAbility extends UIAbility { + onForeground() { + let wantParam: Record = { + 'time': '2023-10-23 20:45', + }; + let abilityStartCallback: common.AbilityStartCallback = { + onError: (code: number, name: string, message: string) => { + console.log(`code:` + code + `name:` + name + `message:` + message); + }, + onResult: (abilityResult: common.AbilityResult) => { + console.log(`resultCode:` + abilityResult.resultCode + `bundleName:` + abilityResult.want?.bundleName); + } + }; + + this.context.startAbilityByType("photoEditor", wantParam, abilityStartCallback, (err: BusinessError) => { + if (err) { + console.error(`startAbilityByType fail, err: ${JSON.stringify(err)}`); + } else { + console.log(`success`); + } + }); } } - context.startAbilityByType("photoEditor", wantParam, abilityStartCallback, (err: BusinessError) => { - if (err) { - console.error(`startAbilityByType fail, err: ${JSON.stringify(err)}`); - } else { - console.log(`success`); - } - }); ``` diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md index 9e32108fc0..313a748b8c 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md @@ -80,7 +80,6 @@ import Want from '@ohos.app.ability.Want'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { let want: Want = { bundleName: 'com.example.myapplication', @@ -163,7 +162,6 @@ import StartOptions from '@ohos.app.ability.StartOptions'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { let want: Want = { deviceId: '', @@ -255,14 +253,13 @@ import StartOptions from '@ohos.app.ability.StartOptions'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; let options: StartOptions = { - displayId: 0, + displayId: 0 }; try { @@ -340,7 +337,6 @@ import Want from '@ohos.app.ability.Want'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { let want: Want = { deviceId: '', @@ -425,7 +421,6 @@ import StartOptions from '@ohos.app.ability.StartOptions'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { let want: Want = { deviceId: '', @@ -433,7 +428,7 @@ export default class EntryAbility extends UIAbility { abilityName: 'EntryAbility' }; let options: StartOptions = { - displayId: 0, + displayId: 0 }; try { @@ -520,14 +515,13 @@ import StartOptions from '@ohos.app.ability.StartOptions'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { let want: Want = { bundleName: 'com.example.myapplication', abilityName: 'EntryAbility' }; let options: StartOptions = { - displayId: 0, + displayId: 0 }; try { @@ -584,7 +578,6 @@ import UIAbility from '@ohos.app.ability.UIAbility'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { try { this.context.terminateSelf((err: BusinessError) => { @@ -641,7 +634,6 @@ import UIAbility from '@ohos.app.ability.UIAbility'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { try { this.context.terminateSelf() @@ -701,7 +693,6 @@ import Want from '@ohos.app.ability.Want'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { let want: Want = { bundleName: 'com.example.myapplication', @@ -777,7 +768,6 @@ import Want from '@ohos.app.ability.Want'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { let want: Want = { bundleName: 'com.example.myapplication', @@ -858,7 +848,6 @@ import { BusinessError } from '@ohos.base'; import rpc from '@ohos.rpc'; export default class EntryAbility extends UIAbility { - onForeground() { let want: Want = { deviceId: '', @@ -869,16 +858,17 @@ export default class EntryAbility extends UIAbility { let options: common.ConnectOptions = { onConnect(elementName, remote) { commRemote = remote; - console.info('onConnect...') + console.info('onConnect...'); }, onDisconnect(elementName) { - console.info('onDisconnect...') + console.info('onDisconnect...'); }, onFailed(code) { - console.info('onFailed...') + console.info('onFailed...'); } }; let connection: number; + try { connection = this.context.connectServiceExtensionAbility(want, options); } catch (err) { @@ -928,7 +918,6 @@ import { BusinessError } from '@ohos.base'; import rpc from '@ohos.rpc'; export default class EntryAbility extends UIAbility { - onForeground() { // connection为connectServiceExtensionAbility中的返回值 let connection = 1; @@ -942,7 +931,7 @@ export default class EntryAbility extends UIAbility { }).catch((err: BusinessError) => { // 处理业务逻辑错误 console.error(`disconnectServiceExtensionAbility failed, code is ${err.code}, message is ${err.message}`); - }) + }); } catch (err) { commRemote = null; // 处理入参错误异常 @@ -986,7 +975,6 @@ import { BusinessError } from '@ohos.base'; import rpc from '@ohos.rpc'; export default class EntryAbility extends UIAbility { - onForeground() { // connection为connectServiceExtensionAbility中的返回值 let connection = 1; @@ -1074,10 +1062,8 @@ import Want from '@ohos.app.ability.Want'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { let caller: Caller; - // 后台启动Ability，不配置parameters let wantBackground: Want = { bundleName: 'com.example.myapplication', @@ -1115,10 +1101,8 @@ import Want from '@ohos.app.ability.Want'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { let caller: Caller; - // 前台启动Ability，将parameters中的'ohos.aafwk.param.callAbilityToForeground'配置为true let wantForeground: Want = { bundleName: 'com.example.myapplication', @@ -1183,7 +1167,6 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { this.context.setMissionLabel('test', (result: BusinessError) => { console.info(`setMissionLabel: ${JSON.stringify(result)}`); @@ -1230,7 +1213,6 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { this.context.setMissionLabel('test').then(() => { console.info('success'); @@ -1534,7 +1516,6 @@ import Want from '@ohos.app.ability.Want'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { let want: Want = { bundleName: 'com.example.myapplication', @@ -1614,7 +1595,7 @@ export default class EntryAbility extends UIAbility { console.error(`reportDrawnCompleted failed, code is ${code}, message is ${message}`); } }); - console.log("MainAbility onWindowStageCreate") + console.log("MainAbility onWindowStageCreate"); } }; ``` @@ -1653,26 +1634,32 @@ startAbilityByType(type: string, wantParam: Record, **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; import common from '@ohos.app.ability.common'; - let context = getContext(this) as common.UIAbilityContext; - let wantParam: Record = { - 'time':'2023-10-23 20:45', - }; - let abilityStartCallback: common.AbilityStartCallback = { - onError: (code: number, name: string, message: string) => { - console.log(`code:` + code + `name:` + name + `message:` + message); - }, - onResult: (abilityResult: common.AbilityResult) => { - console.log(`resultCode:` + abilityResult.resultCode + `bundleName:` + abilityResult.want?.bundleName); + + export default class EntryAbility extends UIAbility { + onForeground() { + let wantParam: Record = { + 'time': '2023-10-23 20:45' + }; + let abilityStartCallback: common.AbilityStartCallback = { + onError: (code: number, name: string, message: string) => { + console.log(`code:` + code + `name:` + name + `message:` + message); + }, + onResult: (abilityResult: common.AbilityResult) => { + console.log(`resultCode:` + abilityResult.resultCode + `bundleName:` + abilityResult.want?.bundleName); + } + }; + + this.context.startAbilityByType("photoEditor", wantParam, abilityStartCallback, (err) => { + if (err) { + console.error(`startAbilityByType fail, err: ${JSON.stringify(err)}`); + } else { + console.log(`success`); + } + }); } } - context.startAbilityByType("photoEditor", wantParam, abilityStartCallback, (err) => { - if (err) { - console.error(`startAbilityByType fail, err: ${JSON.stringify(err)}`); - } else { - console.log(`success`); - } - }); ``` ## UIAbilityContext.startAbilityByType11+ @@ -1714,25 +1701,31 @@ startAbilityByType(type: string, wantParam: Record, **示例：** ```ts + import UIAbility from '@ohos.app.ability.UIAbility'; import common from '@ohos.app.ability.common'; import { BusinessError } from '@ohos.base'; - let context = getContext(this) as common.UIAbilityContext; - let wantParam: Record = { - 'time':'2023-10-23 20:45', - }; - let abilityStartCallback: common.AbilityStartCallback = { - onError: (code: number, name: string, message: string) => { - console.log(`code:` + code + `name:` + name + `message:` + message); - }, - onResult: (abilityResult: common.AbilityResult) => { - console.log(`resultCode:` + abilityResult.resultCode + `bundleName:` + abilityResult.want?.bundleName); + + export default class EntryAbility extends UIAbility { + onForeground() { + let wantParam: Record = { + 'time': '2023-10-23 20:45' + }; + let abilityStartCallback: common.AbilityStartCallback = { + onError: (code: number, name: string, message: string) => { + console.log(`code:` + code + `name:` + name + `message:` + message); + }, + onResult: (abilityResult: common.AbilityResult) => { + console.log(`resultCode:` + abilityResult.resultCode + `bundleName:` + abilityResult.want?.bundleName); + } + }; + + this.context.startAbilityByType("photoEditor", wantParam, abilityStartCallback).then(() => { + console.log(`startAbilityByType success`); + }).catch((err: BusinessError) => { + console.error(`startAbilityByType fail, err: ${JSON.stringify(err)}`); + }); } } - context.startAbilityByType("photoEditor", wantParam, abilityStartCallback).then(() => { - console.log(`startAbilityByType success`); - }).catch((err: BusinessError) => { - console.error(`startAbilityByType fail, err: ${JSON.stringify(err)}`); - }) ``` ## UIAbilityContext.showAbility12+ @@ -1763,15 +1756,77 @@ showAbility() : Promise\ **示例：** ```ts + // Index.ets import common from '@ohos.app.ability.common'; import { BusinessError } from '@ohos.base'; - let context = getContext(this) as common.UIAbilityContext; - context.showAbility().then(() => { - console.log(`showAbility success`); - }).catch((err: BusinessError) => { - console.error(`showAbility fail, err: ${JSON.stringify(err)}`); - }) + + @Entry + @Component + struct Index { + @State showAbility: string = 'showAbility' + + build() { + Row() { + Column() { + Text(this.showAbility) + .fontSize(30) + .fontWeight(FontWeight.Bold) + .onClick(() => { + let context = getContext(this) as common.UIAbilityContext; + + context.showAbility().then(() => { + console.log(`showAbility success`); + }).catch((err: BusinessError) => { + console.error(`showAbility fail, err: ${JSON.stringify(err)}`); + }); + }); + } + .width('100%') + } + .height('100%') + } + } + ``` + ```ts + // EntryAbility.ts + import UIAbility from '@ohos.app.ability.UIAbility'; + import Want from '@ohos.app.ability.Want'; + import StartOptions from '@ohos.app.ability.StartOptions'; + import contextConstant from '@ohos.app.ability.contextConstant'; + import { BusinessError } from '@ohos.base'; + + export default class EntryAbility extends UIAbility { + onForeground() { + let want: Want = { + deviceId: '', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility' + }; + let options: StartOptions = { + displayId: 0, + processMode: contextConstant.ProcessMode.NEW_PROCESS_ATTACH_TO_STATUS_BAR_ITEM + }; + + try { + this.context.startAbility(want, options, (err: BusinessError) => { + if (err.code) { + // 处理业务逻辑错误 + console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`); + return; + } + // 执行正常业务 + console.info('startAbility succeed'); + }); + } catch (err) { + // 处理入参错误异常 + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbility failed, code is ${code}, message is ${message}`); + } + } + } ``` + ## UIAbilityContext.hideAbility12+ hideAbility() : Promise\ @@ -1800,14 +1855,75 @@ hideAbility() : Promise\ **示例：** ```ts + // Index.ets import common from '@ohos.app.ability.common'; import { BusinessError } from '@ohos.base'; - let context = getContext(this) as common.UIAbilityContext; - context.hideAbility().then(() => { - console.log(`hideAbility success`); - }).catch((err: BusinessError) => { - console.error(`hideAbility fail, err: ${JSON.stringify(err)}`); - }) + + @Entry + @Component + struct Index { + @State hideAbility: string = 'hideAbility' + + build() { + Row() { + Column() { + Text(this.hideAbility) + .fontSize(30) + .fontWeight(FontWeight.Bold) + .onClick(() => { + let context = getContext(this) as common.UIAbilityContext; + + context.hideAbility().then(() => { + console.log(`hideAbility success`); + }).catch((err: BusinessError) => { + console.error(`hideAbility fail, err: ${JSON.stringify(err)}`); + }); + }); + } + .width('100%') + } + .height('100%') + } + } + ``` + ```ts + // EntryAbility.ts + import UIAbility from '@ohos.app.ability.UIAbility'; + import Want from '@ohos.app.ability.Want'; + import StartOptions from '@ohos.app.ability.StartOptions'; + import contextConstant from '@ohos.app.ability.contextConstant'; + import { BusinessError } from '@ohos.base'; + + export default class EntryAbility extends UIAbility { + onForeground() { + let want: Want = { + deviceId: '', + bundleName: 'com.example.myapplication', + abilityName: 'EntryAbility' + }; + let options: StartOptions = { + displayId: 0, + processMode: contextConstant.ProcessMode.NEW_PROCESS_ATTACH_TO_STATUS_BAR_ITEM + }; + + try { + this.context.startAbility(want, options, (err: BusinessError) => { + if (err.code) { + // 处理业务逻辑错误 + console.error(`startAbility failed, code is ${err.code}, message is ${err.message}`); + return; + } + // 执行正常业务 + console.info('startAbility succeed'); + }); + } catch (err) { + // 处理入参错误异常 + let code = (err as BusinessError).code; + let message = (err as BusinessError).message; + console.error(`startAbility failed, code is ${code}, message is ${message}`); + } + } + } ``` ## UIAbilityContext.moveAbilityToBackground12+ @@ -1854,10 +1970,11 @@ struct Index { .fontWeight(FontWeight.Bold) .onClick(() => { let context = getContext(this) as common.UIAbilityContext; + context.moveAbilityToBackground().then(() => { console.log(`moveAbilityToBackground success.`); }).catch((err: BusinessError) => { - console.log(`moveAbilityToBackground error: ${JSON.stringify(err)}.`) + console.log(`moveAbilityToBackground error: ${JSON.stringify(err)}.`); }); }); } @@ -1922,11 +2039,10 @@ import common from '@ohos.app.ability.common'; import { BusinessError } from '@ohos.base'; export default class EntryAbility extends UIAbility { - onForeground() { let appId: string = '6918661953712445909'; let options: AtomicServiceOptions = { - displayId: 0, + displayId: 0 }; try { @@ -2030,11 +2146,12 @@ struct Index { .margin({ bottom: '12vp' }) .onClick(() => { let context = getContext(this) as common.UIAbilityContext; - let link: string = "https://www.example.com" + let link: string = "https://www.example.com"; let openLinkOptions: OpenLinkOptions = { appLinkingOnly: true, parameters: {demo_key: "demo_value"} }; + try { context.openLink( link, @@ -2048,7 +2165,7 @@ struct Index { hilog.info(DOMAIN, TAG, 'open link success.'); }).catch((err: BusinessError)=>{ hilog.error(DOMAIN, TAG, 'open link failed, errCode ' + JSON.stringify(err.code)); - }) + }); } catch (e) { hilog.error(DOMAIN, TAG, 'exception occured, errCode ' + JSON.stringify(e.code)); -- Gitee From f6adaec44d74919c9c595a583f7b845b82cfe3da Mon Sep 17 00:00:00 2001 From: xuzhihao Date: Thu, 2 May 2024 11:37:13 +0800 Subject: [PATCH 2/2] =?UTF-8?q?Bugfix:=20=E5=85=83=E8=83=BD=E5=8A=9B401?= =?UTF-8?q?=E9=94=99=E8=AF=AF=E7=A0=81=E6=95=B4=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: xuzhihao --- .../js-apis-app-ability-errorManager.md | 45 ++++++--- ...s-apis-app-ability-insightIntentContext.md | 6 ++ ...pis-app-ability-insightIntentDriver-sys.md | 14 ++- ...js-apis-app-ability-quickFixManager-sys.md | 40 +++++--- .../js-apis-app-ability-uiAbility.md | 56 +++++++---- ...p-ability-uiExtensionContentSession-sys.md | 95 +++++++++++++------ ...s-app-ability-uiExtensionContentSession.md | 59 ++++++++++-- .../js-apis-app-ability-wantAgent-sys.md | 8 +- .../js-apis-app-ability-wantAgent.md | 72 ++++++++++---- .../js-apis-app-appstartup-startupManager.md | 18 ++-- 10 files changed, 307 insertions(+), 106 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-errorManager.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-errorManager.md index 9a7a9fee3e..d3da5ce255 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-errorManager.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-errorManager.md @@ -36,12 +36,13 @@ on(type: 'error', observer: ErrorObserver): number **错误码**： +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed. | | 16000003 | Id does not exist. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - **示例：** ```ts @@ -90,12 +91,13 @@ off(type: 'error', observerId: number, callback: AsyncCallback\): void **错误码**： +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed. | | 16000003 | Id does not exist. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - **示例：** ```ts @@ -143,12 +145,13 @@ off(type: 'error', observerId: number): Promise\ **错误码**： +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed. | | 16000003 | Id does not exist. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - **示例：** ```ts @@ -189,6 +192,14 @@ on(type: 'loopObserver', timeout: number, observer: LoopObserver): void | timeout | number | 是 | 表示事件执行阈值（单位：毫秒）。 阈值必须大于0。 | | observer | [LoopObserver](js-apis-inner-application-loopObserver.md) | 是 | 注册主线程消息处理耗时监听器。 | +**错误码**： + +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed. | + **示例：** ```ts @@ -221,11 +232,12 @@ on(type: 'unhandledRejection', observer: UnhandledRejectionObserver): void **错误码**： +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------- | -| 16200001 | Invalid caller. | - -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed. | +| 16200001 | If the caller is invalid. | **示例：** @@ -267,6 +279,14 @@ off(type: 'loopObserver', observer?: LoopObserver): void | type | string | 是 | 填写'loopObserver'，表示应用主线程观察器。 | | observer | [LoopObserver](js-apis-inner-application-loopObserver.md) | 否 | 应用主线程观察器标志。 | +**错误码**： + +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed. | + **示例：** ```ts @@ -294,10 +314,13 @@ off(type: 'unhandledRejection', observer?: UnhandledRejectionObserver): void **错误码**： +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------- | -| 16200001 | Invalid caller. | -| 16300004 | observer not found. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3. Parameter verification failed. | +| 16200001 | If the caller is invalid. | +| 16300004 | If the observer does not exist. | 以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-insightIntentContext.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-insightIntentContext.md index 89c3875723..d223292205 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-insightIntentContext.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-insightIntentContext.md @@ -35,8 +35,11 @@ startAbility(want: Want, callback: AsyncCallback\): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | -------- | -------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000004 | Can not start invisible component. | | 16000005 | The specified process does not have the permission. | @@ -120,8 +123,11 @@ startAbility(want: Want): Promise\ **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | -------- | -------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000004 | Can not start invisible component. | | 16000005 | The specified process does not have the permission. | diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-insightIntentDriver-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-insightIntentDriver-sys.md index 20e8ca541a..f09d613178 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-insightIntentDriver-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-insightIntentDriver-sys.md @@ -59,8 +59,13 @@ execute(param: ExecuteParam, callback: AsyncCallback **错误码**： +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | -------- | -------- | +| 201 | Permission denied. | +| 202 | Not system application. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000002 | Incorrect ability type. | | 16000004 | Can not start invisible component. | @@ -158,8 +166,6 @@ execute(param: ExecuteParam): Promise | 16000053 | The ability is not on the top of the UI. | | 16000055 | Installation-free timed out. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - **示例：** ```ts diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-quickFixManager-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-quickFixManager-sys.md index 8cb293162e..e528b1c6f4 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-quickFixManager-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-quickFixManager-sys.md @@ -67,13 +67,16 @@ applyQuickFix(hapModuleQuickFixFiles: Array\, callback: AsyncCallback\ 说明：调用applyQuickFix接口时，补丁文件所在路径为应用沙箱路径。沙箱路径的获取参考[获取应用的沙箱路径](js-apis-bundle-BundleInstaller-sys.md#获取应用的沙箱路径)，映射到设备上的路径为/proc/<应用进程Id>/root/沙箱路径。 **示例：** @@ -123,13 +126,16 @@ applyQuickFix(hapModuleQuickFixFiles: Array\): Promise\; 在打补丁过程中发生的错误，其错误码及错误信息通过公共事件[COMMON_EVENT_QUICK_FIX_APPLY_RESULT](../apis-basic-services-kit/common_event/commonEvent-definitions.md#common_event_quick_fix_apply_result9)的参数返回给应用开发者。 +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------- | +| 201 | Permission denied. | +| 202 | Not system application. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 18500002 | The specified quick fix is invalid. It may not exist or inaccessible. | | 18500008 | Internal error. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - **示例：** ```ts @@ -169,13 +175,16 @@ getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\): void; **错误码**： +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------- | +| 201 | Permission denied. | +| 202 | Not system application. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 18500001 | The bundle is not exist or no patch has applied. | | 18500009 | The application has a apply quick fix task that is being processed. | 在撤销补丁过程中发生的错误，其错误码及错误信息通过公共事件[COMMON_EVENT_QUICK_FIX_REVOKE_RESULT](../apis-basic-services-kit/common_event/commonEvent-ability.md#common_event_quick_fix_revoke_result10)的参数返回给应用开发者。 - - **示例：** ```ts @@ -313,10 +328,13 @@ revokeQuickFix(bundleName: string): Promise\; **错误码**： -以下错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 | 错误码ID | 错误信息 | | ------- | -------- | +| 201 | Permission denied. | +| 202 | Not system application. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 18500001 | The bundle is not exist or no patch has applied. | | 18500009 | The application has a apply quick fix task that is being processed. | diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiAbility.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiAbility.md index b1021b457a..d38f4ac171 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiAbility.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiAbility.md @@ -543,14 +543,15 @@ call(method: string, data: rpc.Parcelable): Promise<void> **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16200001 | Caller released. The caller has been released. | | 16200002 | Callee invalid. The callee does not exist. | | 16000050 | Internal error. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - **示例：** ```ts @@ -630,14 +631,15 @@ callWithResult(method: string, data: rpc.Parcelable): Promise<rpc.MessageSequ **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16200001 | Caller released. The caller has been released. | | 16200002 | Callee invalid. The callee does not exist. | | 16000050 | Internal error. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - **示例：** ```ts @@ -706,13 +708,13 @@ release(): void **错误码：** +以下错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | | 16200001 | Caller released. The caller has been released. | | 16200002 | Callee invalid. The callee does not exist. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - **示例：** ```ts @@ -758,12 +760,13 @@ release(): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16200001 | Caller released. The caller has been released. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - **示例：** ```ts @@ -811,12 +814,13 @@ onRemoteStateChange(callback: OnRemoteStateChangeCallback): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16200001 | Caller released. The caller has been released. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - **示例：** ```ts @@ -866,12 +870,13 @@ on(type: 'release', callback: OnReleaseCallback): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. | | 16200001 | Caller released. The caller has been released. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - **示例：** ```ts @@ -918,6 +923,14 @@ off(type: 'release', callback: OnReleaseCallback): void | type | string | 是 | 监听releaseCall事件，固定为'release'。 | | callback | [OnReleaseCallback](#onreleasecallback) | 是 | 回调函数，返回off回调结果。 | +**错误码：** + +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. | + **示例：** ```ts @@ -965,6 +978,14 @@ off(type: 'release'): void | -------- | -------- | -------- | -------- | | type | string | 是 | 监听releaseCall事件，固定为'release'。 | +**错误码：** + +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. | + **示例：** ```ts @@ -1019,13 +1040,14 @@ on(method: string, callback: CalleeCallback): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. | | 16200004 | Method registered. The method has registered. | | 16000050 | Internal error. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - **示例：** ```ts @@ -1090,14 +1112,14 @@ off(method: string): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed. | | 16200005 | Method not registered. The method has not registered. | | 16000050 | Internal error. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - - **示例：** ```ts diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiExtensionContentSession-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiExtensionContentSession-sys.md index ed74f8b3f9..88855fa530 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiExtensionContentSession-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiExtensionContentSession-sys.md @@ -34,12 +34,14 @@ sendData(data: Record\): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 202 | Not System App. Interface caller is not a system app. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000050 | Internal error. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.setReceiveDataCallback setReceiveDataCallback(callback: (data: Record\) => void): void @@ -58,12 +60,14 @@ setReceiveDataCallback(callback: (data: Record\) => void): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 202 | Not System App. Interface caller is not a system app. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000050 | Internal error. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.setReceiveDataForResultCallback11+ setReceiveDataForResultCallback(callback: (data: Record) => Record): void @@ -83,12 +87,14 @@ setReceiveDataForResultCallback(callback: (data: Record) => Reco **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 202 | Not System App. Interface caller is not a system app. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000050 | Internal error. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.startAbility startAbility(want: Want, callback: AsyncCallback<void>): void @@ -100,8 +106,6 @@ startAbility(want: Want, callback: AsyncCallback<void>): void > 组件启动规则详见：[组件启动规则（Stage模型）](../../application-models/component-startup-rules.md)。 > 对应UIExtensionComponent控件所在的应用需要处于前台获焦状态。 - - **系统能力**：SystemCapability.Ability.AbilityRuntime.Core **系统接口**：此接口为系统接口。 @@ -115,8 +119,13 @@ startAbility(want: Want, callback: AsyncCallback<void>): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 201 | The application does not have permission to call the interface. | +| 202 | Not System App. Interface caller is not a system app. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000002 | Incorrect ability type. | | 16000004 | Can not start invisible component. | @@ -133,8 +142,6 @@ startAbility(want: Want, callback: AsyncCallback<void>): void | 16000055 | Installation-free timed out. | | 16200001 | The caller has been released. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.startAbility startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void @@ -160,8 +167,13 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void& **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 201 | The application does not have permission to call the interface. | +| 202 | Not System App. Interface caller is not a system app. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000004 | Can not start invisible component. | | 16000005 | The specified process does not have the permission. | @@ -176,8 +188,6 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void& | 16000055 | Installation-free timed out. | | 16200001 | The caller has been released. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.startAbility startAbility(want: Want, options?: StartOptions): Promise<void> @@ -208,8 +218,13 @@ startAbility(want: Want, options?: StartOptions): Promise<void> **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 201 | The application does not have permission to call the interface. | +| 202 | Not System App. Interface caller is not a system app. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000002 | Incorrect ability type. | | 16000004 | Can not start invisible component. | @@ -226,8 +241,6 @@ startAbility(want: Want, options?: StartOptions): Promise<void> | 16000055 | Installation-free timed out. | | 16200001 | The caller has been released. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.startAbilityForResult startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>): void @@ -257,8 +270,13 @@ Ability的终止方式包括以下几种情况: **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 201 | The application does not have permission to call the interface. | +| 202 | Not System App. Interface caller is not a system app. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000002 | Incorrect ability type. | | 16000004 | Can not start invisible component. | @@ -275,8 +293,6 @@ Ability的终止方式包括以下几种情况: | 16000055 | Installation-free timed out. | | 16200001 | The caller has been released. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.startAbilityForResult startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>): void @@ -307,8 +323,13 @@ Ability的终止方式包括以下几种情况: **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 201 | The application does not have permission to call the interface. | +| 202 | Not System App. Interface caller is not a system app. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000004 | Can not start invisible component. | | 16000005 | The specified process does not have the permission. | @@ -323,8 +344,6 @@ Ability的终止方式包括以下几种情况: | 16000055 | Installation-free timed out. | | 16200001 | The caller has been released. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.startAbilityForResult startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityResult> @@ -361,8 +380,13 @@ Ability的终止方式包括以下几种情况: **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 201 | The application does not have permission to call the interface. | +| 202 | Not System App. Interface caller is not a system app. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000002 | Incorrect ability type. | | 16000004 | Can not start invisible component. | @@ -379,8 +403,6 @@ Ability的终止方式包括以下几种情况: | 16000055 | Installation-free timed out. | | 16200001 | The caller has been released. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.setWindowBackgroundColor setWindowBackgroundColor(color: string): void @@ -399,12 +421,14 @@ setWindowBackgroundColor(color: string): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 202 | Not System App. Interface caller is not a system app. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000050 | Internal error. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.startAbilityAsCaller11+ startAbilityAsCaller(want: Want, callback: AsyncCallback\): void @@ -422,11 +446,15 @@ startAbilityAsCaller(want: Want, callback: AsyncCallback\): void | want | [Want](js-apis-app-ability-want.md) | 是 | 启动Ability的want信息。 | | callback | AsyncCallback\ | 是 | 回调函数。当启动Ability成功，err为undefined，否则为错误对象。 | - **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 201 | The application does not have permission to call the interface. | +| 202 | Not System App. Interface caller is not a system app. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000002 | Incorrect ability type. | | 16000004 | Can not start invisible component. | @@ -443,8 +471,6 @@ startAbilityAsCaller(want: Want, callback: AsyncCallback\): void | 16000055 | Installation-free timed out. | | 16200001 | The caller has been released. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.startAbilityAsCaller11+ startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback\): void @@ -463,11 +489,15 @@ startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback\ | options | [StartOptions](js-apis-app-ability-startOptions.md) | 是 | 启动Ability所携带的参数。 | | callback | AsyncCallback\ | 是 | 回调函数。当启动Ability成功，err为undefined，否则为错误对象。 | - **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 201 | The application does not have permission to call the interface. | +| 202 | Not System App. Interface caller is not a system app. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000004 | Can not start invisible component. | | 16000005 | The specified process does not have the permission. | @@ -482,8 +512,6 @@ startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback\ | 16000055 | Installation-free timed out. | | 16200001 | The caller has been released. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.startAbilityAsCaller11+ startAbilityAsCaller(want: Want, options?: StartOptions): Promise\ @@ -509,8 +537,13 @@ startAbilityAsCaller(want: Want, options?: StartOptions): Promise\ **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 201 | The application does not have permission to call the interface. | +| 202 | Not System App. Interface caller is not a system app. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000002 | Incorrect ability type. | | 16000004 | Can not start invisible component. | @@ -527,8 +560,6 @@ startAbilityAsCaller(want: Want, options?: StartOptions): Promise\ | 16000055 | Installation-free timed out. | | 16200001 | The caller has been released. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.getUIExtensionHostWindowProxy11+ getUIExtensionHostWindowProxy(): uiExtensionHost.UIExtensionHostWindowProxy @@ -547,8 +578,11 @@ getUIExtensionHostWindowProxy(): uiExtensionHost.UIExtensionHostWindowProxy **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 202 | Not System App. Interface caller is not a system app. | | 16000050 | Internal error. | **示例：** @@ -593,4 +627,3 @@ export default class UIExtAbility extends UIExtensionAbility { } } ``` -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiExtensionContentSession.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiExtensionContentSession.md index d82173d2b7..7e49e502a5 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiExtensionContentSession.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiExtensionContentSession.md @@ -31,12 +31,13 @@ loadContent(path: string, storage?: LocalStorage): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000050 | Internal error. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.terminateSelf terminateSelf(callback: AsyncCallback<void>): void @@ -51,6 +52,14 @@ terminateSelf(callback: AsyncCallback<void>): void | -------- | -------- | -------- | -------- | | callback | AsyncCallback<void> | 是 | 回调函数。当停止UIExtensionContentSession对应的窗口界面对象成功，err为undefined，否则为错误对象。 | +**错误码：** + +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | + ## UIExtensionContentSession.terminateSelf terminateSelf(): Promise<void> @@ -80,6 +89,14 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback<voi | parameter | [AbilityResult](js-apis-inner-ability-abilityResult.md) | 是 | 返回给UIExtensionComponent控件的信息。 | | callback | AsyncCallback<void> | 是 | 回调函数。当停止成功，err为undefined，否则为错误对象。 | +**错误码：** + +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | + ## UIExtensionContentSession.terminateSelfWithResult terminateSelfWithResult(parameter: AbilityResult): Promise<void> @@ -100,6 +117,14 @@ terminateSelfWithResult(parameter: AbilityResult): Promise<void> | -------- | -------- | | Promise<void> | Promise对象。无返回结果的Promise对象。 | +**错误码：** + +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | + ## UIExtensionContentSession.setWindowPrivacyMode setWindowPrivacyMode(isPrivacyMode: boolean): Promise<void> @@ -122,6 +147,15 @@ setWindowPrivacyMode(isPrivacyMode: boolean): Promise<void> | ------------------- | ------------------------ | | Promise<void> | Promise对象。无返回结果的Promise对象。 | +**错误码：** + +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 201 | The application does not have permission to call the interface. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | + ## UIExtensionContentSession.setWindowPrivacyMode setWindowPrivacyMode(isPrivacyMode: boolean, callback: AsyncCallback<void>): void @@ -139,6 +173,15 @@ setWindowPrivacyMode(isPrivacyMode: boolean, callback: AsyncCallback<void> | isPrivacyMode | boolean | 是 | 窗口是否为隐私模式。true表示模式开启；false表示模式关闭。 | | callback | AsyncCallback<void> | 是 | 回调函数。当设置成功，err为undefined，否则为错误对象。 | +**错误码：** + +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + +| 错误码ID | 错误信息 | +| ------- | -------------------------------- | +| 201 | The application does not have permission to call the interface. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | + ## UIExtensionContentSession.startAbilityByType11+ startAbilityByType(type: string, wantParam: Record, @@ -159,16 +202,18 @@ startAbilityByType(type: string, wantParam: Record, **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 201 | The application does not have permission to call the interface. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000002 | Incorrect ability type. | | 16000004 | Can not start invisible component. | | 16000050 | Internal error. | | 16200001 | The caller has been released. | -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - ## UIExtensionContentSession.startAbilityByType11+ startAbilityByType(type: string, wantParam: Record, @@ -194,12 +239,14 @@ startAbilityByType(type: string, wantParam: Record, **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | +| 201 | The application does not have permission to call the interface. | +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000001 | The specified ability does not exist. | | 16000002 | Incorrect ability type. | | 16000004 | Can not start invisible component. | | 16000050 | Internal error. | | 16200001 | The caller has been released. | - -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-wantAgent-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-wantAgent-sys.md index 5c227cdd00..cbf359e2e5 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-wantAgent-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-wantAgent-sys.md @@ -33,14 +33,15 @@ getWant(agent: WantAgent, callback: AsyncCallback\): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | |-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000007 | Service busy, there are concurrent tasks, waiting for retry.| | 16000015 | Service timeout.| | 16000151 | Invalid wantagent object.| -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md) - **示例：** ```ts @@ -132,8 +133,11 @@ getWant(agent: WantAgent): Promise\ **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | |-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000007 | Service busy, there are concurrent tasks, waiting for retry.| | 16000015 | Service timeout.| | 16000151 | Invalid wantagent object.| diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-wantAgent.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-wantAgent.md index ee29c00dc6..dd9d058503 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-wantAgent.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-wantAgent.md @@ -29,13 +29,14 @@ getWantAgent(info: WantAgentInfo, callback: AsyncCallback\): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | |-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000007 | Service busy, there are concurrent tasks, waiting for retry.| | 16000151 | Invalid wantagent object.| -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md) - **示例：** ```ts @@ -112,13 +113,14 @@ getWantAgent(info: WantAgentInfo): Promise\ **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | |-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000007 | Service busy, there are concurrent tasks, waiting for retry.| | 16000151 | Invalid wantagent object.| -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md) - **示例：** ```ts @@ -185,13 +187,14 @@ getBundleName(agent: WantAgent, callback: AsyncCallback\): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | |-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000007 | Service busy, there are concurrent tasks, waiting for retry.| | 16000151 | Invalid wantagent object.| -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md) - **示例：** ```ts @@ -281,13 +284,14 @@ getBundleName(agent: WantAgent): Promise\ **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | |-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000007 | Service busy, there are concurrent tasks, waiting for retry.| | 16000151 | Invalid wantagent object.| -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md) - **示例：** ```ts @@ -368,13 +372,14 @@ getUid(agent: WantAgent, callback: AsyncCallback\): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | |-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000007 | Service busy, there are concurrent tasks, waiting for retry.| | 16000151 | Invalid wantagent object.| -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md) - **示例：** ```ts @@ -464,13 +469,14 @@ getUid(agent: WantAgent): Promise\ **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | |-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000007 | Service busy, there are concurrent tasks, waiting for retry.| | 16000151 | Invalid wantagent object.| -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md) - **示例：** ```ts @@ -550,13 +556,14 @@ cancel(agent: WantAgent, callback: AsyncCallback\): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | |-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000007 | Service busy, there are concurrent tasks, waiting for retry.| | 16000151 | Invalid wantagent object.| -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md) - **示例：** ```ts @@ -646,13 +653,14 @@ cancel(agent: WantAgent): Promise\ **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | |-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000007 | Service busy, there are concurrent tasks, waiting for retry.| | 16000151 | Invalid wantagent object.| -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md) - **示例：** ```ts @@ -730,6 +738,14 @@ trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: AsyncCallback\ | 否 | 主动激发WantAgent实例的回调方法。 | +**错误码：** + +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + +| 错误码ID | 错误信息 | +|-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | + **示例：** ```ts @@ -817,6 +833,14 @@ equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\ | 是 | 判断两个WantAgent实例是否相等的回调方法。返回true表示两个WantAgent实例相等，false表示两个WantAgent实例不相等。 | +**错误码：** + +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + +| 错误码ID | 错误信息 | +|-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | + **示例：** ```ts @@ -907,6 +931,14 @@ equal(agent: WantAgent, otherAgent: WantAgent): Promise\ | ----------------------------------------------------------- | ------------------------------------------------------------ | | Promise\ | 以Promise形式返回获取判断两个WantAgent实例是否相等的结果。返回true表示两个WantAgent实例相等，false表示两个WantAgent实例不相等。 | +**错误码：** + +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + +| 错误码ID | 错误信息 | +|-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | + **示例：** ```ts @@ -987,14 +1019,15 @@ getOperationType(agent: WantAgent, callback: AsyncCallback\): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | |-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000007 | Service busy, there are concurrent tasks, waiting for retry.| | 16000015 | Service timeout.| | 16000151 | Invalid wantagent object.| -错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md) - **示例：** ```ts @@ -1082,8 +1115,11 @@ getOperationType(agent: WantAgent): Promise\ **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | |-----------|--------------------| +| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000007 | Service busy, there are concurrent tasks, waiting for retry.| | 16000015 | Service timeout.| | 16000151 | Invalid wantagent object.| diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-appstartup-startupManager.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-appstartup-startupManager.md index 38b4870461..ab6bceccec 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-appstartup-startupManager.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-appstartup-startupManager.md @@ -36,17 +36,17 @@ run(startupTasks: Array\, config?: StartupConfig): Promise\ **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | - | 401 | If the input parameter is not valid parameter. | + | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | | 16000050 | Internal error. | | 28800001 | Startup task or its dependency not found. | | 28800002 | The startup tasks have circular dependencies. | | 28800003 | An error occurred while running the startup tasks. | | 28800004 | Running startup tasks timeout. | -以上错误码详细介绍请参考[元能力子系统错误码](errorcode-ability.md)。 - **示例：**： ```ts @@ -142,9 +142,11 @@ getStartupTaskResult(startupTask: string): Object **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | - | 401 | If the input parameter is not valid parameter. | + | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | **示例：**： @@ -202,9 +204,11 @@ isStartupTaskInitialized(startupTask: string): boolean **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | - | 401 | If the input parameter is not valid parameter. | + | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | **示例：**： @@ -260,9 +264,11 @@ removeStartupTaskResult(startupTask: string): void **错误码：** +以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)。 + | 错误码ID | 错误信息 | | ------- | -------------------------------- | - | 401 | If the input parameter is not valid parameter. | + | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. | **示例：**： -- Gitee