# ClassGadgets

**Repository Path**: xiaoyangcc/ClassGadgets

## Basic Information

- **Project Name**: ClassGadgets
- **Description**: 班级小工具

砖🚪订制
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-25
- **Last Updated**: 2025-12-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, Javafx, Python, 班级

## README

# ClassGadgets

## 介绍
班级小工具 - 课堂点名程序

这是一个前端基于 JavaFX 的课堂点名应用程序，具有以下功能：
- 从远程服务器获取学生名单
- 本地缓存支持，断网也能使用
- 防止重复点名功能
- 批量点名（连抽）
- 图形化用户界面
- And so on...

## 软件架构
- Java 21
- JavaFX 21
- Maven 构建工具
- Jackson JSON 处理库
- Apache HttpClient 网络请求库
- Python 3.10.4 后端服务

## 安装教程

### 1. 前端
#### 使用打包的 exe 程序
#### 编译安装运行：
    1. 克隆或下载项目仓库到本地 IDE
    2. 确保系统已安装 Java 21
    3. 使用 Maven 构建项目: `mvn clean package`
    4. 运行程序: `mvn javafx:run` 或双击 run.bat
#### 自行打包为 exe：
    - 可以使用第三方工具如 Launch4j 或 jpackage 将程序打包为 exe 文件
    - 命令行打包：
        1. 使用 Maven 构建项目: `mvn clean package javafx:jlink`
        2. 本地终端进入到 client 目录并执行：`jpackage --name "吕老师点名小程序-安装包" --input target --main-class top.ltc_cn.class_gadgets.Application --main-jar Rollcall-1.0-SNAPSHOT-shaded.jar --icon src/main/resources/static/images/application-icon.jpg --runtime-image ./target/app-image --verbose --vendor Ltc-cn --win-console –win-dir-chooser –win-shortcut`
        3. 打包出exe安装包文件
        
### jpackage 命令行参数说明：
- `--name`: 指定生成的安装包名称
- `--input`: 指定输入目录，包含要打包的jar文件
- `--main-class`: 指定应用程序的主类 [top.ltc_cn.class_gadgets.Application](file://C:\Users\xiaoyangcc\Documents\小扬的程序\ClassGadgets\Rollcall\client\src\main\java\top\ltc_cn\class_gadgets\Application.java#L15-L39)
- `--main-jar`: 指定主JAR文件 [Rollcall-1.0-SNAPSHOT-shaded.jar](file://C:\Users\xiaoyangcc\Documents\小扬的程序\ClassGadgets\Rollcall\client\target\Rollcall-1.0-SNAPSHOT-shaded.jar)
- `--icon`: 指定应用程序图标路径
- `--runtime-image`: 指定自定义运行时镜像路径
- `--verbose`: 输出详细日志信息
- `--vendor`: 指定供应商信息
- `--win-console`: 为Windows平台创建控制台版本
- `--win-dir-chooser`: 在Windows安装程序中添加目录选择功能
- `--win-shortcut`: 在Windows开始菜单创建快捷方式

### 2. 后端
使用 Python 3.10.4 运行后端服务：
1. 确保已安装 Python 3.10.4
2. 下载 pip 依赖：`pip install -r requirements.txt`
3. 修改名单等配置
4. 运行后端服务：`python server.py`

## 使用说明
懒得写

## 参与贡献
1. 添加功能：（!!! 别直接强制推送到我的 master 分支）
    1. Fork 本仓库
    2. 新建 Feat_xxx 或其他分支
    3. 提交代码
    4. 新建 Pull Request
2. 提交建议直接提 issue
3. 提交 Bug 也直接提 issue