快速开始

本文将带你打开课堂点名,建好一个班级,并完成第一次随机点名。

方式一:直接在线使用(推荐)

  1. 用浏览器打开 https://classroom.fusuccess.top/
  2. 在登录页输入默认密码 123456,点击 进入系统
  3. 进入首页后,即可使用班级管理、点名和统计。
💡 提示
登录状态会保存在当前浏览器。刷新页面一般不用重新输入密码。 若这是公开或共用环境,登录后请立刻到「设置 → 修改密码」改掉默认密码。

方式二:安装 Android 版

通过上方「Android 安装包」下载 app-release.apk, 在手机上允许安装未知来源应用后即可安装。手机版与网页版功能相同,数据各自存在本机,不会自动同步。

方式三:从源码运行

环境要求

  • Flutter SDK 3.x(Dart SDK 3.0 及以上)
  • 按目标平台安装对应工具:Chrome(Web)、Xcode(iOS / macOS)、Android Studio(Android)

安装并启动

git clone https://github.com/Fusuccess/classroom_roll_call.git
cd classroom_roll_call
flutter pub get
flutter run -d chrome

也可换成其他设备:

flutter run -d android
flutter run -d ios
flutter run -d macos

打包发布

# Web(产物在 build/web/)
flutter build web --release

# Android 安装包
flutter build apk --release

# 构建 Web 时若需附带 APK,可用项目脚本
./build_web.sh

完成第一次点名

以「手动建一个小班,再点一名学生」为例:

  1. 登录后进入首页,点击 班级管理
  2. 右下角点击 新增,班级名称填 高一(1)班,描述可留空,保存。
  3. 点开该班级右侧菜单,选择 管理学生
  4. 右下角添加学生,例如姓名 张三、学号 001。至少再加 1~2 人,方便看到随机效果。
  5. 返回首页,点击 开始点名,在弹窗里选中 高一(1)班
  6. 点击大按钮 开始点名,圆圈会快速切换姓名,最后停在抽出的学生上。
  7. 根据回答点击 1 分~5 分;也可以不评分,再点一次「开始点名」抽下一位。

点名页上方会显示总人数、已点名、未点名。右上角时钟图标可查看本班点名历史。

⚠️ 注意
班级里还没有学生时,点名页会提示先去班级管理添加。 学号是必填项,添加或导入时缺学号的行会被跳过。

用 CSV 一次导入整班(可选)

名单较多时,不必逐条添加:

  1. 用 Excel 或记事本准备 CSV,第一行必须是标题,并包含 学生姓名学号 两列。
  2. 在班级管理页点击 导入,先填写要创建的班级名称。
  3. 选择 CSV 文件,核对预览名单后点击 确认导入
学生姓名,学号
张三,001
李四,002
王五,003

列名、多列表格、导出文件位置见 导入导出

下一步