简介本资源是一份面向高校Android开发初学者与课程设计学生的完整安卓应用实战项目聚焦学生信息管理系统的全流程实现帮助学习者系统掌握Android Studio开发核心技能。压缩包共1426个文件涵盖338个XML布局与资源文件、280个PNG图标素材、255个编译后class字节码、39个Java源码文件、12个APK安装包及多个gradle构建配置文件完整呈现从UI设计、SQLite数据存储、Activity跳转、RecyclerView列表展示到权限适配与调试发布的全链路工程结构总大小21.14MB。已有3738人学习下载项目代码规范、模块清晰、注释充分附带可直接运行的debug版APK与资源打包产物如resources-debug.ap_、slice_x.apk等便于快速部署验证与逆向理解构建流程是Android入门实践与课程作业交付的理想参考范例。1. 学生信息管理App一个能真正在Android Studio里跑通、改得动、交得上的课程设计闭环你是不是也经历过——老师布置“用Android Studio做一个学生信息管理系统”结果网上搜到的代码要么缺数据库表结构要么Activity跳转逻辑断在半路要么连build.gradle里该配哪个版本的com.android.tools.build:gradle都模棱两可这个Mystudent项目不是Demo截图也不是半成品框架而是一个从新建项目开始、完整走完“添加学生→查询列表→修改信息→删除记录→本地SQLite持久化”全链路的可运行工程。它不炫技没用Jetpack Compose纯XMLJava或Kotlin原生SQLite所有Activity之间用Intent传参、所有数据操作封装在DAO层、所有UI控件命名规范可读。适合大二大三刚学完《移动应用开发》课程的学生直接导入Android Studio 4.2兼容Gradle 7.0改个包名就能当课设交作业也适合想补Android基础的同学把它当“教科书式样板”——看清楚一个真实App里onCreate()里该初始化什么CursorAdapter怎么绑定ListViewContentValues怎么填字段甚至adb logcat | grep Mystudent时该盯哪几行日志。这不是玩具项目是踩过坑、修过bug、真在真机上点过“添加”按钮弹出Toast的落地工程。2. 工程结构与技术栈解析从project根目录到app/src/main的每一层都藏着关键线索2.1 项目层级与模块划分为什么这个结构能避免“导入就报红”打开解压后的Mystudent文件夹你会看到典型的Android Studio标准结构Mystudent/ ├── app/ # 核心模块所有业务代码在此 │ ├── src/ │ │ ├── main/ │ │ │ ├── java/com/example/mystudent/ # Java源码若为Kotlin版则为kotlin/ │ │ │ │ ├── MainActivity.java # 主界面学生列表展示 │ │ │ │ ├── AddStudentActivity.java # 添加界面表单输入 │ │ │ │ ├── EditStudentActivity.java # 编辑界面回显更新 │ │ │ │ ├── Student.java # 实体类id, name, age, major等字段 │ │ │ │ ├── StudentDBHelper.java # SQLiteOpenHelper子类建表、升级 │ │ │ │ └── StudentDAO.java # 数据访问对象增删改查封装 │ │ │ ├── res/ # 资源文件 │ │ │ │ ├── layout/ # activity_main.xml, activity_add.xml等 │ │ │ │ ├── values/ # strings.xml定义所有文本 │ │ │ │ └── ... │ │ │ └── AndroidManifest.xml # 四大组件注册、权限声明 │ │ └── build.gradle # 模块级构建脚本重点看dependencies │ ├── build.gradle # 项目级构建脚本定义gradle插件版本 ├── gradle/ └── settings.gradle提示很多同学导入失败根本原因不是代码问题而是app/build.gradle里compileSdkVersion和targetSdkVersion写成了33但本地Android Studio只装了SDK 31。务必先打开File → Project Structure → SDK Location确认已安装的SDK Platform版本再反向匹配build.gradle中的数值。常见做法是统一设为31对应Android 12L既兼容旧设备又避开33引入的严格后台限制导致的崩溃。2.2 核心依赖与版本锁定Gradle配置里的生存指南app/build.gradle中关键依赖如下以Java版为例android { compileSdkVersion 31 // 必须与本地SDK安装版本一致 buildToolsVersion 30.0.3 // 若报错可删掉此行AS会自动选最新可用版 defaultConfig { applicationId com.example.mystudent minSdkVersion 16 // 支持Android 4.1覆盖99%以上设备 targetSdkVersion 31 // 与compileSdkVersion保持一致 versionCode 1 versionName 1.0 } } dependencies { implementation androidx.appcompat:appcompat:1.4.2 // 兼容库必须 implementation com.google.android.material:material:1.6.1 // Material Design组件 implementation androidx.constraintlayout:constraintlayout:2.1.4 // 布局利器 // 注意没有引入Room或LiveData纯原生SQLite降低学习门槛 }这里没有用androidx.room:room-runtime说明它绕过了Jetpack架构组件的抽象层直接操作SQLiteDatabase对象。好处是逻辑透明——你看得见每一条INSERT INTO student (...) VALUES (...)是怎么拼出来的坏处是需要手动处理游标关闭、事务边界。这正是课程设计要考察的基本功不是调API而是理解数据如何落盘。2.3 Manifest注册与Activity跳转链四步完成一次学生添加AndroidManifest.xml中三个Activity的注册是功能闭环的前提activity android:name.MainActivity android:exportedtrue intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity activity android:name.AddStudentActivity android:exportedfalse / activity android:name.EditStudentActivity android:exportedfalse /注意android:exportedfalse表示这些Activity不能被其他App启动符合安全规范。而跳转逻辑全部在Java代码中完成例如MainActivity中点击“添加”按钮// MainActivity.java addBtn.setOnClickListener(v - { Intent intent new Intent(MainActivity.this, AddStudentActivity.class); startActivity(intent); // 启动添加界面 });这种显式Intent调用比隐式Intent更可控也更适合初学者理解组件通信本质。2.4 资源文件组织逻辑strings.xml和layout如何支撑多语言与适配res/values/strings.xml不只是存文字更是解耦UI与逻辑的第一道防线resources string nameapp_nameMyStudent/string string nametitle_activity_main学生信息列表/string string namebtn_add添加学生/string string namehint_name请输入姓名/string string namehint_age请输入年龄/string string namehint_major请输入专业/string string nametoast_add_success添加成功/string string namedialog_delete_title确认删除/string string namedialog_delete_message确定要删除该学生信息吗/string /resources所有界面文字都通过string/btn_add引用而非硬编码。这意味着若需中英文切换只需新增res/values-en/strings.xml若老师要求改成“学员信息管理”改一处strings.xml即可全局生效Toast.makeText(..., R.string.toast_add_success, ...)比写死字符串更易维护。同理activity_main.xml使用ConstraintLayout而非LinearLayout是因为它天然支持不同屏幕尺寸的约束关系——比如“删除按钮始终在列表项右侧”这种声明式布局比Java代码动态计算坐标更稳定也更符合现代Android开发习惯。3. SQLite数据库实现详解StudentDBHelper与StudentDAO的协作机制3.1 StudentDBHelper建表语句、版本升级与onUpgrade的血泪经验StudentDBHelper.java继承自SQLiteOpenHelper核心在于onCreate()和onUpgrade()两个方法public class StudentDBHelper extends SQLiteOpenHelper { private static final String DATABASE_NAME student.db; private static final int DATABASE_VERSION 2; // 初始为1改表结构时必须1 public StudentDBHelper(Context context) { super(context, DATABASE_NAME, null, DATABASE_VERSION); } Override public void onCreate(SQLiteDatabase db) { // 创建student表id主键自增name非空age默认0major可为空 String CREATE_TABLE CREATE TABLE student ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, age INTEGER DEFAULT 0, major TEXT ); db.execSQL(CREATE_TABLE); } Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { // 版本升级策略简单场景直接删表重建仅限开发阶段 if (oldVersion 2) { db.execSQL(DROP TABLE IF EXISTS student); onCreate(db); // 重建新表结构 } } }注意onUpgrade()里DROP TABLE IF EXISTS是教学项目的权宜之计。真实项目中应使用ALTER TABLE ADD COLUMN等增量语句否则用户数据全丢。但课程设计允许——因为重点是让学生理解“版本号变化触发升级流程”而不是数据迁移工程。3.2 StudentDAO封装CRUD操作让业务代码干净如初StudentDAO.java是数据访问层屏蔽了SQL细节。以“添加学生”为例public long addStudent(Student student) { SQLiteDatabase db dbHelper.getWritableDatabase(); ContentValues values new ContentValues(); values.put(name, student.getName()); values.put(age, student.getAge()); values.put(major, student.getMajor()); // insert()返回新记录的rowid-1表示失败 long result db.insert(student, null, values); db.close(); // 关键必须关闭否则下次getWritableDatabase()可能阻塞 return result; }ContentValues是Android提供的键值对容器比手动拼接SQL字符串安全防SQL注入、简洁不用写引号和?占位符。而db.close()这行常被忽略——若不关多次调用getWritableDatabase()会导致IllegalStateException: attempt to re-open an already-closed object。我一般会在每个DAO方法末尾加Log.d(DAO, insert completed, rowid result);方便调试时一眼看出是否写入成功。3.3 MainActivity中ListView与SimpleCursorAdapter的绑定从数据库到UI的最后100米MainActivity不直接new Student对象列表而是用Cursor加载数据并通过SimpleCursorAdapter绑定到ListViewprivate void loadStudentList() { StudentDAO dao new StudentDAO(this); Cursor cursor dao.getAllStudents(); // 返回查询student表的Cursor // 定义ListView每一项显示哪些字段from和对应控件IDto String[] from {name, age, major}; int[] to {R.id.tv_name, R.id.tv_age, R.id.tv_major}; SimpleCursorAdapter adapter new SimpleCursorAdapter( this, R.layout.list_item_student, // 每一项的布局文件 cursor, from, to, 0 ); listView.setAdapter(adapter); }list_item_student.xml长这样!-- res/layout/list_item_student.xml -- LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:layout_widthmatch_parent android:layout_heightwrap_content android:orientationhorizontal android:padding8dp TextView android:idid/tv_name android:layout_width0dp android:layout_heightwrap_content android:layout_weight2 android:textSize16sp / TextView android:idid/tv_age android:layout_width0dp android:layout_heightwrap_content android:layout_weight1 android:textSize14sp / TextView android:idid/tv_major android:layout_width0dp android:layout_heightwrap_content android:layout_weight2 android:textSize14sp / /LinearLayout这种CursorAdapter方案比ArrayAdapterStudent更省内存——因为Cursor是数据库游标不把全部数据加载进内存适合列表项较多时。但代价是必须手动管理Cursor生命周期adapter销毁时需调用cursor.close()否则内存泄漏。课程设计中常被省略但你在onDestroy()里加上这一句会显得很专业Override protected void onDestroy() { super.onDestroy(); if (cursor ! null !cursor.isClosed()) { cursor.close(); } }3.4 查询、修改、删除的完整链路一个学生ID如何贯穿三个Activity编辑功能最能体现数据流设计MainActivity中长按列表项获取该行Cursor的_id注意SQLite自动创建的主键列名是_id不是id这是CursorAdapter强制要求通过Intent将_id传给EditStudentActivityIntent intent new Intent(MainActivity.this, EditStudentActivity.class); intent.putExtra(student_id, cursor.getInt(cursor.getColumnIndexOrThrow(_id))); startActivity(intent);EditStudentActivity中用该ID查出原始数据填充到EditText点击“保存”时调用StudentDAO.updateStudent()SQL语句形如UPDATE student SET name?, age?, major? WHERE _id?这个_id就是连接UI与数据库的唯一纽带。很多同学卡在“编辑后内容没变”八成是因为WHERE条件写成了WHERE id?少了个下划线而_id才是Cursor能识别的列名。这是个经典玄学坑debug时用Log.d(DEBUG, cursor column names: Arrays.toString(cursor.getColumnNames()));打印列名立刻破案。4. 运行与调试全流程从Android Studio导入到真机验证的每一步实操4.1 导入工程的正确姿势别让Gradle同步毁掉第一印象解压Mystudent.rar到无中文、无空格路径例如D:\AndroidProjects\Mystudent打开Android Studio →Open an existing project→ 选择解压后的Mystudent文件夹不是.rar文件首次导入会触发Gradle同步此时观察右下角提示若提示“Gradle project sync failed”点开Build → Sync Project with Gradle Files重试若提示“Could not find method compile()”说明Gradle版本太老需升级打开gradle/wrapper/gradle-wrapper.properties将distributionUrl改为https\://services.gradle.org/distributions/gradle-7.2-bin.zip对应AS 4.2同步成功后检查app/src/main/AndroidManifest.xml中package属性是否为com.example.mystudent若与你本地包名冲突如你之前建过同名项目需全局替换右键com.example.mystudent包名 →Refactor → Rename→ 勾选Search in comments and strings确保所有引用同步更新。提示同步完成后app/build/intermediates/merged_manifests/debug/AndroidManifest.xml会生成合并后的清单文件可用来确认Activity是否注册成功。若AddStudentActivity没出现在这里说明Manifest写错了。4.2 连接真机与模拟器的双保险策略真机调试开启手机开发者选项 → 打开USB调试 → 用原装数据线连接电脑 → Android Studio中Device下拉菜单应显示设备型号。若显示????????需安装对应手机厂商的USB驱动华为用HiSuite小米用Mi PC Suite模拟器推荐AVD Manager中创建Pixel 3 API 30Android 11的x86_64镜像启动后若卡在Google Logo勾选Cold Boot Now若提示HAXM not installed需在SDK Tools中勾选Intel x86 Emulator Accelerator (HAXM installer)并单独安装。无论哪种方式首次运行前务必检查app/src/main/res/values/strings.xml中app_name是否可见排除资源编译失败app/src/main/java/.../MainActivity.java中setContentView(R.layout.activity_main)的activity_main.xml是否存在且无语法错误。4.3 关键日志定位法用logcat快速揪出Crash根源运行后App闪退别急着重装打开Android Studio底部Logcat窗口设置过滤过滤器名称Mystudent自定义Log LevelErrorPackage Namecom.example.mystudent搜索关键词FATAL EXCEPTION、NullPointerException、SQLiteException。典型报错及对策现象原因解决Caused by: java.lang.NullPointerException: Attempt to invoke virtual method void android.widget.Button.setOnClickListener(...) on a null object referencefindViewById(R.id.btn_add)返回null说明activity_main.xml中没有id为btn_add的Button或ID写错如写成R.id.add_btn检查XML中android:idid/btn_add是否拼写一致且在setContentView()之后调用findViewByIdandroid.database.sqlite.SQLiteException: no such table: student (code 1 SQLITE_ERROR)StudentDBHelper.onCreate()未执行常见于dbHelper new StudentDBHelper(this)写在onCreate()之前导致构造函数中getWritableDatabase()提前触发确保StudentDBHelper dbHelper;声明在类成员变量dbHelper new StudentDBHelper(this);写在onCreate()方法内第一行android.content.ActivityNotFoundException: Unable to find explicit activity class {...AddStudentActivity}AndroidManifest.xml中漏注册AddStudentActivity或android:name写成.addStudentActivity首字母未大写检查Manifest中activity android:name.AddStudentActivity是否完整注意大小写4.4 功能验证Checklist五步确认系统闭环运行App后按顺序验证以下动作每步成功即打钩✅ 点击“添加学生” → 跳转至添加界面输入姓名“张三”、年龄“20”、专业“计算机”点击“保存” → 弹出Toast“添加成功”✅ 返回主界面 → ListView中出现“张三 20 计算机”一行✅ 长按该行 → 弹出“删除”对话框点击“确定” → 该行消失✅ 再次点击“添加”输入“李四”、“21”、“软件工程” → 成功添加✅ 重启App → “李四”的信息仍在列表中证明SQLite持久化生效。若第5步失败重启后列表为空说明数据库未真正写入。此时用ADB命令导出数据库验证# 在终端执行需已连接设备 adb shell run-as com.example.mystudent cp /data/data/com.example.mystudent/databases/student.db /sdcard/ adb pull /sdcard/student.db ./ # 下载到电脑 # 用DB Browser for SQLite打开student.db查看student表是否有数据5. 常见问题排查五个真实翻车现场与救命解法5.1 现象点击“添加”按钮毫无反应logcat无任何输出原因btn_add.setOnClickListener(...)写在setContentView(R.layout.activity_main)之前导致findViewById()找不到控件返回nullsetOnClickListener调用失败但不报错。解决严格遵循“先setContentView再findViewById最后setOnClickListener”顺序。在MainActivity.onCreate()中把Button addBtn findViewById(R.id.btn_add);这行移到setContentView(...)之后。5.2 现象添加学生后列表不刷新需手动杀进程再进才显示原因loadStudentList()只在onCreate()中调用一次添加新数据后未重新加载。AddStudentActivity保存成功后直接finish()但MainActivity的onResume()里没调用loadStudentList()。解决在MainActivity中重写onResume()Override protected void onResume() { super.onResume(); loadStudentList(); // 每次回到主界面都刷新列表 }或者更优解在AddStudentActivity保存成功后发送广播或调用startActivityForResult已废弃的替代方案——用ActivityResultLauncher但课程设计中直接onResume刷新最简单。5.3 现象编辑学生时界面上显示的姓名、年龄全是0或空字符串原因EditStudentActivity中查询SQL写错例如SELECT * FROM student WHERE id?但Cursor的_id列名是_idgetColumnIndex(id)返回-1cursor.getString(-1)返回null。解决查询时明确指定列名并用getColumnIndexOrThrow(_id)String query SELECT _id, name, age, major FROM student WHERE _id?; Cursor cursor db.rawQuery(query, new String[]{String.valueOf(id)}); if (cursor.moveToFirst()) { String name cursor.getString(cursor.getColumnIndexOrThrow(name)); int age cursor.getInt(cursor.getColumnIndexOrThrow(age)); String major cursor.getString(cursor.getColumnIndexOrThrow(major)); // 填充EditText... } cursor.close();5.4 现象删除学生后再次添加时新记录的ID不连续如删了id2新ID变成4原因SQLite的AUTOINCREMENT保证主键唯一且递增但不保证连续。删除记录后ID不会回收这是数据库正常行为不是Bug。解决无需解决。若老师质疑可解释“AUTOINCREMENT用于避免主键冲突连续ID需额外维护序号表违背关系型数据库设计原则。”课程设计中只要功能正确ID是否连续不扣分。5.5 现象在Android 12API 31及以上设备点击删除对话框“确定”后App闪退原因AlertDialog.Builder在onCreateDialog()中创建但Context传入的是Activity.this而Android 12对Dialog的Context校验更严格若Activity已finish()show()会抛BadTokenException。解决确保AlertDialog在Activity存活时创建。将删除逻辑写在MainActivity中而非Adapter的onClick里// 在MainActivity中定义 private void showDeleteDialog(final long studentId) { new AlertDialog.Builder(this) .setTitle(getString(R.string.dialog_delete_title)) .setMessage(getString(R.string.dialog_delete_message)) .setPositiveButton(确定, (dialog, which) - { StudentDAO dao new StudentDAO(this); dao.deleteStudent(studentId); loadStudentList(); // 刷新列表 }) .setNegativeButton(取消, null) .show(); }然后在Adapter的onClick中调用((MainActivity)context).showDeleteDialog(id)。6. 二次开发改造指南从交作业到真能用的三个跃迁技巧6.1 技巧一增加搜索功能——三步接入Filterable接口让列表秒变可检索课程设计只要求增删改查但加个搜索框能让项目脱颖而出。核心是让SimpleCursorAdapter支持过滤但SimpleCursorAdapter本身不实现Filterable所以需自定义Adapter// 新建 StudentCursorAdapter.java public class StudentCursorAdapter extends CursorAdapter implements Filterable { private Context context; private StudentDAO dao; public StudentCursorAdapter(Context context, Cursor c, int flags) { super(context, c, flags); this.context context; this.dao new StudentDAO(context); } Override public View newView(Context context, Cursor cursor, ViewGroup parent) { return LayoutInflater.from(context).inflate(R.layout.list_item_student, parent, false); } Override public void bindView(View view, Context context, Cursor cursor) { TextView name view.findViewById(R.id.tv_name); TextView age view.findViewById(R.id.tv_age); TextView major view.findViewById(R.id.tv_major); name.setText(cursor.getString(cursor.getColumnIndexOrThrow(name))); age.setText(String.valueOf(cursor.getInt(cursor.getColumnIndexOrThrow(age)))); major.setText(cursor.getString(cursor.getColumnIndexOrThrow(major))); } Override public Cursor runQueryOnBackgroundThread(CharSequence constraint) { if (constraint null || constraint.length() 0) { return dao.getAllStudents(); // 无搜索词返回全量 } else { return dao.searchStudents(constraint.toString()); // 自定义搜索方法 } } }StudentDAO.java中新增searchStudents()public Cursor searchStudents(String keyword) { SQLiteDatabase db dbHelper.getReadableDatabase(); String query SELECT _id, name, age, major FROM student WHERE name LIKE ? OR major LIKE ?; String[] args {% keyword %, % keyword %}; return db.rawQuery(query, args); }最后在MainActivity中替换Adapter// 原来用SimpleCursorAdapter的地方改为 StudentCursorAdapter adapter new StudentCursorAdapter(this, cursor, 0); listView.setAdapter(adapter); // 添加搜索框在activity_main.xml顶部加EditText EditText searchBox findViewById(R.id.et_search); searchBox.addTextChangedListener(new TextWatcher() { Override public void onTextChanged(CharSequence s, int start, int before, int count) { adapter.getFilter().filter(s); // 触发runQueryOnBackgroundThread } // 其他方法留空 });从那以后我每次做列表页都强制在onCreate()里加一行Log.d(Adapter, Adapter created with cursor: cursor.getCount());确保Cursor不为空。搜索功能上线后再加一句Log.d(Search, Searching for: keyword);调试时一眼看清搜索词是否传进来了。希望帮到你。本文还有配套的精品资源点击获取 Android学生信息管理系统：SQLite+Java/Kotlin完整课设工程
简介本资源是一份面向高校Android开发初学者与课程设计学生的完整安卓应用实战项目聚焦学生信息管理系统的全流程实现帮助学习者系统掌握Android Studio开发核心技能。压缩包共1426个文件涵盖338个XML布局与资源文件、280个PNG图标素材、255个编译后class字节码、39个Java源码文件、12个APK安装包及多个gradle构建配置文件完整呈现从UI设计、SQLite数据存储、Activity跳转、RecyclerView列表展示到权限适配与调试发布的全链路工程结构总大小21.14MB。已有3738人学习下载项目代码规范、模块清晰、注释充分附带可直接运行的debug版APK与资源打包产物如resources-debug.ap_、slice_x.apk等便于快速部署验证与逆向理解构建流程是Android入门实践与课程作业交付的理想参考范例。1. 学生信息管理App一个能真正在Android Studio里跑通、改得动、交得上的课程设计闭环你是不是也经历过——老师布置“用Android Studio做一个学生信息管理系统”结果网上搜到的代码要么缺数据库表结构要么Activity跳转逻辑断在半路要么连build.gradle里该配哪个版本的com.android.tools.build:gradle都模棱两可这个Mystudent项目不是Demo截图也不是半成品框架而是一个从新建项目开始、完整走完“添加学生→查询列表→修改信息→删除记录→本地SQLite持久化”全链路的可运行工程。它不炫技没用Jetpack Compose纯XMLJava或Kotlin原生SQLite所有Activity之间用Intent传参、所有数据操作封装在DAO层、所有UI控件命名规范可读。适合大二大三刚学完《移动应用开发》课程的学生直接导入Android Studio 4.2兼容Gradle 7.0改个包名就能当课设交作业也适合想补Android基础的同学把它当“教科书式样板”——看清楚一个真实App里onCreate()里该初始化什么CursorAdapter怎么绑定ListViewContentValues怎么填字段甚至adb logcat | grep Mystudent时该盯哪几行日志。这不是玩具项目是踩过坑、修过bug、真在真机上点过“添加”按钮弹出Toast的落地工程。2. 工程结构与技术栈解析从project根目录到app/src/main的每一层都藏着关键线索2.1 项目层级与模块划分为什么这个结构能避免“导入就报红”打开解压后的Mystudent文件夹你会看到典型的Android Studio标准结构Mystudent/ ├── app/ # 核心模块所有业务代码在此 │ ├── src/ │ │ ├── main/ │ │ │ ├── java/com/example/mystudent/ # Java源码若为Kotlin版则为kotlin/ │ │ │ │ ├── MainActivity.java # 主界面学生列表展示 │ │ │ │ ├── AddStudentActivity.java # 添加界面表单输入 │ │ │ │ ├── EditStudentActivity.java # 编辑界面回显更新 │ │ │ │ ├── Student.java # 实体类id, name, age, major等字段 │ │ │ │ ├── StudentDBHelper.java # SQLiteOpenHelper子类建表、升级 │ │ │ │ └── StudentDAO.java # 数据访问对象增删改查封装 │ │ │ ├── res/ # 资源文件 │ │ │ │ ├── layout/ # activity_main.xml, activity_add.xml等 │ │ │ │ ├── values/ # strings.xml定义所有文本 │ │ │ │ └── ... │ │ │ └── AndroidManifest.xml # 四大组件注册、权限声明 │ │ └── build.gradle # 模块级构建脚本重点看dependencies │ ├── build.gradle # 项目级构建脚本定义gradle插件版本 ├── gradle/ └── settings.gradle提示很多同学导入失败根本原因不是代码问题而是app/build.gradle里compileSdkVersion和targetSdkVersion写成了33但本地Android Studio只装了SDK 31。务必先打开File → Project Structure → SDK Location确认已安装的SDK Platform版本再反向匹配build.gradle中的数值。常见做法是统一设为31对应Android 12L既兼容旧设备又避开33引入的严格后台限制导致的崩溃。2.2 核心依赖与版本锁定Gradle配置里的生存指南app/build.gradle中关键依赖如下以Java版为例android { compileSdkVersion 31 // 必须与本地SDK安装版本一致 buildToolsVersion 30.0.3 // 若报错可删掉此行AS会自动选最新可用版 defaultConfig { applicationId com.example.mystudent minSdkVersion 16 // 支持Android 4.1覆盖99%以上设备 targetSdkVersion 31 // 与compileSdkVersion保持一致 versionCode 1 versionName 1.0 } } dependencies { implementation androidx.appcompat:appcompat:1.4.2 // 兼容库必须 implementation com.google.android.material:material:1.6.1 // Material Design组件 implementation androidx.constraintlayout:constraintlayout:2.1.4 // 布局利器 // 注意没有引入Room或LiveData纯原生SQLite降低学习门槛 }这里没有用androidx.room:room-runtime说明它绕过了Jetpack架构组件的抽象层直接操作SQLiteDatabase对象。好处是逻辑透明——你看得见每一条INSERT INTO student (...) VALUES (...)是怎么拼出来的坏处是需要手动处理游标关闭、事务边界。这正是课程设计要考察的基本功不是调API而是理解数据如何落盘。2.3 Manifest注册与Activity跳转链四步完成一次学生添加AndroidManifest.xml中三个Activity的注册是功能闭环的前提activity android:name.MainActivity android:exportedtrue intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity activity android:name.AddStudentActivity android:exportedfalse / activity android:name.EditStudentActivity android:exportedfalse /注意android:exportedfalse表示这些Activity不能被其他App启动符合安全规范。而跳转逻辑全部在Java代码中完成例如MainActivity中点击“添加”按钮// MainActivity.java addBtn.setOnClickListener(v - { Intent intent new Intent(MainActivity.this, AddStudentActivity.class); startActivity(intent); // 启动添加界面 });这种显式Intent调用比隐式Intent更可控也更适合初学者理解组件通信本质。2.4 资源文件组织逻辑strings.xml和layout如何支撑多语言与适配res/values/strings.xml不只是存文字更是解耦UI与逻辑的第一道防线resources string nameapp_nameMyStudent/string string nametitle_activity_main学生信息列表/string string namebtn_add添加学生/string string namehint_name请输入姓名/string string namehint_age请输入年龄/string string namehint_major请输入专业/string string nametoast_add_success添加成功/string string namedialog_delete_title确认删除/string string namedialog_delete_message确定要删除该学生信息吗/string /resources所有界面文字都通过string/btn_add引用而非硬编码。这意味着若需中英文切换只需新增res/values-en/strings.xml若老师要求改成“学员信息管理”改一处strings.xml即可全局生效Toast.makeText(..., R.string.toast_add_success, ...)比写死字符串更易维护。同理activity_main.xml使用ConstraintLayout而非LinearLayout是因为它天然支持不同屏幕尺寸的约束关系——比如“删除按钮始终在列表项右侧”这种声明式布局比Java代码动态计算坐标更稳定也更符合现代Android开发习惯。3. SQLite数据库实现详解StudentDBHelper与StudentDAO的协作机制3.1 StudentDBHelper建表语句、版本升级与onUpgrade的血泪经验StudentDBHelper.java继承自SQLiteOpenHelper核心在于onCreate()和onUpgrade()两个方法public class StudentDBHelper extends SQLiteOpenHelper { private static final String DATABASE_NAME student.db; private static final int DATABASE_VERSION 2; // 初始为1改表结构时必须1 public StudentDBHelper(Context context) { super(context, DATABASE_NAME, null, DATABASE_VERSION); } Override public void onCreate(SQLiteDatabase db) { // 创建student表id主键自增name非空age默认0major可为空 String CREATE_TABLE CREATE TABLE student ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, age INTEGER DEFAULT 0, major TEXT ); db.execSQL(CREATE_TABLE); } Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { // 版本升级策略简单场景直接删表重建仅限开发阶段 if (oldVersion 2) { db.execSQL(DROP TABLE IF EXISTS student); onCreate(db); // 重建新表结构 } } }注意onUpgrade()里DROP TABLE IF EXISTS是教学项目的权宜之计。真实项目中应使用ALTER TABLE ADD COLUMN等增量语句否则用户数据全丢。但课程设计允许——因为重点是让学生理解“版本号变化触发升级流程”而不是数据迁移工程。3.2 StudentDAO封装CRUD操作让业务代码干净如初StudentDAO.java是数据访问层屏蔽了SQL细节。以“添加学生”为例public long addStudent(Student student) { SQLiteDatabase db dbHelper.getWritableDatabase(); ContentValues values new ContentValues(); values.put(name, student.getName()); values.put(age, student.getAge()); values.put(major, student.getMajor()); // insert()返回新记录的rowid-1表示失败 long result db.insert(student, null, values); db.close(); // 关键必须关闭否则下次getWritableDatabase()可能阻塞 return result; }ContentValues是Android提供的键值对容器比手动拼接SQL字符串安全防SQL注入、简洁不用写引号和?占位符。而db.close()这行常被忽略——若不关多次调用getWritableDatabase()会导致IllegalStateException: attempt to re-open an already-closed object。我一般会在每个DAO方法末尾加Log.d(DAO, insert completed, rowid result);方便调试时一眼看出是否写入成功。3.3 MainActivity中ListView与SimpleCursorAdapter的绑定从数据库到UI的最后100米MainActivity不直接new Student对象列表而是用Cursor加载数据并通过SimpleCursorAdapter绑定到ListViewprivate void loadStudentList() { StudentDAO dao new StudentDAO(this); Cursor cursor dao.getAllStudents(); // 返回查询student表的Cursor // 定义ListView每一项显示哪些字段from和对应控件IDto String[] from {name, age, major}; int[] to {R.id.tv_name, R.id.tv_age, R.id.tv_major}; SimpleCursorAdapter adapter new SimpleCursorAdapter( this, R.layout.list_item_student, // 每一项的布局文件 cursor, from, to, 0 ); listView.setAdapter(adapter); }list_item_student.xml长这样!-- res/layout/list_item_student.xml -- LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:layout_widthmatch_parent android:layout_heightwrap_content android:orientationhorizontal android:padding8dp TextView android:idid/tv_name android:layout_width0dp android:layout_heightwrap_content android:layout_weight2 android:textSize16sp / TextView android:idid/tv_age android:layout_width0dp android:layout_heightwrap_content android:layout_weight1 android:textSize14sp / TextView android:idid/tv_major android:layout_width0dp android:layout_heightwrap_content android:layout_weight2 android:textSize14sp / /LinearLayout这种CursorAdapter方案比ArrayAdapterStudent更省内存——因为Cursor是数据库游标不把全部数据加载进内存适合列表项较多时。但代价是必须手动管理Cursor生命周期adapter销毁时需调用cursor.close()否则内存泄漏。课程设计中常被省略但你在onDestroy()里加上这一句会显得很专业Override protected void onDestroy() { super.onDestroy(); if (cursor ! null !cursor.isClosed()) { cursor.close(); } }3.4 查询、修改、删除的完整链路一个学生ID如何贯穿三个Activity编辑功能最能体现数据流设计MainActivity中长按列表项获取该行Cursor的_id注意SQLite自动创建的主键列名是_id不是id这是CursorAdapter强制要求通过Intent将_id传给EditStudentActivityIntent intent new Intent(MainActivity.this, EditStudentActivity.class); intent.putExtra(student_id, cursor.getInt(cursor.getColumnIndexOrThrow(_id))); startActivity(intent);EditStudentActivity中用该ID查出原始数据填充到EditText点击“保存”时调用StudentDAO.updateStudent()SQL语句形如UPDATE student SET name?, age?, major? WHERE _id?这个_id就是连接UI与数据库的唯一纽带。很多同学卡在“编辑后内容没变”八成是因为WHERE条件写成了WHERE id?少了个下划线而_id才是Cursor能识别的列名。这是个经典玄学坑debug时用Log.d(DEBUG, cursor column names: Arrays.toString(cursor.getColumnNames()));打印列名立刻破案。4. 运行与调试全流程从Android Studio导入到真机验证的每一步实操4.1 导入工程的正确姿势别让Gradle同步毁掉第一印象解压Mystudent.rar到无中文、无空格路径例如D:\AndroidProjects\Mystudent打开Android Studio →Open an existing project→ 选择解压后的Mystudent文件夹不是.rar文件首次导入会触发Gradle同步此时观察右下角提示若提示“Gradle project sync failed”点开Build → Sync Project with Gradle Files重试若提示“Could not find method compile()”说明Gradle版本太老需升级打开gradle/wrapper/gradle-wrapper.properties将distributionUrl改为https\://services.gradle.org/distributions/gradle-7.2-bin.zip对应AS 4.2同步成功后检查app/src/main/AndroidManifest.xml中package属性是否为com.example.mystudent若与你本地包名冲突如你之前建过同名项目需全局替换右键com.example.mystudent包名 →Refactor → Rename→ 勾选Search in comments and strings确保所有引用同步更新。提示同步完成后app/build/intermediates/merged_manifests/debug/AndroidManifest.xml会生成合并后的清单文件可用来确认Activity是否注册成功。若AddStudentActivity没出现在这里说明Manifest写错了。4.2 连接真机与模拟器的双保险策略真机调试开启手机开发者选项 → 打开USB调试 → 用原装数据线连接电脑 → Android Studio中Device下拉菜单应显示设备型号。若显示????????需安装对应手机厂商的USB驱动华为用HiSuite小米用Mi PC Suite模拟器推荐AVD Manager中创建Pixel 3 API 30Android 11的x86_64镜像启动后若卡在Google Logo勾选Cold Boot Now若提示HAXM not installed需在SDK Tools中勾选Intel x86 Emulator Accelerator (HAXM installer)并单独安装。无论哪种方式首次运行前务必检查app/src/main/res/values/strings.xml中app_name是否可见排除资源编译失败app/src/main/java/.../MainActivity.java中setContentView(R.layout.activity_main)的activity_main.xml是否存在且无语法错误。4.3 关键日志定位法用logcat快速揪出Crash根源运行后App闪退别急着重装打开Android Studio底部Logcat窗口设置过滤过滤器名称Mystudent自定义Log LevelErrorPackage Namecom.example.mystudent搜索关键词FATAL EXCEPTION、NullPointerException、SQLiteException。典型报错及对策现象原因解决Caused by: java.lang.NullPointerException: Attempt to invoke virtual method void android.widget.Button.setOnClickListener(...) on a null object referencefindViewById(R.id.btn_add)返回null说明activity_main.xml中没有id为btn_add的Button或ID写错如写成R.id.add_btn检查XML中android:idid/btn_add是否拼写一致且在setContentView()之后调用findViewByIdandroid.database.sqlite.SQLiteException: no such table: student (code 1 SQLITE_ERROR)StudentDBHelper.onCreate()未执行常见于dbHelper new StudentDBHelper(this)写在onCreate()之前导致构造函数中getWritableDatabase()提前触发确保StudentDBHelper dbHelper;声明在类成员变量dbHelper new StudentDBHelper(this);写在onCreate()方法内第一行android.content.ActivityNotFoundException: Unable to find explicit activity class {...AddStudentActivity}AndroidManifest.xml中漏注册AddStudentActivity或android:name写成.addStudentActivity首字母未大写检查Manifest中activity android:name.AddStudentActivity是否完整注意大小写4.4 功能验证Checklist五步确认系统闭环运行App后按顺序验证以下动作每步成功即打钩✅ 点击“添加学生” → 跳转至添加界面输入姓名“张三”、年龄“20”、专业“计算机”点击“保存” → 弹出Toast“添加成功”✅ 返回主界面 → ListView中出现“张三 20 计算机”一行✅ 长按该行 → 弹出“删除”对话框点击“确定” → 该行消失✅ 再次点击“添加”输入“李四”、“21”、“软件工程” → 成功添加✅ 重启App → “李四”的信息仍在列表中证明SQLite持久化生效。若第5步失败重启后列表为空说明数据库未真正写入。此时用ADB命令导出数据库验证# 在终端执行需已连接设备 adb shell run-as com.example.mystudent cp /data/data/com.example.mystudent/databases/student.db /sdcard/ adb pull /sdcard/student.db ./ # 下载到电脑 # 用DB Browser for SQLite打开student.db查看student表是否有数据5. 常见问题排查五个真实翻车现场与救命解法5.1 现象点击“添加”按钮毫无反应logcat无任何输出原因btn_add.setOnClickListener(...)写在setContentView(R.layout.activity_main)之前导致findViewById()找不到控件返回nullsetOnClickListener调用失败但不报错。解决严格遵循“先setContentView再findViewById最后setOnClickListener”顺序。在MainActivity.onCreate()中把Button addBtn findViewById(R.id.btn_add);这行移到setContentView(...)之后。5.2 现象添加学生后列表不刷新需手动杀进程再进才显示原因loadStudentList()只在onCreate()中调用一次添加新数据后未重新加载。AddStudentActivity保存成功后直接finish()但MainActivity的onResume()里没调用loadStudentList()。解决在MainActivity中重写onResume()Override protected void onResume() { super.onResume(); loadStudentList(); // 每次回到主界面都刷新列表 }或者更优解在AddStudentActivity保存成功后发送广播或调用startActivityForResult已废弃的替代方案——用ActivityResultLauncher但课程设计中直接onResume刷新最简单。5.3 现象编辑学生时界面上显示的姓名、年龄全是0或空字符串原因EditStudentActivity中查询SQL写错例如SELECT * FROM student WHERE id?但Cursor的_id列名是_idgetColumnIndex(id)返回-1cursor.getString(-1)返回null。解决查询时明确指定列名并用getColumnIndexOrThrow(_id)String query SELECT _id, name, age, major FROM student WHERE _id?; Cursor cursor db.rawQuery(query, new String[]{String.valueOf(id)}); if (cursor.moveToFirst()) { String name cursor.getString(cursor.getColumnIndexOrThrow(name)); int age cursor.getInt(cursor.getColumnIndexOrThrow(age)); String major cursor.getString(cursor.getColumnIndexOrThrow(major)); // 填充EditText... } cursor.close();5.4 现象删除学生后再次添加时新记录的ID不连续如删了id2新ID变成4原因SQLite的AUTOINCREMENT保证主键唯一且递增但不保证连续。删除记录后ID不会回收这是数据库正常行为不是Bug。解决无需解决。若老师质疑可解释“AUTOINCREMENT用于避免主键冲突连续ID需额外维护序号表违背关系型数据库设计原则。”课程设计中只要功能正确ID是否连续不扣分。5.5 现象在Android 12API 31及以上设备点击删除对话框“确定”后App闪退原因AlertDialog.Builder在onCreateDialog()中创建但Context传入的是Activity.this而Android 12对Dialog的Context校验更严格若Activity已finish()show()会抛BadTokenException。解决确保AlertDialog在Activity存活时创建。将删除逻辑写在MainActivity中而非Adapter的onClick里// 在MainActivity中定义 private void showDeleteDialog(final long studentId) { new AlertDialog.Builder(this) .setTitle(getString(R.string.dialog_delete_title)) .setMessage(getString(R.string.dialog_delete_message)) .setPositiveButton(确定, (dialog, which) - { StudentDAO dao new StudentDAO(this); dao.deleteStudent(studentId); loadStudentList(); // 刷新列表 }) .setNegativeButton(取消, null) .show(); }然后在Adapter的onClick中调用((MainActivity)context).showDeleteDialog(id)。6. 二次开发改造指南从交作业到真能用的三个跃迁技巧6.1 技巧一增加搜索功能——三步接入Filterable接口让列表秒变可检索课程设计只要求增删改查但加个搜索框能让项目脱颖而出。核心是让SimpleCursorAdapter支持过滤但SimpleCursorAdapter本身不实现Filterable所以需自定义Adapter// 新建 StudentCursorAdapter.java public class StudentCursorAdapter extends CursorAdapter implements Filterable { private Context context; private StudentDAO dao; public StudentCursorAdapter(Context context, Cursor c, int flags) { super(context, c, flags); this.context context; this.dao new StudentDAO(context); } Override public View newView(Context context, Cursor cursor, ViewGroup parent) { return LayoutInflater.from(context).inflate(R.layout.list_item_student, parent, false); } Override public void bindView(View view, Context context, Cursor cursor) { TextView name view.findViewById(R.id.tv_name); TextView age view.findViewById(R.id.tv_age); TextView major view.findViewById(R.id.tv_major); name.setText(cursor.getString(cursor.getColumnIndexOrThrow(name))); age.setText(String.valueOf(cursor.getInt(cursor.getColumnIndexOrThrow(age)))); major.setText(cursor.getString(cursor.getColumnIndexOrThrow(major))); } Override public Cursor runQueryOnBackgroundThread(CharSequence constraint) { if (constraint null || constraint.length() 0) { return dao.getAllStudents(); // 无搜索词返回全量 } else { return dao.searchStudents(constraint.toString()); // 自定义搜索方法 } } }StudentDAO.java中新增searchStudents()public Cursor searchStudents(String keyword) { SQLiteDatabase db dbHelper.getReadableDatabase(); String query SELECT _id, name, age, major FROM student WHERE name LIKE ? OR major LIKE ?; String[] args {% keyword %, % keyword %}; return db.rawQuery(query, args); }最后在MainActivity中替换Adapter// 原来用SimpleCursorAdapter的地方改为 StudentCursorAdapter adapter new StudentCursorAdapter(this, cursor, 0); listView.setAdapter(adapter); // 添加搜索框在activity_main.xml顶部加EditText EditText searchBox findViewById(R.id.et_search); searchBox.addTextChangedListener(new TextWatcher() { Override public void onTextChanged(CharSequence s, int start, int before, int count) { adapter.getFilter().filter(s); // 触发runQueryOnBackgroundThread } // 其他方法留空 });从那以后我每次做列表页都强制在onCreate()里加一行Log.d(Adapter, Adapter created with cursor: cursor.getCount());确保Cursor不为空。搜索功能上线后再加一句Log.d(Search, Searching for: keyword);调试时一眼看清搜索词是否传进来了。希望帮到你。本文还有配套的精品资源点击获取