Android毕设新手入门：从零搭建可交付的毕业项目架构-平芜编程栈

Android毕设新手入门：从零搭建可交付的毕业项目架构

摘要：许多计算机专业学生在完成Android毕设时面临项目结构混乱、功能堆砌无重点、代码耦合度高等问题，导致答辩表现不佳或延期交付。本文面向Android开发新手，提供一套轻量但规范的毕设项目搭建方案，涵盖MVVM架构选型、Room本地数据库集成、Retrofit网络请求封装及基础单元测试配置。读者将掌握如何在2-3周内构建一个结构清晰、具备完整CRUD功能且易于演示的毕业应用，显著提升代码质量与项目可信度。

一、新手常见痛点：为什么“跑得快”却“倒得早”

盲目套模板：GitHub 一搜“Android毕设”，star 最高的往往是 3 年前用 Java 写的 MVC demo。clone 下来能跑，但一改动就崩——Activity 里 800 行 SQL、网络请求、SharedPreferences 全挤在一起，改个字段名要全局替换。
缺架构思维：很多同学把“能跑”当终点，没有分层概念。答辩老师一问“如果以后把 SQLite 换成远程接口，要改几处？”——当场沉默。
功能堆砌无重点：为了“显得厉害”盲目加蓝牙、加扫码、加地图，结果核心业务流程都没跑通，PPT 上 10 页功能截图，代码里全是空实现。
忽视可演示性：本地写死数据，现场一换手机就 404；或者把服务器部署在寝室电脑，答辩教室没 Wi-Fi，直接原地爆炸。

一句话总结：先让项目“像回事”，再让它“跑起来”。下面给出一条“2-3 周可落地”的路线，亲测带过 5 届学弟妹，答辩通过率 100%。

二、技术栈选型：MVC vs MVVM & Hilt vs Dagger

维度	MVC	MVVM（推荐）
生命周期耦合	Activity 既管 UI 又管数据，旋转屏必崩	ViewModel 自动恢复，数据与 UI 解耦
单元测试	需要 Robolectric，慢	纯 JVM 测试 ViewModel，秒级
Google 官方态度	放弃治疗	2021 后样板代码全部按 MVVM 给

依赖注入同理：Dagger 学不动就直接上 Hilt，注解少、编译快、AS 自带模板，毕设阶段完全够用。下文代码全部基于 MVVM + Hilt，如果你还在用 MVC，建议直接重构，别犹豫。

三、核心实现细节：让代码“长得能见人”

3.1 项目骨架一览

com.example.todo ├── data │ ├── local │ │ └── TaskDao.kt │ ├── remote │ │ └── TaskApi.kt │ └── repo │ └── TaskRepository.kt ├── di │ └── AppModule.kt ├── ui │ ├── main │ │ ├── MainActivity.kt │ │ └── TaskViewModel.kt │ └── adapter └── utils

3.2 ViewModel 生命周期管理

关键点：不要持有 View、不要传入 Context。

@HiltViewModel class TaskViewModel @Inject constructor( private val repo: TaskRepository ) : ViewModel() { private val _tasks = MutableLiveData<List<Task>>() val tasks: LiveData<List<Task>> = _tasks fun loadTasks() = viewModelScope.launch { repo.getAllTasks() .collect { _tasks.value = it } } }

viewModelScope与宿主生命周期同步，页面销毁自动取消协程，比 GlobalScope 安全 100 倍。

3.3 Repository 层解耦

Repository 只做“数据调度”，不 care 数据从哪来：

class TaskRepository @Inject constructor( private val dao: TaskDao, private val api: TaskApi ) { fun getAllTasks(): Flow<List<Task>> = dao.getTasks() // 优先本地 suspend fun sync() concrete { val remote = api.pull() dao.insertAll(remote) } }

以后把 Room 换成 Firebase，只改 Repository 实现，UI 层零感知。

3.4 Room 实体定义与迁移策略

@Entity(tableName = "task") data class Task( @PrimaryKey(autoGenerate = true) val id: Int = 0, val title: String, val isDone: Boolean = false, val createAt: Long = System.currentTimeMillis() )

别忘了 exportSchema：

@Database(entities = [Task::], version = 1, exportSchema = true) abstract class AppDB : RoomDatabase() { abstract fun taskDao(): TaskDao }

exportSchema 生成的 json 文件要随 git 提交，这是老师判断你“懂迁移”的直接证据。

四、完整代码示例（含注释）

以下两个文件可直接放进工程跑通，建议逐行读注释，比任何理论都直观。

4.1 UserRepository.kt（演示登录分支）

interface UserRepository { suspend fun login(email: String, pwd: String): Result<User> } class UserRepositoryImpl @Inject constructor( private val api: UserApi, private val prefs: SharedPreferences ) : UserRepository { override suspend fun login(email: String, pwd: String): Result<User> { return try { val user = api.login(LoginRequest(email, pwd)) prefs.edit { putString("token", user.token) } Result.success(user) } catch (e: Exception) { Result.failure(e) } } }

4.2 MainActivity.kt（单一 Activity 架构）

@AndroidEntryPoint class MainActivity : AppCompatActivity() { private val vm: TaskViewModel by viewModels() private lateinit var binding: ActivityMainBinding override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) binding = ActivityMainBinding.inflate(layoutInflater) setContentView(binding.root) val adapter = TaskAdapter() binding.recycler.adapter = adapter vm.tasks.observe(this) { adapter.submitList(it) } vm.loadTasks() binding.fab.setOnClickListener { openAddTaskSheet() } } }

Clean Code 原则体现：

函数不超 20 行
命名语义化（loadTasks()而不是getData()）
拒绝魔法数，常量集中object Constants

五、冷启动优化 & 数据持久化安全

冷启动优化
- 使用App Startup库把 DB、DI 初始化合并到统一线程，减少 80~120 ms
- 合并android:theme的 splash 背景，避免白屏
数据持久化安全
- 账号 token 存EncryptedSharedPreferences，毕设也能讲“安全”得分点
- Room 支持SQLCipher，一句代码打开加密数据库：

Room.databaseBuilder(ctx, AppDB::class.java, "todo.db") .openHelperFactory(SupportFactory("password".toByteArray())) .build()

六、生产环境避坑指南

硬编码
把BASE_URL写在BuildConfig里，利用buildConfigField "String", "BASE_URL", "\"https://xxx.com\""，debug/release 环境一键切换。
权限申请遗漏
Android 11 后，读写外部存储要申请MANAGE_EXTERNAL_STORAGE，否则相册读不到图片。用ActivityResultContracts新 API，代码量减一半。
空指针 & 异常 swallowed
网络请求用Result<T>包装，统一onFailure抛到Snackbar，别让 crash 只在 logcat 里出现——老师现场可不会连 ADB。
ProGuard 混淆
release 打包一定开混淆，把 Room 实体、Retrofit 接口 keep 住，否则一启动就ClassNotFoundException。