math-learing/doc

Math Learning 应用 JAR 运行指南

环境准备

• Windows 10/11，已安装 64 位 JDK 17

终端设置为 UTF-8

为避免中文字符显示异常，请在运行前切换到 UTF-8 编码。

命令提示符（cmd）

chcp 65001
set JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8

PowerShell

chcp 65001
$env:JAVA_TOOL_OPTIONS = "-Dfile.encoding=UTF-8"
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

运行 JAR 包

1. 打开对应终端，切换到 可执行JAR 所在目录：
2. 执行运行命令：
   • cmd

     java -jar math-learning.jar
     

   • 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）。