|
|
|
|
@ -0,0 +1,40 @@
|
|
|
|
|
# Math Learning 应用 JAR 运行指南
|
|
|
|
|
|
|
|
|
|
## 环境准备
|
|
|
|
|
- Windows 10/11，已安装 64 位 JDK 17
|
|
|
|
|
|
|
|
|
|
## 终端设置为 UTF-8
|
|
|
|
|
为避免中文字符显示异常，请在运行前切换到 UTF-8 编码。
|
|
|
|
|
|
|
|
|
|
### 命令提示符（cmd）
|
|
|
|
|
```cmd
|
|
|
|
|
chcp 65001
|
|
|
|
|
set JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### PowerShell
|
|
|
|
|
```powershell
|
|
|
|
|
chcp 65001
|
|
|
|
|
$env:JAVA_TOOL_OPTIONS = "-Dfile.encoding=UTF-8"
|
|
|
|
|
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 运行 JAR 包
|
|
|
|
|
1. 打开对应终端，切换到 可执行JAR 所在目录：
|
|
|
|
|
2. 执行运行命令：
|
|
|
|
|
- **cmd**
|
|
|
|
|
```cmd
|
|
|
|
|
java -jar math-learning.jar
|
|
|
|
|
```
|
|
|
|
|
- **PowerShell**
|
|
|
|
|
```powershell
|
|
|
|
|
java -jar math-learning.jar
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 项目技术要点速览
|
|
|
|
|
- **语言与版本**：Java 17，采用 UTF-8 编码。
|
|
|
|
|
- **界面框架**：JavaFX 21（controls 与 fxml 模块）。
|
|
|
|
|
- **构建工具**：Maven，使用 `maven-jar-plugin` 与 `maven-shade-plugin` 打包并生成可执行胖 JAR。
|
|
|
|
|
- **模块架构**：分层设计（认证、试题生成、JavaFX UI 视图与场景）。
|
|
|
|
|
- **邮件支持**：Jakarta Mail 2.0.1，基于 `email-config.properties` 的 SMTP 配置。
|
|
|
|
|
- **测试框架**：JUnit 5（jupiter-api 与 jupiter-engine）。
|
