ManyCourse 动手练习：从跑项目到加学校的实战路线

环境要求#

零基础搭建步骤#

1. 装 Android Studio（官网下载），首次打开会引导装 SDK。
2. 克隆项目：git clone https://github.com/ksayus/ManyCourse.git
3. 用 Android Studio 打开项目目录（不是某个文件，是整个 ManyCourse 文件夹）。
4. Android Studio 会自动生成 local.properties（里面是本机 SDK 路径），通常自己搞定。
5. 等它同步（Gradle 拉依赖，第一次可能较慢）。
6. 连一台 Android 手机（开 USB 调试）或建一个模拟器，点 Run ▶。

命令行构建（可选）#

1
cd ManyCourse
2
./gradlew :app:testDebugUnitTest :app:assembleDebug

练习 1（最简单）：读懂一个 data class#

打开 School.kt，回答以下问题：

• School 有哪几个字段？哪些有默认值？
• 创建一个”只给 id/name/baseUrl”的 School，system 和 timetable 会是什么？
• host 是存下来的字段，还是现算的？给 baseUrl = "https://jwxt.xx.edu.cn/"，host 等于多少？

目的：理解 data class、默认参数、计算属性的基本概念。

练习 2：改预置课程，验证”改数据 → 界面自动更新”#

Course.kt 的 init { } 里有一堆预置课程。找到它们，改成你自己的课（名字/教室/星期几），重新运行，看课表页变没变。

目的：体会 object 单例 + mutableStateListOf 改了数据后 Compose 自动重画的机制——不需要手动调用任何刷新方法。

练习 3：给登录结果加一种新状态#

在 SchoolApi.kt 的 LoginResult 里新增一种：

1
data class NetworkError(val message: String) : LoginResult

然后编译项目，观察：哪里报错提示”没处理完 when”？

目的：体会 sealed 的威力——新增一种状态，编译器会逼你在所有 when 分支里处理它，漏了就编译不过。这是 Kotlin 类型系统防止遗漏的经典设计。

练习 4（核心挑战）：加一所学校#

照项目 README 的「三步接入」流程抄一遍：

第一步：复制 gr_api/schools/NhjcxyApi.kt 成 XxxApi.kt，修改 school 的 id/name/baseUrl。

1
// 模板骨架
2
class XxxApi : WebLoginSchoolApi() {
3
    override val school = School(
4
        id = "xxx",
5
        name = "某某大学",
6
        baseUrl = "https://jwxt.xxx.edu.cn",
7
    )
8
    override val loginUrl = "$baseUrl/jwglxt/xtgl/login_slogin.html"
9
    override val usernameField = "yhm"
10
    override val passwordField = "mm"
11
}

第二步：在 SchoolRegistry.kt 的 apis 列表里加一行：

1
private val apis: List<SchoolApi> = listOf(
2
    GzusApi(),
3
    NhjcxyApi(),
4
    GdutApi(),
5
    XxxApi(),   // ← 新增这一行
6
)

第三步：跑测试验证：

1
./gradlew :app:testDebugUnitTest --tests '*SchoolRegistryTest*'

目的：真正理解”接口 + 清单驱动”的架构——为什么加学校不用改 UI，只需实现接口 + 注册一行。

练习 5：加一个节假日年份#

在 HolidayCalendar.kt 里，照现有年份的写法给新的一年加一组 rest(...)/work(...) 调用，然后跑 HolidayCalendarTest。

注意：要”原文照抄 + 注释写通知原话”，否则测试会拦。

目的：理解”内置常量数据 + 用测试钉住事实”的设计——数据对了测试过，数据错了测试拦。

练习 6：加一个校区地图#

照项目 README 第五章的流程：

1. 放一张图到 drawable-nodpi/；
2. 在 SchoolMap.kt 登记校区（含坐标）；
3. 跑 SchoolMapTest 验证。

目的：理解 Android 资源目录规则（-nodpi、全小写命名）和项目约定的”坐标系/主校区”规范。

练习 7：给某个解析器写一个单测#

挑一个解析器（如 GdutScheduleParser.kt），在 app/src/test/.../ 里仿照现有的 GdutScheduleParserTest.kt 加一条断言。

目的：理解”把解析逻辑拆成独立 object + 用样本钉住真实页面结构”的价值——解析器失效时不会报错，只会静默表现成”课表空了”，测试能兜住。