简介：本资源是面向计算机及相关专业本科生的鸿蒙移动应用开发期末大作业实战项目，聚焦校园迎新场景，提供完整可运行的HarmonyOS应用源码与配套设计报告，专为课程设计、期末作业及鸿蒙开发入门实践打造。压缩包共324个文件，含107个核心逻辑文件（.ets）、124张界面截图与图标（.png）、52张辅助图片（.jpg）、12个矢量图标（.svg），以及JSON配置、TS/JS工具脚本、PDF报告和MP4演示视频等，总大小443.12MB，结构清晰、模块解耦明确，涵盖首页、任务管理、地图导航、迎新介绍等完整功能链路。已有1550人学习下载，项目经导师指导并获99分高分评价，代码注释充分、依赖精简、环境适配主流DevEco Studio版本，小白亦可一键编译运行。读者可直接复用项目框架、参考ViewModel分层设计、借鉴DialogComponent等通用组件封装思路，并结合报告深入理解需求分析、UI设计与HarmonyOS生命周期实践要点。 先说个实话：当初决定用鸿蒙做移动应用开发期末作业时，我的第一反应是上网找一套校园迎新APP的源码，改巴改巴交上去。结果翻了整整两天，能直接跑起来的少之又少。找到的鸿蒙项目源码，要么是API 6时代的老古董，工程结构和现在的DevEco Studio完全对不上；要么结构乱成一锅粥，注释比代码还少。最后我认了，老老实实从零开始写。
这套校园迎新APP从搭工程到最终跑通，加上写报告，一共花了我大约两周的课余时间。现在回头看，这大概是整个大学阶段收获最大的一次作业——它不仅让我把移动应用开发课上那些零碎的概念串成了一条线，还让我在答辩时第一次体会到“被老师追问但越讲越自信”的感觉。
这篇文章就完整复盘一下：题目怎么选、架构怎么搭、底部导航和液态玻璃怎么适配、数据怎么存、hdc调试有什么坑、报告和答辩怎么准备。如果你也是做移动应用开发期末作业、又刚好选鸿蒙方向，这篇文章可以帮你少走不少弯路。
1. 为什么期末大作业我选了鸿蒙，以及校园迎新APP这个题目好在哪
1.1 选鸿蒙的真实动机：不是赶时髦，是课程风向变了
我们这门移动应用开发课，前半学期讲Android，后半学期专门留了几周讲鸿蒙。当时不少同学觉得鸿蒙就是“换皮的Android”，没当回事，期末作业一股脑全报了Android。但真到做的时候我发现，事情没那么简单。
选鸿蒙的原因有三层。第一，这是课程最后讲的内容，印象最深，做起来最有延续性；第二，网上Android期末作业一抓一大把，鸿蒙的相对少，答辩时老师也愿意多聊两句新东西；第三，也是最实际的——Android项目从0到1的教程太多了，反而没什么挑战，鸿蒙的文档少、坑多，但做完以后知识是自己的。
当然，选鸿蒙的代价也实实在在：社区资料少，版本迭代快。我在网上查资料时，经常搜到去年的代码，用的是旧API，复制到新版DevEco Studio里直接报错。后来养成了习惯：看到一篇博客先看发布时间和标注的SDK版本，版本对不上就直接略过，省了很多时间。
1.2 为什么选校园迎新这个业务场景
迎新APP几乎是期末作业的“标准答案”。为什么？因为它的业务场景足够真实，但边界又很清晰。
真实的迎新流程包含：新生信息登记、报到进度查询、校园公告、宿舍安排、缴费状态——这些映射到移动开发里，恰好对应：表单输入、页面跳转、列表渲染、状态管理、本地存储。可以说一张卷子把移动开发的核心知识点全考了，但每道题难度都不高，期末作业最需要的就是这种“覆盖面广但单点不难”的题目。
如果选“记账本”或者“备忘录”，功能太少，报告写不出三页技术点；如果选“电商平台”，光是订单状态流转就够写一个月的。迎新APP刚好卡在中间。关键它还有天然的展示效果：首页有轮播图、有流程引导、有列表、有个人中心，截几张图放在报告里，版面也撑得住。
1.3 先给想直接找源码的朋友一句提醒
网上确实能搜到不少“校园迎新APP鸿蒙源码”，但据我帮同学看代码的经验，直接下载别人的工程能跑起来的概率不高。原因一般是：SDK版本不一致、工程配置残留、资源文件缺失、签名信息对不上。
就算跑起来了，答辩时老师让你现场改个功能，你连工程的目录结构都不熟，当场就露馅。所以源码可以看，但一定要自己敲一遍、改一遍，把所有报错都经历一遍，这个项目才真正属于你。我后面会详细讲完整的工程搭建和踩坑过程，跟一套学下来，你对自己项目的熟悉程度完全不一样。
2. 工程搭建与架构设计：ArkTS、SDK版本和目录怎么定
2.1 语言选型：为什么是ArkTS而不是Java或JavaScript
现在新建鸿蒙工程，默认就是ArkTS。它本质上是TypeScript的超集，同时加了一套声明式UI语法，用起来的感觉介于Flutter和SwiftUI之间。如果你之前写过前端，上手会很快；如果只写过Android的Java/Kotlin，会有一个短暂的适应期——原来“控件.setXXX”的写法全变成了装饰器加状态绑定。
| 对比项 | ArkTS | Java（旧方案） | JavaScript（旧方案） |
|---|---|---|---|
| UI写法 | 声明式，状态驱动 | 命令式，XML布局 | 声明式但不成熟 |
| 官方支持 | 当前主推 | 逐步退出主导 | 逐步退出主导 |
| 前端基础迁移成本 | 低 | 高 | 低 |
| 期末作业推荐度 | 强烈推荐 | 不推荐 | 不推荐 |
一句话：如果你现在开始学鸿蒙，直接学ArkTS，不用犹豫。
2.2 SDK版本怎么选：别盲目追新
开发环境是DevEco Studio，SDK版本我一上来装的当时最新的，结果折腾了两天，后来老老实实换回老师课件对应的版本。这里给所有人的建议是：以课程课件标明的版本为准；如果课件没写明，默认选教学视频对应的那个大版本。
鸿蒙API每个大版本之间，组件属性和方法会变。网上教程如果没标注版本，照着写很容易翻车。我做的时候用的是当时比较稳定的版本，你现在做的话，用什么版本取决于DevEco Studio安装时为你配置的默认SDK。提醒一个小技巧：如果工程编译报错出现类似“Property 'xxx' does not exist”或者“Cannot find name”的提示，先想到版本问题，而不是代码问题。很多网上老代码就是这么废的。
2.3 工程目录怎么组织
项目名称我起得比较直白：CampusWelcome。工程默认会生成entry模块，核心代码都在entry/src/main/ets下面。我在里面分了这几个目录：
- pages/：放页面。首页、新闻列表、新闻详情、迎新流程、个人中心、登录页都在这下面。
- model/：放数据模型，就是一堆interface定义，比如StudentInfo、NewsItem、FlowStep。
- common/：放公共组件和工具类，比如自定义的列表项组件、日期格式化函数。
- repository/：放数据获取逻辑，比如从rawfile读JSON、解析成对象。
这种分包方式不算复杂，但分层清楚：页面归页面、数据归数据、模型归模型。答辩的时候，老师问“你的数据从哪里来”，你直接说repository层负责读JSON，再按接口封装，以后想换成本地数据库或者后端API，改动都在这一层——这个回答是很加分的。
2.4 配置和签名：很多工程跑不起来的元凶
鸿蒙应用的图标、应用名、权限声明都在entry/src/main/module.json5里。如果APP要联网，需要声明INTERNET权限；如果要用到相机或定位，也要在这里提前声明。很多网上的工程源码直接装不上，就是因为这里的权限声明和代码不匹配。
签名在DevEco Studio里是自动生成的。路径是：File → Project Structure → Signing Configs，勾选Automatically generate signature。第一次生成需要登录华为账号，这步别跳过。我遇到过的情况是：工程从别人那里拷过来之后，原来的签名配置还残留在工程文件里，导致一直报“签名验证失败”。重新生成一次就好了。
3. 底部导航的实现思路，以及液态玻璃适配的实际操作
3.1 别自己堆按钮，用Tabs组件
一个APP最常见的入口结构就是底部导航栏。很多新手喜欢用Row加Button自己画一个放底部，然后点击切换页面内容。这个思路在鸿蒙里我不建议：页面切换的状态保存、滑动切换、角标显示、图标文字的选中态，这些Tabs组件全都帮你做了。自己写的话，后期每加一个功能都要手动维护状态，期末冲刺阶段容易写出一堆bug。
Tabs的基本结构大致是这样的：
// 结构示意，属性和方法名以官方文档为准 Tabs({ barPosition: BarPosition.End }) { TabContent() { HomePage() } TabContent() { NewsPage() } TabContent() { ProfilePage() } } // 再通过tabBar属性配置图标和文字每个TabContent对应一个页面，用tabBar设置底部图标和文字。这一点必须强调：页面内容可以简单，但主框架要和官方推荐保持一致。用Tabs的另一个好处是，底部导航栏的切换是系统级的，答辩时操作起来比较顺滑。
3.2 底栏样式调整的最常见问题
Tabs默认的底栏背景是白色，图标默认是灰色。要把图标改成“选中变蓝、未选中变灰”，需要给tabBar传一个自定义构建函数。函数里用一个状态记录当前选中索引，点击时更新，图标颜色根据索引切换。
思路很简单，但新手在自定义tabBar时经常遇到一个坑：自定义之后，Tabs的滑动切换和点击切换不同步。解决办法是监听Tabs的onChange事件，同步更新选中索引，让tabBar的显示状态跟随当前页面索引变化。这个坑我是在做个人中心页时踩到的，当时点底部按钮切换很流畅，但左右滑动时图标不跟着变，看起来特别奇怪。
3.3 液态玻璃效果：期末作业要不要上、怎么上
“液态玻璃”是鸿蒙较新的设计风格，核心是半透明、模糊、融为一体的玻璃质感。我的态度是：期末作业可以上，但优先级排在功能之后。如果项目主体功能都完成了、布局
本文还有配套的精品资源，点击获取
