文章目录
- 1. 实战概述
- 2. 实现步骤
- 2.1 创建项目
- 2.2 准备图片素材
- 2.3 编写首页代码
- 2.4 创建第二个页面
- 3. 测试效果
- 4. 实战总结
1. 实战概述
- 实战概述：本实战通过ArkUI框架，在鸿蒙系统上开发了一个简单的两页面应用。首页显示问候语和“下一页”按钮，点击后跳转到第二页。第二页展示欢迎信息并提供“返回”按钮。通过路由模块实现页面跳转，并在控制台记录操作结果。
2. 实现步骤
2.1 创建项目
- 选择类型与模板：
Application-Empty Ability
- 设置项目基本信息
- 单击【Finish】按钮，生成项目基本框架
- 运行程序，查看效果（需要创建模拟器，没有模拟器，可以用previewer）
- 单击绿色的运行按钮
2.2 准备图片素材
- 将两个页面所需背景图片放入
resources\base\media目录里
2.3 编写首页代码
- 首页
pages/Index.ets
// 导入页面路由模块，它提供了页面间跳转的功能
import { router } from '@kit.ArkUI';
// 导入业务错误处理模块，用于处理业务逻辑中可能出现的错误
import { BusinessError } from '@kit.BasicServicesKit';
// 使用@Entry装饰器标记这个组件为页面的入口点
@Entry
// 使用@Component装饰器定义这个组件
@Component
struct Index {
// 定义一个状态变量message，用于存储要显示的文本内容，初始值为'Hi, My Friend'
@State message: string = '你好，我的朋友~';
// 定义一个状态变量next，用于存储按钮上的文本内容，初始值为'Next'
@State next: string = '下一页';
// build方法用于构建和返回组件的UI结构
build() {
Stack() {
// 使用Image组件设置背景图片，图片资源通过$r函数引用
Image($r('app.media.first'))
.width('100%') // 设置图片宽度为父容器宽度的100%
.height('100%') // 设置图片高度为父容器高度的100%
.objectFit(ImageFit.Cover) // 设置图片适应方式为覆盖整个容器，保持图片比例
// 使用Row组件创建一个水平布局容器
Row() {
// 使用Column组件创建一个垂直布局容器，用于放置文本和按钮
Column() {
// 使用Text组件显示message状态变量的值
Text(this.message)
.fontSize(40) // 设置文本字体大小为40
.fontWeight(FontWeight.Bold) // 设置文本字体加粗
.fontColor(Color.Green) // 设置文本绿色
// 使用Button组件创建一个按钮
Button() {
// 按钮内的文本，显示next状态变量的值
Text(this.next)
.fontSize(30) // 设置按钮内文本字体大小为30
.fontWeight(FontWeight.Bold) // 设置按钮内文本字体加粗
}
// 设置按钮的类型为胶囊形
.type(ButtonType.Capsule)
// 设置按钮顶部外边距为20
.margin({
top: 20
})
// 设置按钮的背景颜色为蓝色
.backgroundColor('#0D9FFB')
// 设置按钮的宽度为父容器宽度的40%
.width('40%')
// 设置按钮的高度为父容器高度的10%
.height('10%')
// 为按钮绑定点击事件处理函数
.onClick(() => {
// 点击按钮时，在控制台输出成功点击的信息
console.info('单击【下一页】按钮~');
// 执行页面跳转操作，跳转到'pages/Second'页面
// 使用router.pushUrl方法进行页面跳转，并处理跳转结果
router.pushUrl({ url: 'pages/Second' }).then(() => {
// 跳转成功后，在控制台输出跳转成功的信息
console.info('成功跳转到第二页~');
}).catch((err: BusinessError) => {
// 捕获跳转过程中可能发生的错误，并处理
// 这里假设错误对象是BusinessError类型，并输出错误码和错误信息
console.error(`跳转到下一页失败。错误码：${err.code}, 错误信息：is ${err.message}`);
});
});
}
// 设置Column容器的宽度为父容器的100%，确保布局填满整个水平空间
.width('100%')
}
// 设置Row容器的高度为父容器的100%，确保布局填满整个垂直空间
.height('100%')
}
}
}
- 代码说明：这段代码定义了一个ArkUI框架下的页面组件Index，作为鸿蒙系统的用户界面入口。它包含背景图片、文本和按钮。点击按钮后，页面会跳转到pages/Second，同时处理跳转成功或失败的情况，并在控制台输出相关信息。
2.4 创建第二个页面
- 在
pages目录上单击右键，New | Page | Empty Page
- 设置页面名称 -
Second
- 单击【Finish】按钮
- 查看主页配置文件 -
main_pages.json
- 编写
Second.ets代码
// 导入页面路由模块，用于页面间的导航
import { router } from '@kit.ArkUI';
// 导入业务错误处理模块，用于捕获和处理业务相关的错误
import { BusinessError } from '@kit.BasicServicesKit';
// 使用@Entry注解标记Second组件为页面入口点
@Entry
// 使用@Component注解定义Second为一个组件
@Component
struct Second {
// 定义一个状态变量message，用于存储页面上要显示的文本
@State message: string = '泸职院欢迎你';
// 定义一个状态变量back，用于存储返回按钮上的文本
@State back: string = '返回';
// build方法用于构建和返回组件的UI结构
build() {
Stack() {
// 使用Image组件设置背景图片，图片资源通过$r函数引用
Image($r('app.media.second'))
.width('100%') // 设置图片宽度为父容器宽度的100%
.height('100%') // 设置图片高度为父容器高度的100%
.objectFit(ImageFit.Cover) // 设置图片适应方式为覆盖整个容器，保持图片比例
// 使用Row组件创建一个水平布局容器
Row() {
// 使用Column组件创建一个垂直布局容器，用于放置文本和按钮
Column() {
// 使用Text组件显示message状态变量的值
Text(this.message)
.fontSize(40) // 设置文本字体大小为40
.fontWeight(FontWeight.Bold) // 设置文本字体加粗
.fontColor(Color.Red) // 设置文本红色
// 使用Button组件创建一个按钮
Button() {
// 按钮内的文本，显示back状态变量的值
Text(this.back)
.fontSize(30) // 设置按钮内文本字体大小为30
.fontWeight(FontWeight.Bold) // 设置按钮内文本字体加粗
}
// 设置按钮的类型为胶囊形
.type(ButtonType.Capsule)
// 设置按钮顶部外边距为20
.margin({
top: 20
})
// 设置按钮的背景颜色为蓝色
.backgroundColor('#0D9FFB')
// 设置按钮的宽度为父容器宽度的40%
.width('40%')
// 设置按钮的高度为父容器高度的10%
.height('10%')
// 为按钮绑定onClick事件处理函数
.onClick(() => {
// 点击按钮时，在控制台输出成功点击的信息
console.info('成功单击【返回】按钮~')
try {
// 调用router.back()方法尝试返回到上一页
router.back()
// 如果返回成功，在控制台输出成功返回的信息
console.info('成功返回第一页~')
} catch (err) {
// 如果返回失败，捕获错误并处理
// 尝试将错误对象转换为BusinessError类型，并获取错误码和错误信息
let code = (err as BusinessError).code;
let message = (err as BusinessError).message;
// 在控制台输出失败返回的信息，包括错误码和错误信息
console.error(`返回第一页失败。错误码：${err.code}, 错误信息：is ${err.message}`);
}
})
}
// 设置Column容器的宽度为父容器宽度的100%
.width('100%')
}
// 设置Row容器的高度为父容器高度的100%，确保布局填满整个页面
.height('100%')
}
}
}
- 代码说明：这段代码定义了一个ArkUI的页面组件Second，作为鸿蒙系统的界面之一。它包含背景图、红色加粗文本“泸职院欢迎你”和蓝色胶囊形返回按钮。点击按钮尝试返回上一页，并在控制台记录操作结果，包括成功或失败的错误信息。
3. 测试效果
- 在模拟器上运行程序
- 单击【下一页】按钮，跳转到第二个页面
- 单击【返回】按钮，返回第一个页面
- 查看操作录屏
4. 实战总结
- 通过本次实战，在鸿蒙系统上使用ArkUI框架开发了一个包含两个页面的简单应用。首页展示了问候语和一个按钮，点击后能够跳转到第二页。第二页则展示了欢迎信息和一个返回按钮。通过路由模块实现了页面间的跳转，并在控制台记录了操作结果。这个项目不仅加深了对ArkUI框架的理解，也锻炼了在鸿蒙系统上进行应用开发的实践能力。通过实际操作，学会了如何设置项目、准备素材、编写代码以及测试应用，为未来更复杂的项目打下了坚实的基础。
