使用显式Want启动Ability

2024-01-25 12:25 更新

在应用使用场景中,当用户点击某个按钮时,应用经常需要拉起指定UIAbility组件来完成某些特定任务。下面介绍如何通过显式Want拉起应用内一个指定UIAbility组件。

开发步骤

  1. Stage模型工程内,创建一个Ability(此示例内命名为callerAbility)与相应Page(此示例中名为Index.ets),并在callerAbility.ts文件内的onWindowStageCreate函数内通过windowStage.loadContent()方法将两者绑定。

    1. // ...
    2. // callerAbility.ts
    3. onWindowStageCreate(windowStage) {
    4. // Main window is created, set main page for this ability
    5. console.info('[Demo] EntryAbility onWindowStageCreate')
    6. // Bind callerAbility with a paged named Index
    7. windowStage.loadContent('pages/Index')
    8. }
    9. // ...
  2. 同上方法再创建一个Ability,此示例内命名为“calleeAbility”。

  3. 在callerAbility的“Index.ets”页面内新增一个按钮。

    1. // ...
    2. build() {
    3. Row() {
    4. Column() {
    5. Text('hello')
    6. .fontSize(50)
    7. .fontWeight(FontWeight.Bold)
    8. // A new button with will call explicitStartAbility() when clicked.
    9. Button("CLICKME")
    10. .onClick(this.explicitStartAbility) // explicitStartAbility见下面示例代码
    11. // ...
    12. }
    13. .width('100%')
    14. }
    15. .height('100%')
    16. }
    17. // ...
  4. 补充相对应的onClick方法,并使用显式Want在方法内启动calleeAbility。bundleName字段可在工程AppScope>app.json5文件内获取;abilityName可在对应模块内的“yourModuleName > src > main > module.json5”文件查看。

    1. import common from '@ohos.app.ability.common';
    2. // ...
    3. async explicitStartAbility() {
    4. try {
    5. // Explicit want with abilityName specified.
    6. let want = {
    7. deviceId: "",
    8. bundleName: "com.example.myapplication",
    9. abilityName: "calleeAbility"
    10. };
    11. let context = getContext(this) as common.UIAbilityContext;
    12. await context.startAbility(want);
    13. console.info(`explicit start ability succeed`);
    14. } catch (error) {
    15. console.info(`explicit start ability failed with ${error.code}`);
    16. }
    17. }
    18. // ...
  5. 至此,当您点击CLICKME按钮时,应看到页面的跳转。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号