svn-log-tool/docs/发行版打包指南.md

发行版打包指南

本文档说明当前纯 backend/ 结构下的发行版打包方式。

一键打包

在项目根目录执行：

make release

该命令会自动：

1. 在 backend/ 执行 mvn clean package -DskipTests
2. 生成 backend/target/svn-log-tool-1.0.0-jar-with-dependencies.jar
3. 将 jar 复制到 release/windows/ 和 release/unix/
4. 打包 Windows、Unix、Docker 三类发行包

手动打包步骤

1. 构建后端产物

cd backend
mvn clean package -DskipTests

2. 复制 jar 到发行目录

cp backend/target/svn-log-tool-1.0.0-jar-with-dependencies.jar release/windows/
cp backend/target/svn-log-tool-1.0.0-jar-with-dependencies.jar release/unix/

3. 打包 Windows 版本

cd release/windows
zip -r ../svn-log-tool-1.0.0-windows.zip *
cd ../..

4. 打包 Unix 版本

cd release/unix
tar czf ../svn-log-tool-1.0.0-unix.tar.gz *
cd ../..

5. 打包 Docker 版本

cd release/docker
cp ../../Dockerfile .
tar czf ../svn-log-tool-1.0.0-docker.tar.gz *
rm Dockerfile
cd ../..

Docker 构建说明

根目录 Dockerfile 采用多阶段构建：

1. maven:3.9.6-eclipse-temurin-8 打包 backend/
2. eclipse-temurin:8-jre 作为最终运行镜像

发布清单

• Windows 发行包（.zip）
• Unix 发行包（.tar.gz）
• Docker 发行包（.tar.gz）
• 用户手册
• 快速开始指南
• 样例报表
• 产品截图
• 演示视频（可选）