广州商学院-开源鸿蒙创新应用大赛:基于 OpenHarmony 的简易页面应用开发项目

广州商学院《鸿蒙北向应用开发基础》班级全体学生,班级课程实践大赛;

Branch1Tags0

学生校园 App — 项目总结

基本信息

属性 值
项目名称 hmdzy 学生工具
平台 HarmonyOS ArkTS(原始 API 6.0.2,本机适配为 API 6.0.0)
构建工具 hvigor 6.21.0(DevEco Studio NEXT Beta1 集成版)
包名 com.example.myapplication
设备类型 phone
注意 见 CONTEXT.md — 本机适配修改与比赛提交恢复说明

功能清单

认证系统

首页

活动

工具

我的

文件清单

项目根目录: 202406110226-wfk/
├── AppScope/app.json5                    # 应用配置
├── entry/src/main/ets/
│   ├── common/UserStorage.ets            # 数据持久化层(250+ 行)
│   ├── entryability/EntryAbility.ets     # 入口
│   ├── entrybackupability/              # 备份扩展
│   └── pages/
│       ├── Log.ets                       # 登录页
│       ├── Enroll.ets                    # 注册页
│       ├── Index.ets                     # 首页(600+ 行,4 Tab)
│       ├── Register.ets                  # 个人信息页
│       ├── ActivityDetail.ets            # 活动详情页
│       ├── CalculatorPage.ets            # 计算器
│       ├── CalendarPage.ets              # 日历
│       ├── MemoPage.ets                  # 便签
│       ├── MemoBookPage.ets              # 备忘录
│       ├── SchedulePage.ets              # 课程表
│       └── TimerPage.ets                 # 计时器
├── entry/src/main/resources/
│   ├── base/profile/main_pages.json      # 路由注册(11页)
│   ├── base/media/                       # 图片资源(9张内容图+4张应用图)
│   └── base/element/                     # 颜色/字符串/浮点数
├── CONTEXT.md                            # 项目上下文文档
├── ArkTS-Errors.md                       # 编译踩坑记录
└── build-profile.json5                   # 构建配置

技术要点

持久化

  • 使用 preferences(@kit.ArkData)同步 API
  • 每个用户存两条记录:密码 + 完整档案 JSON
  • 密码明文存储(已知问题,建议 hash 加固)
  • changePassword 同步更新密码记录和档案
  • 需 flush() 提交写入

路由

  • 11 个页面注册在 main_pages.json
  • 入口:Log.ets(通过 EntryAbility.loadContent)
  • 页面间传参:router.pushUrl({ url, params })
  • 返回传信号:AppStorage + router.back() + onPageShow

ArkTS 踩坑

  • @Builder 不允许变量声明
  • Select.value() 比 .selected() 更可靠
  • replaceUrl 栈内重入问题,用 router.back() 替代

调试

  • Log.ets 底部"重置数据"按钮一键清空 preferences

编译与运行

  • DevEco Studio 位置:D:\HarmonyNext\DevEco Studio\
  • 在 DevEco Studio 中打开项目,Build → Make Module 'entry'
  • 本机 hvigor 6.21.0,只支持 modelVersion 6.0.1
  • 本机 SDK 为 HarmonyOS 6.0.1 Beta1(API 21),原始项目 API 22
  • 本机适配:modelVersion → 6.0.1,targetSdkVersion → 6.0.0(20)
  • 提交比赛前需恢复原始值,详见 CONTEXT.md
  • 测试账号注册后可用 "重置数据" 清除

Introduction

广州商学院《鸿蒙北向应用开发基础》班级全体学生,班级课程实践大赛;

Customize your domain