• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 启动ServiceAbility
2<!--Kit: Ability Kit-->
3<!--Subsystem: Ability-->
4<!--Owner: @xialiangwei-->
5<!--Designer: @jsjzju-->
6<!--Tester: @lixueqing513-->
7<!--Adviser: @huipeizi-->
8<!--deprecated_code_no_check-->
9
10ServiceAbility的启动与其他Ability并无区别，应用开发者可以在PageAbility中通过featureAbility的startAbility接口拉起ServiceAbility，在ServiceAbility中通过particleAbility的startAbility接口拉起ServiceAbility。ServiceAbility的启动规则详见[组件启动规则](component-startup-rules.md)章节。
11
12
13如下示例展示了在PageAbility中通过startAbility启动bundleName为"com.example.myapplication"，abilityName为"ServiceAbility"的ServiceAbility的方法。启动FA模型的ServiceAbility时，需要在abilityName前拼接bundleName字符串。
14
15```ts
16import featureAbility from '@ohos.ability.featureAbility';
17import Want from '@ohos.app.ability.Want';
18import promptAction from '@ohos.promptAction';
19import hilog from '@ohos.hilog';
20
21const TAG: string = 'PageServiceAbility';
22const domain: number = 0xFF00;
23
24@Entry
25@Component
26struct PageServiceAbility {
27  async startServiceAbility(): Promise<void> {
28    try {
29      hilog.info(domain, TAG, 'Begin to start ability');
30      let want: Want = {
31        bundleName: 'com.samples.famodelabilitydevelop',
32        abilityName: 'com.samples.famodelabilitydevelop.ServiceAbility'
33      };
34      await featureAbility.startAbility({ want });
35      promptAction.showToast({
36        message: 'start_service_success_toast'
37      });
38      hilog.info(domain, TAG, `Start ability succeed`);
39    } catch (error) {
40      hilog.error(domain, TAG, 'Start ability failed with ' + error);
41    }
42  }
43  build() {
44    // ...
45  }
46}
47```
48
49
50执行上述代码后，Ability将通过[`startAbility()`](../reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#startability)方法来启动ServiceAbility。
51
52
53- 如果ServiceAbility尚未运行，则系统会先调用onStart()来初始化ServiceAbility，再回调Service的onCommand()方法来启动ServiceAbility。
54
55- 如果ServiceAbility正在运行，则系统会直接回调ServiceAbility的onCommand()方法来启动ServiceAbility。
56