3步实现Uncle小说跨平台部署：Windows与macOS安装包构建指南

Uncle小说是一款功能强大的PC端全网小说下载器及阅读器，支持目录解析与书源结合，提供有声小说与文本小说阅读体验，可下载mobi、epub、txt等多种格式文本小说。本指南将通过环境搭建、平台适配和结果验证三个核心步骤，帮助你无门槛实现Windows和macOS系统的安装包构建，轻松完成跨平台部署。

准备阶段｜环境检查与项目配置

环境检查清单

在开始部署前，请确保开发环境已安装以下工具：

• JDK 11+（Java开发工具包，用于编译Java代码）
• Gradle 7.0+（构建自动化工具，用于执行打包任务）
• Git（版本控制工具，用于克隆项目代码）

💻 系统兼容性验证：

# 检查Java版本
java -version  # 需显示11.0.0或更高版本
# 检查Gradle版本
gradle -v      # 需显示7.0或更高版本

项目获取与结构解析

通过Git克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/un/uncle-novel
cd uncle-novel  # 进入项目根目录

项目核心打包相关代码位于 buildSrc/src/main/java/com/unclezs/novel/app/packager/ 目录，包含：

• 跨平台打包逻辑（WindowsPackager.java、MacPackager.java）
• 打包任务定义（PackageTask.java）
• 平台配置模型（WindowsConfig.java、MacConfig.java等）

⚠️ 注意：项目根目录下的 gradlew 和 gradlew.bat 是Gradle包装器脚本，无需单独安装Gradle即可使用。

Windows部署｜高效构建安装包

一键打包指令

Windows平台提供32位和64位两种打包任务，通过以下命令快速构建：

# 构建64位Windows安装包（推荐现代PC使用）
./gradlew app:packageWin64  # Windows系统使用gradlew.bat app:packageWin64

# 构建32位Windows安装包（适用于老旧设备）
./gradlew app:packageWin32  # Windows系统使用gradlew.bat app:packageWin32

打包流程解析

Windows打包过程由 WindowsPackager.java 类驱动，自动完成以下步骤：

1. 编译项目：生成可执行JAR文件
2. 创建EXE安装程序：使用Inno Setup工具打包（配置文件位于 app/packager/inno-setup/）
3. 构建辅助安装包：生成MSI安装包和ZIP压缩包

⚠️ 注意：若打包失败提示"Inno Setup未找到"，需安装Inno Setup并添加到系统环境变量。

部署结果查看

打包完成后，安装文件位于项目的 build/packages 目录，包含：

• Uncle小说_setup_64.exe（64位安装程序）
• Uncle小说_32.zip（32位压缩包）
• 其他辅助安装格式文件

图1：Uncle小说Windows平台主界面，展示小说书架与导航功能

macOS适配｜无门槛构建应用程序

专属打包命令

macOS平台提供统一打包任务，执行以下命令即可构建：

./gradlew app:packageMac  # 仅在macOS系统执行

打包流程解析

macOS打包由 MacPackager.java 类实现，核心步骤包括：

1. 生成.app应用束：创建Mac标准应用目录结构
2. 构建DMG镜像：生成可拖拽安装的磁盘镜像
3. 创建PKG安装包：生成系统级安装程序

签名与分发

若需正式分发，可在打包命令中添加签名参数：

./gradlew app:packageMac -Psign=true -Pkeychain=你的钥匙串 -Pidentity=签名身份

图2：Uncle小说macOS平台阅读界面，展示主题切换与阅读设置

结果验证｜功能与兼容性测试

安装包完整性检查

打包完成后，建议从以下维度验证：

1. 文件结构：检查 build/packages 目录是否包含目标平台安装文件
2. 安装测试：在对应系统中执行安装程序，验证是否能正常完成安装
3. 功能验证：启动应用后测试核心功能（搜索、下载、阅读）

界面与功能展示

Uncle小说提供丰富的跨平台功能体验：

图3：多主题阅读界面对比，支持深色/浅色模式切换

图4：系统设置界面，可配置下载参数、书架管理和快捷键

排障指南｜常见问题Q&A

🔍 Q：执行打包命令提示"依赖缺失"怎么办？
A：尝试刷新项目依赖：

./gradlew build --refresh-dependencies  # 强制更新所有依赖

🔍 Q：Windows打包时提示"无法找到Inno Setup"？
A：从官网安装Inno Setup后，将安装目录（通常是 C:\Program Files (x86)\Inno Setup 6）添加到系统环境变量PATH中。

🔍 Q：macOS打包后应用无法打开提示"已损坏"？
A：在终端执行以下命令解除安全限制：

xattr -cr /Applications/Uncle小说.app  # 替换为实际安装路径

🔍 Q：打包生成的文件体积过大如何优化？
A：修改 gradle.properties 中的 package.compression.level 参数为 HIGH，启用高压缩率模式。

通过以上步骤，你已掌握Uncle小说在Windows和macOS平台的完整部署流程。项目的Gradle自动化打包系统确保了跨平台构建的一致性，无论是开发测试还是正式发布，都能通过简单命令快速完成。如需进一步定制打包参数，可参考 app/app.gradle 中的任务定义或 buildSrc 目录下的打包逻辑源码。