diff --git a/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md b/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md index 230abe9053b032e5f6aaffdf1d941044b63a96b6..52ac34de00da85572d9e0cd1866bc544544d1655 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md +++ b/zh-cn/application-dev/reference/apis/js-apis-ability-wantConstant.md @@ -48,7 +48,11 @@ want操作的常数。 | ACTION_APP_ACCOUNT_OAUTH 8+ | ohos.account.appAccount.action.oauth | 指示提供oauth服务的操作。 | | ACTION_MARKET_DOWNLOAD 9+ | ohos.want.action.marketDownload | 表示从应用程序市场下载应用程序的的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | | ACTION_MARKET_CROWDTEST 9+ | ohos.want.action.marketCrowdTest | 指示从应用程序市场众测应用程序的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | - +| DLP_PARAMS_SANDBOX9+ |ohos.dlp.params.sandbox | 指示沙盒标志的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | +| DLP_PARAMS_BUNDLE_NAME9+ |ohos.dlp.params.bundleName |指示DLP包名称的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | +| DLP_PARAMS_MODULE_NAME9+ |ohos.dlp.params.moduleName |指示DLP模块名称的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | +| DLP_PARAMS_ABILITY_NAME9+ |ohos.dlp.params.abilityName |指示DLP能力名称的参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | +| DLP_PARAMS_INDEX9+ |ohos.dlp.params.index |指示DLP索引参数的操作。
**系统API**：该接口为系统接口，三方应用不支持调用。 | ## wantConstant.Entity diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-quickFixManager.md b/zh-cn/application-dev/reference/apis/js-apis-application-quickFixManager.md new file mode 100644 index 0000000000000000000000000000000000000000..88876191cbe1311ff44d9f15cd355fa352555243 --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-application-quickFixManager.md @@ -0,0 +1,178 @@ +# quickFixManager + +quickFixManager模块提供快速修复的能力，快速修复是鸿蒙提供给开发者的一种技术手段，支持开发者以远快于（小时级、分钟级）应用升级的方式进行缺陷修复。 + +> **说明：** +> +> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + +## 导入模块 + +``` +import quickFixManager from '@ohos.application.quickFixManager'; +``` + +## HapModuleQuickFixInfo + +hap级别的快速修复信息。 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.QuickFix + +**系统API**: 此接口为系统接口，三方应用不支持调用。 + +| 名称 | 读写属性 | 类型 | 必填 | 描述 | +| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ | +| moduleName | 只读 | string | 是 | hap包的名称。 | +| originHapHash | 只读 | string | 是 | 指示hap的哈希值。 | +| quickFixFilePath | 只读 | string | 是 | 指示快速修复文件的安装路径。 | + +## ApplicationQuickFixInfo + +应用级别的快速修复信息。 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.QuickFix + +**系统API**: 此接口为系统接口，三方应用不支持调用。 + +| 名称 | 读写属性 | 类型 | 必填 | 描述 | +| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ | +| bundleName | 只读 | string | 是 | 应用的包名。 | +| bundleVersionCode | 只读 | number | 是 | 应用的版本号。 | +| bundleVersionName | 只读 | string | 是 | 应用版本号的文字描述。 | +| quickFixVersionCode | 只读 | number | 是 | 快速修复补丁包的版本号。 | +| quickFixVersionName | 只读 | string | 是 | 快速修复补丁包版本号的文字描述。 | +| hapModuleQuickFixInfo | 只读 | Array\<[HapModuleQuickFixInfo](#hapmodulequickfixinfo)> | 是 | hap级别的快速修复信息。 | + +## quickFixManager.applyQuickFix + +applyQuickFix(hapModuleQuickFixFiles: Array\, callback: AsyncCallback\): void; + +快速修复的补丁安装接口。 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.QuickFix + +**系统API**: 此接口为系统接口，三方应用不支持调用。 + +**参数：** + + | 参数名 | 类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | hapModuleQuickFixFiles | Array\ | 否 | 快速修复补丁文件（补丁文件需包含有效的文件路径）。 | + | callback | AsyncCallback\ | 否 | 表示指定的回调方法。 | + +**示例：** + +```js + import quickFixManager from '@ohos.application.quickFixManager' + + let hapModuleQuickFixFiles = ["/data/storage/el2/base/entry.hqf"] + quickFixManager.applyQuickFix(hapModuleQuickFixFiles, (error) => { + if (error) { + console.info( `applyQuickFix failed with error + ${error}`) + } else { + console.info( 'applyQuickFix success') + } + }) +``` + +## quickFixManager.applyQuickFix + +applyQuickFix(hapModuleQuickFixFiles: Array\): Promise; + +快速修复的补丁安装接口。 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.QuickFix + +**系统API**: 此接口为系统接口，三方应用不支持调用。 + +**参数：** + + | 参数名 | 类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | hapModuleQuickFixFiles | Array\ | 否 | 快速修复补丁文件（补丁文件需包含有效的文件路径）。 | + +**返回值：** + + | 类型 | 说明 | + | -------- | -------- | + | Promise\ | 返回相应结果。 | + +**示例：** + +```js + import quickFixManager from '@ohos.application.quickFixManager' + + let hapModuleQuickFixFiles = ["/data/storage/el2/base/entry.hqf"] + quickFixManager.applyQuickFix(hapModuleQuickFixFiles).then(() => { + console.info('applyQuickFix success') + }).catch((error) => { + console.info(`applyQuickFix err: + ${error}`) + }) +``` + +## quickFixManager.getApplicationQuickFixInfo + +getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback\): void; + +获取应用的快速修复信息。 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.QuickFix + +**系统API**: 此接口为系统接口，三方应用不支持调用。 + +**参数：** + + | 参数名 | 类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | bundleName | string | 否 |应用的包名。 | + | callback | AsyncCallback\<[ApplicationQuickFixInfo](#applicationquickfixinfo)> | 否 | 应用的快速修复信息。 | + +**示例：** + +```js + import quickFixManager from '@ohos.application.quickFixManager' + + let bundleName = "bundleName" + quickFixManager.getApplicationQuickFixInfo(bundleName, (error, data) => { + if (error) { + console.info(`getApplicationQuickFixInfo error: + ${error}`) + } else { + console.info(`getApplicationQuickFixInfo success: + ${data}`) + } + }) +``` + +## quickFixManager.getApplicationQuickFixInfo + +getApplicationQuickFixInfo(bundleName: string): Promise\; + +获取应用的快速修复信息。 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.QuickFix + +**系统API**: 此接口为系统接口，三方应用不支持调用。 + +**参数：** + + | 参数名 | 类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | bundleName | string | 否 | 应用的包名。 | + +**返回值：** + + | 类型 | 说明 | + | -------- | -------- | + | Promise\<[ApplicationQuickFixInfo](#applicationquickfixinfo)> | 返回应用的快速修复信息。 | + +**示例：** + + ```js + import quickFixManager from '@ohos.application.quickFixManager' + + let bundleName = "bundleName" + quickFixManager.getApplicationQuickFixInfo(bundleName).then((data) => { + console.info(`getApplicationQuickFixInfo success: + ${data}`) + }).catch((error) => { + console.info(`getApplicationQuickFixInfo err: + ${error}`) + }) +``` \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-shellCmdResult.md b/zh-cn/application-dev/reference/apis/js-apis-application-shellCmdResult.md index 2c9f76234fb7eec46f45e2faf3d09f2bf980b7ae..7fb56e487ec5d78cd1f6ae87edbc645faee0a5bc 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-shellCmdResult.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-shellCmdResult.md @@ -1,6 +1,6 @@ # ShellCmdResult -ShellCmdResult模块提供Shell命令执行结果的能力。 +本模块提供Shell命令执行结果的能力。 > **说明：** > diff --git a/zh-cn/application-dev/reference/apis/js-apis-appmanager.md b/zh-cn/application-dev/reference/apis/js-apis-appmanager.md index 01c486e90e52e531bb75c8301f0df1bbbf6a47a9..32cbf3a3a2a7aabc52d408aeb90113156af8b099 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-appmanager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-appmanager.md @@ -784,7 +784,7 @@ onProcessDied(processData: ProcessData): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| processData | ProcessData | 否 | 进程信息。 | +| processData | [ProcessData](#processdata) | 否 | 进程信息。 | **示例：** @@ -798,6 +798,34 @@ onProcessDied(processData: ProcessData): void; console.log('-------- observerCode: ---------', observerCode); ``` +## ApplicationStateObserver.onProcessStateChanged9+ + + onProcessStateChanged(processData: ProcessData): void; + +当进程状态更改时调用。 + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +**系统API**：该接口为系统接口，三方应用不支持调用。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| processData | [ProcessData](#processdata) | 否 | 进程信息。 | + +**示例：** + +```js + var applicationStateObserver = { + onProcessStateChanged(processData) { + console.log('------------ onProcessStateChanged -----------', processData); + } + } + const observerCode = app.registerApplicationStateObserver(applicationStateObserver); + console.log('-------- observerCode: ---------', observerCode); +``` + ## AppStateData **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core @@ -837,8 +865,8 @@ onProcessDied(processData: ProcessData): void; | pid8+ | number | 是 | 否 | 进程ID。 | | bundleName8+ | string | 是 | 否 | 应用包名。 | | uid8+ | number | 是 | 否 | 用户ID。 | - - +| isContinuousTask9+ | boolean | 是 | 否 | 判断过程是否为连续任务。 | +| isKeepAlive8+ | boolean | 是 | 否 | 判断该过程是否保持活跃。 | ## ProcessRunningInfo @@ -875,4 +903,32 @@ onProcessDied(processData: ProcessData): void; | pid9+ | 只读 | number | 否 | 进程ID。 | | uid9+ | 只读 | number | 否 | 用户ID。 | | processName9+ | 只读 | string | 否 | 进程的名称。 | -| bundleNames9+ | 只读 | Array\ | 否 | 进程中运行的bundleName数组。 | \ No newline at end of file +| bundleNames9+ | 只读 | Array\ | 否 | 进程中运行的bundleName数组。 | + +## ApplicationState9+ + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +**系统API**: 此接口为系统接口，三方应用不支持调用。 + +| 名称 | 值 | 描述 | +| -------------------- | --- | --------------------------------- | +| STATE_CREATE | 1 | 当应用在创建中的时候处于的状态。 | +| STATE_FOREGROUND | 2 | 当应用切换到前台的时候处于的状态。 | +| STATE_ACTIVE | 3 | 当应用在获焦的时候处于的状态。 | +| STATE_BACKGROUND | 4 | 当应用处于后台不可见时处于的状态。 | +| STATE_DESTROY | 5 | 当应用在销毁的时候处于的状态。 | + +## ProcessState9+ + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +**系统API**: 此接口为系统接口，三方应用不支持调用。 + +| 名称 | 值 | 描述 | +| -------------------- | --- | --------------------------------- | +| STATE_CREATE | 1 | 当进程在创建中的时候处于的状态。 | +| STATE_FOREGROUND | 2 | 当进程切换到前台的时候处于的状态。 | +| STATE_ACTIVE | 3 | 当进程在获焦的时候处于的状态。 | +| STATE_BACKGROUND | 4 | 当进程处于后台不可见时处于的状态。 | +| STATE_DESTROY | 5 | 当进程在销毁的时候处于的状态。 |