未验证 提交 63371136 编写于 作者: O openharmony_ci 提交者: Gitee

!5308 Update branch by cherry-pick of ability

Merge pull request !5308 from yuyaozhi/OpenHarmony-3.2-Beta1
# Context模块 # Context模块
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在FA模型下使用。
## 导入模块 ## 导入模块
......
# DataUriUtils模块 # DataUriUtils模块
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
......
# AbilityContext # AbilityContext
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
Ability的上下文环境,继承自Context。 Ability的上下文环境,继承自Context。
...@@ -55,7 +57,7 @@ startAbility(want: Want, callback: AsyncCallback<void>): void ...@@ -55,7 +57,7 @@ startAbility(want: Want, callback: AsyncCallback<void>): void
var want = { var want = {
"deviceId": "", "deviceId": "",
"bundleName": "com.extreme.test", "bundleName": "com.extreme.test",
"abilityName": "com.extreme.test.MainAbility" "abilityName": "MainAbility"
}; };
this.context.startAbility(want, (error) => { this.context.startAbility(want, (error) => {
console.log("error.code = " + error.code) console.log("error.code = " + error.code)
...@@ -85,7 +87,7 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void& ...@@ -85,7 +87,7 @@ startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void&
var want = { var want = {
"deviceId": "", "deviceId": "",
"bundleName": "com.extreme.test", "bundleName": "com.extreme.test",
"abilityName": "com.extreme.test.MainAbility" "abilityName": "MainAbility"
}; };
var options = { var options = {
windowMode: 0, windowMode: 0,
...@@ -123,7 +125,7 @@ startAbility(want: Want, options?: StartOptions): Promise<void>; ...@@ -123,7 +125,7 @@ startAbility(want: Want, options?: StartOptions): Promise<void>;
var want = { var want = {
"deviceId": "", "deviceId": "",
"bundleName": "com.extreme.test", "bundleName": "com.extreme.test",
"abilityName": "com.extreme.test.MainAbility" "abilityName": "MainAbility"
}; };
var options = { var options = {
windowMode: 0, windowMode: 0,
...@@ -374,7 +376,7 @@ startAbilityByCall(want: Want): Promise<Caller>; ...@@ -374,7 +376,7 @@ startAbilityByCall(want: Want): Promise<Caller>;
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
this.context.startAbilityByCall({ this.context.startAbilityByCall({
bundleName: "com.example.myservice", bundleName: "com.example.myservice",
abilityName: "com.example.myservice.MainAbility", abilityName: "MainAbility",
deviceId: "" deviceId: ""
}).then((obj) => { }).then((obj) => {
caller = obj; caller = obj;
......
# ErrorCode # ErrorCode
> **说明:**
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** >
> 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
``` ```
......
# wantConstant # wantConstant
> **说明:**
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** >
> 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
``` ```
import wantConstant from '@ohos.ability.wantConstant' import wantConstant from '@ohos.ability.wantConstant'
``` ```
## wantConstant.Action ## wantConstant.Action
**系统能力**:SystemCapability.Ability.AbilityBase **系统能力**:SystemCapability.Ability.AbilityBase
......
# AbilityDelegatorRegistry # AbilityDelegatorRegistry
> **说明** > **说明**
> >
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
...@@ -10,8 +10,6 @@ ...@@ -10,8 +10,6 @@
import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry' import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
``` ```
## AbilityLifecycleState ## AbilityLifecycleState
Ability生命周期状态。 Ability生命周期状态。
......
# AbilityRunningInfo # AbilityRunningInfo
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
Ability运行相关信息。 Ability运行相关信息。
## 导入模块 ## 导入模块
...@@ -11,13 +11,11 @@ Ability运行相关信息。 ...@@ -11,13 +11,11 @@ Ability运行相关信息。
```js ```js
import abilitymanager from '@ohos.application.abilityManager'; import abilitymanager from '@ohos.application.abilityManager';
``` ```
## 使用说明
## 使用说明
通过abilityManager中getAbilityRunningInfos方法获取。 通过abilityManager中getAbilityRunningInfos方法获取。
```js ```js
import abilitymanager from '@ohos.application.abilityManager'; import abilitymanager from '@ohos.application.abilityManager';
abilitymanager.getAbilityRunningInfos((err,data) => { abilitymanager.getAbilityRunningInfos((err,data) => {
......
# AbilityStageContext # AbilityStageContext
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
AbilityStage的上下文环境,继承自[Context](js-apis-application-context.md) AbilityStage的上下文环境,继承自[Context](js-apis-application-context.md)
...@@ -14,11 +15,8 @@ import AbilityStage from '@ohos.application.AbilityStage'; ...@@ -14,11 +15,8 @@ import AbilityStage from '@ohos.application.AbilityStage';
## 使用说明 ## 使用说明
通过AbilityStage实例来获取。 通过AbilityStage实例来获取。
```js ```js
import AbilityStage from '@ohos.application.AbilityStage'; import AbilityStage from '@ohos.application.AbilityStage';
class MyAbilityStage extends AbilityStage { class MyAbilityStage extends AbilityStage {
...@@ -28,7 +26,6 @@ class MyAbilityStage extends AbilityStage { ...@@ -28,7 +26,6 @@ class MyAbilityStage extends AbilityStage {
} }
``` ```
## 属性 ## 属性
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
......
# MissionSnapshot # MissionSnapshot
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
任务对应的任务快照。 任务对应的任务快照。
## 导入模块 ## 导入模块
``` ```
import abilitymanager from '@ohos.application.abilityManager'; import missionManager from '@ohos.application.missionManager'
``` ```
## 使用说明 ## 使用说明
使用前需要提前引入对应模块。 使用前需要提前引入对应模块。
......
...@@ -3,18 +3,15 @@ ...@@ -3,18 +3,15 @@
- [导入模块](#导入模块) - [导入模块](#导入模块)
- [属性](#属性) - [属性](#属性)
> **说明:**
>
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块接口仅可在Stage模型下使用。
StartOptions是系统的基本通信组件。 StartOptions是系统的基本通信组件。
## 导入模块 ## 导入模块
``` ```
import StartOptions from '@ohos.application.StartOptions'; import StartOptions from '@ohos.application.StartOptions';
``` ```
......
# Want # Want
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 8 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
Want是系统的基本通信组件。 Want是系统的基本通信组件。
## 导入模块 ## 导入模块
``` ```
import Want from '@ohos.application.Want'; import Want from '@ohos.application.Want';
``` ```
......
# Ability # Ability
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
Ability模块,提供对Ability生命周期、上下文环境等调用管理。 Ability模块,提供对Ability生命周期、上下文环境等调用管理。
...@@ -20,6 +22,8 @@ import Ability from '@ohos.application.Ability'; ...@@ -20,6 +22,8 @@ import Ability from '@ohos.application.Ability';
| context | [AbilityContext](js-apis-ability-context.md) | 是 | 否 | 上下文。 | | context | [AbilityContext](js-apis-ability-context.md) | 是 | 否 | 上下文。 |
| launchWant | [Want](js-apis-application-Want.md) | 是 | 否 | Ability启动时的参数。 | | launchWant | [Want](js-apis-application-Want.md) | 是 | 否 | Ability启动时的参数。 |
| lastRequestWant | [Want](js-apis-application-Want.md) | 是 | 否 | Ability最后请求时的参数。| | lastRequestWant | [Want](js-apis-application-Want.md) | 是 | 否 | Ability最后请求时的参数。|
| callee | [Callee](#callee) | 是 | 否 | 调用Stub(桩)服务对象。|
## Ability.onCreate ## Ability.onCreate
...@@ -261,7 +265,7 @@ onConfigurationUpdated(config: Configuration): void; ...@@ -261,7 +265,7 @@ onConfigurationUpdated(config: Configuration): void;
dump(params: Array\<string>): Array\<string>; dump(params: Array\<string>): Array\<string>;
指示from命令的参数 转储客户端信息时调用
**系统能力**:SystemCapability.Ability.AbilityRuntime.AbilityCore **系统能力**:SystemCapability.Ability.AbilityRuntime.AbilityCore
...@@ -269,7 +273,7 @@ dump(params: Array\<string>): Array\<string>; ...@@ -269,7 +273,7 @@ dump(params: Array\<string>): Array\<string>;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| params | Array\<string> | 是 | 指示from命令的参数。| | params | Array\<string> | 是 | 表示命令形式的参数。|
**示例:** **示例:**
...@@ -341,7 +345,7 @@ call(method: string, data: rpc.Sequenceable): Promise&lt;void&gt;; ...@@ -341,7 +345,7 @@ call(method: string, data: rpc.Sequenceable): Promise&lt;void&gt;;
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
this.context.startAbilityByCall({ this.context.startAbilityByCall({
bundleName: "com.example.myservice", bundleName: "com.example.myservice",
abilityName: "com.example.myservice.MainAbility", abilityName: "MainAbility",
deviceId: "" deviceId: ""
}).then((obj) => { }).then((obj) => {
caller = obj; caller = obj;
...@@ -414,7 +418,7 @@ callWithResult(method: string, data: rpc.Sequenceable): Promise&lt;rpc.MessagePa ...@@ -414,7 +418,7 @@ callWithResult(method: string, data: rpc.Sequenceable): Promise&lt;rpc.MessagePa
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
this.context.startAbilityByCall({ this.context.startAbilityByCall({
bundleName: "com.example.myservice", bundleName: "com.example.myservice",
abilityName: "com.example.myservice.MainAbility", abilityName: "MainAbility",
deviceId: "" deviceId: ""
}).then((obj) => { }).then((obj) => {
caller = obj; caller = obj;
...@@ -453,7 +457,7 @@ release(): void; ...@@ -453,7 +457,7 @@ release(): void;
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
this.context.startAbilityByCall({ this.context.startAbilityByCall({
bundleName: "com.example.myservice", bundleName: "com.example.myservice",
abilityName: "com.example.myservice.MainAbility", abilityName: "MainAbility",
deviceId: "" deviceId: ""
}).then((obj) => { }).then((obj) => {
caller = obj; caller = obj;
...@@ -475,7 +479,7 @@ release(): void; ...@@ -475,7 +479,7 @@ release(): void;
onRelease(callback: OnReleaseCallBack): void; onRelease(callback: OnReleaseCallBack): void;
注册通用组件服务端Stub断开监听通知。 注册通用组件服务端Stub(桩)断开监听通知。
**系统能力**:SystemCapability.Ability.AbilityRuntime.AbilityCore **系统能力**:SystemCapability.Ability.AbilityRuntime.AbilityCore
...@@ -494,7 +498,7 @@ onRelease(callback: OnReleaseCallBack): void; ...@@ -494,7 +498,7 @@ onRelease(callback: OnReleaseCallBack): void;
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
this.context.startAbilityByCall({ this.context.startAbilityByCall({
bundleName: "com.example.myservice", bundleName: "com.example.myservice",
abilityName: "com.example.myservice.MainAbility", abilityName: "MainAbility",
deviceId: "" deviceId: ""
}).then((obj) => { }).then((obj) => {
caller = obj; caller = obj;
......
...@@ -3,22 +3,19 @@ ...@@ -3,22 +3,19 @@
- [导入模块](#导入模块) - [导入模块](#导入模块)
- [属性](#属性) - [属性](#属性)
> **说明:**
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** >
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
启动参数的接口. 启动参数的接口.
## 导入模块 ## 导入模块
```js ```js
import AbilityConstant from '@ohos.application.AbilityConstant'; import AbilityConstant from '@ohos.application.AbilityConstant';
``` ```
## 属性 ## 属性
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
......
# AbilityDelegator # AbilityDelegator
> **说明** > **说明**
> >
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
...@@ -10,8 +10,6 @@ ...@@ -10,8 +10,6 @@
import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry' import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
``` ```
## AbilityDelegator ## AbilityDelegator
### addAbilityMonitor<sup>9+</sup> ### addAbilityMonitor<sup>9+</sup>
......
# AbilityDelegatorArgs # AbilityDelegatorArgs
> **说明** > **说明**
> >
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
...@@ -10,8 +10,6 @@ ...@@ -10,8 +10,6 @@
import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry' import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
``` ```
## AbilityDelegatorArgs ## AbilityDelegatorArgs
测试参数信息 测试参数信息
......
# AbilityLifecycleCallback # AbilityLifecycleCallback
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
应用上下文ApplicationContext的生命周期监听方法的回调类,里面提供了onAbilityCreate、onAbilityWindowStageCreate、onAbilityWindowStageDestroy等方法。 应用上下文ApplicationContext的生命周期监听方法的回调类,里面提供了onAbilityCreate、onAbilityWindowStageCreate、onAbilityWindowStageDestroy等方法。
......
# AbilityMonitor # AbilityMonitor
> **说明** > **说明**
> >
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
...@@ -10,8 +10,6 @@ ...@@ -10,8 +10,6 @@
import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry' import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
``` ```
## AbilityMonitor ## AbilityMonitor
Ability监听器 Ability监听器
......
# AbilityStage # AbilityStage
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
AbilityStage是HAP包的运行时类。在HAP加载的时候,通知开发者,开发者可以在此进行该HAP的初始化(如资源预加载,线程创建等)。 AbilityStage是HAP包的运行时类。在HAP加载的时候,通知开发者,开发者可以在此进行该HAP的初始化(如资源预加载,线程创建等)。
## 导入模块 ## 导入模块
```js ```js
import AbilityStage from '@ohos.application.AbilityStage'; import AbilityStage from '@ohos.application.AbilityStage';
``` ```
...@@ -22,8 +21,6 @@ onCreate(): void ...@@ -22,8 +21,6 @@ onCreate(): void
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core **系统能力**:SystemCapability.Ability.AbilityRuntime.Core
**示例:** **示例:**
```js ```js
...@@ -92,6 +89,8 @@ onConfigurationUpdated(config: Configuration): void; ...@@ -92,6 +89,8 @@ onConfigurationUpdated(config: Configuration): void;
``` ```
## AbilityStage.context ## AbilityStage.context
context: AbilityStageContext;
指示有关上下文的配置信息。 指示有关上下文的配置信息。
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core **系统能力**:SystemCapability.Ability.AbilityRuntime.Core
......
# ApplicationContext # ApplicationContext
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
提供开发者应用级别的的上下文,提供注册及取消注册应用内组件生命周期的监听接口。 提供开发者应用级别的的上下文,提供注册及取消注册应用内组件生命周期的监听接口。
## 导入模块
```
import Ability from '@ohos.application.Ability';
```
## 使用说明 ## 使用说明
......
# Context # Context
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
提供开发者运行代码的上下文环境,包括应用信息、ResourceManager等信息。 提供开发者运行代码的上下文环境,包括应用信息、ResourceManager等信息。
......
# MissionInfo # MissionInfo
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
...@@ -9,7 +10,6 @@ ...@@ -9,7 +10,6 @@
import MissionInfo from '@ohos.application.missionInfo' import MissionInfo from '@ohos.application.missionInfo'
``` ```
## MissionInfo ## MissionInfo
表示Ability对应任务信息的枚举。 表示Ability对应任务信息的枚举。
......
# ShellCmdResult # ShellCmdResult
> **说明** > **说明**
> >
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
...@@ -10,8 +10,6 @@ ...@@ -10,8 +10,6 @@
import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry' import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
``` ```
## ShellCmdResult ## ShellCmdResult
Shell命令执行结果 Shell命令执行结果
......
# StaticSubscriberExtensionAbility # StaticSubscriberExtensionAbility
> **说明:**
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** >
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
## 导入模块 ## 导入模块
``` ```
......
# appManager # appManager
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
......
# Configuration # Configuration
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
环境变化信息。 环境变化信息。
## 导入模块 ## 导入模块
```js ```js
import Configuration from '@ohos.application.Configuration'; import Configuration from '@ohos.application.Configuration';
``` ```
## 属性 ## 属性
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
......
# ConfigurationConstant # ConfigurationConstant
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
......
# DataAbilityHelper模块(JS端SDK接口) # DataAbilityHelper模块(JS端SDK接口)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在FA模型下使用。
## 导入模块 ## 导入模块
......
# EventHub # EventHub
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
事件中心,提供订阅、取消订阅、触发事件能力。 事件中心,提供订阅、取消订阅、触发事件能力。
...@@ -14,11 +15,8 @@ import Ability from '@ohos.application.Ability' ...@@ -14,11 +15,8 @@ import Ability from '@ohos.application.Ability'
## 使用说明 ## 使用说明
​在使用eventHub的功能前,需要通过Ability实例的成员变量context获取。 ​在使用eventHub的功能前,需要通过Ability实例的成员变量context获取。
```js ```js
import Ability from '@ohos.application.Ability' import Ability from '@ohos.application.Ability'
export default class MainAbility extends Ability { export default class MainAbility extends Ability {
......
# ExtensionContext # ExtensionContext
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
## 导入模块
```js ```js
import DataShareExtensionAbility from '@ohos.application.DataShareExtensionAbility'; import DataShareExtensionAbility from '@ohos.application.DataShareExtensionAbility';
``` ```
## 使用说明
Extension的上下文环境,继承自Context。 Extension的上下文环境,继承自Context。
## 属性 ## 属性
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core **系统能力**:SystemCapability.Ability.AbilityRuntime.Core
......
# ExtensionRunningInfo # ExtensionRunningInfo
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
Extension运行相关信息。 Extension运行相关信息。
## 导入模块 ## 导入模块
...@@ -14,11 +14,8 @@ import abilitymanager from '@ohos.application.abilityManager'; ...@@ -14,11 +14,8 @@ import abilitymanager from '@ohos.application.abilityManager';
## 使用说明 ## 使用说明
通过abilityManager中方法获取。 通过abilityManager中方法获取。
```js ```js
import abilitymanager from '@ohos.application.abilityManager'; import abilitymanager from '@ohos.application.abilityManager';
let upperLimit=1 let upperLimit=1
......
# FeatureAbility模块(JS端SDK接口) # FeatureAbility模块(JS端SDK接口)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在FA模型下使用。
## 使用限制 ## 使用限制
...@@ -918,7 +920,6 @@ featureAbility.AbilityStartSetting.BOUNDS_KEY ...@@ -918,7 +920,6 @@ featureAbility.AbilityStartSetting.BOUNDS_KEY
| ------------------- | ---- | -------------------- | ---- | -------------------------------------- | | ------------------- | ---- | -------------------- | ---- | -------------------------------------- |
| want | 只读 | [Want](js-apis-application-Want.md) | 是 | 表示需要包含有关目标启动能力的信息。 | | want | 只读 | [Want](js-apis-application-Want.md) | 是 | 表示需要包含有关目标启动能力的信息。 |
| abilityStartSetting | 只读 | {[key: string]: any} | 否 | 表示能力的特殊属性,当开发者启动能力时,该属性可以作为调用中的输入参数传递。 | | abilityStartSetting | 只读 | {[key: string]: any} | 否 | 表示能力的特殊属性,当开发者启动能力时,该属性可以作为调用中的输入参数传递。 |
|
## flags说明 ## flags说明
......
# FormInfo # FormInfo
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
卡片信息。 卡片信息。
......
# 卡片数据绑定类 # 卡片数据绑定类
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
......
# FormError # FormError
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
卡片错误码。 卡片错误码。
......
# FormExtension # FormExtension
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
提供FormExtension卡片扩展相关接口。 提供FormExtension卡片扩展相关接口。
...@@ -227,7 +229,7 @@ onConfigurationUpdated(config: Configuration): void; ...@@ -227,7 +229,7 @@ onConfigurationUpdated(config: Configuration): void;
onAcquireFormState?(want: Want): formInfo.FormState; onAcquireFormState?(want: Want): formInfo.FormState;
返回formInfo#FormState对象 卡片提供方接收查询卡片状态通知接口。默认返回卡片初始状态
**系统能力**:SystemCapability.Ability.Form **系统能力**:SystemCapability.Ability.Form
...@@ -235,7 +237,7 @@ onAcquireFormState?(want: Want): formInfo.FormState; ...@@ -235,7 +237,7 @@ onAcquireFormState?(want: Want): formInfo.FormState;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| want | [Want](js-apis-application-Want.md) | 否 | 返回formInfo#FormState对象。 | | want | [Want](js-apis-application-Want.md) | 否 | want表示获取卡片状态的描述。描述包括包名称、能力名称、模块名称、卡片名和卡片维度。 |
**示例:** **示例:**
......
# FormExtensionContext # FormExtensionContext
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
FormExtension的上下文环境,提供FormExtension具有的能力和接口,继承自ExtensionContext。 FormExtension的上下文环境,提供FormExtension具有的能力和接口,继承自ExtensionContext。
......
# FormHost # FormHost
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
卡片使用方相关接口。 卡片使用方相关接口。
......
# FormProvider # FormProvider
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
卡片提供方相关接口。 卡片提供方相关接口。
......
# missionManager # missionManager
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
missionManager模块提供系统任务管理能力,开发者可以对系统任务执行锁定、解锁、清理、切换到前台等操作。 missionManager模块提供系统任务管理能力,开发者可以对系统任务执行锁定、解锁、清理、切换到前台等操作。
......
# particleAbility模块 # particleAbility模块
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在FA模型下使用。
## 使用限制 ## 使用限制
......
# PermissionRequestResult # PermissionRequestResult
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
权限请求结果。 权限请求结果。
...@@ -12,6 +13,29 @@ ...@@ -12,6 +13,29 @@
import Ability from '@ohos.application.Ability' import Ability from '@ohos.application.Ability'
``` ```
## 使用说明
通过AbilityContext实例来获取。
```js
import Ability from '@ohos.application.Ability'
export default class MainAbility extends Ability {
onWindowStageCreate(windowStage) {
var permissions=['com.example.permission']
var permissionRequestResult;
this.context.requestPermissionsFromUser(permissions,(err,result) => {
if(err){
console.log('requestPermissionsFromUserError: ' + JSON.stringify(err));
}else{
permissionRequestResult=result;
console.log('permissionRequestResult: ' + JSON.stringify(permissionRequestResult));
}
});
}
}
```
## 属性 ## 属性
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core **系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
......
# ProcessRunningInfo # ProcessRunningInfo
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
进程运行信息。 进程运行信息。
## 导入模块 ## 导入模块
...@@ -14,11 +14,8 @@ import appManager from '@ohos.application.appManager' ...@@ -14,11 +14,8 @@ import appManager from '@ohos.application.appManager'
## 使用说明 ## 使用说明
通过appManager来获取。 通过appManager来获取。
```js ```js
import appManager from '@ohos.application.appManager'; import appManager from '@ohos.application.appManager';
appManager.getProcessRunningInfos((error,data) => { appManager.getProcessRunningInfos((error,data) => {
......
# ServiceExtensionAbility # ServiceExtensionAbility
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
提供ServiceExtension服务扩展相关接口。 提供ServiceExtension服务扩展相关接口。
## 导入模块 ## 导入模块
``` ```
import ServiceExtension from '@ohos.application.ServiceExtensionAbility'; import ServiceExtension from '@ohos.application.ServiceExtensionAbility';
``` ```
## 权限 ## 权限
## 属性 ## 属性
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core **系统能力**:SystemCapability.Ability.AbilityRuntime.Core
......
# ServiceExtensionContext # ServiceExtensionContext
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 >
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块接口仅可在Stage模型下使用。
ServiceExtension的上下文环境,提供ServiceExtension具有的能力和接口,继承自ExtensionContext。 ServiceExtension的上下文环境,提供ServiceExtension具有的能力和接口,继承自ExtensionContext。
## 导入模块 ## 导入模块
``` ```
...@@ -36,7 +36,7 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void; ...@@ -36,7 +36,7 @@ startAbility(want: Want, callback: AsyncCallback&lt;void&gt;): void;
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
let want = { let want = {
"bundleName": "com.example.myapp", "bundleName": "com.example.myapp",
"abilityName": "com.example.myapp.MyAbility"}; "abilityName": "MyAbility"};
this.context.startAbility(want, (err) => { this.context.startAbility(want, (err) => {
console.log('startAbility result:' + JSON.stringify(err)); console.log('startAbility result:' + JSON.stringify(err));
}); });
...@@ -74,7 +74,7 @@ startAbility(want: Want): Promise&lt;void&gt;; ...@@ -74,7 +74,7 @@ startAbility(want: Want): Promise&lt;void&gt;;
onWindowStageCreate(windowStage) { onWindowStageCreate(windowStage) {
let want = { let want = {
"bundleName": "com.example.myapp", "bundleName": "com.example.myapp",
"abilityName": "com.example.myapp.MyAbility" "abilityName": "MyAbility"
}; };
this.context.startAbility(want).then((data) => { this.context.startAbility(want).then((data) => {
console.log('success:' + JSON.stringify(data)); console.log('success:' + JSON.stringify(data));
...@@ -175,7 +175,7 @@ connectAbility(want: Want, options: ConnectOptions): number; ...@@ -175,7 +175,7 @@ connectAbility(want: Want, options: ConnectOptions): number;
```js ```js
let want = { let want = {
"bundleName": "com.example.myapp", "bundleName": "com.example.myapp",
"abilityName": "com.example.myapp.MyAbility" "abilityName": "MyAbility"
}; };
let options = { let options = {
onConnect: function(elementName, proxy) {}, onConnect: function(elementName, proxy) {},
......
# TestRunner # TestRunner
> **说明** > **说明**
> >
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
......
# uriPermissionManager # uriPermissionManager
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > **说明:**
>
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
......
# WantAgent模块 # WantAgent模块
>**说明:** > **说明:**
> >
>本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块 ## 导入模块
...@@ -914,7 +914,7 @@ WantAgent.equal(wantAgent1, wantAgent2).then((data) => { ...@@ -914,7 +914,7 @@ WantAgent.equal(wantAgent1, wantAgent2).then((data) => {
}); });
``` ```
## WantAgent.getOperationType ## WantAgent.getOperationType<sup>9+</sup>
getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void; getOperationType(agent: WantAgent, callback: AsyncCallback\<number>): void;
...@@ -975,7 +975,7 @@ WantAgent.getOperationType(wantAgent, (OperationType) => { ...@@ -975,7 +975,7 @@ WantAgent.getOperationType(wantAgent, (OperationType) => {
}) })
``` ```
## WantAgent.getOperationType ## WantAgent.getOperationType<sup>9+</sup>
getOperationType(agent: WantAgent): Promise\<number>; getOperationType(agent: WantAgent): Promise\<number>;
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册