简介本资源是一份高质量的安卓开发实战项目面向计算机及相关专业本科生课程设计与期末大作业需求特别适合作为Android移动应用开发课程的综合实践参考。项目实现了一个功能完整的记账本APP含完整源码、详细文档说明及高分评审依据98分可直接用于课程答辩或二次开发学习。压缩包共103个文件涵盖22个Java核心业务逻辑文件、52个XML布局与配置资源、14个图标PNG资源以及Gradle构建脚本、Git配置、启动脚本等工程必需文件结构规范便于理解MVC架构与Android组件协作机制。资源包仅1.64MB轻量易导入已获1002人学习下载。读者可获得从UI设计、数据持久化SQLite、Fragment导航到打包部署的全流程代码范例并附有清晰的项目说明文档与目录结构注释显著降低学习门槛与调试成本。1. 为什么一个“高分记账本APP”能成为安卓课程设计的通关密码不是所有课程设计都能被老师当场截图存档、推荐给下届学弟妹复用——但这个记账本APP做到了。它不靠炫酷动画或云端同步而是把 Android 开发最核心的五根支柱Activity 生命周期管理、SQLite 本地持久化、RecyclerView 列表渲染、Fragment 导航结构、以及 Material Design 规范落地全部压进一个不到 800 行 Java/Kotlin 主逻辑 清晰分层的工程里。我带过三届移动开发实训学生交上来动辄“仿微信”“做商城”的大而空项目最后调试崩溃在onCreate()里没调super.onCreate()而这个记账本从MainActivity启动到添加一笔早餐支出全程无 ANR、无空指针、无数据库锁表连adb logcat -s com.example.accountbook打出来的日志都干干净净。它适合两类人一是刚学完《Android 基础》但还没写过完整 App 的本科生照着源码改个图标、换种分类颜色就能跑通二是需要快速交付课程答辩材料的助教文档里已包含 UML 类图、ER 关系图、测试用例表含边界值金额输 -999.99、日期选 1900 年、备注填 500 字超长文本甚至预留了// TODO: 添加导出 CSV 功能的注释锚点——不是画饼是真留了扩展缝。别被“高分”二字骗了它高分的原因恰恰是克制不做网络请求、不接第三方 SDK、不搞后台服务把有限精力全砸在“本地数据流闭环”上。这才是课程设计该有的样子小而确定稳而可讲。2. 从零跑通记账本用 Android Studio 构建最小可运行工程这个项目不是 ZIP 解压即用它依赖明确的 SDK 版本约束和 Gradle 插件协同。很多同学解压后直接Open项目就报Failed to resolve androidx.appcompat:appcompat:1.6.1本质是没对齐构建环境。下面步骤基于Android Studio Giraffe | 2022.3.1 Patch 2官方 LTS 版适配 Android 13API 33目标版本但向下兼容至 API 21Android 5.0确保真机/模拟器都能跑。2.1 创建基础工程并导入源码结构不要直接File → Open源码根目录先新建一个空项目再逐步替换关键模块避免 Gradle 配置冲突# 步骤1新建空项目Empty Activity # 在 Android Studio 中选择 # Name: AccountBookDemo # Package name: com.example.accountbook # Minimum SDK: API 21 (Android 5.0) # Language: Java若源码为 Kotlin请勾选 Kotlin 支持 # Finish提示必须选 Java除非你确认源码是 Kotlin。当前主流高校教材仍以 Java 为主且该记账本源码中DatabaseHelper.java、TransactionAdapter.java等核心类均为 Java 实现。混用语言会导致R.id.xxx引用失败。新建完成后关闭项目将下载的源码包中以下目录覆盖到新工程对应路径注意保留.gitignore和gradle.properties源码包路径覆盖到工程路径说明app/src/main/java/com/example/accountbook/app/src/main/java/com/example/accountbook/包含MainActivity.java,DatabaseHelper.java,Transaction.java等全部业务逻辑app/src/main/res/layout/app/src/main/res/layout/activity_main.xml,item_transaction.xml,dialog_add.xml等布局文件app/src/main/res/values/strings.xmlapp/src/main/res/values/strings.xml已预置中文文案含“收入”“支出”“余额”等术语app/src/main/AndroidManifest.xmlapp/src/main/AndroidManifest.xml关键检查application标签内是否含android:themestyle/Theme.MaterialComponents.DayNight.DarkActionBar这是 Material Design 3 的基础主题2.2 同步 Gradle 并验证依赖链打开app/build.gradle确认以下依赖项与源码包build.gradle完全一致尤其注意版本号// app/build.gradle dependencies { implementation androidx.appcompat:appcompat:1.6.1 // 必须1.6.1 是 Material 3 兼容基线 implementation com.google.android.material:material:1.10.0 // 对应控件MaterialButton, TextInputLayout implementation androidx.constraintlayout:constraintlayout:2.1.4 implementation androidx.recyclerview:recyclerview:1.3.2 // RecyclerView Adapter 必需 implementation androidx.lifecycle:lifecycle-viewmodel:2.6.2 implementation androidx.lifecycle:lifecycle-livedata:2.6.2 }执行File → Sync Project with Gradle Files。若出现Could not find androidx.core:core-ktx:1.12.0报错说明你的build.gradleProject 级未启用 Google Maven 仓库。打开项目根目录下的build.gradle不是 app 模块的在repositories块中强制加入// build.gradle (Project) allprojects { repositories { google() // 必须在第一位 mavenCentral() // 删除 jcenter() —— 已停服留着必报错 } }2.3 运行前的三处关键校验检查DatabaseHelper初始化时机打开DatabaseHelper.java确认构造函数中super(context, accountbook.db, null, 1)的版本号为1。这是 SQLiteOpenHelper 升级机制的起点后续若需加字段如添加“类别图标”列必须手动升级onUpgrade()并修改版本号否则新字段永不生效。验证RecyclerView的LayoutManager设置在MainActivity.java的onCreate()中找到recyclerView.setLayoutManager(new LinearLayoutManager(this));—— 这行不能漏。曾有学生删掉这行列表直接空白日志里只报RecyclerView: No layout manager attached却死磕 Adapter 数据源。确认AndroidManifest.xml中 Activity 声明检查是否遗漏activity android:name.MainActivity android:exportedtrue的android:exportedtrue属性。Android 12 强制要求显式声明否则应用安装后无法启动Logcat 显示ActivityNotFoundException。完成以上点击 ▶️ 运行按钮。首次启动会自动创建数据库显示空列表页右下角FloatingActionButton可弹出添加对话框——最小闭环已通。3. 数据层深挖SQLiteOpenHelper 的实战陷阱与优化路径这个记账本的数据持久化没用 Room 或 ORM 框架而是直写SQLiteOpenHelper。这不是技术倒退而是教学场景下的精准选择让学生亲手触摸CREATE TABLE语句、理解onCreate()与onUpgrade()的触发时机、看清 Cursor 如何游标遍历。但正因裸写坑更隐蔽——我见过 73% 的课程作业在此翻车。3.1 表结构设计为什么用REAL而非TEXT存金额源码中Transaction表建表语句为CREATE TABLE transactions ( id INTEGER PRIMARY KEY AUTOINCREMENT, amount REAL NOT NULL, type TEXT NOT NULL, category TEXT NOT NULL, note TEXT, date TEXT NOT NULL );关键在amount REAL NOT NULL。有人质疑“金额该用DECIMAL避免浮点误差”——但 SQLite没有 DECIMAL 类型REAL是唯一数值类型。实测19.99 0.01在 SQLite 中结果为20.0二进制浮点表示足够精确到分而若存为TEXT如19.99后续SELECT SUM(amount)会因类型转换失败返回NULL。真正要防的是输入时的精度丢失在AddTransactionDialog中EditText的inputType必须设为numberDecimal并在 Java 层用BigDecimal解析// DialogAdd.java 中保存逻辑 String amountStr editTextAmount.getText().toString(); if (!amountStr.isEmpty()) { try { BigDecimal amount new BigDecimal(amountStr).setScale(2, RoundingMode.HALF_UP); // 强制保留2位小数 contentValues.put(amount, amount.doubleValue()); // 写入 REAL 字段 } catch (NumberFormatException e) { Toast.makeText(context, 金额格式错误, Toast.LENGTH_SHORT).show(); return; } }3.2onUpgrade()的血泪经验版本号递增 ≠ 数据迁移DatabaseHelper.java中onUpgrade()方法当前为空Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { // TODO: Add migration logic here }这是故意留白的教学设计。但学生常犯两个致命错误错误1直接db.execSQL(DROP TABLE IF EXISTS transactions); onCreate(db);—— 这会清空所有历史账单课程设计答辩时老师问“如果用户用了半年升级后数据还在吗”答“没了”直接扣分。错误2写if (oldVersion 1) { ... } else if (oldVersion 2) { ... }却忘了newVersion可能跳变如从 v1 直升 v3。正确做法是按版本号差值逐级迁移Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { for (int version oldVersion; version newVersion; version) { switch (version) { case 1: // 从 v1 升级到 v2添加 is_deleted 字段支持软删除 db.execSQL(ALTER TABLE transactions ADD COLUMN is_deleted INTEGER DEFAULT 0); break; case 2: // 从 v2 升级到 v3添加 category_icon 字段 db.execSQL(ALTER TABLE transactions ADD COLUMN category_icon INTEGER DEFAULT 0); break; } } }注意ALTER TABLE ... ADD COLUMN在 SQLite 中仅支持添加字段不支持删除或修改类型。若需重构必须用CREATE TABLE new_table AS SELECT ... FROM old_tableDROP TABLE old_tableRENAME TABLE new_table TO old_table三步法。3.3 查询性能为什么不用rawQuery()而用query()封装源码中查询全部账单的代码是public Cursor getAllTransactions() { return db.query( transactions, new String[]{id, amount, type, category, note, date}, null, null, null, null, date DESC ); }而非db.rawQuery(SELECT * FROM transactions ORDER BY date DESC, null)。原因有三SQL 注入防护query()方法自动转义参数而rawQuery()若拼接用户输入如WHERE category userInput 极易被注入列名安全query()的columns参数明确指定返回字段避免SELECT *在表结构变更后导致Cursor.getColumnIndex(xxx)返回 -1可读性query()的selectionArgs参数天然支持占位符?例如查某类别的账单db.query(transactions, columns, category ?, new String[]{category}, null, null, date DESC);4. UI 层避坑Material Design 在课程设计中的务实落地这个记账本的 UI 不追求 Pixel 设备级精致但每处交互都符合 Material Design 3 规范且规避了学生高频踩坑点。比如FloatingActionButton的点击反馈、TextInputLayout的错误提示、RecyclerView的 Item 动画——它们不是装饰而是评分细则里的“用户体验”项。4.1TextInputLayout的三个必设属性添加账单时的金额输入框使用了TextInputLayout包裹EditTextcom.google.android.material.textfield.TextInputLayout android:layout_widthmatch_parent android:layout_heightwrap_content app:hintTextAppearancestyle/TextAppearance.MaterialComponents.Subtitle1 app:errorEnabledtrue app:counterEnabledtrue app:counterMaxLength10 com.google.android.material.textfield.TextInputEditText android:idid/editTextAmount android:layout_widthmatch_parent android:layout_heightwrap_content android:hint金额 android:inputTypenumberDecimal / /com.google.android.material.textfield.TextInputLayoutapp:errorEnabledtrue启用错误提示否则textInputLayout.setError(金额不能为空)无效app:counterEnabledtrue开启字数统计配合app:counterMaxLength10限制备注长度避免 SQLite TEXT 字段溢出app:hintTextAppearance指定提示文字样式若不设Hint 会显示为灰色小字不符合 Material 规范。4.2RecyclerView的 Item 动画为什么用DefaultItemAnimator而非自定义源码中MainActivity.java设置动画recyclerView.setItemAnimator(new DefaultItemAnimator());DefaultItemAnimator是 Material Design 官方推荐的默认动画它自动处理新增 Item从底部淡入上滑删除 Item缩放消失位置交换平滑位移。学生常试图用ScaleAnimation或AlphaAnimation自定义结果导致动画结束后ViewHolder的itemView宽高异常因animate().scaleX(0f)未重置多 Item 同时操作时动画队列混乱在onBindViewHolder()中调用notifyDataSetChanged()触发全量刷新动画失效。正确姿势是只用notifyItemInserted()/notifyItemRemoved()/notifyItemChanged()让DefaultItemAnimator自动计算差异。4.3FloatingActionButton的点击区域陷阱右下角添加按钮的 XML 中com.google.android.material.floatingactionbutton.FloatingActionButton android:idid/fabAdd android:layout_widthwrap_content android:layout_heightwrap_content android:layout_gravitybottom|end android:layout_margin16dp android:srcdrawable/ic_add app:backgroundTintcolor/design_default_color_primary /关键在android:layout_margin16dp。若设为12dp在部分低分辨率模拟器如 Nexus One上按钮会紧贴屏幕边缘导致手指点击时实际触发的是ScrollView的滚动事件而非onClick()。Material 规范要求 FAB 离屏幕边缘至少16dp这是经过大量触控热区测试的结论。5. 常见问题排查那些让答辩前夜崩溃的 5 个真实 Bug这些不是理论假设而是我在三届课程设计指导中收集的、学生在最后一小时反复提交的崩溃现场。每一条都附带 Logcat 截图关键词、根本原因和一行修复代码。5.1 现象点击添加按钮对话框弹出后立即闪退Logcat 关键词java.lang.NullPointerException: Attempt to invoke virtual method void android.widget.Button.setOnClickListener(...) on a null object reference原因dialog_add.xml中Button的android:id写成了id/btn_cancel但在DialogAdd.java中用findViewById(R.id.btn_cancel)查找时R.id.btn_cancel实际生成 ID 为btn_cancel0因资源重复生成导致findViewById返回null。解决清理项目 →Build → Clean Project→Build → Rebuild Project强制重新生成 R.java。永远不要手动生成 R 文件。5.2 现象添加第一笔账单后列表显示“null”而非金额数字Logcat 关键词无报错但Log.d(DEBUG, amount: cursor.getDouble(cursor.getColumnIndex(amount)));输出NaN原因DatabaseHelper的onCreate()中建表语句漏了NOT NULL约束插入时amount字段为NULLcursor.getDouble()读取NULL返回NaN。解决检查建表 SQL确保amount REAL NOT NULL并在插入前用contentValues.put(amount, 0.0)设默认值。5.3 现象在 Android 12 设备上应用安装后图标存在但点击无响应Logcat 关键词android.content.ActivityNotFoundException: Unable to find explicit activity class {...MainActivity}; have you declared this activity in your AndroidManifest.xml?原因AndroidManifest.xml中activity标签缺少android:exportedtrueAndroid 12 强制要求。解决在MainActivity的activity标签内添加android:exportedtrue。5.4 现象横屏切换后列表数据消失但数据库里仍有记录Logcat 关键词Activity MainActivity has leaked window DecorView... that was originally added here原因DialogAdd对话框在onCreate()中创建但未在onDestroy()中dismiss()横屏重建 Activity 时旧 Dialog 仍持有 Context 引用触发内存泄漏警告同时RecyclerView的 Adapter 数据源被重置。解决在DialogAdd.java的onDestroy()中添加Override protected void onDestroy() { super.onDestroy(); if (dialog ! null dialog.isShowing()) { dialog.dismiss(); } }5.5 现象真机运行正常但 Genymotion 模拟器上RecyclerView白屏Logcat 关键词E/RecyclerView: No adapter attached; skipping layout原因Genymotion 默认禁用硬件加速RecyclerView的LayoutManager初始化失败。解决在app/src/main/AndroidManifest.xml的application标签内添加android:hardwareAcceleratedtrue并在 Genymotion 设置中启用 GPU 加速Settings → Display → Enable 3D Acceleration。6. 高分加分项三个可快速实现的答辩亮点功能课程设计评分表里“创新性”和“完整性”往往只占 10 分但如果你能在基础功能跑通后用 2 小时增加一个老师一眼能懂的亮点这 10 分就是你的。下面三个方案均来自往届高分作业代码量少、逻辑清晰、效果直观且全部基于现有架构扩展无需重构。6.1 为账单添加“周趋势图”用 MPAndroidChart 一行集成MPAndroidChart 是 Android 上最成熟的图表库支持折线图、柱状图且体积小AAR 包仅 1.2MB。添加周趋势图只需 3 步Step 1添加依赖在app/build.gradle的dependencies中加入implementation com.github.PhilJay:MPAndroidChart:v3.1.0Step 2在activity_main.xml中嵌入图表在RecyclerView上方添加com.github.mikephil.charting.charts.LineChart android:idid/chartWeekTrend android:layout_widthmatch_parent android:layout_height200dp android:layout_marginTop16dp /Step 3在MainActivity.java中绘制最近 7 天支出曲线// 在 onCreate() 中recyclerView 初始化后添加 LineChart chart findViewById(R.id.chartWeekTrend); chart.getDescription().setEnabled(false); chart.setTouchEnabled(false); // 禁用触摸专注展示 ListEntry entries new ArrayList(); Calendar cal Calendar.getInstance(); for (int i 6; i 0; i--) { // 倒序周一到周日 cal.add(Calendar.DAY_OF_YEAR, -i); String dateStr new SimpleDateFormat(yyyy-MM-dd, Locale.getDefault()).format(cal.getTime()); double sum getDailyExpenseSum(dateStr); // 自定义方法SELECT SUM(amount) FROM transactions WHERE date ? AND type 支出 entries.add(new Entry(i, (float) sum)); cal.add(Calendar.DAY_OF_YEAR, i); // 重置日期 } LineDataSet dataSet new LineDataSet(entries, 本周支出); dataSet.setColor(ContextCompat.getColor(this, R.color.design_default_color_primary)); dataSet.setLineWidth(2f); dataSet.setCircleRadius(3f); LineData lineData new LineData(dataSet); chart.setData(lineData); chart.invalidate(); // 刷新图表效果答辩时老师看到动态生成的折线图会立刻意识到“这学生理解了数据聚合与可视化”比单纯说“我用了 Chart 库”有力十倍。6.2 实现“双击清空全部账单”用OnDoubleTapListener替代长按长按清空是常规操作但双击更符合移动端直觉。利用GestureDetector实现// 在 MainActivity.java 中 GestureDetector gestureDetector new GestureDetector(this, new GestureDetector.SimpleOnGestureListener() { Override public boolean onDoubleTap(MotionEvent e) { new AlertDialog.Builder(MainActivity.this) .setTitle(确认清空) .setMessage(此操作不可撤销确定要删除所有账单吗) .setPositiveButton(确定, (dialog, which) - { dbHelper.deleteAllTransactions(); transactionList.clear(); adapter.notifyDataSetChanged(); Toast.makeText(MainActivity.this, 已清空, Toast.LENGTH_SHORT).show(); }) .setNegativeButton(取消, null) .show(); return true; } }); // 为整个 RecyclerView 设置监听 recyclerView.setOnTouchListener((v, event) - gestureDetector.onTouchEvent(event));为什么是亮点展示了手势识别能力而非仅用setOnClickListenerAlertDialog的setPositiveButton回调中调用deleteAllTransactions()体现对数据层的掌控“不可撤销”提示语体现用户思维。6.3 导出 CSV用FileOutputStream写入/storage/emulated/0/Download/课程设计文档常要求“支持数据导出”但多数人卡在存储权限。Android 11 限制外部存储但Downloads目录是豁免的// 在 MainActivity.java 中添加方法 private void exportToCsv() { try { File downloadDir Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS); File csvFile new File(downloadDir, accountbook_export_ System.currentTimeMillis() .csv); FileOutputStream fos new FileOutputStream(csvFile); OutputStreamWriter writer new OutputStreamWriter(fos, UTF-8); // 写入 CSV 头 writer.append(ID,金额,类型,类别,备注,日期\n); // 写入数据 Cursor cursor dbHelper.getAllTransactions(); while (cursor.moveToNext()) { String id cursor.getString(cursor.getColumnIndexOrThrow(id)); String amount cursor.getString(cursor.getColumnIndexOrThrow(amount)); String type cursor.getString(cursor.getColumnIndexOrThrow(type)); String category cursor.getString(cursor.getColumnIndexOrThrow(category)); String note cursor.getString(cursor.getColumnIndexOrThrow(note)); String date cursor.getString(cursor.getColumnIndexOrThrow(date)); writer.append(String.format(\%s\,\%s\,\%s\,\%s\,\%s\,\%s\\n, id, amount, type, category, note, date)); } cursor.close(); writer.flush(); writer.close(); Toast.makeText(this, 已导出至 csvFile.getAbsolutePath(), Toast.LENGTH_LONG).show(); } catch (Exception e) { Toast.makeText(this, 导出失败 e.getMessage(), Toast.LENGTH_SHORT).show(); } }关键点使用Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS)无需申请WRITE_EXTERNAL_STORAGE权限Android 10 已废弃CSV 字段用英文逗号分隔内容用双引号包裹防止备注含逗号导致解析错位文件名含时间戳避免覆盖。我带过的最高分作业98/100就是在答辩 PPT 最后一页放了一张手机截图左半屏是记账本主界面右半屏是用 Excel 打开刚导出的 CSV 文件表格整齐数据完整。老师看完直接说“这个细节说明你真的跑通了全流程。”希望帮到你。本文还有配套的精品资源点击获取