企业官网建设流程全解析

简介：本资源是一套面向计算机相关专业本科生的Android毕业设计实战项目，聚焦高校课程电子化管理场景，为正在完成期末大作业或毕业设计的学生提供可直接复用的完整解决方案。压缩包共含论文、开发文档、数据库设计说明与可运行源码四大类内容，涵盖需求分析、系统架构、UI实现及SQLite数据管理等核心模块，所有代码均经本地编译调试通过，适合作为Android应用开发入门到进阶的实践范例。资源包大小19.76MB，文件总数未提供，但结构清晰、文档齐全，便于快速理解整体设计逻辑与技术实现路径。目前已有32人学习下载，适合需要真实项目练手、掌握移动应用开发全流程的学习者——不仅能获得完整可运行工程，还能通过配套文档深入理解MVC分层设计、Activity生命周期管理及课程数据增删改查等关键知识点。

1. 这不是又一个“课程表App”：它解决的是教务系统与学生终端之间那层看不见的胶水问题

大学里，课表查不到、调课通知滞后、实验预约抢不到、成绩更新不同步——这些不是功能缺失，而是数据孤岛在作祟。教务系统跑在校园内网Windows服务器上，学生用的却是Android手机；老师手动导出Excel再发QQ群，学生截图保存后三天就找不着；课程资源散落在FTP、百度网盘、超星平台，链接失效是常态。基于Android的大学课程电子管理平台系统，核心不在“做个App”，而在于构建一套轻量级、可插拔、能绕过教务系统封闭API的本地化数据桥接机制：它不替代教务系统，但能从网页端抓取、解析、缓存、推送关键教学数据，并在离线状态下保证课表、作业、通知的强一致性。适合教务处无预算采购商业系统、院系想快速落地数字化服务、或计算机专业学生做毕业设计——它不要求对接校方数据库权限，靠规则化爬虫+本地SQLite+Android JobIntentService实现“零后台服务依赖”。我带三届毕设团队跑通这个路径，最深的体会是：90%的翻车点不在UI，而在/storage/emulated/0/android/data/目录下的文件权限博弈和WebView加载教务页面时的JavaScript沙箱逃逸。

2. 从零启动：用Android Studio搭建可维护的架构骨架

2.1 为什么选Kotlin+MVVM+Room而不是Java+MVC？

教务数据结构天然具备强实体关系：Course（课程）→Schedule（课表）→Assignment（作业）→Resource（资料），且需离线优先。Java写MVC容易陷入Activity里塞满网络请求、SQL拼接、UI刷新的“上帝类”。而Kotlin的空安全、协程作用域、扩展函数，配合MVVM的ViewModel隔离UI逻辑、LiveData响应式更新，能让代码可测试性提升3倍以上。Room则直接把SQLite操作封装成DAO接口，避免手写Cursor解析的玄学崩溃。

注意：不要用GreenDao或ObjectBox——它们对@Embedded嵌套对象支持弱，而课程数据中“教师信息嵌套在课程里、教室位置嵌套在课表里”是刚需。Room的@Relation注解能自动生成JOIN查询，比手写SQL少踩70%的字段映射坑。

2.2 模块化分层：把“教务适配器”单独抽成module

整个项目拆为三个module：

• app：纯UI层，只含Activity/Fragment，不碰网络和数据库
• data：含Room Entity/DAO、Retrofit Service、Web Scraping工具类
• domain：定义业务实体（如CourseEntity）、Repository接口、UseCase类

这样做的好处是：当某天学校教务系统从http://jwxt.xxx.edu.cn升级到https://jwxt2.xxx.edu.cn，只需重写data模块里的JwxtScraper.kt，app层完全不用动。我们曾用此结构在2小时内完成对3所高校教务系统的适配切换。

2.3 初始化Room数据库：带预置数据的迁移策略

// data/src/main/java/com/university/manager/database/AppDatabase.kt @Database( entities = [CourseEntity::class, ScheduleEntity::class, AssignmentEntity::class], version = 3, exportSchema = false ) abstract class AppDatabase : RoomDatabase() { abstract fun courseDao(): CourseDao abstract fun scheduleDao(): ScheduleDao abstract fun assignmentDao(): AssignmentDao companion object { @Volatile private var INSTANCE: AppDatabase? = null fun getDatabase(context: Context): AppDatabase { return INSTANCE ?: synchronized(this) { INSTANCE ?: buildDatabase(context).also { INSTANCE = it } } } private fun buildDatabase(context: Context): AppDatabase { return Room.databaseBuilder( context.applicationContext, AppDatabase::class.java, "university_manager.db" ) .addCallback(object : Callback() { override fun onCreate(db: SupportSQLiteDatabase) { super.onCreate(db) // 预置本学期默认课表（避免首次启动空白） val defaultCourses = loadDefaultCourses() db.insert("course", ConflictStrategy.IGNORE, ContentValues().apply { put("id", "CS101"); put("name", "数据结构") }) } }) .addMigrations(MIGRATION_1_2, MIGRATION_2_3) .build() } } }

参数说明：

• exportSchema = false：关闭schema导出，避免生成大量JSON文件污染git仓库
• ConflictStrategy.IGNORE：插入重复主键时静默跳过，防止教务系统重复推送同一门课
• addMigrations：必须显式声明迁移，否则升级version会清空数据库——这是学生反馈“课表突然消失”的头号原因

3. 教务数据获取：绕过登录态的稳定抓取方案

3.1 为什么放弃WebView自动登录？真实场景中的权限陷阱

教务系统普遍采用CAS单点登录或Session Cookie验证。初版我们尝试用WebView加载登录页、注入JS填账号密码、监听URL跳转判断登录成功——结果在Android 10+设备上全军覆没：WebView默认禁用第三方Cookie，setDomStorageEnabled(true)在targetSdkVersion>=30后被废弃，且onPageFinished回调在JS异步重定向时不可靠。更致命的是，/storage/emulated/0/android/data/com.xxx.jwxt/目录下无法写入Cookie文件，导致后续HTTP请求全部401。

最终方案：改用OkHttpClient+CookieJar手动管理会话，配合Jsoup解析HTML。流程如下：

1. GET登录页 → 提取<input name="lt" value="xxx">等隐藏字段
2. POST账号密码+隐藏字段 → 获取Set-Cookie头
3. 后续所有请求复用该CookieJar → 解析课表HTML表格

3.2 Jsoup解析课表：对抗教务系统HTML的野蛮生长

教务系统HTML常含以下反爬特征：

• 表格无<thead>，全靠<tr>第1行当标题
• 课程名称藏在<font color="#FF0000">高等数学</font>里
• 时间单元格含<br>换行，需textNodes().join("\n")提取

// data/src/main/java/com/university/manager/scraping/JwxtScraper.kt fun parseSchedule(html: String): List<ScheduleEntity> { val doc = Jsoup.parse(html) val table = doc.select("table[border=1]").first() ?: return emptyList() val rows = table.select("tr") val headers = rows.first().select("td").map { it.text().trim() } // ["节次", "星期一", "星期二", ...] return rows.drop(1).mapNotNull { row -> val cells = row.select("td") if (cells.size < headers.size) return@mapNotNull null val period = cells.first().text().trim() // "1-2节" headers.drop(1).withIndex().map { (index, day) -> val cell = cells.getOrNull(index + 1) ?: return@mapNotNull null val courseText = cell.textNodes().join("\n").trim() if (courseText.isBlank()) return@map null ScheduleEntity( period = period, dayOfWeek = day, courseName = extractCourseName(courseText), // 处理<font>标签 classroom = extractClassroom(cell.html()) ) }.filterNotNull() }.flatten() }

关键技巧：

• cell.textNodes().join("\n")比cell.text()更能保留换行语义，避免“高等数学\nA201”被压成“高等数学A201”
• extractCourseName()用正则<font[^>]*>(.*?)</font>提取，而非select("font")——因部分系统用<span style="color:red">替代

3.3 网络请求超时与重试：教务服务器的“间歇性失联”

教务服务器常因负载过高返回502/504，或DNS解析失败。我们采用OkHttp的Interceptor实现指数退避重试：

// data/src/main/java/com/university/manager/network/RetryInterceptor.kt class RetryInterceptor : Interceptor { override fun intercept(chain: Interceptor.Chain): Response { var response: Response? = null var exception: IOException? = null var retryCount = 0 val maxRetries = 3 while (retryCount < maxRetries && (response == null || !response.isSuccessful)) { try { response = chain.proceed(chain.request()) exception = null } catch (e: IOException) { exception = e Thread.sleep((1000 * (2f.pow(retryCount))).toLong()) // 1s, 2s, 4s } retryCount++ } if (response == null) throw exception!! return response } }

参数说明：

• 2f.pow(retryCount)实现指数退避，避免瞬间重试压垮本就脆弱的教务服务器
• response.isSuccessful判断HTTP状态码200-299，不包含302重定向（需单独处理）

4. 本地存储与同步：让离线课表真正“可用”

4.1 Room实体设计：用@Embedded解决教务数据的嵌套地狱

教务课表数据本质是“课程-时间-地点”三维映射，若强行扁平化会导致冗余字段爆炸。Room的@Embedded是解药：

@Entity(tableName = "schedule") data class ScheduleEntity( @PrimaryKey val id: Long = 0, val period: String, // "1-2节" val dayOfWeek: String, // "星期一" @Embedded(prefix = "course_") val course: CourseSummary, // 嵌套课程摘要 @Embedded(prefix = "room_") val room: RoomInfo // 嵌套教室信息 ) data class CourseSummary( val code: String, // "CS101" val name: String, // "数据结构" val teacher: String // "张教授" ) data class RoomInfo( val building: String, // "主楼" val number: String, // "A201" val capacity: Int // 120 )

效果：数据库表实际字段为course_code,course_name,room_building等，但代码中仍以对象形式访问，避免cursor.getString(5)这种易错写法。

4.2 同步策略：手动触发 vs 后台定时，哪个更省电？

学生最反感“App在后台偷偷耗电”。我们弃用WorkManager的周期性任务（Android 12+限制严格），改用混合触发：

• 手动：下拉刷新（SwipeRefreshLayout）
• 半自动：App进入前台时检查距上次同步是否超2小时
• 全自动：仅当收到教务系统Webhook推送（需学校开放）才触发

// app/src/main/java/com/university/manager/ui/schedule/ScheduleFragment.kt override fun onResume() { super.onResume() val lastSync = prefs.getLong("last_sync_time", 0) if (System.currentTimeMillis() - lastSync > 2 * 60 * 60 * 1000) { syncSchedule() } }

提示：SharedPreferences存时间戳比数据库查更轻量，避免每次onResume都开Room连接。

4.3 文件存储规范：为什么坚持用Context.getExternalFilesDir()

教务资料（PDF课件、PPT、实验指导书）需持久化。/storage/emulated/0/Download/目录虽易访问，但会被其他App扫描索引，造成隐私泄露。正确做法是：

// data/src/main/java/com/university/manager/file/FileStorage.kt fun getCourseFileDir(context: Context, courseId: String): File { val baseDir = context.getExternalFilesDir("courses") ?: return File("") val courseDir = File(baseDir, courseId) // /android/data/com.university.manager/files/courses/CS101/ courseDir.mkdirs() return courseDir }

优势：

• Android 11+无需申请READ_EXTERNAL_STORAGE权限
• App卸载时自动清理，不残留垃圾文件
• 路径稳定，不受厂商定制ROM影响（对比/storage/emulated/0/android/data/...可能被MIUI冻结）

5. 避坑指南：那些让毕设答辩前夜崩溃的典型问题

5.1 现象：课表数据显示为空白，Logcat只报android.database.sqlite.SQLiteConstraintException

原因：Room插入时主键冲突，但未设置OnConflictStrategy。例如同一门课在不同周次重复解析，ScheduleEntity.id自增但period+dayOfWeek+course.code组合应唯一，却未建联合索引。

解决：

1. 在ScheduleEntity加@ColumnInfo(name = "unique_key")字段，值为"$period-$dayOfWeek-${course.code}"
2. 数据库建唯一索引：

@Entity( tableName = "schedule", indices = [Index(value = ["unique_key"], unique = true)] )

3. 插入时用INSERT OR REPLACE INTO：

@Insert(onConflict = OnConflictStrategy.REPLACE) suspend fun insertAll(schedules: List<ScheduleEntity>)

5.2 现象：Android 10设备上getExternalFilesDir()返回null

原因：targetSdkVersion设为29（Android 10）时，若AndroidManifest.xml未声明requestLegacyExternalStorage="true"，且设备启用了分区存储（Scoped Storage），getExternalFilesDir()在某些厂商ROM（如华为EMUI）上会返回null。

解决：

• 短期：在AndroidManifest.xml的<application>标签加android:requestLegacyExternalStorage="true"
• 长期：升级targetSdkVersion到30+后，改用MediaStore保存文件，或坚持用Context.getDataDir()（需用户授权）

5.3 现象：WebView加载教务页面时白屏，onReceivedError回调显示net::ERR_CLEARTEXT_NOT_PERMITTED

原因：教务系统仍用HTTP协议（非HTTPS），而Android 9+默认禁止明文流量。

解决：

1. 在AndroidManifest.xml的<application>标签加：

android:usesCleartextTraffic="true"

2. 更优方案：在res/xml/network_security_config.xml中精准放行：

<?xml version="1.0" encoding="utf-8"?> <network-security-config> <domain-config> <domain includeSubdomains="true">jwxt.xxx.edu.cn</domain> <cleartextTrafficPermitted="true" /> </domain-config> </network-security-config>

然后在Manifest中引用：android:networkSecurityConfig="@xml/network_security_config"

5.4 现象：夜间模式下课表文字看不清，TextView颜色随系统主题乱变

原因：未为TextView指定android:textColor，依赖系统?android:attr/textColorPrimary，而教务系统深色主题下该属性值为浅灰，在深色背景上几乎隐形。

解决：

• 所有课表相关TextView强制指定颜色：

<TextView android:textColor="@color/course_text_color" ... />

• 在res/values/colors.xml和res/values-night/colors.xml中分别定义：

<!-- values/colors.xml --> <color name="course_text_color">#333333</color> <!-- values-night/colors.xml --> <color name="course_text_color">#FFFFFF</color>

5.5 现象：adb logcat看到java.lang.SecurityException: Permission Denial: reading com.android.providers.media.MediaProvider，但App没申请存储权限

原因：使用ContentResolver查询媒体库（如从相册选课件封面）时，Android 10+要求动态申请READ_MEDIA_IMAGES，而非旧版READ_EXTERNAL_STORAGE。

解决：

• 检查targetSdkVersion，若≥30，权限申请代码必须用：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) { requestPermissions(arrayOf(Manifest.permission.READ_MEDIA_IMAGES), REQUEST_CODE) } else { requestPermissions(arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE), REQUEST_CODE) }

• AndroidManifest.xml中对应权限声明也要分版本：

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="29" />

6. 进阶技巧：用JobIntentService实现“静默同步”，让教务数据真正活起来

6.1 为什么不用WorkManager？直面Android后台限制的硬核解法

WorkManager在Android 10+后台执行受Battery Optimization和Doze Mode双重压制，尤其教务系统同步需在凌晨2点抓取新课表，但WorkManager可能延迟到次日中午才执行。JobIntentService是Google官方推荐的替代方案——它本质是JobScheduler的兼容封装，能在后台保活且不受电池优化影响。

// app/src/main/java/com/university/manager/service/SyncJobService.kt class SyncJobService : JobIntentService() { companion object { private const val JOB_ID = 1001 fun enqueueWork(context: Context, work: Intent) { enqueueWork(context, SyncJobService::class.java, JOB_ID, work) } } override fun onHandleWork(intent: Intent) { // 此处执行同步逻辑，运行在后台线程 val result = JwxtScraper().syncSchedule() // 发送通知提醒用户 if (result.success) { showSyncSuccessNotification() } } }

注册方式（AndroidManifest.xml）：

<service android:name=".service.SyncJobService" android:permission="android.permission.BIND_JOB_SERVICE" />

6.2 定时触发：用AlarmManager设置精确唤醒点

JobIntentService需外部触发。我们在Application.onCreate()中设置每日凌晨2:15唤醒：

// app/src/main/java/com/university/manager/MyApplication.kt override fun onCreate() { super.onCreate() setDailySyncAlarm() } private fun setDailySyncAlarm() { val alarmManager = getSystemService(Context.ALARM_SERVICE) as AlarmManager val intent = Intent(this, SyncJobService::class.java) val pendingIntent = PendingIntent.getService( this, 0, intent, PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT ) val calendar = Calendar.getInstance().apply { set(Calendar.HOUR_OF_DAY, 2) set(Calendar.MINUTE, 15) set(Calendar.SECOND, 0) if (timeInMillis < System.currentTimeMillis()) add(Calendar.DAY_OF_YEAR, 1) } alarmManager.setExactAndAllowWhileIdle( AlarmManager.RTC_WAKEUP, calendar.timeInMillis, pendingIntent ) }

关键参数：

• setExactAndAllowWhileIdle：绕过Doze Mode限制，确保准时唤醒
• PendingIntent.FLAG_IMMUTABLE：Android 12+强制要求，否则PendingIntent创建失败

6.3 同步结果可视化：用Android进度条反馈真实进度

学生最焦虑“同步到底卡在哪”。我们弃用ProgressDialog（已废弃），改用ProgressBar+TextView组合，并实时显示当前步骤：

// app/src/main/java/com/university/manager/ui/schedule/SyncDialog.kt class SyncDialog(context: Context) : Dialog(context) { private lateinit var progressBar: ProgressBar private lateinit var statusText: TextView override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.dialog_sync) progressBar = findViewById(R.id.progress_bar) statusText = findViewById(R.id.status_text) // 绑定同步过程中的LiveData viewModel.syncProgress.observe(this) { progress -> progressBar.progress = progress.value statusText.text = progress.message } } }

血泪经验：进度条数值不能简单线性分配。教务系统登录常耗时最长（网络抖动），而解析HTML反而快——所以login阶段占20%，fetchHtml占30%，parseHtml占20%，saveToDb占30%，这才是真实体验。

最后说句实在话：做这个系统，80%时间花在和教务系统HTML的斗智斗勇上，20%才是Android开发。我带学生做毕设时反复强调——别急着画UI，先用Chrome开发者工具把教务页面的HTML结构扒干净，存成.html文件本地调试。没有比本地静态HTML更快的迭代方式，也没有比真实教务页面更难啃的骨头。希望帮到你。

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