简介基于安卓开发工具实现的作业提交管理应用课程设计资源包面向高校学生与安卓初学者适合课程设计、项目实训或毕业设计参考。压缩包共二百零七个文件体积约三兆多核心由一百一十二个 Java 源代码与五十六个 XML 布局及配置文件组成另包含 Gradle 构建脚本、PNG 和 WebP 图片素材、PPT 演示文稿、DOCX 测试报告以及 Markdown 说明文档目录结构清楚便于按模块查找复用。功能覆盖学生作业提交、作业查看和教师批改等典型教学场景涉及界面跳转、列表展示、本地数据库持久化、网络请求、后台任务调度等安卓开发要点还附带服务器端代码与前后端交互示例能帮助理解从移动端到服务端的完整开发流程。目前已有 1376 人学习下载适合需要课程设计参考、安卓实战练习或源码解析的读者使用。1. 作业提交管理APP一个被选烂了却最值得拆的课程设计项目我拆过不少课程设计项目作业提交APP确实在选题榜上常年霸屏但它也是最适合练手的一个功能里同时塞了界面、本地存储、网络交互和文件传输。这套基于Android Studio的源码包压缩包里既有gradlew.bat、build.gradle也有task-server-master和一个测试报告.docx前后端都齐了。很多同学拿到手第一件事就是点Sync结果被Gradle下载卡住然后开始怀疑人生。这里不写空话直接讲怎么把项目跑起来、作业提交这条链路是怎么实现的、答辩时哪些点能被评审高看一眼。如果你是正在做课程设计或者想在已有源码上改成自己项目的开发者这篇值得往下翻。2. 从gradlew.bat读懂项目构建Gradle配置与Android Studio环境2.1 用Gradle Wrapper固定版本而不是直接装Gradle打开项目根目录先看到gradlew.bat和gradlew这两个是Gradle Wrapper生成的脚本。它的作用是让团队里所有人都用同一个Gradle版本构建正好解决课程设计小组里最常见的“我本地编译通过了你怎么报错”的扯皮问题。Windows下不要双击gradlew.bat要在项目根目录打开cmd或PowerShell执行gradlew.bat assembleDebugmacOS/Linux 下执行./gradlew assembleDebug。首次运行会读取gradle/wrapper/gradle-wrapper.properties指定地址下载对应版本的Gradle。如果下载慢我一般会把distributionUrl换成国内镜像地址比如腾讯或阿里云的镜像路径结构保持一致即可。distributionUrl有两个关键点第一Gradle版本要与Android Studio版本匹配版本不匹配会报“Gradle sync failed”或“Unsupported Gradle version”第二zip包名末尾的-bin和-all区别-all带源码和文档能看Gradle内置任务但体积更大课程设计项目用-bin足够。2.2 项目级与模块级build.gradle各管什么项目根目录的build.gradle主要声明Android Gradle PluginAGP版本app模块下的build.gradle才配置依赖和构建类型。如果项目里同时看到mvnw.cmd说明task-server-master后端是用Maven构建的前端Gradle和后端Maven是两套独立构建链别混在一起。Android Studio里经常有人把整个task-server目录拖进来Gradle解析直接挂掉这就是没搞清模块边界。// 项目根 build.gradle 常见内容示例 plugins { id com.android.application version 7.4.2 apply false }// app/build.gradle 常见依赖节选 dependencies { implementation androidx.appcompat:appcompat:1.6.1 implementation androidx.recyclerview:recyclerview:1.3.0 implementation com.squareup.retrofit2:retrofit:2.9.0 implementation com.squareup.okhttp3:logging-interceptor:4.11.0 }appcompat提供旧版本Android的Activity兼容recyclerview用来展示作业列表retrofit和okhttp负责与后端通信。这些版本号不是随便选的AGP版本和Gradle版本有对应关系比如AGP 7.4对应Gradle 7.5以上compileSdkVersion一般配33或34。如果只把compileSdk调高依赖库没升级会报“依赖库不支持当前SDK”的警告。2.3 settings.gradle决定项目由哪些模块组成多模块项目的模块清单在settings.gradle里通过include声明。比如include :app就代表只有一个Android应用模块。如果里面还有:server或:backend后端源码也进了同一套Gradle工程。本项目的task-server通常是一个独立目录有自己的pom.xml和Android无关。打开项目时只让Android Studio加载app模块后端用IDEA或命令行Maven单独构建。2.4 .gitignore与测试报告.docx在项目里的角色.gitignore过滤了build/、.gradle/、local.properties等文件这是多人协作的基本功。测试报告.docx是课程设计的重要交付物里面往往包含测试用例和执行结果。要让报告和源码对应起来比如“提交空白作业被拒绝”对应前端非空校验“提交成功提示”对应服务端返回的code字段判断。答辩时能指着源码说清每条用例的入口比干巴巴说“测过了”更能说服评审。这里直接给一张常见Gradle配置项速查表项目报错时优先对照这里配置项作用常见错误distributionUrl指定Gradle版本与下载地址版本不匹配导致Gradle sync失败compileSdkVersion编译使用的SDK版本高于本机SDK导致SDK not foundapplicationId应用包名决定应用唯一性改动后影响签名和第三方平台配置minSdkVersion最低支持Android版本太低时部分API需做兼容targetSdkVersion目标SDK版本决定系统兼容行为高target下默认限制明文HTTP流量3. Activity与界面层用RecyclerView实现作业列表与提交表单3.1 从启动页到作业列表的页面流转作业提交APP一般分学生端和教师端。学生端核心流程是启动页/登录页 → 作业列表 → 作业详情/提交页。列表页拿到作业ID点击后跳转提交页提交成功后返回到列表页并刷新对应条目。老师端的列表则是显示已提交学生可打分和写评语。Activity跳转用Intent但启动模式要留意列表页如果配成singleTop避免退出后重新进入出现多个实例。// 从作业列表跳转到提交页 Intent intent new Intent(MainActivity.this, SubmitActivity.class); intent.putExtra(assignment_id, assignmentId); intent.putExtra(assignment_title, title); startActivityForResult(intent, REQUEST_SUBMIT);上面的代码里assignment_id是后续网络请求和本地存储的主键title用于提交页顶部直接显示作业名。startActivityForResult已经被标记为deprecated但课程设计项目里很常见。新写代码建议用Activity Result API的registerForActivityResult这里先按原项目常见写法演示。3.2 RecyclerView.Adapter列表数据的绑定与刷新作业列表通常用RecyclerView加LinearLayoutManager。Adapter的核心在onBindViewHolder里不能做耗时操作比如读数据库或加载大图。常见做法是一次性从SQLite或网络读出数据放进List 再notifyDataSetChanged()。数据量超过几十条时应该用DiffUtil计算差异否则每次刷新整个列表都会闪一下。Override public void onBindViewHolder(ViewHolder holder, int position) { Assignment item list.get(position); holder.titleView.setText(item.getTitle()); holder.deadlineView.setText(截止 item.getDeadline()); holder.statusView.setText(item.isSubmitted() ? 已提交 : 未提交); holder.itemView.setOnClickListener(v - { Intent intent new Intent(context, SubmitActivity.class); intent.putExtra(assignment_id, item.getId()); context.startActivity(intent); }); }代码中statusView根据提交状态显示不同文字这是答辩时最容易被追问的点状态变化后什么时候触发刷新一般是在SubmitActivity成功上传后setResult(RESULT_OK)回到列表页的onActivityResult里重新查询数据库或者更新对应item。如果只想更新单个item用notifyItemChanged(position)避免全量刷新。刷新方式适用场景代价notifyDataSetChanged()列表整体变化数据量小于50条重建所有可见item闪烁明显notifyItemChanged(position)单个item状态变化需要持有准确的positionDiffUtil大列表或频繁局部更新增加回调计算代码稍复杂3.3 XML布局用ConstraintLayout减少嵌套层级界面布局不要用多层LinearLayout嵌套会拖慢渲染。现在的Android Studio模板默认用ConstraintLayout可以把多个控件的约束关系写在一个layout里。EditText android:idid/et_remark android:layout_width0dp android:layout_heightwrap_content android:hint填写作业备注 app:layout_constraintTop_toBottomOfid/tv_title app:layout_constraintStart_toStartOfparent app:layout_constraintEnd_toEndOfparent /0dp配合约束代表宽度由约束决定。et_remark的上边界约束在tv_title下方左右对齐父容器。如果你要动态控制提交按钮是否可用可以在Activity里用TextWatcher监听EditText变化再更新Button的enabled属性这样能挡住点击空备注提交。3.4 屏幕适配与文件权限的隐藏扣分点课程设计项目经常模拟器上正常换到真机就变形。主要原因是写死dp文字单位又用了dp而不是sp。规范做法是文字用sp控件尺寸用dpRecyclerView的item高度不要硬编码。涉及文件选择时还要动态申请READ_EXTERNAL_STORAGE权限Android 6.0以上是运行时权限需要在请求回调里处理用户拒绝的情况。这个地方经常被评审挑刺做了就是加分项。4. 数据持久化用SQLite记录作业状态、用SharedPreferences保存草稿4.1 为什么课程设计不用Room而是直接写SQLite项目源码里如果出现数据库helper类大概率是直接继承SQLiteOpenHelper而不是用Room。原因很简单课程设计要求演示“掌握数据库操作”手写SQL更容易在答辩时讲清楚。Room是更高层的抽象写起来方便但很多同学答不上Room是怎么生成DAO的反而露怯。SQLiteOpenHelper的核心是onCreate和onUpgradeonCreate里建表onUpgrade里处理版本升级。课程设计里通常只写onCreate升级逻辑容易被忽略。public class DBHelper extends SQLiteOpenHelper { public static final String DB_NAME homework.db; public static final int DB_VERSION 1; public DBHelper(Context context) { super(context, DB_NAME, null, DB_VERSION); } Override public void onCreate(SQLiteDatabase db) { db.execSQL(CREATE TABLE IF NOT EXISTS assignment ( id INTEGER PRIMARY KEY AUTOINCREMENT, assignment_id INTEGER UNIQUE, title TEXT, deadline TEXT, submitted INTEGER DEFAULT 0)); } Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { // 课程设计可以简单 drop 重建真实项目需要迁移数据 } }上面的建表语句里assignment_id是服务端返回的作业ID用UNIQUE避免重复插入submitted用int值0/1表示未提交/已提交。本地存一份提交状态弱网时也能快速显示历史状态页面不需要一直转圈。需要注意SQLite的INTEGER PRIMARY KEY会自动复用rowid如果插入业务主键要避免类型不匹配。比较项SQLiteOpenHelperRoom代码量手写SQL和Cursor代码多注解生成代码少编译期检查无有SQL错误编译报错学习成本需要懂SQL语法需要懂注解和Flow课程设计答辩好讲能说清SQL细节容易被认为直接抄教程4.2 用ContentValues而不是拼接SQL字符串很多同学为了演示方便直接写db.execSQL(INSERT ... title)一旦title里带单引号SQL语句直接崩还有SQL注入风险。规范写法是用ContentValuesSQLiteDatabase db helper.getWritableDatabase(); ContentValues values new ContentValues(); values.put(assignment_id, assignmentId); values.put(title, title); values.put(submitted, 0); long rowId db.insert(assignment, null, values);insert方法内部会拼接SQL并做转义返回rowId失败返回-1。能写出db.insert和db.query而不是execSQL拼字符串已经是答辩加分项。查询时用selectionArgs传参Cursor cursor db.query(assignment, null, assignment_id ?, new String[]{String.valueOf(assignmentId)}, null, null, deadline ASC);query方法有七个参数这里前六个传完最后一个排序条件用deadline升序。Cursor使用完一定要在finally或try-with-resources里关闭否则反复打开会报“Failed to close cursor”日志。4.3 SharedPreferences的适用边界作业草稿、登录状态这类轻量键值对用SharedPreferences最合适。但不要塞大字符串比如把老师评语几十KB写进去会拖慢读取。登录token建议只在内存和Preferences各存一份不要让数据库参与。SharedPreferences sp getSharedPreferences(user_info, MODE_PRIVATE); sp.edit() .putString(student_id, 20240001) .putString(token, token) .putBoolean(is_login, true) .apply();apply()与commit()的区别是commit同步写磁盘apply异步。在Activity的onDestroy里最好用commit保证状态即时落盘。apply在部分Android版本上有ANR风险课程设计场景不用过度纠结但被问到时要能说出这两者的区别。4.4 查看数据库内容的方法调试时不一定要打Log可以直接用adb进数据库查看数据adb shell run-as com.example.homeworkapp sqlite3 /data/data/com.example.homeworkapp/databases/homework.db select * from assignment;run-as只在debuggable应用下可用release包会报错。sqlite3命令也不是所有模拟器都带如果提示not found可以用Android Studio自带的Database Inspector直接查看。这个工具能边操作App边看数据库变化比一遍遍打印Log靠谱得多。5. 网络通信RetrofitOkHttp对接task-server实现文件上传5.1 先看task-server-master暴露哪些接口task-server-master如果是Spring Boot或普通Java后端的Maven项目它的Controller会定义作业和提交接口。拿到源码后不要急着写Android代码先打开服务端的RequestMapping看路径和参数。常见接口设计如下接口方法请求参数返回/api/student/assignmentsGETstudentId作业列表JSON/api/student/submitPOSTMultipartFile file, studentId, assignmentId, remark成功/失败code/api/teacher/gradePOSTsubmissionId, score, comment更新后的评分这里要注意服务端返回体最好统一为{code, message, data}前端才好解析。如果发现接口格式不统一我的建议是前端做一层包装解析不要直接改后端返回结构因为后端还要跑测试报告里的用例。5.2 用Retrofit的Multipart把文件和表单字段一起上传Retrofit处理文件上传非常直接接口方法上标注Multipart和Part把表单字段和文件分开声明。public interface ApiService { Multipart POST(student/submit) CallBaseResponse submitAssignment( Part(studentId) RequestBody studentId, Part(assignmentId) RequestBody assignmentId, Part(remark) RequestBody remark, Part MultipartBody.Part file ); }调用时先构造MultipartBody.PartFile file new File(filePath); RequestBody fileBody RequestBody.create(file, MediaType.parse(application/octet-stream)); MultipartBody.Part part MultipartBody.Part.createFormData(file, file.getName(), fileBody);RequestBody.create有两个参数新版OkHttp要求显式指定MediaType不指定会报错。这里的第一个字符串“file”必须与后端RequestParam(file)一致否则后端拿不到文件。表单字段也要用RequestBody.create传入不能直接传StringRetrofit会要求RequestBody类型。5.3 网络层统一设置超时和日志OkHttpClient是Retrofit的底层网络栈超时时间需要按场景区分。作业文件不小写超时要放宽。OkHttpClient client new OkHttpClient.Builder() .connectTimeout(10, TimeUnit.SECONDS) .readTimeout(15, TimeUnit.SECONDS) .writeTimeout(60, TimeUnit.SECONDS) .addInterceptor(new HttpLoggingInterceptor().setLevel(HttpLoggingInterceptor.Level.BODY)) .build();连接10秒、读15秒、写60秒这是针对作业文件上传场景的习惯配置。日志拦截器在调试时开BODY能看到请求参数和响应内容但BODY日志会打印文件流如果文件很大日志会刷屏甚至OOM。调试完确认参数没问题就改回BASIC或NONE。5.4 解析返回结果与错误处理服务端返回BaseResponse里code为0表示成功非0表示失败。onResponse里不能只判断isSuccessful业务code也必须检查。很多同学只处理200结果后端返回业务失败时界面还是提示成功这是课程设计答辩常被挑的毛病。call.enqueue(new CallbackBaseResponse() { Override public void onResponse(CallBaseResponse call, ResponseBaseResponse response) { BaseResponse body response.body(); if (response.isSuccessful() body ! null body.getCode() 0) { // 标记本机已提交 } else { // 提示后端返回的 message } } Override public void onFailure(CallBaseResponse call, Throwable t) { // 超时、断网等情况 } });这里有个坑如果后端业务失败也返回HTTP 200response.isSuccessful()一直为true所以必须检查code。如果后端返回4xx/5xxresponse.body()会是null需要从response.errorBody()里读取错误信息但errorBody只能消费一次读取后不要重复使用。5.5 明文HTTP流量的坑targetSdkVersion 28以上默认禁止明文HTTP请求Android会报Cleartext HTTP traffic not permitted。如果你的后端是本地局域网地址比如 http://192.168.1.100:8080有两个解决办法。第一在AndroidManifest.xml的application标签里加 android:usesCleartextTraffictrue全局允许明文课程设计常用。第二更安全的做法是在res/xml/network_security_config.xml里只允许指定域名明文其他走HTTPS。答辩时能主动说出这两个方案的区别比被问了才解释要好得多。6. 让作业提交APP更像真实产品WorkManager重试机制与答辩演示顺序6.1 用WorkManager把上传失败的任务放入队列课程设计项目大都是同步调用网络弱网下点提交转圈几秒后失败数据就丢了。真实产品会用WorkManager或前台服务保证任务必达。在作业提交场景里把待提交的作业ID和文件路径先写入SQLite状态标记为“上传中”然后enqueue一个OneTimeWorkRequest。Data inputData new Data.Builder() .putInt(assignmentId, assignmentId) .putString(filePath, filePath) .build(); OneTimeWorkRequest request new OneTimeWorkRequest.Builder(UploadWorker.class) .setInputData(inputData) .setConstraints(new Constraints.Builder().setRequiredNetworkType(NetworkType.CONNECTED).build()) .setBackoffCriteria(BackoffPolicy.EXPONENTIAL, 5, TimeUnit.SECONDS) .build(); WorkManager.getInstance(context).enqueue(request);setBackoffCriteria表示失败后按指数退避重试从5秒开始。UploadWorker里在doWork()中调用网络上传返回Result.success()或Result.retry()。Worker默认运行在后台线程不需要自己开线程。这种设计在答辩时能明显拉开与“直接new Thread”的差距。6.2 答辩演示顺序建议拿到源码和PPT后不要一上来就讲代码。我建议顺序是先花30秒说清问题场景再打开App演示学生提交作业和教师端查看状态最后用一两分钟看重点代码。演示时先把网络断开展示本地草稿还在再恢复网络展示队列恢复上传。这个场景比单纯演示正常流程更能证明你理解了数据一致性和后台任务。6.3 把测试报告.docx变成答辩弹药测试报告里的每条用例都可以在源码里找到对应逻辑。比如“提交空文件被拦截”对应SubmitActivity里的文件大小校验“重复作业不重复提交”对应SQLite中assignment_id的UNIQUE约束和回调中的状态判断。下面这张表是常见的功能到源码映射可以直接拿去对照PPT评分项对应源码位置说明启动流程MainActivity应用入口检查登录状态并跳转作业列表AssignmentAdapterRecyclerView数据与点击事件数据存储DBHelperSQLiteOpenHelper操作作业状态文件上传ApiServiceRetrofit接口定义与Multipart上传失败重试UploadWorkerWorkManager后台任务与重试策略本文还有配套的精品资源点击获取