HarmonyOS编程 | 页面跳转 | Java注释版

2023-08-22 23:49:46

HarmonyOS编程 —— 第一弹

页面跳转

前言

这里有HarmonyOS文档学习 | Page Ability | 思维导图，是关于文档部分的思维导图，页面跳转也是要到里面的知识

本文章只是说明书，是代码的补充部分。不建议仅根据该文进行实践

正确的做法是下载附件中的源码，对照源码和文章的步骤，进行实践复现

页面跳转即AbilitySlice间导航。这部分有两种，一种是同Page里跳转，另一种是不同Page里跳转

下面将介绍这两种的实现方式

正文

1. 同Page跳转的三种实现方式

1.1. 基本实验步骤

1. 在layout文件夹中写xml布局文件

ability_main.xml是主页面，其他三个是要跳转到的页面，可以随便定义内容

2. 在slice中声明创建Slice文件声明调用layout布局文件

3. 在主Slice中，编写业务代码实现跳转（不同的方式实现区别主要在第3个步骤）

1.2. 核心代码部分

1.2.1. 无参跳转

MainAbilitySlice.java

// 第一个按钮：实现基本的跳转
// 通过xml布局文件中的组件ID获取组件
Button btn_1 = (Button) findComponentById(ResourceTable.Id_btn_1);
// 设置按钮点击监听事件，在点击时进行如下操作
btn_1.setClickedListener(component -> {	// lambda表达式
    Intent btn_1_intent = new Intent();	// Intent：意图，是对象之间传递信息的载体
    // 通过present进行跳转操作
    /**
	 * 参数说明
 	 * new FirstAbilitySlice()：表示要跳转到的slice
 	 * btn_1_intent：把信息载体作为参数传到对应slice中
 	 */
    present(new FirstAbilitySlice(), btn_1_intent);
});

调用present()之后会直接跳转

1.2.2. 带参数跳转

大部分内容和第一个实现差不多，所以就不写注释了

MainAbilitySlice.java

// 第二个按钮：实现带参数跳转；可以边跳转边传值改变内容
Button btn_2 = (Button) findComponentById(ResourceTable.Id_btn_2);
btn_2.setClickedListener(component -> {
   Intent btn_2_intent = new Intent();
   btn_2_intent.setParam("data", "鸿蒙，你好");    // 设置参数，形式是K:V结构，存在intent中
   present(new SecondAbilitySlice(), btn_2_intent);
});

secondAbilitySlice.java

@Override
public void onStart(Intent intent) {
    super.onStart(intent);
    super.setUIContent(ResourceTable.Layout_ability_2);

    Text text = (Text) findComponentById(ResourceTable.Id_ability_text_2);	// 获得text组件
    // getStringParam()，从inent中通过键获取值，因为是键值对形式；返回的结果为"鸿蒙，你好"
    text.setText(intent.getStringParam("data"));	// 修改text组件的内容，会覆盖原来的内容

}

在主页面设置参数存入intent中之后跳转，跳转到目标页面Slice后，读取inent中的参数，从而修改本来的内容

内容由 “第二个页面跳转实现” 变为 “鸿蒙，你好”

1.2.3. 带返回值跳转

（以下代码按步骤实现）

MainAbilitySlice.java

// 第三个按钮：实现带返回值跳转；可以通过校验返回值，在onResult中实现校验通过后的其他行为
text_main = (Text) findComponentById(ResourceTable.Id_text_main);
Button btn_3 = (Button) findComponentById(ResourceTable.Id_btn_3);
btn_3.setClickedListener(component -> {
    Intent btn_3_intent = new Intent();
    // 这是使用的是presentForResult()进行跳转，最后一个参数是请求代码，用于返回时校验
    presentForResult(new ThirdAbilitySlice(), btn_3_intent, 666);
});

ThridAbilitySlice.java

@Override
public void onStart(Intent intent) {
   super.onStart(intent);
   super.setUIContent(ResourceTable.Layout_ability_3);

   // 通过组件id获取组件
   Text text = (Text) findComponentById(ResourceTable.Id_ability_text_3);
   text.setClickedListener(component -> {
      Intent intent1 = new Intent();
      intent1.setParam("pwd", "51cto");  // 设置参数
      setResult(intent1);    // 设置返回的结果
      terminate();   // 点击事件结束后销毁该slice
   });

}

MainAbilitySlice.java

@Override
protected void onResult(int requestCode, Intent resultIntent) {
    super.onResult(requestCode, resultIntent);
    // 如果请求代码校验通过，则执行一下的操作
    if (requestCode == 666) {
        // 获取pwd的值
        String pwd = resultIntent.getStringParam("pwd");
        // 在pwd的值，添加到原文本的后面
        text_main.append(" 密码：" + pwd);
    }
}

调用流程如下所示

结果

点击获取密码后，会调用terminate()方法销毁页面。回到主页面同时调用onResult()方法，执行文字拼接

2. 不同Page跳转的两种实现方式

2.1 基本实验步骤

1. 新建Ability，同时DES会自动在layout和slice中创建新的文件

2. 在layout文件夹中写xml布局文件

3. 在slice中声明创建Slice文件声明调用layout布局文件

4. 在主Slice中，编写业务代码实现跳转

2.2. 核心代码部分

2.2.1. 通过 new Intent.OperationBuilder() 方式

MainAbilitySlice.java

// 推荐使用这种方法实现！使用OperationBuilder()方法实现
Button btn_4 = (Button) findComponentById(ResourceTable.Id_btn_4);
btn_4.setClickedListener(component -> {
   Intent btn_4_intent = new Intent();
   Operation operation = new Intent.OperationBuilder()
         .withDeviceId("")    // 设备Id，在本地上进行跳转可以为空，跨设备进行跳转则需要传入值
         .withBundleName("com.anzia.pagejump")    // 包名
         .withAbilityName(".SecondAbility")    // Ability页面的名称，在本地可以缺省前面的路径
         .build();    // 构建代码
   btn_4_intent.setOperation(operation);    // 将operation存入到intent中
   startAbility(btn_4_intent);    // 实现Ability跳转
});

结果

2.2.2. 通过 setAction() 方式

第一步：在config中声明SecondAbility的actions

第二步：在SecondAbility中添加Action路由

public class SecondAbility extends Ability {
   @Override
   public void onStart(Intent intent) {
      super.onStart(intent);
      super.setMainRoute(SecondPageSlice.class.getName());

       // 第一个参数为：config.json中声明的actions；第二个参数为：要跳转目标Slice的路径名
      super.addActionRoute("abilityslice2", SecondPageSlice.class.getName());
   }
}

第三步：在MainAbilitySlice.java中实现不同页面跳转

// 不推荐这个，挺麻烦的
// 先去config.json中添加对应的action
// 在Ability文件添加addActionRoute()路由
// 在Slice文件中组件的监听事件设置跳转方法
Button btn_5 = (Button) findComponentById(ResourceTable.Id_btn_5);
btn_5.setClickedListener(component -> {
   Intent btn_5_intent = new Intent();
   btn_5_intent.setAction("abilityslice2");
   startAbility(btn_5_intent);
});

结果

3. 总结

3.1. 同页面跳转

默认：

// 直接调用present()方法

带参数：

// 主页面
intent.setParam()
present()
// 目标页面
intent.getXXXParam()

等待返回值：

// 主页面
presentForResult()
// 目标页面
setResult()
// 主页面
实现onResult()方法

3.2. 不同页面跳转

OperationBuilder()方式

// 主页面
Operation operation = new Intent.opationBuilder()
    .withDeviceId(设备id)
    .withBundleName(包名)
    .withAbilityName(FA名)
    .build();
intent.setOparation(operation);
startAbility(intent);

setAction()方式

// 在config.json中声明actions
// 在目标Ability中调用addActionRoute()方法添加路由
super.addActionRoute();
// 主页面
intent.setAction(action名);
startAbility(intent);

3.3. 差别

有present()、presentForResult()的是同页面跳转

有startAbility()的是不同页面跳转

不同页面跳转推荐使用OperationBuilder()方式，因为这种方式在跨设备调用还需要用。习惯这一种就好了

PS：友情提示

# 图片模糊怎么办？

对图片右键在新窗口打开
对图片右键另存为本地看

# 下面有一个文件

【abilityslice页面跳转.rar】是源码

在专栏中还有大量这样类似的文章，如果觉得对你有用，不妨关注一起学习~

想了解更多关于鸿蒙的内容，请访问：

51CTO和华为官方战略合作共建的鸿蒙技术社区

https://harmonyos.51cto.com/#bkwz

码农公寓

相关文章