当前位置：首页 > article >正文

鸿蒙实战：使用隐式Want启动Ability

article 2025/2/23 6:20:52

文章目录

1. 实战概述
2. 实现步骤
- 2.1 创建鸿蒙应用项目
- 2.2 修改Index.ets代码
- 2.3 创建LuzhouAbility
- 2.4 创建Luzhou页面
- 2.5 设置模块配置文件
3. 测试效果
4. 实战总结

1. 实战概述

本次鸿蒙应用实战，先创建项目“ImplicitWantStartAbility”，接着修改Index.ets等代码构建页面与隐式Want逻辑，创建Luzhou相关文件及设置配置文件匹配条件，最终测试时点击按钮可隐式匹配，实现从首页跳转至泸州页面的效果。

2. 实现步骤

2.1 创建鸿蒙应用项目

创建鸿蒙应用项目 - ImplicitWantStartAbility
单击【Finish】按钮，生成应用基本框架

2.2 修改Index.ets代码

首页 - Index.ets

import { common, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';

const TAG: string = '[Page_Index]';
const DOMAIN_NUMBER: number = 0xFF00;

@Entry
@Component
struct Index {
  @State message: string = 'Index页面';
  private context = getContext(this) as common.UIAbilityContext;

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(40)
          .fontWeight(FontWeight.Bold)
          .foregroundColor(Color.Yellow)
          .margin('10')
        // 添加按钮
        Button('去泸州')
          .fontSize(40)
          .width(250)
          .height(70)
          .backgroundColor('#44dd22')
          .foregroundColor('#ffffff')
          .onClick(() => {
            // 创建隐式Want对象
            let wantInfo: Want = {
              action: 'action.huawei.luzhou',
              entities: ['entity.huawei.luzhou']
            };
            // context为调用方UIAbility的UIAbilityContext
            this.context.startAbility(wantInfo).then(() => {
              hilog.info(DOMAIN_NUMBER, TAG, 'startAbility success.');
            }).catch((error: BusinessError) => {
              hilog.error(DOMAIN_NUMBER, TAG, 'startAbility failed.');
            });
          });
      }
      .width('100%');
    }
    .height('100%')
    .backgroundColor('#00662F')
  }
}

代码说明：这段代码基于鸿蒙开发框架编写。Index组件构建页面，含文本与按钮。点击“去泸州”按钮时，构造含特定action与entities的隐式Want对象，通过上下文尝试启动对应能力，同时利用日志记录启动成功或失败情况，实现交互并监测启动结果。

2.3 创建LuzhouAbility

在ets里创建LuzhouAbility.ets
修改代码，将pages/Index改成pages/Luzhou

2.4 创建Luzhou页面

在pages里创建Luzhou.ets文件

@Entry
@Component
struct Luzhou {
  @State message: string = '泸州欢迎您';

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(40)
          .fontWeight(FontWeight.Bold)
          .foregroundColor(Color.Yellow)         
      }
      .width('100%');
    }
    .height('100%')
    .backgroundColor('#00008B')
  }
}

2.5 设置模块配置文件

模块配置文件 - module.json5
在LuzhouAbility里添加skills，设置匹配条件

{                                                              
  "name": "LuzhouAbility",                                     
  "srcEntry": "./ets/luzhouability/LuzhouAbility.ets",         
  "description": "$string:LuzhouAbility_desc",                 
  "icon": "$media:layered_image",                              
  "label": "$string:LuzhouAbility_label",                      
  "startWindowIcon": "$media:startIcon",                       
  "startWindowBackground": "$color:start_window_background",   
  "skills": [                                                  
    {                                                          
      "entities": [                                            
        "entity.huawei.luzhou"                                 
      ],                                                       
      "actions": [                                             
        "action.huawei.luzhou"                                 
      ]                                                        
    }                                                          
  ]                                                            
}