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

!2503 update zh-cn/application-dev/ability/fa-serviceability.md

Merge pull request !2503 from 时睿/master
......@@ -46,7 +46,7 @@
2.注册Service。
Service也需要在应用配置文件config.json中进行注册,注册类型type需要设置为service。
```javascript
{
"module": {
......@@ -64,17 +64,18 @@
}
```
### 启动Service<a name="section944219415599"></a>
Ability为开发者提供了startAbility()方法来启动另外一个Ability。因为Service也是Ability的一种,开发者同样可以通过将Want传递给该方法来启动Service。
开发者可以通过构造包含BundleName与AbilityName的Want对象来设置目标Service信息。参数的含义如下:
开发者可以通过构造包含bundleName与abilityName的Want对象来设置目标Service信息。参数的含义如下:
- BundleName:表示包名称。
- AbilityName:表示待启动的Ability名称。
- bundleName:表示包名称。
- abilityName:表示待启动的Ability名称。
启动本地设备Service的代码示例如下:
......@@ -95,7 +96,9 @@ var promise = await featureAbility.startAbility(
- 如果Service尚未运行,则系统会先调用onStart()来初始化Service,再回调Service的onCommand()方法来启动Service。
- 如果Service正在运行,则系统会直接回调Service的onCommand()方法来启动Service。
- 停止Service
### 停止Service
Service一旦创建就会一直保持在后台运行,除非必须回收内存资源,否则系统不会停止或销毁Service。开发者可以在Service中通过terminateSelf()停止本Service或在其他Ability调用stopAbility()来停止Service。
......
......@@ -880,9 +880,9 @@ getApplicationContext(): Context
**返回值:**
| 参数 | 类型 | 说明 |
| --------------- | ------------------------- |------ |
| Context | Context |返回应用版本信息。 |
| 类型 | 说明 |
| --------- |------ |
| Context |返回应用上下文信息。 |
**示例:**
......@@ -908,7 +908,7 @@ var context = featureAbility.getContext().getApplicationContext();
| ----------- | -------- | -------------- | ---- | ------------------ |
| requestCode | 只读 | number | 是 | 用户传入的请求代码。 |
| permissions | 只读 | Array\<string> | 是 | 用户传入的权限。 |
| authResults | 只读 | Array\<number> | 是 | 求权限的结果。 |
| authResults | 只读 | Array\<number> | 是 | 请求权限的结果。 |
## HapModuleInfo
......
......@@ -652,15 +652,15 @@ featureAbility.disconnectAbility(connId).then((error,data)=>{
getWindow(callback: AsyncCallback\<window.Window>): void
获取当前技能对应的窗口(callback形式)。
获取当前Ability对应的窗口(callback形式)。
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | ----------------------------- | ---- | ------------- |
| callback | AsyncCallback\<window.Window> | 是 | 返回与当前能力对应的窗口。 |
| 名称 | 类型 | 必填 | 描述 |
| -------- | ----------------------------- | ---- | ----------------------------- |
| callback | AsyncCallback\<window.Window> | 是 | 返回与当前Ability对应的窗口。 |
**示例:**
......@@ -672,15 +672,15 @@ featureAbility.getWindow()
getWindow(): Promise\<window.Window>;
获取当前技能对应的窗口(Promise形式)。
获取当前Ability对应的窗口(Promise形式)。
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
**返回值:**
| 类型 | 说明 |
| ----------------------- | ------------- |
| Promise\<window.Window> | 返回与当前能力对应的窗口。 |
| 类型 | 说明 |
| ----------------------- | ----------------------------- |
| Promise\<window.Window> | 返回与当前Ability对应的窗口。 |
**示例:**
......@@ -914,19 +914,19 @@ featureAbility.AbilityStartSetting.BOUNDS_KEY
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityBase
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| -------------------------------- | ---- | -------------------- | ---- | ---------------------------------------- |
| deviceId | 只读 | string | 否 | 表示运行指定Ability的设备ID。 |
| bundleName | 只读 | string | 否 | 表示包描述。如果在Want中同时指定了BundleName和AbilityName,则Want可以直接匹配到指定的Ability。 |
| abilityName | 只读 | string | 否 | 表示待启动的Ability名称。如果在Want中同时指定了BundleName和AbilityName,则Want可以直接匹配到指定的Ability。 |
| uri | 只读 | string | 否 | 表示Uri描述。如果在Want中指定了Uri,则Want将匹配指定的Uri信息,包括scheme, schemeSpecificPart, authority和path信息。 |
| type | 只读 | string | 否 | 表示MIME type类型描述,比如:"text/plain" 、 "image/*"等。 |
| flags | 只读 | number | 否 | 表示处理Want的方式。默认传数字,具体参考:[flags说明](#flags说明)。 |
| action | 只读 | string | 否 | 表示action选项描述。 |
| parameters | 只读 | {[key: string]: any} | 否 | 表示WantParams描述。 |
| entities | 只读 | Array\<string> | 否 | 表示entities相关描述。 |
| extensionAbilityName<sup>9+<sup> | 只读 | string | 否 | Want中扩展能力名称的描述。 |
| extensionAbilityType<sup>9+<sup> | 只读 | number | 否 | 需求中扩展能力类型的描述。 |
| 名称 | 读写属性 | 类型 | 必填 | 描述 |
| -------------------------------- | -------- | -------------------- | ---- | ------------------------------------------------------------ |
| deviceId | 只读 | string | 否 | 表示运行指定Ability的设备ID。 |
| bundleName | 只读 | string | 否 | 表示包描述。如果在Want中同时指定了BundleName和AbilityName,则Want可以直接匹配到指定的Ability。 |
| abilityName | 只读 | string | 否 | 表示待启动的Ability名称。如果在Want中同时指定了BundleName和AbilityName,则Want可以直接匹配到指定的Ability。 |
| uri | 只读 | string | 否 | 表示Uri描述。如果在Want中指定了Uri,则Want将匹配指定的Uri信息,包括scheme, schemeSpecificPart, authority和path信息。 |
| type | 只读 | string | 否 | 表示MIME type类型描述,比如:"text/plain" 、 "image/*"等。 |
| flags | 只读 | number | 否 | 表示处理Want的方式。默认传数字,具体参考:[flags说明](#flags说明)。 |
| action | 只读 | string | 否 | 表示action选项描述。 |
| parameters | 只读 | {[key: string]: any} | 否 | 表示WantParams描述。 |
| entities | 只读 | Array\<string> | 否 | 表示entities相关描述。 |
| extensionAbilityName<sup>9+<sup> | 只读 | string | 否 | Want中扩展能力名称的描述。 |
| extensionAbilityType<sup>9+<sup> | 只读 | number | 否 | Want中扩展能力类型的描述。 |
## flags说明
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册