diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-DataShareExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-application-DataShareExtensionAbility.md index a42342c7a9155f3874bde46c253f00ab194c3fe3..a97420ecc3e7c326a1e86f6a153d1424b06d1f7e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-DataShareExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-DataShareExtensionAbility.md @@ -6,7 +6,7 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 从API Version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> 从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 类的数据共享扩展能力。 @@ -21,10 +21,10 @@ import DataShareExtensionAbility from '@ohos.application.DataShareExtensionAbili ## 属性 -| 名称 | 参数类型 | 可读 | 可写 | 说明 | -| -------- | -------- | -------- | -------- | -------- | -| context? | ExtensionContext | 是 | 否 | 指示数据共享扩展能力上下文。
**系统能力**：SystemCapability.DistributedDataManager.DataShare.Provider | - +| 名称 | 可读 | 可写 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | -------- | -------- | +| context | 是 | 否 | ExtensionContext | 否 | 指示数据共享扩展能力上下文。
**系统能力**：SystemCapability.DistributedDataManager.DataShare.Provider | + ## DataShareExtensionAbility.onCreate @@ -83,7 +83,7 @@ DAHelper.getFileTypes( ## DataShareExtensionAbility.insert -insert?(uri: string, valuesBucket: rdb.ValuesBucket, callback: AsyncCallback\): void +insert?(uri: string, valueBucket: rdb.ValuesBucket, callback: AsyncCallback\): void 将单个数据记录插入数据库（callback形式）。 @@ -120,7 +120,7 @@ DAHelper.insert( ## DataShareExtensionAbility.update -update?(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\): void +update?(uri: string, valueBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\): void 更新数据库中的数据记录（callback形式）。 @@ -259,7 +259,7 @@ DAHelper.getType( ## DataShareExtensionAbility.batchInsert -batchInsert?(uri: string, valuesBuckets: Array, callback: AsyncCallback\): void +batchInsert?(uri: string, valueBuckets: Array, callback: AsyncCallback\): void 插入数据库（callback形式）。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-StartOptions.md b/zh-cn/application-dev/reference/apis/js-apis-application-StartOptions.md index bad372255e7d250eb79a1c656cabe8c0aed6a01a..8c715fe253c2f908deaeb0f162e9dae5ab5b22cd 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-StartOptions.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-StartOptions.md @@ -6,7 +6,7 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 从API Version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 StartOptions是系统的基本通信组件。 @@ -21,10 +21,10 @@ import StartOptions from '@ohos.application.StartOptions'; ## 属性 -| 名称 | 参数类型 | 可读 | 可写 | 说明 | -| -------- | -------- | -------- | -------- | -------- | -| windowMode? | number | 是 | 否 | 窗口模式。
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore | -| displayId? | number | 是 | 否 | 显示ID。
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore | +| 名称 | 可读 | 可写 | 参数类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | -------- | -------- | +| windowMode | 是 | 否 | number | 否 | 窗口模式。
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore | +| displayId | 是 | 否 | number | 否 | 显示ID。
**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore | diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-ability.md b/zh-cn/application-dev/reference/apis/js-apis-application-ability.md index 3b367aadd16a08b5b605e622bbeffdbe61a7c77e..9dc5fe3e76e5d60877bc45cb6d0f650c6e6dc931 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-ability.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-ability.md @@ -1,7 +1,7 @@ # Ability > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 从API Version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 Ability模块，提供对Ability生命周期、上下文环境等调用管理。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilitystage.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilitystage.md index c777da815e168dcca898b2a8970bb22be8520212..9f7399e90bec28776e893d9543ea1290f8236c85 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-abilitystage.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilitystage.md @@ -1,7 +1,7 @@ # AbilityStage > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 本模块首批接口从API 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 AbilityStage是HAP包的运行时类。在HAP加载的时候，通知开发者，开发者可以在此进行该HAP的初始化（如资源预加载，线程创建等）。 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 f7d0f2fb6c7617c08d6b683d564b6f4d3c34df33..fd5d831722260b0bddc5408d02c408c220a98554 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-appmanager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-appmanager.md @@ -1,7 +1,7 @@ # appManager > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 本模块首批接口从API 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 App管理。 @@ -165,4 +165,15 @@ getAppMemorySize(callback: AsyncCallback\): void; console.log('startAbility result success:' + JSON.stringify(data)); }) } - ``` \ No newline at end of file + ``` + +## ProcessRunningInfo + +**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core + +| 名称 | 读写属性 | 类型 | 必填 | 描述 | +| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ | +| pid8+ | 只读 | number | 否 | 进程ID。 | +| uid8+ | 只读 | number | 否 | 用户ID。 | +| processName8+ | 只读 | string | 否 | 进程的名称。 | +| bundleNames8+ | 只读 | Array\ | 否 | 进程中运行的bundleName数组。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-configurationconstant.md b/zh-cn/application-dev/reference/apis/js-apis-configurationconstant.md index 9af37d0aad2f4f402b2d96616c11620a34411cde..90d4d1451fc7ab04c32a0fa65c183d65a43443f1 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-configurationconstant.md +++ b/zh-cn/application-dev/reference/apis/js-apis-configurationconstant.md @@ -22,7 +22,7 @@ import ConfigurationConstant from '@ohos.application.ConfigurationConstant'; **示例：** ``` -ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT。 +ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT ``` **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase @@ -41,7 +41,7 @@ ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT。 **示例：** ``` -ConfigurationConstant.Direction.DIRECTION_VERTICAL。 +ConfigurationConstant.Direction.DIRECTION_VERTICAL ``` **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase @@ -60,7 +60,7 @@ ConfigurationConstant.Direction.DIRECTION_VERTICAL。 **示例：** ``` -ConfigurationConstant.ScreenDensity.SCREEN_DENSITY_NOT_SET。 +ConfigurationConstant.ScreenDensity.SCREEN_DENSITY_NOT_SET ``` **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase diff --git a/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md b/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md index 016db64b471b5e8fd04a20e70d3523850af0a365..5d6fbd259ca3a604ce4756a63e9a526c86ae6f7e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md @@ -694,6 +694,136 @@ GetWindowPromise(){ } ``` +## ConnectOptions.onConnect7+ + +onConnect(elementName: ElementName, remote: rpc.IRemoteObject): void; + +连接成功时的回调函数。 + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +**参数：** + +| 名称 | 类型 | 必填 | 描述 | +| -------- | ----------------------- | ---- | ------------------------------------------------------------ | +| elementName | ElementName | 是 | 元素名。 | +| remote | rpc.IRemoteObject | 是 | rpc远程对象。 | + +**示例：** + +```javascript +import rpc from '@ohos.rpc' +import featureAbility from '@ohos.ability.featureAbility' +function onConnectCallback(element, remote){ + console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy)); +} +function onDisconnectCallback(element){ + console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId) +} +function onFailedCallback(code){ + console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code) +} +var connId = featureAbility.connectAbility( + { + deviceId: "", + bundleName: "com.ix.ServiceAbility", + abilityName: "ServiceAbilityA", + }, + { + onConnect: onConnectCallback, + onDisconnect: onDisconnectCallback, + onFailed: onFailedCallback, + }, +); +``` + +## ConnectOptions.onDisconnect7+ + +onDisconnect(elementName: ElementName): void; + +连接失败时的回调函数。 + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +**参数：** + +| 名称 | 类型 | 必填 | 描述 | +| -------- | ----------------------- | ---- | ------------------------------------------------------------ | +| elementName | ElementName | 是 | 元素名。 | + +**示例：** + +```javascript +import rpc from '@ohos.rpc' +import featureAbility from '@ohos.ability.featureAbility' +function onConnectCallback(element, remote){ + console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy)); +} +function onDisconnectCallback(element){ + console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId) +} +function onFailedCallback(code){ + console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code) +} +var connId = featureAbility.connectAbility( + { + deviceId: "", + bundleName: "com.ix.ServiceAbility", + abilityName: "ServiceAbilityA", + }, + { + onConnect: onConnectCallback, + onDisconnect: onDisconnectCallback, + onFailed: onFailedCallback, + }, +); +``` + +## ConnectOptions.onFailed7+ + +onFailed(code: number): void; + +ConnectAbility调用失败时的回调函数。 + +**系统能力**：SystemCapability.Ability.AbilityRuntime.Core + +**参数：** + +| 名称 | 类型 | 必填 | 描述 | +| -------- | ----------------------- | ---- | ------------------------------------------------------------ | +| code | number | 是 | number类型。 | + +**示例：** + +```javascript +import rpc from '@ohos.rpc' +import featureAbility from '@ohos.ability.featureAbility' +function onConnectCallback(element, remote){ + console.log('ConnectAbility onConnect remote is proxy:' + (remote instanceof rpc.RemoteProxy)); +} +function onDisconnectCallback(element){ + console.log('ConnectAbility onDisconnect element.deviceId : ' + element.deviceId) +} +function onFailedCallback(code){ + console.log('featureAbilityTest ConnectAbility onFailed errCode : ' + code) +} +var connId = featureAbility.connectAbility( + { + deviceId: "", + bundleName: "com.ix.ServiceAbility", + abilityName: "ServiceAbilityA", + }, + { + onConnect: onConnectCallback, + onDisconnect: onDisconnectCallback, + onFailed: onFailedCallback, + }, +); +``` + + + + ## AbilityWindowConfiguration @@ -702,7 +832,7 @@ GetWindowPromise(){ **示例：** ``` -featureAbility.AbilityWindowConfiguration.WINDOW_MODE_UNDEFINED。 +featureAbility.AbilityWindowConfiguration.WINDOW_MODE_UNDEFINED ``` | 名称 | 参数 | 描述 | @@ -723,7 +853,7 @@ abilityStartSetting属性是一个定义为[key: string]: any的对象，key对 **示例：** ``` -featureAbility.AbilityStartSetting.BOUNDS_KEY。 +featureAbility.AbilityStartSetting.BOUNDS_KEY ``` | 名称 | 参数 | 描述 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-missionManager.md b/zh-cn/application-dev/reference/apis/js-apis-missionManager.md index 2fcc9a50c082e354a76215d7debb48e44c4f0875..e3cf1dba13d645fa472c26d20cab7b761c9d445d 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-missionManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-missionManager.md @@ -18,7 +18,7 @@ import missionManager from '@ohos.application.missionManager' ## missionManager.registerMissionListener -function registerMissionListener(listener: MissionListener): number; +registerMissionListener(listener: MissionListener): number; 注册系统任务状态监听。 @@ -53,7 +53,7 @@ function registerMissionListener(listener: MissionListener): number; ## missionManager.unregisterMissionListener -function unregisterMissionListener(listenerId: number, callback: AsyncCallback<void>): void; +unregisterMissionListener(listenerId: number, callback: AsyncCallback<void>): void; 取消任务状态监听。 @@ -86,7 +86,7 @@ function unregisterMissionListener(listenerId: number, callback: AsyncCallback&l ## missionManager.unregisterMissionListener -function unregisterMissionListener(listenerId: number): Promise<void>; +unregisterMissionListener(listenerId: number): Promise<void>; 取消任务状态监听，以promise方式返回执行结果。 @@ -118,7 +118,7 @@ function unregisterMissionListener(listenerId: number): Promise<void>; ## missionManager.getMissionInfo -function getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback<MissionInfo>): void; +getMissionInfo(deviceId: string, missionId: number, callback: AsyncCallback<MissionInfo>): void; 获取任务信息，以异步回调的方式返回任务信息。 @@ -151,7 +151,7 @@ function getMissionInfo(deviceId: string, missionId: number, callback: AsyncCall ## missionManager.getMissionInfo -function getMissionInfo(deviceId: string, missionId: number): Promise<MissionInfo>; +getMissionInfo(deviceId: string, missionId: number): Promise<MissionInfo>; 获取任务信息，以promise方式返回任务信息。 @@ -183,7 +183,7 @@ function getMissionInfo(deviceId: string, missionId: number): Promise<Mission ## missionManager.getMissionInfos -function getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback<Array<MissionInfo>>): void; +getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallback<Array<MissionInfo>>): void; 获取所有任务信息，以回调函数的方式返回任务信息数组。 @@ -212,7 +212,7 @@ function getMissionInfos(deviceId: string, numMax: number, callback: AsyncCallba ## missionManager.getMissionInfos -function getMissionInfos(deviceId: string, numMax: number): Promise<Array<MissionInfo>>; +getMissionInfos(deviceId: string, numMax: number): Promise<Array<MissionInfo>>; 获取所有任务信息，以promise的方式返回任务信息数组。 @@ -244,7 +244,7 @@ function getMissionInfos(deviceId: string, numMax: number): Promise<Array< ## missionManager.getMissionSnapShot -function getMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback<MissionSnapshot>): void; +getMissionSnapShot(deviceId: string, missionId: number, callback: AsyncCallback<MissionSnapshot>): void; 获取任务快照，以回调函数的方式返回快照内容。 @@ -279,7 +279,7 @@ function getMissionSnapShot(deviceId: string, missionId: number, callback: Async ## missionManager.getMissionSnapShot -function getMissionSnapShot(deviceId: string, missionId: number): Promise<MissionSnapshot>; +getMissionSnapShot(deviceId: string, missionId: number): Promise<MissionSnapshot>; 获取任务快照，以promise的方式返回快照内容。 @@ -317,7 +317,7 @@ function getMissionSnapShot(deviceId: string, missionId: number): Promise<Mis ## missionManager.lockMission -function lockMission(missionId: number, callback: AsyncCallback<void>): void; +lockMission(missionId: number, callback: AsyncCallback<void>): void; 锁定指定任务id的任务，以回调函数的方式返回。 @@ -350,7 +350,7 @@ function lockMission(missionId: number, callback: AsyncCallback<void>): vo ## missionManager.lockMission -function lockMission(missionId: number): Promise<void>; +lockMission(missionId: number): Promise<void>; 锁定指定任务id的任务，以promise方式返回。 @@ -382,7 +382,7 @@ function lockMission(missionId: number): Promise<void>; ## missionManager.unlockMission -function unlockMission(missionId: number, callback: AsyncCallback<void>): void; +unlockMission(missionId: number, callback: AsyncCallback<void>): void; 解锁指定任务id的任务，以回调函数的方式返回。 @@ -414,7 +414,7 @@ function unlockMission(missionId: number, callback: AsyncCallback<void>): ## missionManager.unlockMission -function unlockMission(missionId: number): Promise<void>; +unlockMission(missionId: number): Promise<void>; 解锁指定任务id的任务，以promise的方式返回。 @@ -449,7 +449,7 @@ function unlockMission(missionId: number): Promise<void>; ## missionManager.clearMission -function clearMission(missionId: number, callback: AsyncCallback<void>): void; +clearMission(missionId: number, callback: AsyncCallback<void>): void; 清理指定任务id的任务，无论该任务是否被锁定，以回调函数的方式返回。 @@ -482,7 +482,7 @@ function clearMission(missionId: number, callback: AsyncCallback<void>): v ## missionManager.clearMission -function clearMission(missionId: number): Promise<void>; +clearMission(missionId: number): Promise<void>; 清理指定任务id的任务，无论该任务是否被锁定，以promise的方式返回。 @@ -514,7 +514,7 @@ function clearMission(missionId: number): Promise<void>; ## missionManager.clearAllMissions -function clearAllMissions(callback: AsyncCallback<void>): void; +clearAllMissions(callback: AsyncCallback<void>): void; 清理所有未锁定的任务，以回调函数的方式返回。 @@ -533,7 +533,7 @@ function clearAllMissions(callback: AsyncCallback<void>): void; ## missionManager.clearAllMissions -function clearAllMissions(): Promise<void>; +clearAllMissions(): Promise<void>; 清理所有未锁定的任务，以promise的方式返回。 @@ -551,7 +551,7 @@ function clearAllMissions(): Promise<void>; ## missionManager.moveMissionToFront -function moveMissionToFront(missionId: number, callback: AsyncCallback<void>): void; +moveMissionToFront(missionId: number, callback: AsyncCallback<void>): void; 把指定任务id的任务切到前台，以回调函数的方式返回。 @@ -584,7 +584,7 @@ function moveMissionToFront(missionId: number, callback: AsyncCallback<void&g ## missionManager.moveMissionToFront -function moveMissionToFront(missionId: number, options: StartOptions, callback: AsyncCallback<void>): void; +moveMissionToFront(missionId: number, options: StartOptions, callback: AsyncCallback<void>): void; 把指定任务id的任务切到前台，同时指定任务切换到前台时的启动参数，例如窗口模式、设备ID等，以回调函数的方式返回。 @@ -618,7 +618,7 @@ function moveMissionToFront(missionId: number, options: StartOptions, callback: ## missionManager.moveMissionToFront -function moveMissionToFront(missionId: number, options?: StartOptions): Promise<void>; +moveMissionToFront(missionId: number, options?: StartOptions): Promise<void>; 把指定任务id的任务切到前台，以promise的方式返回。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md b/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md index 3051642b6fbf9e4ab0340a439f3f28c7c95511a3..c2b55af5584868611ed11bbd3bfc1d525c39f713 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-particleAbility.md @@ -417,7 +417,7 @@ connectAbility(request: Want, options:ConnectOptions): number ## particleAbility.disconnectAbility -disconnectAbility(connection: number, callback:AsyncCallback): void; +disconnectAbility(connection: number, callback:AsyncCallback\): void; 将功能与服务功能断开连接。 @@ -463,7 +463,7 @@ disconnectAbility(connection: number, callback:AsyncCallback): void; ## particleAbility.disconnectAbility -disconnectAbility(connection: number): Promise; +disconnectAbility(connection: number): Promise\; 将功能与服务功能断开连接。