简介这是一份面向移动应用开发期末大作业的鸿蒙校园迎新APP项目包含完整源码与配套报告。项目由大三学生完成经导师指导并获评审99分代码完整且确保可运行既能作为计算机专业课程设计与期末大作业的参考模板也可作为鸿蒙应用开发入门者的实战练习素材。资源包为ZIP压缩包共324个文件大小约443.12MB。其中以107个ets源码文件为核心覆盖页面、组件、视图模型与工具类等工程结构另有124个png与52个jpg图片资源、12个svg图标、JSON5与JSON配置文件、TS/JS辅助脚本以及项目报告PDF和操作演示MP4视频方便对照开发与演示效果。从文件分布可看出工程包含首页、地图组件、弹窗对话框、任务列表、主页视图模型等典型模块目录层次清晰便于按功能模块逐项研读配套报告能帮助理解整体架构与关键实现思路适合需要快速完成同类大作业或系统学习鸿蒙开发流程的同学。目前已有1571人学习下载是同类课程资源中较受关注的一份入手后可节省大量查阅与调试时间。1. 校园迎新 APP 期末作业选鸿蒙开发这条线值不值把移动应用开发期末作业做成校园迎新 APP很多同学第一反应是写安卓或微信小程序。我的建议是如果课程没有硬性指定技术栈鸿蒙开发是性价比很高的选择。期末大作业通常要求“源码 报告”一起交付鸿蒙的 ArkTS 声明式 UI 写页面快路由、状态管理、本地存储的复杂度都在一个人能驾驭的范围内两三周就能从注册登录做到报到查询和校园公告。答辩时“为什么选鸿蒙、和安卓有什么区别”本身就是能讲到细节加分的点。这篇内容按我带课设的复盘习惯来写不需要你有鸿蒙开发基础照着选版本、搭工程、铺代码最后把源码、报告、演示视频三件事对齐期末作业基本就不会翻车。2. 鸿蒙开发环境和工程骨架API 版本、Stage 模型先定案再写功能期末作业最常翻车的地方不是功能写不出来是环境磨掉两三天。我见过不少同学装好开发环境后工程里报一堆和版本相关的错App 一直起不来。所以动手写代码前先把三件事固定下来DevEco Studio 的大版本、SDK 的 API 版本、应用模型。这三项一旦定了整个项目期间就不要换换了容易出现“昨天还能跑今天全是错”的尴尬局面。2.1 DevEco Studio 与 API 版本先统一大版本再动代码DevEco Studio 是鸿蒙开发的官方 IDE第一次打开会让你下载 HarmonyOS SDK。这里不要看到新版本就激动课程设计不是搞前沿技术选一个当前课程环境里资料最充足的 API 档位就好。我一般建议在 API 9 和 API 10 之间选API 9 的资料多、报错少很多教程和案例都基于这个版本API 10 的组件和 ArkTS 语法更顺比如路由跳转、状态管理这些细节上体验更好。手头有真机就按真机系统版本选没有真机就默认 API 10。新建工程时按下面几步走每一步都不要跳打开 DevEco Studio选择 New Project。项目类型选 Application模板选 Empty Ability。语言选 ArkTS工程名和包名按自己学号起比如com.example.welcome。在 SDK 选择界面勾选并记住自己用的 API 版本。等工程初始化完成后在 IDE 底部 Terminal 里做一次工具链自检。# 检查鸿蒙开发工具链是否就绪以及能否识别设备 hdc list targets # 预期输出示例 # 127.0.0.1:5555 device这一条命令的意思是把当前连接的鸿蒙模拟器或真机列出来。hdc是鸿蒙开发的设备调试命令行工具类似安卓的adb。如果输出一行设备信息说明 IDE 和设备的连接是通的后面点击 Run 就能直接装到设备上。如果输出为空不要急着写代码先解决设备识别问题如果提示找不到hdc命令就在 DevEco Studio 的 Terminal 里执行它会自动带上 IDE 的工具目录。另外新建工程时 SDK 下载那一步如果失败多数是网络波动换个时间重新打开 DevEco Studio 重试即可不要反复切换版本。一旦 SDK 下载完成后续所有演示和答辩都基于这个环境千万不要在上台前一天随手点升级。2.2 Stage 模型与 ArkTS 页面路由把迎新流程拆成四个页面新建出的工程默认使用 Stage 模型这是鸿蒙当前的推荐应用模型。听懂这一点答辩时就能多讲一层。Stage 模型把应用拆成入口 Ability、页面、模块配置三部分EntryAbility是应用启动入口页面写在src/main/ets/pages/目录下module.json5和main_pages.json负责配置页面。你不需要把整个 Stage 模型吃透只需要知道在这个模型下页面跳转是压栈模式从一个页面 push 到另一个返回时 pop 回来。校园迎新 APP 的业务线比较简单我一般拆成四个页面页面功能核心数据Index首页公告公告列表Register新生注册表单信息Report报到单学号与班级Guide校园指南地图与路线这四个页面能覆盖“迎新”这个主题的完整流程。页面不用做多但每个页面都要有交互源码才有东西可讲。页面之间的跳转用router.pushUrl就够没必要引入 Navigation 组件。// 在 Index 页面里跳转到 Register 页面 import router from ohos.router Entry Component struct Index { toRegister(): void { // url 是相对路径不加 .ets 后缀 router.pushUrl({ url: pages/Register, params: { from: index } }).catch((err: Error) { // 路由失败要能看见错误不要静默吞掉 console.error(路由跳转失败: err.message) }) } build() { Column() { Button(开始注册) .onClick(() this.toRegister()) } } }这里有两个关键参数需要说明。url的pages/Register是相对src/main/ets/pages目录的路径如果你在 pages 下建了二级目录就把二级目录一并写进去。params可以带任意键值在接收页面里通过router.getParams()取出来适合在注册页回显“从首页过来的”这类状态。.catch是必须写的因为路由失败不会把 App 崩掉但会在日志里报错不写 catch一旦页面路径写错你只能看到白屏找不到原因。还有一处容易漏新建页面文件后必须到entry/src/main/resources/base/profile/main_pages.json里把页面注册进 pages 数组。这是全局路由表漏了就跳不过去。很多同学说“页面白屏、点按钮没反应”八成是这一行没加。3. 迎新功能落地注册、报到、公告页这三段就是你源码的主体页面骨架搭好后剩下的活就是把每个页面填满。我习惯按“公告页 → 注册页 → 报到页”的顺序写因为这三个页面分别对应列表渲染、表单校验、数据持久化三个高频考点答辩时老师最爱问的就是这三块。3.1 公告列表ArkTS 的 List 渲染和状态更新写法首页我一般放迎新公告。数据可以先写死在页面里不用急着接后端。期末作业里面接口联调不是加分项把列表渲染和点击交互写清楚才是重点。// 公告列表页面index.ets 的核心代码 import router from ohos.router // 定义公告数据结构 interface Notice { id: number title: string date: string } Entry Component struct Index { // State 修饰的数组数据变化时 UI 会自动刷新 State notices: Notice[] [ { id: 1, title: 9月1日 8:30 新生欢迎会, date: 08-26 }, { id: 2, title: 宿舍开放查询通知, date: 08-28 }, { id: 3, title: 接站大巴时刻表已发布, date: 08-29 } ] build() { Column() { Text(迎新公告) .fontSize(20) .fontWeight(FontWeight.Bold) .width(100%) .padding(12) List({ space: 10 }) { ForEach(this.notices, (item: Notice) { ListItem() { Row({ space: 10 }) { Column() { Text(item.title) .fontSize(16) .width(100%) Text(item.date) .fontSize(12) .fontColor(#888888) } .alignItems(HorizontalAlign.Start) .layoutWeight(1) } .padding(12) .borderRadius(8) .backgroundColor(#FFFFFF) } }, (item: Notice) String(item.id)) } .width(100%) .layoutWeight(1) .padding({ left: 16, right: 16 }) } .width(100%) .height(100%) .backgroundColor(#F5F5F5) } }这段代码有三个地方值得在报告里写清楚。第一个是State notices它把数组声明成响应式状态后续如果从本地存储读数据并赋值页面自动刷新不需要手动操作 DOM。第二个是List组件的space参数代表列表项间距配合.padding控制页面左右边距。第三个是ForEach的第三个参数(item: Notice) String(item.id)是键值生成器作用是让每个 ListItem 有唯一标识列表刷新时不闪烁、不错位。这个细节很多教程不强调但老师问“ForEach 为什么要传第三个参数”时你能答出来就是加分项。3.2 报到信息持久化Preferences 读写与表单校验报到页面我让学生做成“填写信息 保存到本地”的格式数据量不大不需要上数据库。鸿蒙提供的 Preferences 键值存储正好合适。// 注册页面的保存逻辑 import preferences from ohos.data.preferences import common from ohos.app.ability.common Entry Component struct Register { State studentName: string State studentId: string async saveData(): Promisevoid { // 表单校验姓名和学号不能为空 if (this.studentName.length 0 || this.studentId.length 0) { console.error(姓名或学号为空) return } // getContext 拿到当前应用的上下文 const ctx getContext(this) as common.Context const pref await preferences.getPreferences(ctx, { name: welcomeReg }) // 写入两个键值 await pref.put(studentName, this.studentName) await pref.put(studentId, this.studentId) // flush 才真正落盘 await pref.flush() } build() { Column({ space: 16 }) { TextInput({ placeholder: 请输入姓名, text: this.studentName }) .onChange((value: string) { this.studentName value }) TextInput({ placeholder: 请输入学号, text: this.studentId }) .onChange((value: string) { this.studentId value }) Button(保存报到信息) .onClick(() { this.saveData() }) } .padding(16) } }保存逻辑说明getPreferences第一个参数是应用上下文第二个参数name: welcomeReg是存储文件名不需要手动创建系统会自动生成。put是写值flush才是真正落盘只 put 不 flush数据在 App 退出后会丢。这里用了async/await因为 Preferences 的读写是异步的改成同步写法会阻塞 UI 线程页面容易卡顿。这个页面就是我常说的大作业“最小闭环”用户输入、按钮点击、状态更新、数据保存。在这个闭环上再扩展比如报到后跳到报到单页面把信息显示出来整个业务流就完整了。代码量不大但源码里能讲的东西不少。4. 避坑鸿蒙开发期末作业常见的 4 个翻车点与排查路径下面这几条是我在学生作业里反复见到的坑。每一条都按“现象 → 原因 → 解决”列出来你做完项目后拿这份清单过一遍能省掉很多答辩时的尴尬。4.1 模拟器启动失败页面一直黑屏现象点击运行按钮后模拟器卡在启动界面或者启动后页面一直是黑的不显示 Activity。原因最常见的是电脑内存不够模拟器默认分配内存过大其次是模拟器镜像和 CPU 架构不匹配。还有一部分情况是用户反复删除、重建模拟器导致镜像损坏。解决先在模拟器设置里把内存调整到 2GB 左右再检查电脑整体内存占用如果还不行删除当前模拟器重新创建一台带默认参数的设备。创建模拟器时选 x86_64 对应镜像不要在 ARM 镜像上强行运行。页面黑屏且模拟器日志不报错多半是 IDE 的 Previewer 和模拟器状态冲突关掉 Previewer 再运行一次就正常了。4.2 真机总是安装不上提示签名不一致现象真机连接电脑后DevEco Studio 点击运行控制台报安装失败错误信息里带signature或install关键字。原因期末作业工程大部分是手动导出的 HAP没有自动签名。鸿蒙真机只安装有合法签名的应用包没签名的包会被系统拒掉。解决在 DevEco Studio 的 File Project Structure Signing Configs 里勾选自动签名然后登录华为账号IDE 会帮你生成调试证书。记得保存好这个工程不要拷给别人后重新生成签名否则同一个工程在两台电脑上有不同证书安装时一样报错。答辩用的演示机最好一直使用同一个签名配置别频繁切换。4.3 页面路由跳转没反应控制台报找不到模块现象点击页面上的按钮界面纹丝不动打开日志面板能看到Cannot find module之类的红色报错。原因写路由时router.pushUrl的 url 路径写错或者新建的页面没有在main_pages.json中注册。这两种情况是并发的注册漏掉的话IDE 编译阶段不报错运行时才发现。解决打开entry/src/main/resources/base/profile/main_pages.json确认 pages 数组里有pages/Register这样的完整路径注意大小写要和文件名一致。写router.pushUrl时url 不带.ets后缀这是 ArkTS 的约定。还有一种隐蔽情况网上的教程代码里 url 是pages/Login但你的页面叫LoginPage直接抄过来就会踩坑。4.4 答辩时报告和源码对不上这是最容易被扣分的现象老师打开你的报告翻到“功能实现”章节截图里显示的是三个按钮打开源码却发现只有两个或者报告说“支持查询宿舍信息”视频里演示到一半跳过了这个页面。原因报告是最后两天赶出来的截图和功能介绍不是同一版代码。有些同学的源码是先写的报告后写功能迭代过程中截图没有同步更新最后交付物就成了“两张皮”。解决交付前一周把源码冻结不要为了写报告再改功能。所有报告截图、演示视频、功能列表都基于冻结后的这版源码。离开答辩还有时间的话我建议按“老师拿到源码、看到他环境里能跑起来”这条标准写一个 README 放到源码根目录里标明开发工具版本、API 版本、模拟器或真机型号这一步能有效降低老师在自己电脑上打不开项目时的失望感。报告里加一页“运行环境说明”和 README 内容保持一致。5. 让源码和报告互相支撑期末大作业交付包这样整理5.1 交付清单和报告结构期末大作业交的不只是代码是一整套东西源码、报告、演示视频三件套缺一不可。我见过太多学生代码写得不错结果报告里流程图没有、数据表没有、测试过程没有白白丢分。整理交付包的步骤我建议按这个顺序走交付物要求自查点源码工程删掉 build、previewer 等本地缓存目录保留全部源码和配置文件换一台电脑能否直接打开报告文档包含需求分析、页面设计、关键代码、测试过程四部分所有截图是否出自最终版本演示视频2 分钟从首页进入按照功能顺序演示视频里的页面和源码是否能对上报告里的“关键代码”部分不要贴大段源码每页贴一段核心代码加两句注释即可。老师没时间读你的全部代码他们看重的是这个页面怎么实现的、数据怎么存的、路由怎么跳的。这三条能在报告里各自讲清楚就拿住了基础分。我在这种交付上吃过亏。有一门课程的报告里测试章节的截图是旧版界面和最终源码里的页面颜色都不一样老师翻到那页就问了一句我当时差点没接住。后来养成的习惯是所有截图、视频、代码统一在一个晚上生成不再回头改功能。你要交期末作业之前也建议照着这个节奏验收一遍。把开发工具、API 版本、运行方式都写进 README把演示视频控制在两分钟内把报告截图和源码逐一核对。做到这三条你交出去的每个文件都能自圆其说老师也就不太会为难你了。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/27 17:45:45 · 阅读 1.2k 鸿蒙开发期末作业：用ArkTS打造校园迎新APP全流程指南
简介这是一份面向移动应用开发期末大作业的鸿蒙校园迎新APP项目包含完整源码与配套报告。项目由大三学生完成经导师指导并获评审99分代码完整且确保可运行既能作为计算机专业课程设计与期末大作业的参考模板也可作为鸿蒙应用开发入门者的实战练习素材。资源包为ZIP压缩包共324个文件大小约443.12MB。其中以107个ets源码文件为核心覆盖页面、组件、视图模型与工具类等工程结构另有124个png与52个jpg图片资源、12个svg图标、JSON5与JSON配置文件、TS/JS辅助脚本以及项目报告PDF和操作演示MP4视频方便对照开发与演示效果。从文件分布可看出工程包含首页、地图组件、弹窗对话框、任务列表、主页视图模型等典型模块目录层次清晰便于按功能模块逐项研读配套报告能帮助理解整体架构与关键实现思路适合需要快速完成同类大作业或系统学习鸿蒙开发流程的同学。目前已有1571人学习下载是同类课程资源中较受关注的一份入手后可节省大量查阅与调试时间。1. 校园迎新 APP 期末作业选鸿蒙开发这条线值不值把移动应用开发期末作业做成校园迎新 APP很多同学第一反应是写安卓或微信小程序。我的建议是如果课程没有硬性指定技术栈鸿蒙开发是性价比很高的选择。期末大作业通常要求“源码 报告”一起交付鸿蒙的 ArkTS 声明式 UI 写页面快路由、状态管理、本地存储的复杂度都在一个人能驾驭的范围内两三周就能从注册登录做到报到查询和校园公告。答辩时“为什么选鸿蒙、和安卓有什么区别”本身就是能讲到细节加分的点。这篇内容按我带课设的复盘习惯来写不需要你有鸿蒙开发基础照着选版本、搭工程、铺代码最后把源码、报告、演示视频三件事对齐期末作业基本就不会翻车。2. 鸿蒙开发环境和工程骨架API 版本、Stage 模型先定案再写功能期末作业最常翻车的地方不是功能写不出来是环境磨掉两三天。我见过不少同学装好开发环境后工程里报一堆和版本相关的错App 一直起不来。所以动手写代码前先把三件事固定下来DevEco Studio 的大版本、SDK 的 API 版本、应用模型。这三项一旦定了整个项目期间就不要换换了容易出现“昨天还能跑今天全是错”的尴尬局面。2.1 DevEco Studio 与 API 版本先统一大版本再动代码DevEco Studio 是鸿蒙开发的官方 IDE第一次打开会让你下载 HarmonyOS SDK。这里不要看到新版本就激动课程设计不是搞前沿技术选一个当前课程环境里资料最充足的 API 档位就好。我一般建议在 API 9 和 API 10 之间选API 9 的资料多、报错少很多教程和案例都基于这个版本API 10 的组件和 ArkTS 语法更顺比如路由跳转、状态管理这些细节上体验更好。手头有真机就按真机系统版本选没有真机就默认 API 10。新建工程时按下面几步走每一步都不要跳打开 DevEco Studio选择 New Project。项目类型选 Application模板选 Empty Ability。语言选 ArkTS工程名和包名按自己学号起比如com.example.welcome。在 SDK 选择界面勾选并记住自己用的 API 版本。等工程初始化完成后在 IDE 底部 Terminal 里做一次工具链自检。# 检查鸿蒙开发工具链是否就绪以及能否识别设备 hdc list targets # 预期输出示例 # 127.0.0.1:5555 device这一条命令的意思是把当前连接的鸿蒙模拟器或真机列出来。hdc是鸿蒙开发的设备调试命令行工具类似安卓的adb。如果输出一行设备信息说明 IDE 和设备的连接是通的后面点击 Run 就能直接装到设备上。如果输出为空不要急着写代码先解决设备识别问题如果提示找不到hdc命令就在 DevEco Studio 的 Terminal 里执行它会自动带上 IDE 的工具目录。另外新建工程时 SDK 下载那一步如果失败多数是网络波动换个时间重新打开 DevEco Studio 重试即可不要反复切换版本。一旦 SDK 下载完成后续所有演示和答辩都基于这个环境千万不要在上台前一天随手点升级。2.2 Stage 模型与 ArkTS 页面路由把迎新流程拆成四个页面新建出的工程默认使用 Stage 模型这是鸿蒙当前的推荐应用模型。听懂这一点答辩时就能多讲一层。Stage 模型把应用拆成入口 Ability、页面、模块配置三部分EntryAbility是应用启动入口页面写在src/main/ets/pages/目录下module.json5和main_pages.json负责配置页面。你不需要把整个 Stage 模型吃透只需要知道在这个模型下页面跳转是压栈模式从一个页面 push 到另一个返回时 pop 回来。校园迎新 APP 的业务线比较简单我一般拆成四个页面页面功能核心数据Index首页公告公告列表Register新生注册表单信息Report报到单学号与班级Guide校园指南地图与路线这四个页面能覆盖“迎新”这个主题的完整流程。页面不用做多但每个页面都要有交互源码才有东西可讲。页面之间的跳转用router.pushUrl就够没必要引入 Navigation 组件。// 在 Index 页面里跳转到 Register 页面 import router from ohos.router Entry Component struct Index { toRegister(): void { // url 是相对路径不加 .ets 后缀 router.pushUrl({ url: pages/Register, params: { from: index } }).catch((err: Error) { // 路由失败要能看见错误不要静默吞掉 console.error(路由跳转失败: err.message) }) } build() { Column() { Button(开始注册) .onClick(() this.toRegister()) } } }这里有两个关键参数需要说明。url的pages/Register是相对src/main/ets/pages目录的路径如果你在 pages 下建了二级目录就把二级目录一并写进去。params可以带任意键值在接收页面里通过router.getParams()取出来适合在注册页回显“从首页过来的”这类状态。.catch是必须写的因为路由失败不会把 App 崩掉但会在日志里报错不写 catch一旦页面路径写错你只能看到白屏找不到原因。还有一处容易漏新建页面文件后必须到entry/src/main/resources/base/profile/main_pages.json里把页面注册进 pages 数组。这是全局路由表漏了就跳不过去。很多同学说“页面白屏、点按钮没反应”八成是这一行没加。3. 迎新功能落地注册、报到、公告页这三段就是你源码的主体页面骨架搭好后剩下的活就是把每个页面填满。我习惯按“公告页 → 注册页 → 报到页”的顺序写因为这三个页面分别对应列表渲染、表单校验、数据持久化三个高频考点答辩时老师最爱问的就是这三块。3.1 公告列表ArkTS 的 List 渲染和状态更新写法首页我一般放迎新公告。数据可以先写死在页面里不用急着接后端。期末作业里面接口联调不是加分项把列表渲染和点击交互写清楚才是重点。// 公告列表页面index.ets 的核心代码 import router from ohos.router // 定义公告数据结构 interface Notice { id: number title: string date: string } Entry Component struct Index { // State 修饰的数组数据变化时 UI 会自动刷新 State notices: Notice[] [ { id: 1, title: 9月1日 8:30 新生欢迎会, date: 08-26 }, { id: 2, title: 宿舍开放查询通知, date: 08-28 }, { id: 3, title: 接站大巴时刻表已发布, date: 08-29 } ] build() { Column() { Text(迎新公告) .fontSize(20) .fontWeight(FontWeight.Bold) .width(100%) .padding(12) List({ space: 10 }) { ForEach(this.notices, (item: Notice) { ListItem() { Row({ space: 10 }) { Column() { Text(item.title) .fontSize(16) .width(100%) Text(item.date) .fontSize(12) .fontColor(#888888) } .alignItems(HorizontalAlign.Start) .layoutWeight(1) } .padding(12) .borderRadius(8) .backgroundColor(#FFFFFF) } }, (item: Notice) String(item.id)) } .width(100%) .layoutWeight(1) .padding({ left: 16, right: 16 }) } .width(100%) .height(100%) .backgroundColor(#F5F5F5) } }这段代码有三个地方值得在报告里写清楚。第一个是State notices它把数组声明成响应式状态后续如果从本地存储读数据并赋值页面自动刷新不需要手动操作 DOM。第二个是List组件的space参数代表列表项间距配合.padding控制页面左右边距。第三个是ForEach的第三个参数(item: Notice) String(item.id)是键值生成器作用是让每个 ListItem 有唯一标识列表刷新时不闪烁、不错位。这个细节很多教程不强调但老师问“ForEach 为什么要传第三个参数”时你能答出来就是加分项。3.2 报到信息持久化Preferences 读写与表单校验报到页面我让学生做成“填写信息 保存到本地”的格式数据量不大不需要上数据库。鸿蒙提供的 Preferences 键值存储正好合适。// 注册页面的保存逻辑 import preferences from ohos.data.preferences import common from ohos.app.ability.common Entry Component struct Register { State studentName: string State studentId: string async saveData(): Promisevoid { // 表单校验姓名和学号不能为空 if (this.studentName.length 0 || this.studentId.length 0) { console.error(姓名或学号为空) return } // getContext 拿到当前应用的上下文 const ctx getContext(this) as common.Context const pref await preferences.getPreferences(ctx, { name: welcomeReg }) // 写入两个键值 await pref.put(studentName, this.studentName) await pref.put(studentId, this.studentId) // flush 才真正落盘 await pref.flush() } build() { Column({ space: 16 }) { TextInput({ placeholder: 请输入姓名, text: this.studentName }) .onChange((value: string) { this.studentName value }) TextInput({ placeholder: 请输入学号, text: this.studentId }) .onChange((value: string) { this.studentId value }) Button(保存报到信息) .onClick(() { this.saveData() }) } .padding(16) } }保存逻辑说明getPreferences第一个参数是应用上下文第二个参数name: welcomeReg是存储文件名不需要手动创建系统会自动生成。put是写值flush才是真正落盘只 put 不 flush数据在 App 退出后会丢。这里用了async/await因为 Preferences 的读写是异步的改成同步写法会阻塞 UI 线程页面容易卡顿。这个页面就是我常说的大作业“最小闭环”用户输入、按钮点击、状态更新、数据保存。在这个闭环上再扩展比如报到后跳到报到单页面把信息显示出来整个业务流就完整了。代码量不大但源码里能讲的东西不少。4. 避坑鸿蒙开发期末作业常见的 4 个翻车点与排查路径下面这几条是我在学生作业里反复见到的坑。每一条都按“现象 → 原因 → 解决”列出来你做完项目后拿这份清单过一遍能省掉很多答辩时的尴尬。4.1 模拟器启动失败页面一直黑屏现象点击运行按钮后模拟器卡在启动界面或者启动后页面一直是黑的不显示 Activity。原因最常见的是电脑内存不够模拟器默认分配内存过大其次是模拟器镜像和 CPU 架构不匹配。还有一部分情况是用户反复删除、重建模拟器导致镜像损坏。解决先在模拟器设置里把内存调整到 2GB 左右再检查电脑整体内存占用如果还不行删除当前模拟器重新创建一台带默认参数的设备。创建模拟器时选 x86_64 对应镜像不要在 ARM 镜像上强行运行。页面黑屏且模拟器日志不报错多半是 IDE 的 Previewer 和模拟器状态冲突关掉 Previewer 再运行一次就正常了。4.2 真机总是安装不上提示签名不一致现象真机连接电脑后DevEco Studio 点击运行控制台报安装失败错误信息里带signature或install关键字。原因期末作业工程大部分是手动导出的 HAP没有自动签名。鸿蒙真机只安装有合法签名的应用包没签名的包会被系统拒掉。解决在 DevEco Studio 的 File Project Structure Signing Configs 里勾选自动签名然后登录华为账号IDE 会帮你生成调试证书。记得保存好这个工程不要拷给别人后重新生成签名否则同一个工程在两台电脑上有不同证书安装时一样报错。答辩用的演示机最好一直使用同一个签名配置别频繁切换。4.3 页面路由跳转没反应控制台报找不到模块现象点击页面上的按钮界面纹丝不动打开日志面板能看到Cannot find module之类的红色报错。原因写路由时router.pushUrl的 url 路径写错或者新建的页面没有在main_pages.json中注册。这两种情况是并发的注册漏掉的话IDE 编译阶段不报错运行时才发现。解决打开entry/src/main/resources/base/profile/main_pages.json确认 pages 数组里有pages/Register这样的完整路径注意大小写要和文件名一致。写router.pushUrl时url 不带.ets后缀这是 ArkTS 的约定。还有一种隐蔽情况网上的教程代码里 url 是pages/Login但你的页面叫LoginPage直接抄过来就会踩坑。4.4 答辩时报告和源码对不上这是最容易被扣分的现象老师打开你的报告翻到“功能实现”章节截图里显示的是三个按钮打开源码却发现只有两个或者报告说“支持查询宿舍信息”视频里演示到一半跳过了这个页面。原因报告是最后两天赶出来的截图和功能介绍不是同一版代码。有些同学的源码是先写的报告后写功能迭代过程中截图没有同步更新最后交付物就成了“两张皮”。解决交付前一周把源码冻结不要为了写报告再改功能。所有报告截图、演示视频、功能列表都基于冻结后的这版源码。离开答辩还有时间的话我建议按“老师拿到源码、看到他环境里能跑起来”这条标准写一个 README 放到源码根目录里标明开发工具版本、API 版本、模拟器或真机型号这一步能有效降低老师在自己电脑上打不开项目时的失望感。报告里加一页“运行环境说明”和 README 内容保持一致。5. 让源码和报告互相支撑期末大作业交付包这样整理5.1 交付清单和报告结构期末大作业交的不只是代码是一整套东西源码、报告、演示视频三件套缺一不可。我见过太多学生代码写得不错结果报告里流程图没有、数据表没有、测试过程没有白白丢分。整理交付包的步骤我建议按这个顺序走交付物要求自查点源码工程删掉 build、previewer 等本地缓存目录保留全部源码和配置文件换一台电脑能否直接打开报告文档包含需求分析、页面设计、关键代码、测试过程四部分所有截图是否出自最终版本演示视频2 分钟从首页进入按照功能顺序演示视频里的页面和源码是否能对上报告里的“关键代码”部分不要贴大段源码每页贴一段核心代码加两句注释即可。老师没时间读你的全部代码他们看重的是这个页面怎么实现的、数据怎么存的、路由怎么跳的。这三条能在报告里各自讲清楚就拿住了基础分。我在这种交付上吃过亏。有一门课程的报告里测试章节的截图是旧版界面和最终源码里的页面颜色都不一样老师翻到那页就问了一句我当时差点没接住。后来养成的习惯是所有截图、视频、代码统一在一个晚上生成不再回头改功能。你要交期末作业之前也建议照着这个节奏验收一遍。把开发工具、API 版本、运行方式都写进 README把演示视频控制在两分钟内把报告截图和源码逐一核对。做到这三条你交出去的每个文件都能自圆其说老师也就不太会为难你了。希望帮到你。本文还有配套的精品资源点击获取