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

文章目录

[1. 实战概述](#1. 实战概述)
[2. 实现步骤](#2. 实现步骤)
- [2.1 创建鸿蒙应用项目](#2.1 创建鸿蒙应用项目)
- [2.2 修改Index.ets代码](#2.2 修改Index.ets代码)
- [2.3 创建SecondAbility](#2.3 创建SecondAbility)
- [2.4 创建Second.ets](#2.4 创建Second.ets)
[3. 测试效果](#3. 测试效果)
[4. 实战总结](#4. 实战总结)
[5. 拓展练习 - 启动文件管理器](#5. 拓展练习 - 启动文件管理器)
- [5.1 创建鸿蒙应用项目](#5.1 创建鸿蒙应用项目)
- [5.2 修改Index.ets代码](#5.2 修改Index.ets代码)
- [5.3 测试应用运行效果](#5.3 测试应用运行效果)

1. 实战概述

本实战详细阐述了在 HarmonyOS 上开发应用的过程，包括创建项目、修改页面代码、创建 Ability 以及页面间的数据传递。首先，通过 DevEco Studio 创建名为 WantStartAbility 的鸿蒙项目。接着，对 Index.ets 页面进行编码，实现点击按钮后通过 Want 对象显式启动 SecondAbility 并传递参数。然后，创建 SecondAbility 类，在其 onCreate 方法中接收参数并存储在全局变量中。最后，通过 Second.ets 页面组件展示从 SecondAbility 获取的数据。整个流程涵盖了从项目初始化到具体编码实践的完整开发周期。

2. 实现步骤

2.1 创建鸿蒙应用项目

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

2.2 修改Index.ets代码

首页 - pages/Index.ets

ts 复制代码

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(150)
          .height(70)
          .backgroundColor('#44dd22')
          .foregroundColor('#ffffff')
          .onClick(() => {
            // 创建显式 Want 对象
            let wantInfo: Want = {
              deviceId: '', // deviceId 为空表示本设备
              bundleName: 'net.huawei.wsa', // 目标应用的包名
              abilityName: 'SecondAbility', // 目标 Ability 的名称
              parameters: {
                id: '20240101',
                name: '陈燕文',
                gender: '女',
                age: 19,
                major: '软件技术专业',
                class: '2024软件1班',
                telephone: '15893451170'
              },
            };

            // 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')
  }
}

代码说明 ：这段代码定义了一个名为 Second 的页面组件，使用 HarmonyOS 的 ArkUI 框架。页面包含一个文本显示和一个按钮，点击按钮后，通过 Want 对象显式启动名为 SecondAbility 的 Ability，并传递一系列参数。页面背景为深绿色（#00662F），文本为黄色加粗。启动 Ability 后，通过日志记录操作结果。

2.3 创建SecondAbility

在src/main/ets里创建SecondAbility
单击【Finish】按钮
创建完成之后，会自动在module.json5文件中注册该Ability
修改代码，将pages/Index改成pages/Second，接收传递来的参数，并写入全局变量

ts 复制代码

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window } from '@kit.ArkUI';

// 定义Student接口
interface Student {
  id: string,
  name: string,
  gender: string,
  age: number,
  major: string,
  class: string,
  telephone: string
}

export default class SecondAbility extends UIAbility {
  // 定义Student对象
  static student: Student = {id: '', name: '', gender: '', age: 0, major: '', class: '', telephone: ''};

  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
    // 接收调用方UIAbility传过来的参数
    let secondAbilityWant = want;
    SecondAbility.student.id = secondAbilityWant?.parameters?.id as string;
    SecondAbility.student.name = secondAbilityWant?.parameters?.name as string;
    SecondAbility.student.gender = secondAbilityWant?.parameters?.gender as string;
    SecondAbility.student.age = secondAbilityWant?.parameters?.age as number;
    SecondAbility.student.major = secondAbilityWant?.parameters?.major as string;
    SecondAbility.student.class = secondAbilityWant?.parameters?.class as string;
    SecondAbility.student.telephone = secondAbilityWant?.parameters?.telephone as string;
  }

  onDestroy(): void {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onDestroy');
  }

  onWindowStageCreate(windowStage: window.WindowStage): void {
    // Main window is created, set main page for this ability
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');

    windowStage.loadContent('pages/Second', (err) => {
      if (err.code) {
        hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
        return;
      }
      hilog.info(0x0000, 'testTag', 'Succeeded in loading the content.');
    });
  }

  onWindowStageDestroy(): void {
    // Main window is destroyed, release UI related resources
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageDestroy');
  }

  onForeground(): void {
    // Ability has brought to foreground
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onForeground');
  }

  onBackground(): void {
    // Ability has back to background
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onBackground');
  }
}

代码说明 ：这段代码定义了 SecondAbility 类，继承自 UIAbility，用于管理应用的窗口和生命周期。在 onCreate 方法中，它接收启动参数并存储在静态 student 对象中。代码还包含了日志记录和页面加载逻辑，确保在窗口阶段创建时加载 pages/Second 页面。此外，定义了一个 Student 接口来描述接收的学生信息结构。

2.4 创建Second.ets

在pages里创建Second.ets文件

ts 复制代码

import SecondAbility from '../secondability/SecondAbility';

@Entry
@Component
struct Second {
  @State message: string = 'Second页面';
  @State student: string = '';

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(40)
          .fontWeight(FontWeight.Bold)
          .foregroundColor(Color.Yellow)
          .margin('10')
        Text(this.student)
          .fontSize(30)
          .fontWeight(FontWeight.Bold)
          .foregroundColor(Color.Green)
          .margin('10')
        Button('接收')
          .fontSize(40)
          .width(150)
          .height(70)
          .backgroundColor('#44dd22')
          .foregroundColor('#ffffff')
          .onClick(() => {
            // 获取来自SecondAbility的数据
            let student: string = '学号：' + SecondAbility.student.id + '\n'
              + '姓名：' + SecondAbility.student.name + '\n'
              + '性别：' + SecondAbility.student.gender + '\n'
              + '年龄：' + SecondAbility.student.age + '\n'
              + '专业：' + SecondAbility.student.major + '\n'
              + '班级：' + SecondAbility.student.class + '\n'
              + '手机：' + SecondAbility.student.telephone;
            // 修改文本组件的内容
            this.student = student;
          })
      }
      .width('100%')
    }
    .height('100%')
    .backgroundColor('#00008B')
  }
}

代码说明 ：这段代码创建了一个 Second 页面组件，其中包含两个文本区域和一个按钮。初始状态下，显示默认文本"Second页面"。点击"接收"按钮后，从 SecondAbility 中获取学生信息，并更新 student 状态以在页面上显示这些详细信息。页面背景为深蓝色（#00008B），默认文本为黄色加粗，学生信息文本为绿色加粗。此代码实现了 Ability 层与 UI 层间的数据交互和展示。

3. 测试效果

启动应用，显示首页
单击【跳转】按钮，显示第二个页面
单击【接收】按钮，显示接收的数据

4. 实战总结

通过本实战，我们掌握了在HarmonyOS中创建应用、实现页面跳转和数据传递的完整流程。首先，我们学习了如何使用DevEco Studio搭建项目框架。接着，通过编码实践，我们实现了从Index页面到SecondAbility的显式跳转，并传递了参数。在SecondAbility中，我们接收并处理了这些参数，随后在Second页面中展示了这些数据。此过程不仅加深了对HarmonyOS应用开发的理解，也提升了我们的实际开发技能。

5. 拓展练习 - 启动文件管理器

5.1 创建鸿蒙应用项目

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

5.2 修改Index.ets代码

首页 - pages/Index.ets

ts 复制代码

import { Want, common } from '@kit.AbilityKit';

function startFileManagement(context: common.UIAbilityContext): void {
  let want: Want = {
    bundleName: 'com.huawei.hmos.filemanager',
    abilityName: 'MainAbility'
  };
  context.startAbility(want);
}

@Entry
@Component
struct Index {
  @State message: string = 'Index页面';

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(40)
          .fontWeight(FontWeight.Bold)
          .foregroundColor(Color.Yellow)
          .margin('10')
        // 添加按钮
        Button('文件管理器')
          .fontSize(30)
          .width(250)
          .height(70)
          .backgroundColor('#44dd22')
          .foregroundColor('#ffffff')
          .onClick(() => {
            const context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;
            startFileManagement(context);
          });
      }
      .width('100%');
    }
    .height('100%')
    .backgroundColor('#00662F')
  }
}

代码说明 ：这段代码基于鸿蒙开发框架编写。定义了startFileManagement函数用于构造Want对象并启动文件管理器应用。Index组件构建了页面布局，含显示文本与按钮，点击按钮时获取上下文来调用启动函数，旨在实现点击按钮启动文件管理器的交互操作。

5.3 测试应用运行效果

启动应用，显示首页
单击【文件管理器】按钮