南哪课表 APP

为 不止 NJUer 打造的 Android/iOS 平台课程表,使用 Flutter 编写

下载/Download

南哪课表官网

安卓下载地址

iOS 下载地址

南哪课表 FAQ

功能/Features

当前适配学校：南京大学、东南大学、上海交通大学、中国人民大学

更多学校适配欢迎联系作者或自行 PR~

1. Android & iOS 全平台支持
2. 支持南京大学统一认证登录，本科生&研究生均支持
3. 一键导入南大教务处，自动获取当前周
4. 支持免修不免考，同一时段允许多门课程
5. 支持不同学期多个课表管理与切换
6. 更多样式，自由添加背景图片

如何支持更多学校

南哪课表解析课程的主要原理是通过打开页面，并通过 JS 脚本获取页面中的课程信息，然后解析出课程的时间、地点、教师等信息。

涉及到的主要文件：

api/schoolList.json: 学校列表，包含学校名称、登录 URL、课程表 URL 等信息，在其中添加需要适配学校的相关信息

api/tools/njubksjw2.js: 当前南京大学使用的示例课程表解析脚本，你可以参考该文件，根据学校的课程表页面，获取课程信息并解析出时间、地点、教师等信息

api/tools/seubksxk.js: 当前东南大学使用的示例课程表解析脚本，你可以参考该文件，在 JS 脚本中进行 http 请求，根据学校的课程表页面，获取课程信息并解析出时间、地点、教师等信息

需要返回的数据格式（返回下面 json 格式数据的 encodeURIComponent 结果）：

{
    "name": "当前学期名称",
    "courses": [
        {
            "name": "课程名称",
            "classroom": "课程地点",
            "class_number": "课程编号",
            "teacher": "教师名称",
            "test_time": "考试时间",
            "test_location": "考试地点",
            "link":"课程详情链接，没有传null",
            "week": [1,2,3], // 课程第几周上，是一个数组
            "week_time": 1, // 课程周几上
            "start_time": 1, // 课程开始节数，从1开始,
            "time_count": 2, // 课程持续节数，即结束节数-开始结束，注意如果是3-4节则为1，不需要额外进行加一操作
            "import_type": 1, // 固定填1，作为自动导入方式
            "info": "课程详情，没有传null",
            "data": null
        }
    ]
}

部署相关

因为增加了鸿蒙支持，需要使用鸿蒙 Flutter 版本。

1. 根据 flutter_flutter oh-3.27.0 配置鸿蒙依赖
2. 加载项目环境变量：source tool/setup_ohos_env.sh （配好环境之后就只需要每次开发打开终端执行一次）
3. 安装并使用指定版本：fvm install oh-3.27.0-release && fvm use 3.27.5-ohos-1.0.3 （这里很奇怪，下载的版本号和cache版本号不一样）
4. 运行 fvm flutter doctor -v 检查环境变量配置，Flutter 与 OpenHarmony 都应为 ok
5. 在 external 文件夹中 clone 依赖（若尚未 clone）

• cd external
• git clone https://gitcode.com/openharmony-tpc/flutter_packages.git
• git clone https://gitcode.com/openharmony-sig/flutter_sqflite.git
• git clone https://gitcode.com/nutpi/flutter_plus_plugins_package_info_plus.git
• git clone https://gitcode.com/openharmony-sig/fluttertpc_mobile_scanner.git
• git clone https://gitcode.com/openharmony-sig/fluttertpc_device_calendar

6. 如果在中国大陆网络下载失败，执行：

• export USE_CN_FLUTTER_MIRROR=1
• source tool/setup_ohos_env.sh

快速切换构建环境

为了在 Android/iOS 与 OHOS 间减少手动操作，可在当前终端直接切换：

• 切到 OHOS 构建环境：source tool/switch_flutter_env.sh ohos
• 切回官方 Flutter（Android/iOS 常用）：source tool/switch_flutter_env.sh official

切换后建议运行 flutter doctor -v 或 fvm flutter doctor -v 做一次确认，并执行 flutter clean 以清除之前环境的构建缓存。