01. HarmonyOS应用开发实践与技术解析 原创

全栈若城
发布于 2025-3-26 08:58
2212浏览
0收藏

01. HarmonyOS应用开发实践与技术解析-鸿蒙开发者社区

前言

随着华为HarmonyOS生态的不断发展,越来越多的开发者开始关注并投入到HarmonyOS应用开发中。本文将通过一个实际的项目案例,详细讲解HarmonyOS应用开发的核心技术和最佳实践,帮助开发者快速掌握HarmonyOS应用开发的要点。

项目概述

本项目是一个基于HarmonyOS的学习应用,主要包含了一个仪表盘示例页面,用于展示业务数据概览。项目采用了ArkTS语言开发,使用了HarmonyOS提供的UI框架和组件,实现了响应式布局和页面路由等功能。

HarmonyOS应用架构

项目结构

HarmonyOS应用的项目结构遵循一定的规范,主要包括以下几个部分:

  • entry:应用的入口模块,包含了应用的主要代码和资源
    • src/main/ets:ArkTS代码目录
      • entryability:应用的Ability实现,是应用的入口点
      • pages:应用的页面组件
      • components:可复用的UI组件
      • common:公共工具和常量
    • src/main/resources:应用的资源文件,如图片、字符串等
    • src/main/module.json5:模块配置文件

Ability生命周期

Ability是HarmonyOS应用的基本组成单元,类似于Android的Activity。在本项目中,EntryAbility是应用的主入口,它的生命周期包括:

export default class EntryAbility extends UIAbility {
    onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
        // Ability创建时调用
    }

    onDestroy(): void {
        // Ability销毁时调用
    }

    onWindowStageCreate(windowStage: window.WindowStage): void {
        // 窗口创建时调用,在这里加载主页面
        windowStage.loadContent('pages/Index', (err) => {
            // 页面加载回调
        });
    }

    onWindowStageDestroy(): void {
        // 窗口销毁时调用
    }

    onForeground(): void {
        // Ability进入前台时调用
    }

    onBackground(): void {
        // Ability进入后台时调用
    }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.

ArkTS语言特性

ArkTS是HarmonyOS应用开发的首选语言,它基于TypeScript,增加了声明式UI和状态管理等特性。

装饰器

ArkTS中的装饰器是一种特殊的声明,可以附加在类、方法、访问器、属性或参数上。本项目中使用了多种装饰器:

  1. @Entry:标记一个组件为页面入口
  2. @Component:定义一个自定义组件
  3. @State:定义组件内部的状态变量,当状态变化时会触发UI刷新
  4. @Prop:用于父组件向子组件传递数据

例如,在NavBar组件中:

@Component
export struct Navbar {
    @Prop title: string = ''
    build() {
        // 组件UI构建
    }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.

状态管理

ArkTS提供了多种状态管理机制,用于处理组件内部状态和组件间通信:

  1. @State:组件内部状态,变化时会触发组件重新渲染
  2. @Prop:父组件向子组件传递的属性,子组件不能修改
  3. @Link:双向绑定,父子组件可以共同修改
  4. AppStorage:应用级的状态存储

在DashboardExample组件中,使用@State管理数据:

@State screenWidth: number = 0
@State dataCards: DashboardCardItem[] = [
    {title: '今日销售额', value: '8,846', unit: '元', trend: '+12.5%', color: '#2A9D8F'},
    // 其他数据...
]
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.

UI组件与布局

基础组件

HarmonyOS提供了丰富的基础UI组件,本项目中使用了:

  1. Text:文本显示组件
  2. Image:图片显示组件
  3. Column:垂直布局容器
  4. Row:水平布局容器
  5. Flex:弹性布局容器
  6. List:列表容器

响应式布局

HarmonyOS支持响应式布局,可以根据屏幕尺寸自适应调整UI。在DashboardExample中,通过检测屏幕宽度实现响应式布局:

aboutToAppear() {
    // 获取屏幕宽度,用于响应式布局
    this.screenWidth = px2vp(AppStorage.Get<number>('windowWidth') || 720)
}

// 根据屏幕宽度决定每行显示的卡片数量
Flex({ wrap: FlexWrap.Wrap, justifyContent: this.screenWidth > 600 ? FlexAlign.Start : FlexAlign.SpaceAround }) {
    // 卡片布局
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.

样式与主题

ArkTS支持链式调用设置组件样式,使UI代码更加简洁:

Text(card.value)
    .fontSize(28)
    .fontWeight(FontWeight.Bold)
    .fontColor(card.color)
  • 1.
  • 2.
  • 3.
  • 4.

还可以通过设置backgroundColor、borderRadius、shadow等属性实现丰富的视觉效果:

.width(this.screenWidth > 600 ? '22%' : '45%')
.height(120)
.padding(16)
.margin(8)
.borderRadius(12)
.backgroundColor(Color.White)
// 添加卡片阴影效果
.shadow({radius: 4, color: '#1A000000', offsetY: 2})
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.

页面路由与参数传递

HarmonyOS提供了router模块用于页面间导航和参数传递。

页面跳转

在Index页面中,通过router.pushUrl实现页面跳转:

router.pushUrl({
    url: item.path,
    params: {
        desc: item.desc,
        value: item.value
    }
})
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.

参数接收

在目标页面中,通过router.getParams获取传递的参数:

onPageShow(): void {
    // 获取传递过来的参数对象
    const params = router.getParams() as Record<string, string>;
    //   获取传递的值
    if (params) {
        this.desc = params.desc as string
        this.title = params.value as string
    }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.

数据绑定与循环渲染

数据接口定义

使用TypeScript接口定义数据结构,提高代码的可读性和可维护性:

export interface DashboardCardItem {
    title: string;    // 卡片标题
    value: string;    // 数值内容
    unit: string;     // 数值单位
    trend: string;    // 趋势变化
    color: string;    // 卡片主题颜色
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.

循环渲染

使用ForEach语法实现列表循环渲染:

ForEach(this.dataCards, (card: DashboardCardItem) => {
    // 数据卡片UI构建
})
  • 1.
  • 2.
  • 3.

条件渲染

ArkTS支持在UI构建中使用条件表达式,实现动态UI:

// 根据趋势是否为正值显示不同颜色
Text(card.trend)
    .fontSize(14)
    .fontColor(card.trend.includes('+') ? '#2A9D8F' : '#E76F51')
  • 1.
  • 2.
  • 3.
  • 4.

组件生命周期

ArkTS组件有多个生命周期回调函数:

  1. aboutToAppear:组件即将出现时调用,用于初始化
  2. aboutToDisappear:组件即将消失时调用,用于清理资源
  3. onPageShow:页面显示时调用
  4. onPageHide:页面隐藏时调用
  5. onBackPress:处理返回按键事件
aboutToAppear() {
    // 初始化工作
    this.screenWidth = px2vp(AppStorage.Get<number>('windowWidth') || 720)
}

onPageShow(): void {
    // 页面显示时的处理
    const params = router.getParams() as Record<string, string>;
    // ...
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.

最佳实践与性能优化

组件复用

将通用UI封装为可复用组件,如本项目中的NavBar组件:

@Component
export struct Navbar {
    @Prop title: string = ''
    build() {
        Row(){
            Image($r('app.media.tornLeft')).width(30)
                .onClick(()=>{
                    router.back()
                })
            Text(this.title).fontSize(20).fontWeight(800)
        }
        .justifyContent(FlexAlign.SpaceBetween)
        .width('100%')
        .height('50')
    }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.

响应式设计

根据不同屏幕尺寸调整布局,提升用户体验:

.width(this.screenWidth > 600 ? '22%' : '45%')
  • 1.

性能优化

  1. 懒加载:只在需要时加载组件和资源
  2. 状态管理:合理使用状态管理机制,避免不必要的重渲染
  3. 资源复用:复用组件和资源,减少内存占用

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
收藏
回复
举报


回复
    相关推荐