提交 b456ed6f 编写于 作者: Z zhongjianfei

fix docs bugs

Signed-off-by: Nzhongjianfei <zhongjianfei@huawei.com>
Change-Id: I9fe964ce91f41e3190bd01b15e61f3b2c1e917ea
上级 9ab4a839
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
Ability信息,未做特殊说明的属性,均通过[GET_ABILITY_INFO_DEFAULT](js-apis-bundleManager.md)获取 Ability信息,未做特殊说明的属性,可以通过[getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)获取,flag使用[GET_BUNDLE_INFO_WITH_ABILITY](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md#bundleflag)
## AbilityInfo ## AbilityInfo
......
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
应用程序信息,未做特殊说明的属性,均通过[GET_APPLICATION_INFO_DEFAULT](js-apis-bundleManager.md)获取 应用程序信息,未做特殊说明的属性,可以通过[getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)获取,flag使用[GET_BUNDLE_INFO_WITH_APPLICATION](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md#bundleflag)
## ApplicationInfo ## ApplicationInfo
......
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
> **说明:** > **说明:**
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
应用包的信息,未做特殊说明的属性,均通过[GET_BUNDLE_INFO_DEFAULT](js-apis-bundle-bundleManager)获取。 应用包的信息,未做特殊说明的属性,可以通过[getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)获取。
## BundleInfo ## BundleInfo
......
...@@ -3,6 +3,8 @@ ...@@ -3,6 +3,8 @@
> **说明:** > **说明:**
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
HAP信息,未做特殊说明的属性,可以通过[getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)获取,flag使用[GET_BUNDLE_INFO_WITH_HAP_MODULE ](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md#bundleflag)
## HapModuleInfo ## HapModuleInfo
**系统能力**: SystemCapability.BundleManager.BundleFramework.Core **系统能力**: SystemCapability.BundleManager.BundleFramework.Core
......
...@@ -2,6 +2,8 @@ ...@@ -2,6 +2,8 @@
> **说明:** > **说明:**
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
桌面应用的Ability信息,可以通过[getLauncherAbilityInfo](js-apis-launcherBundleManager.md#launcherbundlemanagergetlauncherabilityinfo9)获取。
## LauncherAbilityInfo ## LauncherAbilityInfo
**系统能力:** SystemCapability.BundleManager.BundleFramework.Launcher。 **系统能力:** SystemCapability.BundleManager.BundleFramework.Launcher。
......
...@@ -3,7 +3,10 @@ ...@@ -3,7 +3,10 @@
> **说明:** > **说明:**
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
描述的module、ability、extensionAbility配置信息,标签值为数组类型,该标签下的配置只对当前module、或者ability、或者extensionAbility生效。 描述的module、ability、extensionAbility配置信息,标签值为数组类型,该标签下的配置只对当前module、或者ability、或者extensionAbility生效。
可以通过[getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)获取,此对象在[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)[HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md)[AbilityInfo](js-apis-bundleManager-abilityInfo.md)[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)中均包含。
## Metadata ## Metadata
**系统能力**: SystemCapability.BundleManager.BundleFramework.Core **系统能力**: SystemCapability.BundleManager.BundleFramework.Core
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | ------ | ---- | ---- | ---------- | | -------- | ------ | ---- | ---- | ---------- |
......
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
> **说明:** > **说明:**
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
本应用配置文件中定义的快捷方式信息,FA模型配置在[config.json文件中进行配置](../../quick-start/module-structure.md#%E8%A1%A817-shortcuts%E5%AF%B9%E8%B1%A1%E7%9A%84%E5%86%85%E9%83%A8%E7%BB%93%E6%9E%84%E8%AF%B4%E6%98%8E),Stage模型配置参考[shortcuts对象内部结构](../../quick-start/module-configuration-file.md#shortcuts标签) 本应用配置文件中定义的快捷方式信息,可以通过[getShortcutInfo](js-apis-launcherBundleManager.md#launcherbundlemanagergetshortcutinfo9)获取,FA模型配置在[config.json文件中进行配置](../../quick-start/module-structure.md#%E8%A1%A817-shortcuts%E5%AF%B9%E8%B1%A1%E7%9A%84%E5%86%85%E9%83%A8%E7%BB%93%E6%9E%84%E8%AF%B4%E6%98%8E),Stage模型配置参考[shortcuts对象内部结构](../../quick-start/module-configuration-file.md#shortcuts标签)
## ShortcutWant ## ShortcutWant
......
# ContinuationExtraParams # ContinuationExtraParams
本模块提供流转管理入口中设备选择模块所需的过滤参数。 本模块提供流转管理入口中设备选择模块所需的过滤参数,可以作为[startContinuationDeviceManager](js-apis-continuation-continuationManager.md#continuationmanagerstartcontinuationdevicemanager9)的入参
> **说明:** > **说明:**
> >
......
...@@ -5,7 +5,7 @@ ...@@ -5,7 +5,7 @@
## ContinuationResult ## ContinuationResult
表示流转管理入口返回的设备信息。 ContinuationManager的[on](js-apis-continuation-continuationManager.md#continuationmanagerstartcontinuationdevicemanager9)接口返回此对象表示流转管理入口返回的设备信息。
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.DistributedAbilityManager **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.DistributedAbilityManager
......
# AbilityResult # AbilityResult
定义ability拉起、销毁之后返回的结果码和数据 定义Ability拉起、销毁之后返回的结果码和数据,可以通过[startAbilityForResult](js-apis-ability-context.md#abilitycontextstartabilityforresult)获取对端Ability销毁后返回的AbilityResult对象,被startAbilityForResult拉起的Ability对象可以通过[terminateSelfWithResult](js-apis-ability-context.md#abilitycontextterminateselfwithresult)返回AbilityResult对象
> **说明:** > **说明:**
> >
...@@ -13,14 +13,3 @@ ...@@ -13,14 +13,3 @@
| resultCode | 是 | 否 | number | 否 | 表示ability拉起、销毁之后返回的结果码。 | | resultCode | 是 | 否 | number | 否 | 表示ability拉起、销毁之后返回的结果码。 |
| want | 是 | 否 | [Want](./js-apis-app-ability-want.md) | 否 | 表示ability销毁之后返回的数据。 | | want | 是 | 否 | [Want](./js-apis-app-ability-want.md) | 否 | 表示ability销毁之后返回的数据。 |
**示例:**
```ts
let want = {
bundleName: 'com.example.mydocapplication',
abilityName: 'MainAbility',
};
this.context.startAbilityForResult(want, (error, data) => {
let resultCode = data.resultCode;
let want = data.want;
});
```
\ No newline at end of file
# ConnectOptions # ConnectOptions
ConnectOptions类型说明 在连接指定的后台服务时作为入参用于接收连接过程中的状态变化,如作为[connectServiceExtensionAbility](js-apis-inner-application-serviceExtensionContext.md#serviceextensioncontextconnectserviceextensionability)的入参连接指定的ServiceExtensionAbility。
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------------ | -------- | ---- | ------------------------- | | ------------ | -------- | ---- | ------------------------- |
| onConnect<sup>7+</sup> | function | 是 | 连接成功时的回调函数。 | | onConnect<sup>7+</sup> | function | 是 | 建立连接时的回调函数。 |
| onDisconnect<sup>7+</sup> | function | 是 | 连接失败时的回调函数。 | | onDisconnect<sup>7+</sup> | function | 是 | 断开连接时的回调函数。 |
| onFailed<sup>7+</sup> | function | 是 | ConnectAbility调用失败时的回调函数。 | | onFailed<sup>7+</sup> | function | 是 | 连接失败时的回调函数。 |
**返回值:**
| 类型 | 说明 |
| ------ | -------------------- |
| number | 连接的ServiceAbilityID。 |
**示例:**
```ts
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 connectId = featureAbility.connectAbility(
{
deviceId: "",
bundleName: "com.ix.ServiceAbility",
abilityName: "ServiceAbilityA",
},
{
onConnect: onConnectCallback,
onDisconnect: onDisconnectCallback,
onFailed: onFailedCallback,
},
);
```
\ No newline at end of file
# DataAbilityHelper # DataAbilityHelper
可以通过[acquireDataAbilityHelper](js-apis-ability-featureAbility.md#featureabilityacquiredataabilityhelper7)接口获取DataAbilityHelper对象。
> **说明:** > **说明:**
> >
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
...@@ -37,11 +39,8 @@ var DAHelper = featureAbility.acquireDataAbilityHelper( ...@@ -37,11 +39,8 @@ var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
var mode = "rwt"; var mode = "rwt";
DAHelper.openFile( DAHelper.openFile("dataability:///com.example.DataAbility", mode, (err) => {
"dataability:///com.example.DataAbility", console.info("==========================>Called=======================>");
mode,
(err) => {
console.info("==========================>Called=======================>");
}); });
``` ```
...@@ -74,10 +73,8 @@ var DAHelper = featureAbility.acquireDataAbilityHelper( ...@@ -74,10 +73,8 @@ var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
var mode = "rwt"; var mode = "rwt";
DAHelper.openFile( DAHelper.openFile("dataability:///com.example.DataAbility", mode).then((data) => {
"dataability:///com.example.DataAbility", console.info("==========================>openFileCallback=======================>");
mode).then((data) => {
console.info("==========================>openFileCallback=======================>");
}); });
``` ```
...@@ -173,10 +170,8 @@ import featureAbility from '@ohos.ability.featureAbility' ...@@ -173,10 +170,8 @@ import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper( var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
DAHelper.getType( DAHelper.getType("dataability:///com.example.DataAbility", (err, data) => {
"dataability:///com.example.DataAbility", console.info("==========================>Called=======================>");
(err, data) => {
console.info("==========================>Called=======================>");
}); });
``` ```
...@@ -207,10 +202,8 @@ import featureAbility from '@ohos.ability.featureAbility' ...@@ -207,10 +202,8 @@ import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper( var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
DAHelper.getType( DAHelper.getType("dataability:///com.example.DataAbility").then((data) => {
"dataability:///com.example.DataAbility" console.info("==========================>getTypeCallback=======================>");
).then((data) => {
console.info("==========================>getTypeCallback=======================>");
}); });
``` ```
...@@ -237,11 +230,9 @@ import featureAbility from '@ohos.ability.featureAbility' ...@@ -237,11 +230,9 @@ import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper( var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
DAHelper.getFileTypes( DAHelper.getFileTypes( "dataability:///com.example.DataAbility",
"dataability:///com.example.DataAbility", "image/*", (err, data) => {
"image/*", console.info("==========================>Called=======================>");
(err, data) => {
console.info("==========================>Called=======================>");
}); });
``` ```
...@@ -275,11 +266,9 @@ import featureAbility from '@ohos.ability.featureAbility' ...@@ -275,11 +266,9 @@ import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper( var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
DAHelper.getFileTypes( DAHelper.getFileTypes("dataability:///com.example.DataAbility",
"dataability:///com.example.DataAbility", "image/*").then((data) => {
"image/*" console.info("===================>getFileTypesCallback================>");
).then((data) => {
console.info("==========================>getFileTypesCallback=======================>");
}); });
``` ```
...@@ -305,10 +294,8 @@ import featureAbility from '@ohos.ability.featureAbility' ...@@ -305,10 +294,8 @@ import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper( var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
DAHelper.normalizeUri( DAHelper.normalizeUri("dataability:///com.example.DataAbility", (err, data) => {
"dataability:///com.example.DataAbility", console.info("==========================>Called=======================>");
(err, data) => {
console.info("==========================>Called=======================>");
}); });
``` ```
...@@ -339,10 +326,8 @@ import featureAbility from '@ohos.ability.featureAbility' ...@@ -339,10 +326,8 @@ import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper( var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
DAHelper.normalizeUri( DAHelper.normalizeUri("dataability:///com.example.DataAbility",).then((data) => {
"dataability:///com.example.DataAbility", console.info("=================>normalizeUriCallback=======================>");
).then((data) => {
console.info("==========================>normalizeUriCallback=======================>");
}); });
``` ```
...@@ -368,10 +353,8 @@ import featureAbility from '@ohos.ability.featureAbility' ...@@ -368,10 +353,8 @@ import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper( var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
DAHelper.denormalizeUri( DAHelper.denormalizeUri("dataability:///com.example.DataAbility", (err, data) => {
"dataability:///com.example.DataAbility", console.info("==========================>Called=======================>");
(err, data) => {
console.info("==========================>Called=======================>");
}); });
``` ```
...@@ -404,10 +387,8 @@ import featureAbility from '@ohos.ability.featureAbility' ...@@ -404,10 +387,8 @@ import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper( var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
DAHelper.denormalizeUri( DAHelper.denormalizeUri("dataability:///com.example.DataAbility",).then((data) => {
"dataability:///com.example.DataAbility", console.info("===============>denormalizeUriCallback=======================>");
).then((data) => {
console.info("==========================>denormalizeUriCallback=======================>");
}); });
``` ```
...@@ -433,10 +414,8 @@ import featureAbility from '@ohos.ability.featureAbility' ...@@ -433,10 +414,8 @@ import featureAbility from '@ohos.ability.featureAbility'
var helper = featureAbility.acquireDataAbilityHelper( var helper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
helper.notifyChange( helper.notifyChange("dataability:///com.example.DataAbility", (err) => {
"dataability:///com.example.DataAbility", console.info("==========================>Called=======================>");
(err) => {
console.info("==========================>Called=======================>");
}); });
``` ```
...@@ -467,10 +446,8 @@ import featureAbility from '@ohos.ability.featureAbility' ...@@ -467,10 +446,8 @@ import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper( var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
DAHelper.notifyChange( DAHelper.notifyChange("dataability:///com.example.DataAbility").then(() => {
"dataability:///com.example.DataAbility", console.info("================>notifyChangeCallback================>");
).then(() => {
console.info("==========================>notifyChangeCallback=======================>");
}); });
``` ```
...@@ -503,11 +480,9 @@ const valueBucket = { ...@@ -503,11 +480,9 @@ const valueBucket = {
"salary": 200.5, "salary": 200.5,
"blobType": "u8", "blobType": "u8",
} }
DAHelper.insert( DAHelper.insert("dataability:///com.example.DataAbility", valueBucket,
"dataability:///com.example.DataAbility",
valueBucket,
(err, data) => { (err, data) => {
console.info("==========================>Called=======================>"); console.info("==========================>Called=======================>");
}); });
``` ```
...@@ -545,11 +520,8 @@ const valueBucket = { ...@@ -545,11 +520,8 @@ const valueBucket = {
"salary": 20.5, "salary": 20.5,
"blobType": "u8", "blobType": "u8",
} }
DAHelper.insert( DAHelper.insert("dataability:///com.example.DataAbility", valueBucket).then((data) => {
"dataability:///com.example.DataAbility", console.info("====================>insertCallback=======================>");
valueBucket
).then((data) => {
console.info("==========================>insertCallback=======================>");
}); });
``` ```
...@@ -579,11 +551,9 @@ var DAHelper = featureAbility.acquireDataAbilityHelper( ...@@ -579,11 +551,9 @@ var DAHelper = featureAbility.acquireDataAbilityHelper(
var cars = new Array({"name": "roe11", "age": 21, "salary": 20.5, "blobType": "u8",}, var cars = new Array({"name": "roe11", "age": 21, "salary": 20.5, "blobType": "u8",},
{"name": "roe12", "age": 21, "salary": 20.5, "blobType": "u8",}, {"name": "roe12", "age": 21, "salary": 20.5, "blobType": "u8",},
{"name": "roe13", "age": 21, "salary": 20.5, "blobType": "u8",}) {"name": "roe13", "age": 21, "salary": 20.5, "blobType": "u8",})
DAHelper.batchInsert( DAHelper.batchInsert("dataability:///com.example.DataAbility", cars,
"dataability:///com.example.DataAbility",
cars,
(err, data) => { (err, data) => {
console.info("==========================>Called=======================>"); console.info("==========================>Called=======================>");
}); });
``` ```
...@@ -618,11 +588,8 @@ var DAHelper = featureAbility.acquireDataAbilityHelper( ...@@ -618,11 +588,8 @@ var DAHelper = featureAbility.acquireDataAbilityHelper(
var cars = new Array({"name": "roe11", "age": 21, "salary": 20.5, "blobType": "u8",}, var cars = new Array({"name": "roe11", "age": 21, "salary": 20.5, "blobType": "u8",},
{"name": "roe12", "age": 21, "salary": 20.5, "blobType": "u8",}, {"name": "roe12", "age": 21, "salary": 20.5, "blobType": "u8",},
{"name": "roe13", "age": 21, "salary": 20.5, "blobType": "u8",}) {"name": "roe13", "age": 21, "salary": 20.5, "blobType": "u8",})
DAHelper.batchInsert( DAHelper.batchInsert("dataability:///com.example.DataAbility", cars).then((data) => {
"dataability:///com.example.DataAbility", console.info("==================>batchInsertCallback=======================>");
cars
).then((data) => {
console.info("==========================>batchInsertCallback=======================>");
}); });
``` ```
...@@ -651,11 +618,9 @@ var DAHelper = featureAbility.acquireDataAbilityHelper( ...@@ -651,11 +618,9 @@ var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
let da = new ohos_data_ability.DataAbilityPredicates() let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.delete( DAHelper.delete("dataability:///com.example.DataAbility", da,
"dataability:///com.example.DataAbility",
da,
(err, data) => { (err, data) => {
console.info("==========================>Called=======================>"); console.info("==========================>Called=======================>");
}); });
``` ```
...@@ -689,11 +654,8 @@ var DAHelper = featureAbility.acquireDataAbilityHelper( ...@@ -689,11 +654,8 @@ var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
let da = new ohos_data_ability.DataAbilityPredicates() let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.delete( DAHelper.delete("dataability:///com.example.DataAbility", da).then((data) => {
"dataability:///com.example.DataAbility", console.info("==========================>deleteCallback=======================>");
da
).then((data) => {
console.info("==========================>deleteCallback=======================>");
}); });
``` ```
...@@ -729,12 +691,8 @@ const va = { ...@@ -729,12 +691,8 @@ const va = {
"blobType": "u8", "blobType": "u8",
} }
let da = new ohos_data_ability.DataAbilityPredicates() let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.update( DAHelper.update("dataability:///com.example.DataAbility", va, da, (err, data) => {
"dataability:///com.example.DataAbility", console.info("==========================>Called=======================>");
va,
da,
(err, data) => {
console.info("==========================>Called=======================>");
}); });
``` ```
...@@ -775,12 +733,8 @@ const va = { ...@@ -775,12 +733,8 @@ const va = {
"blobType": "u8", "blobType": "u8",
} }
let da = new ohos_data_ability.DataAbilityPredicates() let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.update( DAHelper.update("dataability:///com.example.DataAbility", va, da).then((data) => {
"dataability:///com.example.DataAbility", console.info("==========================>updateCallback=======================>");
va,
da
).then((data) => {
console.info("==========================>updateCallback=======================>");
}); });
``` ```
...@@ -811,12 +765,8 @@ var DAHelper = featureAbility.acquireDataAbilityHelper( ...@@ -811,12 +765,8 @@ var DAHelper = featureAbility.acquireDataAbilityHelper(
); );
var cars=new Array("value1", "value2", "value3", "value4"); var cars=new Array("value1", "value2", "value3", "value4");
let da = new ohos_data_ability.DataAbilityPredicates() let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.query( DAHelper.query("dataability:///com.example.DataAbility", cars, da, (err, data) => {
"dataability:///com.example.DataAbility", console.info("==========================>Called=======================>");
cars,
da,
(err, data) => {
console.info("==========================>Called=======================>");
}); });
``` ```
...@@ -852,14 +802,10 @@ import ohos_data_ability from '@ohos.data.dataAbility' ...@@ -852,14 +802,10 @@ import ohos_data_ability from '@ohos.data.dataAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper( var DAHelper = featureAbility.acquireDataAbilityHelper(
"dataability:///com.example.DataAbility" "dataability:///com.example.DataAbility"
); );
var cars=new Array("value1", "value2", "value3", "value4"); var cars = new Array("value1", "value2", "value3", "value4");
let da = new ohos_data_ability.DataAbilityPredicates() let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.query( DAHelper.query("dataability:///com.example.DataAbility", cars, da).then((data) => {
"dataability:///com.example.DataAbility", console.info("==========================>queryCallback=======================>");
cars,
da
).then((data) => {
console.info("==========================>queryCallback=======================>");
}); });
``` ```
...@@ -891,8 +837,10 @@ call(uri: string, method: string, arg: string, extras: PacMap): Promise\<PacMap> ...@@ -891,8 +837,10 @@ call(uri: string, method: string, arg: string, extras: PacMap): Promise\<PacMap>
```ts ```ts
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let dataAbilityHelper = featureAbility.acquireDataAbilityHelper("dataability:///com.example.jsapidemo.UserDataAbility"); let dataAbilityHelper = featureAbility.acquireDataAbilityHelper(
dataAbilityHelper.call("dataability:///com.example.jsapidemo.UserDataAbility", "method", "arg", {"key1":"value1"}).then((data) => { "dataability:///com.example.jsapidemo.UserDataAbility");
dataAbilityHelper.call("dataability:///com.example.jsapidemo.UserDataAbility",
"method", "arg", {"key1":"value1"}).then((data) => {
console.info('Operation succeeded: ' + data); console.info('Operation succeeded: ' + data);
}).catch((error) => { }).catch((error) => {
console.error('Operation failed. Cause: ' + error); console.error('Operation failed. Cause: ' + error);
...@@ -922,8 +870,10 @@ call(uri: string, method: string, arg: string, extras: PacMap, callback: AsyncCa ...@@ -922,8 +870,10 @@ call(uri: string, method: string, arg: string, extras: PacMap, callback: AsyncCa
```ts ```ts
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
let dataAbilityHelper = featureAbility.acquireDataAbilityHelper("dataability:///com.example.jsapidemo.UserDataAbility"); let dataAbilityHelper = featureAbility.acquireDataAbilityHelper(
dataAbilityHelper.call("dataability:///com.example.jsapidemo.UserDataAbility", "method", "arg", {"key1":"value1"}, (err, data) => { "dataability:///com.example.jsapidemo.UserDataAbility");
dataAbilityHelper.call("dataability:///com.example.jsapidemo.UserDataAbility",
"method", "arg", {"key1":"value1"}, (err, data) => {
if (err) { if (err) {
console.error('Operation failed. Cause: ' + err); console.error('Operation failed. Cause: ' + err);
return; return;
...@@ -955,8 +905,10 @@ import featureAbility from '@ohos.ability.featureAbility'; ...@@ -955,8 +905,10 @@ import featureAbility from '@ohos.ability.featureAbility';
// 根据DataAbilityOperation列表选择要对数据库做的操作 // 根据DataAbilityOperation列表选择要对数据库做的操作
let op=new Array(); let op=new Array();
let dataAbilityHelper = featureAbility.acquireDataAbilityHelper("dataability:///com.example.jsapidemo.UserDataAbility"); let dataAbilityHelper = featureAbility.acquireDataAbilityHelper(
dataAbilityHelper.executeBatch("dataability:///com.example.jsapidemo.UserDataAbility", op, (err, data) => { "dataability:///com.example.jsapidemo.UserDataAbility");
dataAbilityHelper.executeBatch("dataability:///com.example.jsapidemo.UserDataAbility",
op, (err, data) => {
if (err) { if (err) {
console.error('Operation failed. Cause: ' + err); console.error('Operation failed. Cause: ' + err);
return; return;
...@@ -993,8 +945,10 @@ import featureAbility from '@ohos.ability.featureAbility'; ...@@ -993,8 +945,10 @@ import featureAbility from '@ohos.ability.featureAbility';
// 根据DataAbilityOperation列表选择要对数据库做的操作 // 根据DataAbilityOperation列表选择要对数据库做的操作
let op=new Array(); let op=new Array();
let dataAbilityHelper = featureAbility.acquireDataAbilityHelper("dataability:///com.example.jsapidemo.UserDataAbility"); let dataAbilityHelper = featureAbility.acquireDataAbilityHelper(
dataAbilityHelper.executeBatch("dataability:///com.example.jsapidemo.UserDataAbility",op ).then((data) => { "dataability:///com.example.jsapidemo.UserDataAbility");
dataAbilityHelper.executeBatch("dataability:///com.example.jsapidemo.UserDataAbility",
op).then((data) => {
console.info('Operation succeeded: ' + data); console.info('Operation succeeded: ' + data);
}).catch((error) => { }).catch((error) => {
console.error('Operation failed. Cause: ' + error); console.error('Operation failed. Cause: ' + error);
......
# DataAbilityOperation # DataAbilityOperation
定义dataAbility数据操作方式。 定义dataAbility数据操作方式,可以作为[executeBatch](js-apis-inner-ability-dataAbilityHelper.md#dataabilityhelperexecutebatch)的入参查询数据库的信息
> **说明:** > **说明:**
> >
...@@ -11,56 +11,11 @@ ...@@ -11,56 +11,11 @@
| 名称 | 类型 | 必填| 说明 | | 名称 | 类型 | 必填| 说明 |
| -------- | -------- | --------| -------- | | -------- | -------- | --------| -------- |
| uri | string | 是 | 指定待处理的DataAbility。例:"dataability:///com.example.xxx.xxxx"。 | | uri | string | 是 | 指定待处理的DataAbility。例:"dataability:///com.example.xxx.xxxx"。 |
| type | featureAbility.DataAbilityOperationType | 是 | 指示操作类型。 | | type | featureAbility.DataAbilityOperationType | 是 | 指示操作类型。 |
| valuesBucket? | rdb.ValuesBucket | 否 | 指示要设置的数据值。 | | valuesBucket? | rdb.ValuesBucket | 否 | 指示要设置的数据值。 |
| valueBackReferences? | rdb.ValuesBucket | 否 | 指示包含一组键值对的valuesBucket对象。 | | valueBackReferences? | rdb.ValuesBucket | 否 | 指示包含一组键值对的valuesBucket对象。 |
| predicates? | dataAbility.DataAbilityPredicates | 否 | 指示要设置的筛选条件。如果此参数为空,则所有数据记录。 | | predicates? | dataAbility.DataAbilityPredicates | 否 | 指示要设置的筛选条件。如果此参数为空,则所有数据记录。 |
| predicatesBackReferences? | Map\<number, number> | 否 | 指示用作谓词中筛选条件的反向引用。 | | predicatesBackReferences? | Map\<number, number> | 否 | 指示用作谓词中筛选条件的反向引用。 |
| interrupted? | boolean | 否 | 指定是否可以中断批处理操作。 | | interrupted? | boolean | 否 | 指定是否可以中断批处理操作。 |
| expectedCount? | number | 否 | 指示要更新或删除的预期行数。 | | expectedCount? | number | 否 | 指示要更新或删除的预期行数。 |
**示例:**
```ts
import featureAbility from '@ohos.ability.featureAbility'
let dataAbilityUri = ("dataability:///com.example.myapplication.TestDataAbility");
let DAHelper;
try {
DAHelper = featureAbility.acquireDataAbilityHelper(dataAbilityUri);
if(DAHelper == null){
console.error('DAHelper is null');
return;
}
} catch (err) {
console.error('acquireDataAbilityHelper fail, error:' + JSON.stringify(err));
return;
}
let valueBucket = {
"name": "DataAbilityHelperTest",
"age": 24,
"salary": 2024.20,
};
let dataAbilityOperation = {
uri: dataAbilityUri,
type: featureAbility.DataAbilityOperationType.TYPE_INSERT,
valuesBucket: valueBucket,
predicates: null,
expectedCount: 1,
PredicatesBackReferences: {},
interrupted: true
}
let operations = [
dataAbilityOperation
];
try {
DAHelper.executeBatch(dataAbilityUri, operations,
(err, data) => {
console.log("executeBatch, data: " + JSON.stringify(data));
}
);
} catch (err) {
console.error('executeBatch fail: ' + JSON.stringify(err));
}
```
\ No newline at end of file
# DataAbilityResult # DataAbilityResult
定义dataAbility数据操作结果。 定义dataAbility数据操作结果,通过[executeBatch](js-apis-inner-ability-dataAbilityHelper.md#dataabilityhelperexecutebatch)查询数据库信息时查询结果通过DataAbilityResult对象返回
> **说明:** > **说明:**
> >
...@@ -11,10 +11,11 @@ ...@@ -11,10 +11,11 @@
| 名称 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| uri? | string | 否 | 指定待处理的DataAbility。例:"dataability:///com.example.xxx.xxxx"。 | | uri? | string | 否 | 指定待处理的DataAbility。例:"dataability:///com.example.xxx.xxxx"。 |
| count? | number | 否 | 指示受操作影响的行数。 | | count? | number | 否 | 指示受操作影响的行数。 |
**示例:** **示例:**
```ts ```ts
import featureAbility from '@ohos.ability.featureAbility' import featureAbility from '@ohos.ability.featureAbility'
...@@ -22,7 +23,7 @@ let dataAbilityUri = ("dataability:///com.example.myapplication.TestDataAbility" ...@@ -22,7 +23,7 @@ let dataAbilityUri = ("dataability:///com.example.myapplication.TestDataAbility"
let DAHelper; let DAHelper;
try { try {
DAHelper = featureAbility.acquireDataAbilityHelper(dataAbilityUri); DAHelper = featureAbility.acquireDataAbilityHelper(dataAbilityUri);
if(DAHelper == null){ if (DAHelper == null) {
console.error('DAHelper is null'); console.error('DAHelper is null');
return; return;
} }
......
# StartAbilityParameter # StartAbilityParameter
定义启动Ability参数。 定义启动Ability参数,可以作为入参调用[startAbility](js-apis-ability-featureAbility.md#featureabilitystartability)启动指定的Ability
> **说明:** > **说明:**
> >
...@@ -31,11 +31,11 @@ let abilityStartSetting ={ ...@@ -31,11 +31,11 @@ let abilityStartSetting ={
} }
let startAbilityParameter = { let startAbilityParameter = {
want:Want, want : Want,
abilityStartSetting:abilityStartSetting abilityStartSetting : abilityStartSetting
} }
featureAbility.startAbility(startAbilityParameter, (err,data)=>{ featureAbility.startAbility(startAbilityParameter, (err, data)=>{
console.log('errCode : ' + JSON.stringify(err)); console.log('errCode : ' + JSON.stringify(err));
console.log('data : ' + JSON.stringify(data)); console.log('data : ' + JSON.stringify(data));
} catch(error) { } catch(error) {
......
# Want # Want
Want是对象间信息传递的载体, 可以用于应用组件间的信息传递。 Want的使用场景之一是作为startAbility的参数, 其包含了指定的启动目标, 以及启动时需携带的相关数据, 如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当Ability A需要启动Ability B并传入一些数据时, 可使用Want作为载体将这些数据传递给Ability B。 Want是对象间信息传递的载体, 可以用于应用组件间的信息传递。 Want的使用场景之一是作为[startAbility](js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability)的参数, 其包含了指定的启动目标, 以及启动时需携带的相关数据, 如bundleName和abilityName字段分别指明目标Ability所在应用的包名以及对应包内的Ability名称。当Ability A需要启动Ability B并传入一些数据时, 可使用Want作为载体将这些数据传递给Ability B。
> **说明:** > **说明:**
> >
...@@ -23,43 +23,46 @@ Want是对象间信息传递的载体, 可以用于应用组件间的信息传 ...@@ -23,43 +23,46 @@ Want是对象间信息传递的载体, 可以用于应用组件间的信息传
**示例:** **示例:**
- 基础用法 - 基础用法(在UIAbility对象中调用,其中示例中的context为UIAbility的上下文对象)
```ts ```ts
var want = { let want = {
"deviceId": "", // deviceId为空表示本设备 "deviceId": "", // deviceId为空表示本设备
"bundleName": "com.extreme.test", "bundleName": "com.extreme.test",
"abilityName": "MainAbility", "abilityName": "MainAbility",
"moduleName": "entry" // moduleName非必选 "moduleName": "entry" // moduleName非必选
}; };
this.context.startAbility(want, (error) => { this.context.startAbility(want, (error) => {
// 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability // 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability
console.log("error.code = " + error.code) console.log("error.code = " + error.code)
}) })
``` ```
- 传递FD数据,FD表示文件描述符(FileDescriptor) - 传递FD(文件描述符)数据(在UIAbility对象中调用,其中示例中的context为UIAbility的上下文对象)
```ts ```ts
import fileio from '@ohos.fileio'; import fileio from '@ohos.fileio';
var fd;
try { // ...
fd = fileio.openSync("/data/storage/el2/base/haps/pic.png"); let fd;
} catch(e) { try {
console.log("openSync fail:" + JSON.stringify(e)); fd = fileio.openSync("/data/storage/el2/base/haps/pic.png");
} } catch(e) {
var want = { console.log("openSync fail:" + JSON.stringify(e));
"deviceId": "", // deviceId为空表示本设备 }
"bundleName": "com.extreme.test", let want = {
"abilityName": "MainAbility", "deviceId": "", // deviceId为空表示本设备
"moduleName": "entry", // moduleName非必选 "bundleName": "com.extreme.test",
"parameters": { "abilityName": "MainAbility",
"keyFd":{"type":"FD", "value":fd} "moduleName": "entry", // moduleName非必选
} "parameters": {
}; "keyFd":{"type":"FD", "value":fd}
this.context.startAbility(want, (error) => { }
// 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability };
console.log("error.code = " + error.code) this.context.startAbility(want, (error) => {
}) // 显式拉起Ability,通过bundleName、abilityName和moduleName可以唯一确定一个Ability
console.log("error.code = " + error.code)
})
// ...
``` ```
<!--no_check--> <!--no_check-->
\ No newline at end of file
# AppVersionInfo # AppVersionInfo
定义应用版本信息。 定义应用版本信息,可以通过[getAppVersionInfo](js-apis-inner-app-context.md#contextgetappversioninfo7)获取当前应用的版本信息
> **说明:** > **说明:**
> >
...@@ -14,15 +14,3 @@ ...@@ -14,15 +14,3 @@
| versionCode | number | 是 | 否 | 模块描述信息。 | | versionCode | number | 是 | 否 | 模块描述信息。 |
| versionName | string | 是 | 否 | 描述信息ID。 | | versionName | string | 是 | 否 | 描述信息ID。 |
**示例:**
```ts
let appName;
let versionCode;
let versionName;
this.context.getAppVersionInfo((error, data) => {
console.info('getAppVersionInfo data is:' + JSON.stringify(data));
appName = data.appName;
versionCode = data.versionCode;
versionName = data.versionName;
});
```
\ No newline at end of file
...@@ -9,7 +9,7 @@ Context模块提供了ability或application的上下文的能力,包括允许 ...@@ -9,7 +9,7 @@ Context模块提供了ability或application的上下文的能力,包括允许
## 使用说明 ## 使用说明
Context对象是在featureAbility中创建实例,并通过featureAbility的getContext()接口返回,因此在使用Context时,必须导入@ohos.ability.featureAbility库。示例如下: Context对象是在featureAbility中创建实例,并通过featureAbility的[getContext](js-apis-ability-featureAbility.md#featureabilitygetcontext)接口返回,因此在使用Context时,必须导入@ohos.ability.featureAbility库。示例如下:
```ts ```ts
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
......
# ProcessInfo # ProcessInfo
定义进程信息。 定义进程信息,可以通过[getProcessInfo](js-apis-inner-app-context.md#contextgetprocessinfo7)获取当前Ability运行的进程信息
> **说明:** > **说明:**
> >
...@@ -8,10 +8,10 @@ ...@@ -8,10 +8,10 @@
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| pid | number | 是 | 否 | 进程ID。 | | pid | number | 是 | 否 | 进程ID。 |
| processName | string | 是 | 否 | 进程名称。 | | processName | string | 是 | 否 | 进程名称。 |
**示例:** **示例:**
```ts ```ts
...@@ -24,3 +24,4 @@ context.getProcessInfo((err, data) => { ...@@ -24,3 +24,4 @@ context.getProcessInfo((err, data) => {
let processName = data.processName; let processName = data.processName;
}); });
``` ```
...@@ -8,14 +8,11 @@ AbilityDelegator提供添加用于监视指定ability的生命周期状态更改 ...@@ -8,14 +8,11 @@ AbilityDelegator提供添加用于监视指定ability的生命周期状态更改
## 使用说明 ## 使用说明
通过AbilityDelegatorRegistry中getAbilityDelegator方法获取。 通过AbilityDelegatorRegistry中[getAbilityDelegator](js-apis-app-ability-abilityDelegatorRegistry.md#abilitydelegatorregistrygetabilitydelegator)方法获取。
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry' import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
var abilityDelegator; let abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
``` ```
## AbilityDelegator ## AbilityDelegator
...@@ -1044,7 +1041,7 @@ abilityDelegator.waitAbilityStageMonitor(monitor, (err : any, data : any) => { ...@@ -1044,7 +1041,7 @@ abilityDelegator.waitAbilityStageMonitor(monitor, (err : any, data : any) => {
console.info("waitAbilityStageMonitor callback"); console.info("waitAbilityStageMonitor callback");
}); });
``` ```
### waitAbilityStageMonitor<sup>9+</sup> ### waitAbilityStageMonitor<sup>9+</sup>
waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout?: number): Promise\<AbilityStage>; waitAbilityStageMonitor(monitor: AbilityStageMonitor, timeout?: number): Promise\<AbilityStage>;
......
...@@ -8,7 +8,7 @@ AbilityDelegatorArgs模块提供在应用程序启动期间,用于存储已注 ...@@ -8,7 +8,7 @@ AbilityDelegatorArgs模块提供在应用程序启动期间,用于存储已注
## 使用说明 ## 使用说明
通过AbilityDelegatorRegistry中getArguments方法获取。 通过AbilityDelegatorRegistry中[getArguments](js-apis-app-ability-abilityDelegatorRegistry.md#abilitydelegatorregistrygetarguments)方法获取。
## AbilityDelegatorArgs ## AbilityDelegatorArgs
...@@ -30,5 +30,3 @@ import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry ...@@ -30,5 +30,3 @@ import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry
var args = AbilityDelegatorRegistry.getArguments(); var args = AbilityDelegatorRegistry.getArguments();
``` ```
...@@ -8,7 +8,7 @@ AbilityMonitor模块提供匹配满足指定条件的受监视能力对象的方 ...@@ -8,7 +8,7 @@ AbilityMonitor模块提供匹配满足指定条件的受监视能力对象的方
## 使用说明 ## 使用说明
通过abilityDelegator中的addAbilityMonitor来设置 可以作为abilityDelegator中的[addAbilityMonitor](js-apis-inner-application-abilityDelegator.md#addabilitymonitor9)的入参来监听指定Ability的生命周期变化
## AbilityMonitor ## AbilityMonitor
...@@ -31,7 +31,6 @@ Ability监听器 ...@@ -31,7 +31,6 @@ Ability监听器
```ts ```ts
import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry' import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
var abilityDelegator;
function onAbilityCreateCallback(data) { function onAbilityCreateCallback(data) {
console.info("onAbilityCreateCallback"); console.info("onAbilityCreateCallback");
...@@ -42,7 +41,7 @@ var monitor = { ...@@ -42,7 +41,7 @@ var monitor = {
onAbilityCreate: onAbilityCreateCallback onAbilityCreate: onAbilityCreateCallback
} }
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); var abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
abilityDelegator.addAbilityMonitor(monitor, (err : any) => { abilityDelegator.addAbilityMonitor(monitor, (err : any) => {
console.info("addAbilityMonitor callback"); console.info("addAbilityMonitor callback");
}); });
......
...@@ -8,7 +8,7 @@ AbilityRunningInfo模块提供对Ability运行的相关信息和状态的定义 ...@@ -8,7 +8,7 @@ AbilityRunningInfo模块提供对Ability运行的相关信息和状态的定义
## 使用说明 ## 使用说明
通过abilityManager中getAbilityRunningInfos方法获取。 通过abilityManager中[getAbilityRunningInfos](js-apis-app-ability-abilityManager.md#getabilityrunninginfos)方法获取。
## 属性 ## 属性
......
# AbilityStateData # AbilityStateData
定义Ability状态信息。 定义Ability状态信息,可以通过[registerApplicationStateObserver](js-apis-application-appManager.md#appmanagerregisterapplicationstateobserver8)注册生命周期变化监听后,通过[ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md)的onAbilityStateChanged生命周期回调获取
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...@@ -12,22 +12,5 @@ ...@@ -12,22 +12,5 @@
| uid<sup>8+</sup> | number | 是 | 否 | 用户ID。 | | uid<sup>8+</sup> | number | 是 | 否 | 用户ID。 |
| state<sup>8+</sup> | number | 是 | 否 | Ability状态。 | | state<sup>8+</sup> | number | 是 | 否 | Ability状态。 |
| moduleName<sup>9+</sup> | string | 是 | 否 | Ability所属的HAP包的名称。 | | moduleName<sup>9+</sup> | string | 是 | 否 | Ability所属的HAP包的名称。 |
| abilityType<sup>8+</sup> | string | 是 | 否 | 能力类型、页面或服务等。 | | abilityType<sup>8+</sup> | string | 是 | 否 | Ability类型:页面或服务等。 |
**示例:**
```ts
import appManager from "@ohos.application.appManager"
appManager.getForegroundApplications((error, data) => {
for(let i=0; i<data.length; i++) {
let appStateData = data[i];
console.info('appStateData.pid: ' + appStateData.pid);
console.info('appStateData.bundleName: ' + appStateData.bundleName);
console.info('appStateData.abilityName: ' + appStateData.abilityName);
console.info('appStateData.uid: ' + appStateData.uid);
console.info('appStateData.state: ' + appStateData.state);
console.info('appStateData.moduleName: ' + appStateData.moduleName);
console.info('appStateData.abilityType: ' + appStateData.abilityType);
}
});
```
\ No newline at end of file
# AppStateData # AppStateData
定义应用状态信息。 定义应用状态信息,可以通过[getForegroundApplications](js-apis-app-ability-appManager.md#appmanagergetforegroundapplications)获取当前应用的相关信息
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...@@ -17,11 +17,12 @@ ...@@ -17,11 +17,12 @@
import appManager from "@ohos.application.appManager" import appManager from "@ohos.application.appManager"
appManager.getForegroundApplications((error, data) => { appManager.getForegroundApplications((error, data) => {
for(let i=0; i<data.length; i++) { for (let i = 0; i < data.length; i++) {
let appStateData = data[i]; let appStateData = data[i];
console.info('appStateData.bundleName: ' + appStateData.bundleName); console.info('appStateData.bundleName: ' + appStateData.bundleName);
console.info('appStateData.uid: ' + appStateData.uid); console.info('appStateData.uid: ' + appStateData.uid);
console.info('appStateData.state: ' + appStateData.state); console.info('appStateData.state: ' + appStateData.state);
} }
}); });
``` ```
\ No newline at end of file
# ApplicationStateObserver # ApplicationStateObserver
定义应用状态监听。 定义应用状态监听,可以作为[registerApplicationStateObserver](js-apis-application-appManager.md#appmanagerregisterapplicationstateobserver8)的入参监听当前应用的生命周期变化
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
**系统API**:该接口为系统接口,三方应用不支持调用。 **系统API**:该接口为系统接口,三方应用不支持调用。
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | | 类型 | 可读 | 可写 | 说明 |
| ----------------------- | ---------| ---- | ---- | ------------------------- | | ----------------------- | ---------| ---- | ---- | ------------------------- | ------------------------- |
| onForegroundApplicationChanged<sup>8+</sup> | AsyncCallback\<void> | 是 | 否 | 应用前后台状态发生变化时执行的回调函数。 | | onForegroundApplicationChanged<sup>8+</sup> | [AppStateData](js-apis-inner-application-appStateData.md) | AsyncCallback\<void> | 是 | 否 | 应用前后台状态发生变化时执行的回调函数。 |
| onAbilityStateChanged<sup>8+</sup> | AsyncCallback\<void> | 是 | 否 | ability状态发生变化时执行的回调函数。 | | onAbilityStateChanged<sup>8+</sup> | [AbilityStateData](js-apis-inner-application-abilityStateData.md) | AsyncCallback\<void> | 是 | 否 | ability状态发生变化时执行的回调函数。 |
| onProcessCreated<sup>8+</sup> | AsyncCallback\<void> | 是 | 否 | 进程创建时执行的回调函数。 | | onProcessCreated<sup>8+</sup> | [ProcessData](js-apis-inner-application-processData.md) | AsyncCallback\<void> | 是 | 否 | 进程创建时执行的回调函数。 |
| onProcessDied<sup>8+</sup> | AsyncCallback\<void> | 是 | 否 | 进程销毁时执行的回调函数。 | | onProcessDied<sup>8+</sup> | [ProcessData](js-apis-inner-application-processData.md) | AsyncCallback\<void> | 是 | 否 | 进程销毁时执行的回调函数。 |
| onProcessStateChanged<sup>8+</sup> | AsyncCallback\<void> | 是 | 否 | 进程状态更新时执行的回调函数。 | | onProcessStateChanged<sup>8+</sup> | [ProcessData](js-apis-inner-application-processData.md) | AsyncCallback\<void> | 是 | 否 | 进程状态更新时执行的回调函数。 |
**示例:** **示例:**
```ts ```ts
......
# Context模块 # Context模块
Context模块提供了ability或application的上下文的能力,包括允许访问特定于应用程序的资源、请求和验证权限等。 Context模块提供了ability或application的上下文的能力,包括允许访问特定于应用程序的资源等。
> **说明:** > **说明:**
> >
...@@ -13,8 +13,8 @@ Context模块提供了ability或application的上下文的能力,包括允许 ...@@ -13,8 +13,8 @@ Context模块提供了ability或application的上下文的能力,包括允许
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | ------ | ---- | ---- | ------- | | ----------- | ------ | ---- | ---- | ------- |
| resourceManager | resmgr.ResourceManager | 是 | 否 | 资源管理对象。 | | resourceManager | resmgr.[ResourceManager](js-apis-resource-manager.md) | 是 | 否 | 资源管理对象。 |
| applicationInfo | ApplicationInfo | 是 | 否 | 当前应用程序的信息。 | | applicationInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | 是 | 否 | 当前应用程序的信息。 |
| cacheDir | string | 是 | 否 | 缓存目录。 | | cacheDir | string | 是 | 否 | 缓存目录。 |
| tempDir | string | 是 | 否 | 临时目录。 | | tempDir | string | 是 | 否 | 临时目录。 |
| filesDir | string | 是 | 否 | 文件目录。 | | filesDir | string | 是 | 否 | 文件目录。 |
...@@ -129,7 +129,7 @@ let applicationContext = this.context.getApplicationContext(); ...@@ -129,7 +129,7 @@ let applicationContext = this.context.getApplicationContext();
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| -------- | -------- | -------- | | -------- | -------- | -------- |
| EL1 | 0 | 设备级加密区。 | | EL1 | 0 | 设备级加密区,设备开机后可访问的数据区。 |
| EL2 | 1 | 用户凭据加密区。 | | EL2 | 1 | 用户级加密区,设备开机,首次输入密码后才能够访问的数据区。 |
# ContinueCallback # ContinueCallback
表示迁移完成后,返回迁移结果回调函数。 表示迁移完成后,返回迁移结果回调函数,可以作为[continueMission](js-apis-distributedMissionManager.md#distributedmissionmanagercontinuemission)的入参监听迁移回调
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission **系统能力**:SystemCapability.Ability.AbilityRuntime.Mission
......
# ContinueDeviceInfo # ContinueDeviceInfo
表示发起任务迁移时所需参数的枚举。 表示发起任务迁移时所需参数的枚举,可以作为[continueMission](js-apis-distributedMissionManager.md#distributedmissionmanagercontinuemission)的入参指定迁移相关参数
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission **系统能力**:SystemCapability.Ability.AbilityRuntime.Mission
......
# ErrorObserver # ErrorObserver
定义异常监听。 定义异常监听,可以作为[registerErrorObserver](js-apis-application-errorManager.md#errormanagerregistererrorobserver)的入参监听当前应用发生的异常
## onUnhandledException ## onUnhandledException
...@@ -11,13 +11,13 @@ onUnhandledException(errMsg: string): void; ...@@ -11,13 +11,13 @@ onUnhandledException(errMsg: string): void;
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core **系统能力**:SystemCapability.Ability.AbilityRuntime.Core
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| errMsg | string | 否 | 有关异常的消息和错误堆栈跟踪。 | | errMsg | string | 否 | 有关异常的消息和错误堆栈跟踪。 |
**示例:** **示例:**
```ts ```ts
import errorManager from '@ohos.application.errorManager'; import errorManager from '@ohos.application.errorManager';
......
# ExtensionRunningInfo # ExtensionRunningInfo
ExtensionRunningInfo模块提供对Extension运行的相关信息和类型进行设置和查询的能力。 ExtensionRunningInfo模块提供对Extension运行的相关信息和类型进行设置和查询的能力,可以通过[getExtensionRunningInfos](js-apis-app-ability-abilityManager.md#getextensionrunninginfos)获取
> **说明:** > **说明:**
> >
...@@ -28,10 +28,10 @@ ExtensionRunningInfo模块提供对Extension运行的相关信息和类型进行 ...@@ -28,10 +28,10 @@ ExtensionRunningInfo模块提供对Extension运行的相关信息和类型进行
**示例:** **示例:**
```ts ```ts
import abilityManager from '@ohos.application.abilityManager'; import abilityManager from '@ohos.application.abilityManager';
let upperLimit=1; let upperLimit = 1;
abilityManager.getExtensionRunningInfos(upperLimit, (err,data) => { abilityManager.getExtensionRunningInfos(upperLimit, (err,data) => {
console.log("getExtensionRunningInfos err: " + err + " data: " + JSON.stringify(data)); console.log("getExtensionRunningInfos err: " + err + " data: " + JSON.stringify(data));
for (let i=0; i<data.length; i++) { for (let i = 0; i < data.length; i++) {
let extensionRunningInfo = data[i]; let extensionRunningInfo = data[i];
console.log("extensionRunningInfo.extension: " + JSON.stringify(extensionRunningInfo.extension)); console.log("extensionRunningInfo.extension: " + JSON.stringify(extensionRunningInfo.extension));
console.log("extensionRunningInfo.pid: " + JSON.stringify(extensionRunningInfo.pid)); console.log("extensionRunningInfo.pid: " + JSON.stringify(extensionRunningInfo.pid));
......
...@@ -18,6 +18,8 @@ import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility'; ...@@ -18,6 +18,8 @@ import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
import formBindingData from '@ohos.app.form.formBindingData'; import formBindingData from '@ohos.app.form.formBindingData';
export default class MyFormExtensionAbility extends FormExtensionAbility { export default class MyFormExtensionAbility extends FormExtensionAbility {
onAddForm() { onAddForm() {
let formContext = this.context; // 获取FormExtensionContext
// ...
let dataObj1 = { let dataObj1 = {
temperature:"11c", temperature:"11c",
"time":"11:00" "time":"11:00"
......
# MissionCallbacks # MissionCallbacks
表示开始同步后,建立的回调函数。 作为可以[registerMissionListener](js-apis-distributedMissionManager.md#distributedmissionmanagerregistermissionlistener)的入参,表示开始同步后,建立的回调函数。
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission **系统能力**:SystemCapability.Ability.AbilityRuntime.Mission
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------------- | -------- | ---- | ---- | ------------------ | | ---------------------------------------------------- | -------- | ---- | ---- | ---------------------------------- |
| notifyMissionsChanged | function | 是 | 否 | 通知任务变化,返回设备ID。 | | notifyMissionsChanged(deviceId: string) | function | 是 | 否 | 通知任务变化,返回设备ID。 |
| notifySnapshot | function | 是 | 否 | 通知快照变化,返回设备ID,任务ID | | notifySnapshot(deviceId: string, mission: number) | function | 是 | 否 | 通知快照变化,返回设备ID,任务ID |
| notifyNetDisconnect | function | 是 | 否 | 通知断开连接,返回设备ID,网络状态 | | notifyNetDisconnect(deviceId: string, state: number) | function | 是 | 否 | 通知断开连接,返回设备ID,网络状态 |
**示例:** **示例:**
```ts ```ts
...@@ -21,12 +21,12 @@ let missionCallback = { ...@@ -21,12 +21,12 @@ let missionCallback = {
notifyMissionsChanged: function (deviceId) { notifyMissionsChanged: function (deviceId) {
console.log("notifyMissionsChanged deviceId: " + JSON.stringify(deviceId)); console.log("notifyMissionsChanged deviceId: " + JSON.stringify(deviceId));
}, },
notifySnapshot: function (mission, deviceId) { notifySnapshot: function (deviceId, mission) {
console.log("notifySnapshot mission: " + JSON.stringify(mission));
console.log("notifySnapshot deviceId: " + JSON.stringify(deviceId)); console.log("notifySnapshot deviceId: " + JSON.stringify(deviceId));
console.log("notifySnapshot mission: " + JSON.stringify(mission));
}, },
notifyNetDisconnect: function (mission, state) { notifyNetDisconnect: function (deviceId, state) {
console.log("notifyNetDisconnect mission: " + JSON.stringify(mission)); console.log("notifyNetDisconnect deviceId: " + JSON.stringify(deviceId));
console.log("notifyNetDisconnect state: " + JSON.stringify(state)); console.log("notifyNetDisconnect state: " + JSON.stringify(state));
} }
}; };
......
# MissionDeviceInfo # MissionDeviceInfo
表示注册监听时所需参数的枚举。 作为可以[registerMissionListener](js-apis-distributedMissionManager.md#distributedmissionmanagerregistermissionlistener)的入参,表示注册监听时所需参数的枚举。
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission **系统能力**:SystemCapability.Ability.AbilityRuntime.Mission
......
# MissionInfo # MissionInfo
表示Ability对应任务信息的枚举 表示Ability对应的任务信息,可以通过[getMissionInfo](js-apis-app-ability-missionManager.md#missionmanagergetmissioninfo)获取
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission
**系统API**: 此接口为系统接口,三方应用不支持调用。 **系统API**: 此接口为系统接口,三方应用不支持调用。
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| missionId | number | 是 | 是 | 表示任务ID。| | missionId | number | 是 | 是 | 表示任务ID。|
| runningState | number | 是 | 是 | 表示运行状态。 | | runningState | number | 是 | 是 | 表示运行状态。 |
| lockedState | boolean | 是 | 是 | 表示锁定状态。 | | lockedState | boolean | 是 | 是 | 表示锁定状态。 |
| timestamp | string | 是 | 是 | 表示任务的最近创建或更新时间。 | | timestamp | string | 是 | 是 | 表示任务的最近创建或更新时间。 |
| want | [Want](js-apis-application-want.md) | 是 | 是 | 表示任务的Want信息。 | | want | [Want](js-apis-application-want.md) | 是 | 是 | 表示任务的Want信息。 |
| label | string | 是 | 是 | 表示任务的标签。 | | label | string | 是 | 是 | 表示任务的标签。 |
| iconPath | string | 是 | 是 | 表示任务的图标路径。 | | iconPath | string | 是 | 是 | 表示任务的图标路径。 |
| continuable | boolean | 是 | 是 | 表示任务是否可以迁移。 | | continuable | boolean | 是 | 是 | 表示任务是否可以迁移。 |
**示例:** **示例:**
```ts ```ts
......
# MissionListener # MissionListener
定义系统任务状态监听。 定义系统任务状态监听,可以通过[registerMissionListener](js-apis-application-missionManager.md#missionmanagerregistermissionlistener)注册
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission
......
# MissionParameter # MissionParameter
表示同步时所需参数的枚举。 作为[startSyncRemoteMissions](js-apis-distributedMissionManager.md#distributedmissionmanagerstartsyncremotemissions)的入参,表示同步时所需参数的枚举。
**系统能力**:SystemCapability.Ability.AbilityRuntime.Mission **系统能力**:SystemCapability.Ability.AbilityRuntime.Mission
......
# MissionSnapshot # MissionSnapshot
MissionSnapshot模块提供设置与任务对应的任务快照的任务元素名称的能力。 MissionSnapshot模块提供设置与任务对应的任务快照的任务元素名称的能力,可以通过[getMissionSnapShot](js-apis-app-ability-missionManager.md#missionmanagergetmissionsnapshot)获取
> **说明:** > **说明:**
> >
......
# PermissionRequestResult # PermissionRequestResult
PermissionRequestResult模块提供了权限请求结果的能力。 PermissionRequestResult模块提供了权限请求结果的能力,在调用[requestPermissionsFromUser](js-apis-inner-application-uiAbilityContext.md#abilitycontextrequestpermissionsfromuser)申请权限时返回此对象表明此次权限申请的结果
> **说明:** > **说明:**
> >
...@@ -11,10 +11,10 @@ PermissionRequestResult模块提供了权限请求结果的能力。 ...@@ -11,10 +11,10 @@ PermissionRequestResult模块提供了权限请求结果的能力。
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| permissions | Array&lt;string&gt; | 是 | 否 | 用户传入的权限。| | permissions | Array&lt;string&gt; | 是 | 否 | 用户传入的权限。|
| authResults | Array&lt;number&gt; | 是 | 否 | 相应请求权限的结果。0表示授权成功,非0表示失败。 | | authResults | Array&lt;number&gt; | 是 | 否 | 相应请求权限的结果:0表示授权成功,非0表示失败。 |
## 使用说明 ## 使用说明
...@@ -22,16 +22,16 @@ PermissionRequestResult模块提供了权限请求结果的能力。 ...@@ -22,16 +22,16 @@ PermissionRequestResult模块提供了权限请求结果的能力。
**示例:** **示例:**
```ts ```ts
import Ability from '@ohos.application.Ability' import UIAbility from '@ohos.app.ability.UIAbility'
export default class MainAbility extends Ability { export default class MainAbility extends UIAbility {
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
var permissions=['com.example.permission'] var permissions = ['com.example.permission']
var permissionRequestResult; var permissionRequestResult;
this.context.requestPermissionsFromUser(permissions,(err,result) => { this.context.requestPermissionsFromUser(permissions, (err, result) => {
if(err){ if (err) {
console.log('requestPermissionsFromUserError: ' + JSON.stringify(err)); console.log('requestPermissionsFromUserError: ' + JSON.stringify(err));
}else{ } else {
permissionRequestResult=result; permissionRequestResult = result;
console.log('permissionRequestResult: ' + JSON.stringify(permissionRequestResult)); console.log('permissionRequestResult: ' + JSON.stringify(permissionRequestResult));
} }
}); });
......
# ProcessData # ProcessData
定义进程数据。 定义进程数据,可以通过[registerApplicationStateObserver](js-apis-application-appManager.md#appmanagerregisterapplicationstateobserver8)注册生命周期变化监听后,通过[ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md)的onProcessCreated生命周期回调获取
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
......
...@@ -10,12 +10,12 @@ ...@@ -10,12 +10,12 @@
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Mission
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| pid | number | 是 | 否 | 进程ID。 | | pid | number | 是 | 否 | 进程ID。 |
| uid | number | 是 | 否 | 用户ID。 | | uid | number | 是 | 否 | 用户ID。 |
| processName | string | 是 | 否 | 进程名称。 | | processName | string | 是 | 否 | 进程名称。 |
| bundleNames | Array&lt;string&gt; | 是 | 否 | 进程中所有运行的包名称。 | | bundleNames | Array&lt;string&gt; | 是 | 否 | 进程中所有运行的包名称。 |
## 使用说明 ## 使用说明
...@@ -24,7 +24,8 @@ ...@@ -24,7 +24,8 @@
**示例:** **示例:**
```ts ```ts
import appManager from '@ohos.application.appManager'; import appManager from '@ohos.application.appManager';
app.getProcessRunningInfos().then((data) => {
appManager.getProcessRunningInfos().then((data) => {
console.log('success:' + JSON.stringify(data)); console.log('success:' + JSON.stringify(data));
}).catch((error) => { }).catch((error) => {
console.log('failed:' + JSON.stringify(error)); console.log('failed:' + JSON.stringify(error));
......
...@@ -8,12 +8,13 @@ ProcessRunningInformation模块提供对进程运行信息进行设置和查询 ...@@ -8,12 +8,13 @@ ProcessRunningInformation模块提供对进程运行信息进行设置和查询
## 使用说明 ## 使用说明
通过[appManager](js-apis-application-appManager.md#appmanagergetprocessrunninginformation9)来获取。 通过appManager的[getProcessRunningInformation](js-apis-application-appManager.md#appmanagergetprocessrunninginformation9)来获取。
```ts ```ts
import appManager from '@ohos.application.appManager'; import appManager from '@ohos.application.appManager';
appManager.getProcessRunningInformation((error,data) => {
console.log("getProcessRunningInformation error: " + error.code + " data: " + JSON.stringify(data)); appManager.getProcessRunningInformation((error, data) => {
console.log("error: " + error.code + " data: " + JSON.stringify(data));
}); });
``` ```
...@@ -21,9 +22,9 @@ appManager.getProcessRunningInformation((error,data) => { ...@@ -21,9 +22,9 @@ appManager.getProcessRunningInformation((error,data) => {
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| pid | number | 是 | 否 | 进程ID。 | | pid | number | 是 | 否 | 进程ID。 |
| uid | number | 是 | 否 | 用户ID。 | | uid | number | 是 | 否 | 用户ID。 |
| processName | string | 是 | 否 | 进程名称。 | | processName | string | 是 | 否 | 进程名称。 |
| bundleNames | Array&lt;string&gt; | 是 | 否 | 进程中所有运行的包名称。 | | bundleNames | Array&lt;string&gt; | 是 | 否 | 进程中所有运行的包名称。 |
...@@ -19,7 +19,7 @@ ServiceExtensionContext模块提供ServiceExtensionAbility具有的能力和接 ...@@ -19,7 +19,7 @@ ServiceExtensionContext模块提供ServiceExtensionAbility具有的能力和接
let context = undefined; let context = undefined;
class MainAbility extends ServiceExtensionAbility { class MainAbility extends ServiceExtensionAbility {
onCreate() { onCreate() {
context = this.context; context = this.context; // 获取ServiceExtensionContext
} }
} }
``` ```
...@@ -36,10 +36,10 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -36,10 +36,10 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 | | want | [Want](js-apis-application-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 |
| callback | AsyncCallback&lt;void&gt; | 否 | 回调函数,返回接口调用是否成功的结果。 | | callback | AsyncCallback&lt;void&gt; | 否 | 回调函数,返回接口调用是否成功的结果。 |
**错误码:** **错误码:**
...@@ -103,16 +103,16 @@ startAbility(want: Want, options?: StartOptions): Promise\<void>; ...@@ -103,16 +103,16 @@ startAbility(want: Want, options?: StartOptions): Promise\<void>;
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 | | want | [Want](js-apis-application-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 |
| options | [StartOptions](js-apis-app-ability-startOptions.md) | 是 | 启动Ability所携带的参数。 | | options | [StartOptions](js-apis-app-ability-startOptions.md) | 是 | 启动Ability所携带的参数。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 | | Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 |
**错误码:** **错误码:**
...@@ -406,9 +406,9 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): ...@@ -406,9 +406,9 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 | | Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 |
**错误码:** **错误码:**
...@@ -545,9 +545,9 @@ startServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -545,9 +545,9 @@ startServiceExtensionAbility(want: Want): Promise\<void>;
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 | | Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 |
**错误码:** **错误码:**
...@@ -681,9 +681,9 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ...@@ -681,9 +681,9 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 | | Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 |
**错误码:** **错误码:**
...@@ -807,9 +807,9 @@ stopServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -807,9 +807,9 @@ stopServiceExtensionAbility(want: Want): Promise\<void>;
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 | | Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 |
**错误码:** **错误码:**
...@@ -936,9 +936,9 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ...@@ -936,9 +936,9 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 | | Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 |
**错误码:** **错误码:**
...@@ -995,9 +995,9 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void; ...@@ -995,9 +995,9 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void;
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;void&gt; | 否 | 回调函数,返回接口调用是否成功的结果。 | | callback | AsyncCallback&lt;void&gt; | 否 | 回调函数,返回接口调用是否成功的结果。 |
**错误码:** **错误码:**
...@@ -1037,9 +1037,9 @@ terminateSelf(): Promise&lt;void&gt;; ...@@ -1037,9 +1037,9 @@ terminateSelf(): Promise&lt;void&gt;;
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 | | Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 |
**错误码:** **错误码:**
...@@ -1077,16 +1077,16 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; ...@@ -1077,16 +1077,16 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number;
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 | | want | [Want](js-apis-application-want.md) | 是 | Want类型参数,传入需要启动的ability的信息,如ability名称,包名等。 |
| options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 是 | ConnectOptions类型的回调函数,返回服务连接成功、断开或连接失败后的信息。 | | options | [ConnectOptions](js-apis-inner-ability-connectOptions.md) | 是 | ConnectOptions类型的回调函数,返回服务连接成功、断开或连接失败后的信息。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| number | 返回一个number,后续根据这个number去断开连接。 | | number | 返回一个number,后续根据这个number去断开连接。 |
**错误码:** **错误码:**
...@@ -1197,10 +1197,10 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback&lt; ...@@ -1197,10 +1197,10 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback&lt;
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| connection | number | 是 | 在connectAbility中返回的number。 | | connection | number | 是 | 在connectAbility中返回的number。 |
| callback | AsyncCallback&lt;void&gt; | 否 | 回调函数,返回接口调用是否成功的结果。 | | callback | AsyncCallback&lt;void&gt; | 否 | 回调函数,返回接口调用是否成功的结果。 |
**错误码:** **错误码:**
...@@ -1249,15 +1249,15 @@ disconnectServiceExtensionAbility(connection: number): Promise&lt;void&gt;; ...@@ -1249,15 +1249,15 @@ disconnectServiceExtensionAbility(connection: number): Promise&lt;void&gt;;
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| connection | number | 是 | 在connectAbility中返回的number。 | | connection | number | 是 | 在connectAbility中返回的number。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 | | Promise&lt;void&gt; | 返回一个Promise,包含接口的结果。 |
**错误码:** **错误码:**
......
# UIAbilityContext # UIAbilityContext
UIAbilityContext是Ability的上下文环境,继承自Context。 UIAbilityContext是UIAbility的上下文环境,继承自Context。
UIAbilityContext模块提供允许访问特定Ability的资源的能力,包括对Ability的启动、停止的设置、获取caller通信接口、拉起弹窗请求用户授权等。 UIAbilityContext模块提供允许访问特定UIAbility的资源的能力,包括对UIAbility的启动、停止的设置、获取caller通信接口、拉起弹窗请求用户授权等。
> **说明:** > **说明:**
> >
...@@ -19,7 +19,7 @@ UIAbilityContext模块提供允许访问特定Ability的资源的能力,包括 ...@@ -19,7 +19,7 @@ UIAbilityContext模块提供允许访问特定Ability的资源的能力,包括
| currentHapModuleInfo | [HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md) | 是 | 否 | 当前hap包的信息 | | currentHapModuleInfo | [HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md) | 是 | 否 | 当前hap包的信息 |
| config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 否 | 表示配置信息。 | | config | [Configuration](js-apis-app-ability-configuration.md) | 是 | 否 | 表示配置信息。 |
## AbilityContext.startAbility ## UIAbilityContext.startAbility
startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
...@@ -85,7 +85,7 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -85,7 +85,7 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
``` ```
## AbilityContext.startAbility ## UIAbilityContext.startAbility
startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&gt;): void; startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&gt;): void;
...@@ -103,7 +103,7 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void& ...@@ -103,7 +103,7 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&
**错误码:** **错误码:**
| 错误码ID | 错误信息 | 错误码ID | 错误信息 |
| ------- | -------------------------------- | | ------- | -------------------------------- |
| 201 | The application does not have permission to call the interface. | | 201 | The application does not have permission to call the interface. |
| 401 | Invalid input parameter. | | 401 | Invalid input parameter. |
...@@ -155,7 +155,7 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void& ...@@ -155,7 +155,7 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback&lt;void&
} }
``` ```
## AbilityContext.startAbility ## UIAbilityContext.startAbility
startAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;; startAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;;
...@@ -230,7 +230,7 @@ startAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;; ...@@ -230,7 +230,7 @@ startAbility(want: Want, options?: StartOptions): Promise&lt;void&gt;;
``` ```
## AbilityContext.startAbilityForResult ## UIAbilityContext.startAbilityForResult
startAbilityForResult(want: Want, callback: AsyncCallback&lt;AbilityResult&gt;): void; startAbilityForResult(want: Want, callback: AsyncCallback&lt;AbilityResult&gt;): void;
...@@ -297,7 +297,7 @@ startAbilityForResult(want: Want, callback: AsyncCallback&lt;AbilityResult&gt;): ...@@ -297,7 +297,7 @@ startAbilityForResult(want: Want, callback: AsyncCallback&lt;AbilityResult&gt;):
} }
``` ```
## AbilityContext.startAbilityForResult ## UIAbilityContext.startAbilityForResult
startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback&lt;AbilityResult&gt;): void; startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback&lt;AbilityResult&gt;): void;
...@@ -369,7 +369,7 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback ...@@ -369,7 +369,7 @@ startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback
``` ```
## AbilityContext.startAbilityForResult ## UIAbilityContext.startAbilityForResult
startAbilityForResult(want: Want, options?: StartOptions): Promise&lt;AbilityResult&gt;; startAbilityForResult(want: Want, options?: StartOptions): Promise&lt;AbilityResult&gt;;
...@@ -444,7 +444,7 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise&lt;AbilityRes ...@@ -444,7 +444,7 @@ startAbilityForResult(want: Want, options?: StartOptions): Promise&lt;AbilityRes
} }
``` ```
## AbilityContext.startAbilityForResultWithAccount ## UIAbilityContext.startAbilityForResultWithAccount
startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback\<AbilityResult>): void; startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback\<AbilityResult>): void;
...@@ -519,7 +519,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC ...@@ -519,7 +519,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncC
``` ```
## AbilityContext.startAbilityForResultWithAccount ## UIAbilityContext.startAbilityForResultWithAccount
startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback\<void\>): void; startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback\<void\>): void;
...@@ -598,7 +598,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp ...@@ -598,7 +598,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOp
``` ```
## AbilityContext.startAbilityForResultWithAccount ## UIAbilityContext.startAbilityForResultWithAccount
startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartOptions): Promise\<AbilityResult\>; startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartOptions): Promise\<AbilityResult\>;
...@@ -680,7 +680,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO ...@@ -680,7 +680,7 @@ startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartO
' error.message: ' + JSON.stringify(paramError.message)); ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
## AbilityContext.startServiceExtensionAbility ## UIAbilityContext.startServiceExtensionAbility
startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
...@@ -741,7 +741,7 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -741,7 +741,7 @@ startServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
} }
``` ```
## AbilityContext.startServiceExtensionAbility ## UIAbilityContext.startServiceExtensionAbility
startServiceExtensionAbility(want: Want): Promise\<void>; startServiceExtensionAbility(want: Want): Promise\<void>;
...@@ -801,7 +801,7 @@ startServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -801,7 +801,7 @@ startServiceExtensionAbility(want: Want): Promise\<void>;
} }
``` ```
## AbilityContext.startServiceExtensionAbilityWithAccount ## UIAbilityContext.startServiceExtensionAbilityWithAccount
startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<void>): void; startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<void>): void;
...@@ -863,7 +863,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -863,7 +863,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
} }
``` ```
## AbilityContext.startServiceExtensionAbilityWithAccount ## UIAbilityContext.startServiceExtensionAbilityWithAccount
startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<void>; startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<void>;
...@@ -927,7 +927,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\ ...@@ -927,7 +927,7 @@ startServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\
' error.message: ' + JSON.stringify(paramError.message)); ' error.message: ' + JSON.stringify(paramError.message));
} }
``` ```
## AbilityContext.stopServiceExtensionAbility ## UIAbilityContext.stopServiceExtensionAbility
stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
...@@ -985,7 +985,7 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void; ...@@ -985,7 +985,7 @@ stopServiceExtensionAbility(want: Want, callback: AsyncCallback\<void>): void;
} }
``` ```
## AbilityContext.stopServiceExtensionAbility ## UIAbilityContext.stopServiceExtensionAbility
stopServiceExtensionAbility(want: Want): Promise\<void>; stopServiceExtensionAbility(want: Want): Promise\<void>;
...@@ -1042,7 +1042,7 @@ stopServiceExtensionAbility(want: Want): Promise\<void>; ...@@ -1042,7 +1042,7 @@ stopServiceExtensionAbility(want: Want): Promise\<void>;
} }
``` ```
## AbilityContext.stopServiceExtensionAbilityWithAccount ## UIAbilityContext.stopServiceExtensionAbilityWithAccount
stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<void>): void; stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<void>): void;
...@@ -1105,7 +1105,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback: ...@@ -1105,7 +1105,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number, callback:
} }
``` ```
## AbilityContext.stopServiceExtensionAbilityWithAccount ## UIAbilityContext.stopServiceExtensionAbilityWithAccount
stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<void>; stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<void>;
...@@ -1167,7 +1167,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\< ...@@ -1167,7 +1167,7 @@ stopServiceExtensionAbilityWithAccount(want: Want, accountId: number): Promise\<
} }
``` ```
## AbilityContext.terminateSelf ## UIAbilityContext.terminateSelf
terminateSelf(callback: AsyncCallback&lt;void&gt;): void; terminateSelf(callback: AsyncCallback&lt;void&gt;): void;
...@@ -1208,7 +1208,7 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void; ...@@ -1208,7 +1208,7 @@ terminateSelf(callback: AsyncCallback&lt;void&gt;): void;
``` ```
## AbilityContext.terminateSelf ## UIAbilityContext.terminateSelf
terminateSelf(): Promise&lt;void&gt;; terminateSelf(): Promise&lt;void&gt;;
...@@ -1247,7 +1247,7 @@ terminateSelf(): Promise&lt;void&gt;; ...@@ -1247,7 +1247,7 @@ terminateSelf(): Promise&lt;void&gt;;
``` ```
## AbilityContext.terminateSelfWithResult ## UIAbilityContext.terminateSelfWithResult
terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback&lt;void&gt;): void; terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback&lt;void&gt;): void;
...@@ -1306,7 +1306,7 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback&lt;voi ...@@ -1306,7 +1306,7 @@ terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback&lt;voi
``` ```
## AbilityContext.terminateSelfWithResult ## UIAbilityContext.terminateSelfWithResult
terminateSelfWithResult(parameter: AbilityResult): Promise&lt;void&gt;; terminateSelfWithResult(parameter: AbilityResult): Promise&lt;void&gt;;
...@@ -1370,7 +1370,7 @@ terminateSelfWithResult(parameter: AbilityResult): Promise&lt;void&gt;; ...@@ -1370,7 +1370,7 @@ terminateSelfWithResult(parameter: AbilityResult): Promise&lt;void&gt;;
} }
``` ```
## AbilityContext.connectServiceExtensionAbility ## UIAbilityContext.connectServiceExtensionAbility
connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; connectServiceExtensionAbility(want: Want, options: ConnectOptions): number;
...@@ -1430,7 +1430,7 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number; ...@@ -1430,7 +1430,7 @@ connectServiceExtensionAbility(want: Want, options: ConnectOptions): number;
``` ```
## AbilityContext.connectServiceExtensionAbilityWithAccount ## UIAbilityContext.connectServiceExtensionAbilityWithAccount
connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number; connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number;
...@@ -1494,7 +1494,7 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options ...@@ -1494,7 +1494,7 @@ connectServiceExtensionAbilityWithAccount(want: Want, accountId: number, options
} }
``` ```
## AbilityContext.disconnectServiceExtensionAbility ## UIAbilityContext.disconnectServiceExtensionAbility
disconnectServiceExtensionAbility(connection: number): Promise\<void>; disconnectServiceExtensionAbility(connection: number): Promise\<void>;
...@@ -1551,7 +1551,7 @@ disconnectServiceExtensionAbility(connection: number): Promise\<void>; ...@@ -1551,7 +1551,7 @@ disconnectServiceExtensionAbility(connection: number): Promise\<void>;
} }
``` ```
## AbilityContext.disconnectServiceExtensionAbility ## UIAbilityContext.disconnectServiceExtensionAbility
disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\<void>): void; disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\<void>): void;
...@@ -1603,7 +1603,7 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\<vo ...@@ -1603,7 +1603,7 @@ disconnectServiceExtensionAbility(connection: number, callback:AsyncCallback\<vo
} }
``` ```
## AbilityContext.startAbilityByCall ## UIAbilityContext.startAbilityByCall
startAbilityByCall(want: Want): Promise&lt;Caller&gt;; startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
...@@ -1690,7 +1690,7 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;; ...@@ -1690,7 +1690,7 @@ startAbilityByCall(want: Want): Promise&lt;Caller&gt;;
} }
``` ```
## AbilityContext.startAbilityWithAccount ## UIAbilityContext.startAbilityWithAccount
startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<void\>): void; startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<void\>): void;
...@@ -1764,7 +1764,7 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\< ...@@ -1764,7 +1764,7 @@ startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback\<
``` ```
## AbilityContext.startAbilityWithAccount ## UIAbilityContext.startAbilityWithAccount
startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback\<void\>): void; startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback\<void\>): void;
...@@ -1842,7 +1842,7 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca ...@@ -1842,7 +1842,7 @@ startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, ca
``` ```
## AbilityContext.startAbilityWithAccount ## UIAbilityContext.startAbilityWithAccount
startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise\<void\>; startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise\<void\>;
...@@ -1918,7 +1918,7 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): ...@@ -1918,7 +1918,7 @@ startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions):
} }
``` ```
## AbilityContext.requestPermissionsFromUser ## UIAbilityContext.requestPermissionsFromUser
requestPermissionsFromUser(permissions: Array&lt;string&gt;, requestCallback: AsyncCallback&lt;PermissionRequestResult&gt;) : void; requestPermissionsFromUser(permissions: Array&lt;string&gt;, requestCallback: AsyncCallback&lt;PermissionRequestResult&gt;) : void;
...@@ -1944,7 +1944,7 @@ requestPermissionsFromUser(permissions: Array&lt;string&gt;, requestCallback: As ...@@ -1944,7 +1944,7 @@ requestPermissionsFromUser(permissions: Array&lt;string&gt;, requestCallback: As
``` ```
## AbilityContext.requestPermissionsFromUser ## UIAbilityContext.requestPermissionsFromUser
requestPermissionsFromUser(permissions: Array&lt;string&gt;) : Promise&lt;PermissionRequestResult&gt;; requestPermissionsFromUser(permissions: Array&lt;string&gt;) : Promise&lt;PermissionRequestResult&gt;;
...@@ -1977,7 +1977,7 @@ requestPermissionsFromUser(permissions: Array&lt;string&gt;) : Promise&lt;Permis ...@@ -1977,7 +1977,7 @@ requestPermissionsFromUser(permissions: Array&lt;string&gt;) : Promise&lt;Permis
``` ```
## AbilityContext.setMissionLabel ## UIAbilityContext.setMissionLabel
setMissionLabel(label: string, callback:AsyncCallback&lt;void&gt;): void; setMissionLabel(label: string, callback:AsyncCallback&lt;void&gt;): void;
...@@ -2001,7 +2001,7 @@ setMissionLabel(label: string, callback:AsyncCallback&lt;void&gt;): void; ...@@ -2001,7 +2001,7 @@ setMissionLabel(label: string, callback:AsyncCallback&lt;void&gt;): void;
``` ```
## AbilityContext.setMissionLabel ## UIAbilityContext.setMissionLabel
setMissionLabel(label: string): Promise&lt;void&gt;; setMissionLabel(label: string): Promise&lt;void&gt;;
...@@ -2030,7 +2030,7 @@ setMissionLabel(label: string): Promise&lt;void&gt;; ...@@ -2030,7 +2030,7 @@ setMissionLabel(label: string): Promise&lt;void&gt;;
console.log('failed:' + JSON.stringify(error)); console.log('failed:' + JSON.stringify(error));
}); });
``` ```
## AbilityContext.setMissionIcon ## UIAbilityContext.setMissionIcon
setMissionIcon(icon: image.PixelMap, callback:AsyncCallback\<void>): void; setMissionIcon(icon: image.PixelMap, callback:AsyncCallback\<void>): void;
...@@ -2072,7 +2072,7 @@ setMissionIcon(icon: image.PixelMap, callback:AsyncCallback\<void>): void; ...@@ -2072,7 +2072,7 @@ setMissionIcon(icon: image.PixelMap, callback:AsyncCallback\<void>): void;
``` ```
## AbilityContext.setMissionIcon ## UIAbilityContext.setMissionIcon
setMissionIcon(icon: image.PixelMap): Promise\<void>; setMissionIcon(icon: image.PixelMap): Promise\<void>;
...@@ -2121,7 +2121,7 @@ setMissionIcon(icon: image.PixelMap): Promise\<void>; ...@@ -2121,7 +2121,7 @@ setMissionIcon(icon: image.PixelMap): Promise\<void>;
console.log('-------------- setMissionIcon fail, err: -------------', err); console.log('-------------- setMissionIcon fail, err: -------------', err);
}); });
``` ```
## AbilityContext.restoreWindowStage ## UIAbilityContext.restoreWindowStage
restoreWindowStage(localStorage: LocalStorage) : void; restoreWindowStage(localStorage: LocalStorage) : void;
...@@ -2142,7 +2142,7 @@ restoreWindowStage(localStorage: LocalStorage) : void; ...@@ -2142,7 +2142,7 @@ restoreWindowStage(localStorage: LocalStorage) : void;
this.context.restoreWindowStage(storage); this.context.restoreWindowStage(storage);
``` ```
## AbilityContext.isTerminating ## UIAbilityContext.isTerminating
isTerminating(): boolean; isTerminating(): boolean;
......
# TriggerInfo # TriggerInfo
定义触发WantAgent所需要的的信息 作为[trigger](js-apis-app-ability-wantAgent.md#wantagenttrigger)的入参定义触发WantAgent所需要的的信息。
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...@@ -10,57 +10,3 @@ ...@@ -10,57 +10,3 @@
| want | Want | 否 | Want。 | | want | Want | 否 | Want。 |
| permission | string | 否 | 权限定义。 | | permission | string | 否 | 权限定义。 |
| extraInfo | {[key: string]: any} | 否 | 额外数据。 | | extraInfo | {[key: string]: any} | 否 | 额外数据。 |
**示例:**
```ts
import wantAgent from '@ohos.wantAgent';
let wantAgentInfo = {
wants: [
{
deviceId: "",
bundleName: "com.example.apicoverhaptest",
abilityName: "com.example.apicoverhaptest.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true.true,false}",
parameters: {
myKey0: 2222
}
}
],
operationType: wantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG],
extraInfo:{
"key": "value"
}
}
let triggerInfo = {
code: 0,
want: {
deviceId: "",
bundleName: "com.example.apicoverhaptest",
abilityName: "com.example.apicoverhaptest.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true.true,false}",
parameters: {
myKey0: 2222
}
},
permission: ""
extraInfo:{
"key": "value"
}
}
wantAgent.trigger(wantAgentInfo, triggerInfo).then((data) =>{
console.info("trigger data: " + JSON.stringify(data));
}).catch((err) => {
console.error("trigger err: " + JSON.stringify(err));
})
```
\ No newline at end of file
# WantAgentInfo # WantAgentInfo
定义触发WantAgent所需要的的信息 定义触发WantAgent所需要的信息,可以作为[getWantAgent](js-apis-app-ability-wantAgent.md#wantagentgetwantagent)的入参创建指定的WantAgent对象。
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
...@@ -11,36 +11,3 @@ ...@@ -11,36 +11,3 @@
| requestCode | number | 是 | 使用者定义的一个私有值。 | | requestCode | number | 是 | 使用者定义的一个私有值。 |
| wantAgentFlags | Array<[wantAgent.WantAgentFlags](js-apis-wantAgent.md#WantAgentFlags)> | 否 | 动作执行属性。 | | wantAgentFlags | Array<[wantAgent.WantAgentFlags](js-apis-wantAgent.md#WantAgentFlags)> | 否 | 动作执行属性。 |
| extraInfo | {[key: string]: any} | 否 | 额外数据。 | | extraInfo | {[key: string]: any} | 否 | 额外数据。 |
**示例:**
```ts
import wantAgent from '@ohos.wantAgent';
let wantAgentInfo = {
wants: [
{
deviceId: "",
bundleName: "com.example.apicoverhaptest",
abilityName: "com.example.apicoverhaptest.MainAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true.true,false}",
parameters: {
myKey0: 2222
}
}
],
operationType: wantAgent.OperationType.START_ABILITIES,
requestCode: 0,
wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG],
extraInfo:{
"key": "value"
}
}
wantAgent.getWantAgent(wantAgentInfo).then((data) =>{
console.info("getWantAgent data: " + JSON.stringify(data));
}).catch((err) => {
console.error("getWantAgent err: " + JSON.stringify(err));
})
```
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册