Android作业提交课设实战：SQLite数据层与RecyclerView交互完整指南

简介：一款基于 Android Studio 的作业提交管理课程设计项目，面向高校计算机相关专业学生及 Android 入门开发者，帮助理解从界面搭建、本地存储到服务端联调的应用开发全流程。压缩包共 207 个文件、约 3.15MB，主要内容是 112 个 Java 源码与 56 个 XML 布局文件，另有 Gradle 构建配置、测试报告 docx、答辩 PPT、服务端工程代码及若干运行脚本，目录分层清楚，便于按模块逐项阅读。目前已有 1376 人学习下载。项目中可以看到 Activity 多页面跳转、ListView/RecyclerView 展示作业列表、SQLite 保存学生提交记录、Retrofit/OkHttp 完成作业上传下载、WorkManager 调度后台任务等典型实现；服务端代码则处理作业接收、教师批改与结果回传，前后端交互完整。配套文档涵盖设计说明、需求分析、使用手册和 PPT，可直接支撑课程设计报告撰写与答辩演示，是一份可复用性较高的完整实践参考。

1. 拿到课程设计压缩包，先想清楚这一周要做什么

你刚解压完这个“作业提交管理 APP”的压缩包：一个 Android Studio 工程、一份设计文档、一个答辩 PPT。这种组合的定位很清楚——它不是竞赛项目，而是课程验收项目，老师要看的不只是 App 能跑，更会翻数据库设计、看界面跳转逻辑、听你讲答辩。这类 APP 的核心需求也就这么多：学生端选课、看作业列表、提交文本或文件；教师端发布作业、查看提交记录、给成绩。数据落在本地 SQLite 就够了，不用云服务器，不用 Retrofit，连网络权限都可以不开。它的优势恰恰在于小且闭环，适合被完整讲清楚。适合谁读？接手学长源码想改造成自己项目的人，或者从零复刻这个题目的同学。下面按我接手这类课设时的实际做法，把工程结构、数据层、交互实现和验收材料依次过一遍。

2. 跑通 Android Studio 源码工程的三个前置动作

课程设计源码多半来自他人电脑，能正常同步打开的概率其实不高。你遇到的第一座山不是业务逻辑，而是环境。Android Studio 版本、AGP 版本、Gradle 版本、JDK 版本，四者必须匹配，差一个号都可能同步失败。先把压缩包里的工程看懂，再动手，顺序不能反。

2.1 打开压缩包先定位 4 个关键位置

不要急着把整个工程拖进 Android Studio，先确认下面四样东西，这决定你后续怎么下手。

• android/app/build.gradle或工程根目录的build.gradle，看compileSdk、minSdk、targetSdk和applicationId。课程设计一般minSdk在 21~24 之间，targetSdk在 30~34 之间，这个区间直接影响权限写法和文件存储方式。
• gradle/wrapper/gradle-wrapper.properties，里面的distributionUrl写死了 Gradle 版本，是同步失败的常见来源。
• AndroidManifest.xml，看注册了几个 Activity、有没有申请存储权限、有没有配启动入口。很多课设工程会把所有页面挤在同一个 Activity 里，用setContentView来回切，先知道入口能省很多时间。
• 源码目录下有没有独立的db或database包，决定数据层是手写 SQLiteOpenHelper 还是用了 Room。

四个位置看下来，工程的体量和风格就清楚了。大多数课程设计工程是手写 SQLiteOpenHelper + 多 Activity + ListView/RecyclerView 的组合，理解成本低，改造空间大。

2.2 版本不匹配是打不开的第一根引线

常见做法是先用 Android Studio 自带提示自动升级，但老工程自动升级后build.gradle里的写法经常不兼容。下面这组对照是我跑课设工程时验证过比较稳的组合，按 AGP 主版本号分档。

提示：compileSdk为 33 或更高时，AGP 7.x 会报警告但能运行，AGP 8.x 则要求显式声明namespace。如果你在同步时看到Namespace not specified，去build.gradle的android {}块里加上namespace '你的包名'即可。

2.3 三分钟把工程跑起来的最小步骤

拿到工程后，我一般按这个顺序操作，而不是直接点 Run。先改配置，再同步，最后才是跑模拟器。

# 1. 查看 JDK 版本，Android Studio 自带 JBR，一般无需手动装 java -version # 2. 确认 gradle wrapper 版本，过低时手动改文件 cat gradle/wrapper/gradle-wrapper.properties # 3. 同步失败后清理缓存再试 cd 你的工程目录 ./gradlew clean

如果同步时报SDK location not found，去local.properties写一行明确路径，注意要包含sdk.dir且转义反斜杠。

sdk.dir=D:/Android/Sdk

代码逻辑不复杂：先确认 JDK，再查 Gradle 版本，最后清缓存重新同步。参数上，distributionUrl里的 Gradle 版本必须和 AGP 匹配，local.properties的路径不能有中文，这两个是同步失败的最高频原因。模拟器连不上时，多半是 AVD 镜像与compileSdk不匹配，新建一个对应 API 级别的 AVD 比折腾现有镜像快得多。

2.4 SDK 组件勾不上时怎么办

有同学遇到过 Android Studio 的 SDK Manager 里组件无法勾选，点击没有任何反应。这不是网络问题，多半是 SDK 目录权限或缓存索引坏了。常见做法是先关掉 Android Studio，删除 SDK 目录下的.temp文件夹和platforms里的半截文件，再以管理员身份打开 SDK Manager。如果还不行，换个 SDK 安装目录重新指定路径，通常能绕过去。

3. 作业提交管理 APP 的数据层：四张表与 SQLite DAO

跑通工程只是开始，课程设计的重点在数据层。评阅老师翻源码时，最先看的是数据库设计合不合理。这个 APP 的业务模型不难，但很多课设把它做乱了——要么把所有字段堆进一张大表，要么把业务逻辑写进 Activity。正确的做法是先拆领域，再定表结构，最后写 DAO。

3.1 领域模型先拆清：用户、课程、作业、提交记录

作业提交管理最朴素的领域划分是四个实体：用户（学生/教师）、课程、作业、提交记录。教师和课程是一对多，课程和作业是一对多，作业和提交记录是一对多，学生和提交记录是一对多。这个关系理清楚，数据库设计就定了七成。

常见误用是把“作业内容”直接塞进提交记录，再把“课程名”冗余到作业表里。一旦老师改了课程名，所有作业都要跟着改。课程设计层面不要求第三范式那么严格，但主外键关系要清晰，否则 ER 图画不出来，答辩时一问就卡住。

3.2 建表 SQL 与字段规矩

手写 SQLiteOpenHelper 时，四张表的建表语句建议直接复用下面这段，字段命名保持统一风格。

CREATE TABLE users ( id INTEGER PRIMARY KEY AUTOINCREMENT, username TEXT NOT NULL UNIQUE, password TEXT NOT NULL, role INTEGER NOT NULL DEFAULT 0 -- 0 学生, 1 教师 ); CREATE TABLE courses ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, teacher_id INTEGER NOT NULL, FOREIGN KEY (teacher_id) REFERENCES users(id) ); CREATE TABLE assignments ( id INTEGER PRIMARY KEY AUTOINCREMENT, course_id INTEGER NOT NULL, title TEXT NOT NULL, content TEXT, deadline TEXT, created_at TEXT DEFAULT (datetime('now', 'localtime')), FOREIGN KEY (course_id) REFERENCES courses(id) ); CREATE TABLE submissions ( id INTEGER PRIMARY KEY AUTOINCREMENT, assignment_id INTEGER NOT NULL, student_id INTEGER NOT NULL, content TEXT, file_path TEXT, status INTEGER NOT NULL DEFAULT 0, -- 0 草稿, 1 已提交, 2 已批阅 score REAL, submit_time TEXT, FOREIGN KEY (assignment_id) REFERENCES assignments(id), FOREIGN KEY (student_id) REFERENCES users(id) );

字段说明上，status那一列是提交状态机的地基，后面做离线队列也要靠它。deadline用 TEXT 存yyyy-MM-dd HH:mm:ss，比存时间戳直观，SQLite 的日期函数也能直接处理。score用 REAL 是方便平时成绩出现小数，如果老师只打整数，用 INTEGER 更省事。需要特别强调的是，role不要用字符串存 "student"/"teacher"，整数枚举在代码里更好维护，也不容易写错。

3.3 DAO 层用 ContentValues，别拼 SQL 字符串

不少课设为了省事，直接在 Activity 里写db.execSQL拼字符串，这是很危险的做法。一方面有 SQL 注入风险，另一方面代码没法复用。我一般会抽一个SubmissionDao，把增删改查封装进去，Activity 里只调方法。

public class SubmissionDao { private final SQLiteDatabase db; public SubmissionDao(SQLiteDatabase db) { this.db = db; } public long insertSubmission(int assignmentId, int studentId, String content, String filePath) { ContentValues values = new ContentValues(); values.put("assignment_id", assignmentId); values.put("student_id", studentId); values.put("content", content); values.put("file_path", filePath); values.put("status", 0); // 新建记录默认草稿 values.put("submit_time", getNow()); return db.insert("submissions", null, values); } public List<Submission> getSubmissionsByAssignment(int assignmentId) { List<Submission> list = new ArrayList<>(); Cursor cursor = db.query("submissions", null, "assignment_id = ?", new String[]{String.valueOf(assignmentId)}, null, null, "submit_time DESC"); while (cursor.moveToNext()) { Submission s = new Submission(); s.id = cursor.getLong(cursor.getColumnIndexOrThrow("id")); s.assignmentId = assignmentId; s.studentId = cursor.getInt(cursor.getColumnIndexOrThrow("student_id")); s.status = cursor.getInt(cursor.getColumnIndexOrThrow("status")); s.filePath = cursor.getString(cursor.getColumnIndexOrThrow("file_path")); list.add(s); } cursor.close(); return list; } private String getNow() { return new SimpleDateFormat("yyyy-MM-dd HH:mm:ss", Locale.CHINA).format(new Date()); } }

代码逻辑上，insertSubmission里把status预设为 0，是草稿状态；调用方提交完成后改成 1，批阅后改成 2。db.query的第一个参数是表名，第二个 null 表示查询所有列，selection用assignment_id = ?配合参数数组，避免字符串拼接注入风险。submit_time DESC让最新提交的记录排在最前面，列表页直接拿这个结果填充，不用再排序。

3.4 数据层的三座坑

第一，AUTOINCREMENT会让自增主键形成独立序列，删除最后一条记录后 id 不复用，如果课设里演示“删了再插”，会看到 id 跳跃，这是正常的，不用去改。第二，FOREIGN KEY在 SQLite 里默认不生效，必须执行PRAGMA foreign_keys = ON，建议在onConfigure里写死。第三，时间字段统一走 LOCAL，不要混用datetime('now')（UTC）和System.currentTimeMillis()，不然 deadline 判断会差 8 小时。

4. 提交作业的完整交互：文件选择、私有目录与 RecyclerView

数据层搭好后，真正的 APP 特征在交互层体现。这个课设最核心的操作路径是：学生打开作业列表 → 点击某个作业 → 写文字或选文件 → 点击提交 → 看到提交成功。这条链路涉及列表展示、文件拷贝、状态更新三个技术点，逐个做扎实。

4.1 列表页与 Adapter 的最小实现

列表展示在课程设计中用 RecyclerView 或者 ListView 都可接受。RecyclerView 更接近现在的主流写法，也能在答辩时多说一句“布局复用”。这里的代码用 ViewBinding 简化findViewById，Adapter 里只处理一种视图类型。

public class AssignmentAdapter extends RecyclerView.Adapter<AssignmentAdapter.VH> { private final List<Assignment> data; private final OnItemClickListener listener; public AssignmentAdapter(List<Assignment> data, OnItemClickListener listener) { this.data = data; this.listener = listener; } @Override public VH onCreateViewHolder(ViewGroup parent, int viewType) { ItemAssignmentBinding binding = ItemAssignmentBinding.inflate( LayoutInflater.from(parent.getContext()), parent, false); return new VH(binding); } @Override public void onBindViewHolder(VH holder, int position) { Assignment item = data.get(position); holder.binding.tvTitle.setText(item.title); holder.binding.tvDeadline.setText("截止：" + item.deadline); holder.itemView.setOnClickListener(v -> listener.onClick(item)); } @Override public int getItemCount() { return data.size(); } static class VH extends RecyclerView.ViewHolder { final ItemAssignmentBinding binding; VH(ItemAssignmentBinding binding) { super(binding.getRoot()); this.binding = binding; } } interface OnItemClickListener { void onClick(Assignment item); } }

Adapter 做的事情是把Assignment对象映射到界面。构造参数里的listener是点击回调，Activity 里new AssignmentAdapter(list, this::openDetail)就能把跳转逻辑和列表渲染解耦。getItemCount返回data.size()，如果列表不动，就是数据没刷新。notifyDataSetChanged()能触发重绘，但性能一般，数据量在百条以内完全够用。

这里要特别说明：很多课设把 OnClick 事件写死在 Adapter 里直接跳转 Activity，这会让 Adapter 依赖具体页面，复用性差。用接口回调是常见最佳实践，答辩时也能说清楚。

4.2 文件提交：从 Uri 到私有目录

文件提交的坑集中在“选完文件之后怎么处理”。常见错误是直接保存Uri.toString()，下次想读取时发现权限丢了。Android 的临时授权在 App 重启后就失效，正确做法是立刻把内容拷贝到应用私有目录，再保存新路径。

private String copyUriToPrivate(Uri uri) throws IOException { String fileName = "submission_" + System.currentTimeMillis() + "_" + getFileName(uri); File dir = new File(getFilesDir(), "submissions"); if (!dir.exists()) { dir.mkdirs(); } File target = new File(dir, fileName); try (InputStream in = getContentResolver().openInputStream(uri); FileOutputStream out = new FileOutputStream(target)) { byte[] buf = new byte[8192]; int len; while ((len = in.read(buf)) > 0) { out.write(buf, 0, len); } } return target.getAbsolutePath(); } private String getFileName(Uri uri) { String displayName = "file"; try (Cursor cursor = getContentResolver().query(uri, null, null, null, null)) { if (cursor != null && cursor.moveToFirst()) { int nameIndex = cursor.getColumnIndex(OpenableColumns.DISPLAY_NAME); if (nameIndex >= 0) { displayName = cursor.getString(nameIndex); } } } return displayName; }

逻辑说明：先拼一个带时间戳的文件名，避免重名覆盖；getFilesDir()指向应用私有目录，不需要任何存储权限；getContentResolver().openInputStream()从内容提供器拿输入流，兼容相册、文档、下载目录等各种来源。8KB 缓冲区是通用选择，传大文件时改成 32KB 能快一点，但课设场景差别不大。

getFileName里查询的是OpenableColumns.DISPLAY_NAME，这是系统文档选择器返回的标准字段。如果 cursor 查询失败，兜底返回"file"，至少不会崩溃。整个方法做下来，你在数据库中只需存target.getAbsolutePath()，下次展示附件时直接FileInputStream读取，不再依赖原始 Uri 的授权。

4.3 存档方案对比：私有目录还是公开目录

很多课设里能看到申请WRITE_EXTERNAL_STORAGE权限后把文件写到公共存储的写法。这里给出一组对比，答辩时老师问“为什么这么做”可以直接答。

Android 10 起分区存储是强制的，直接往公共目录写文件会报EACCES，这是热词里“app 抓包失败”“android studio 项目报错”之外的又一个高频现场问题。我的建议是：文件中转一律走私有目录，如果老师要求提交的文件能在手机文件管理器里看到，再把这部分存档导出逻辑单独做成一个功能，不要在提交时顺手写公共目录。

5. 课程设计文档与 PPT 该怎么写才有验收价值

标题里“文档+PPT”占了半壁江山，这两个东西对课设成绩的影响往往超过代码本身。代码没做完，文档画得好，老师还有可能给个“工作量饱满”；代码写完了文档稀烂，答辩印象会大打折扣。这一章讲的是材料组织的常见做法，不是让你去编，而是把已经写出来的代码用文档语言讲清楚。

5.1 设计文档的目录骨架

课程设计文档有固定套路，各校格式不同，但骨架基本一致，按下面这个目录写不会错。

5.2 三张图决定答辩印象：用例图、ER 图、时序图

老师翻文档的习惯是先看图后看字。用例图、ER 图、时序图这三张画对了，文档就成功了一半，用什么工具不重要，画对关系才重要。

用例图画两个角色框，“学生”下面挂查看作业、提交作业、查看成绩；“教师”下面挂发布作业、查看提交记录、批阅打分。两个角色之间不需要连线，它们不直接交互。

ER 图画四个实体，注意主外键连线方向。users 到 courses 是一对多，courses 到 assignments 是一对多，assignments 到 submissions 是一对多。这张图画清楚了，数据库设计那章的文字都可以少写一半。

时序图画一条主链路：学生点开作业详情 → 填内容/选文件 → 点击提交 → DAO 写入 submissions 表 → 页面提示成功。竖线画四个对象：Activity、DAO、SQLiteDatabase、Users，横向箭头依次穿过。

5.3 PPT 的讲法与时间分配

答辩 PPT 控制在 10 页左右，页数越多越容易超时，也越容易讲散。我见到的答辩时间一般是 5 到 10 分钟，按这个节奏卡页面数。

第一页课题背景和个人分工，第二页技术选型及理由，第三页系统功能结构图，四到六页是学生端三个核心页面截图加一句话讲解，七到八页讲数据库设计和 ER 图，第九页现场演示，第十页总结与心得体会。说清楚每个页面在代码里对应的类，比如讲提交页面时顺带指出SubmissionDao.insertSubmission这个入口，话音一落代码和页面就对上了。

这里有一个很实用的技巧：PPT 里放代码截图不如放“运行效果 + 一句话说清设计思路”。老师在答辩现场最反感照着 PPT 念，次反感贴大段代码。你只需要指明“这段代码在哪个类、解决什么问题、为什么这么解决”，这三点讲透，所谓的工作量自然就体现出来了。

6. 排错速查与一个提分技巧：离线提交队列

最后收束在运行期的高频问题和一个能拉开差距的设计点上，两个都解决，这个课设基本稳了。

6.1 三个高频报错的速查表

课设验收时最怕现场翻车。下面三个是 Android Studio 开发常见问题中出现频率最高的，提前打上补丁。

tag number over 30 is not supported这个报错，我一般先让它发生在本地，再关掉 Instant Run、清理 build 目录。多数情况下是 AGP 版本过低与新版资源文件冲突，升级 AGP 后自然消失。如果升级后仍有问题，检查res/xml里是否有重复的文件声明。

6.2 提分技巧：给提交加一个离线队列

课程设计的评分上限在于“有没有超出基本功能的设计”。一个低成本高回报的点是给提交记录加离线队列。实现思路是：状态字段里的status=0是草稿，status=1是已提交，新增一个status=3表示待上传。每次提交先写本地，置为待上传，App 启动时扫描status=3的记录，在后台线程里做跟服务器同步的预留逻辑。

// 提交时先入队，不直接置为成功 public long enqueueSubmission(int assignmentId, int studentId, String content, String filePath) { ContentValues values = new ContentValues(); values.put("assignment_id", assignmentId); values.put("student_id", studentId); values.put("content", content); values.put("file_path", filePath); values.put("status", 3); // 待上传状态 return db.insert("submissions", null, values); } // 启动时扫描待上传队列，模拟网络同步成功 public void flushQueue() { Cursor cursor = db.query("submissions", null, "status = ?", new String[]{"3"}, null, null, null); while (cursor.moveToNext()) { long id = cursor.getLong(cursor.getColumnIndexOrThrow("id")); // 这里预留网络上传逻辑 // 成功后置 status = 1 ContentValues update = new ContentValues(); update.put("status", 1); db.update("submissions", update, "id = ?", new String[]{String.valueOf(id)}); } cursor.close(); }

逻辑说明：enqueueSubmission是提交入口，只负责本地落库和状态标记，不触发网络；flushQueue放在MainActivity.onCreate或启动流程里，扫描所有status=3的记录，预留的网络操作成功后把状态推进到status=1。这样即使演示时没有服务器，你也能讲出一套完整的重试机制，而不是只能说“本地保存”。如果要进一步展示给人的话，还可以在界面上加一个未同步角标，每次 flush 完成后更新 UI。这个设计的妙处在于它不需要你真的引入网络层，只要状态机设计清楚，老师就会认为你有工程思维，而不是只会在页面上堆代码。

本文还有配套的精品资源，点击获取