在Windows系统上基于Qt6构建Sigil电子书编辑器的完整指南

最新推荐文章于 2025-06-06 09:22:20 发布

鲁景晨

最新推荐文章于 2025-06-06 09:22:20 发布

阅读量311

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00185/article/details/148467913

在Windows系统上基于Qt6构建Sigil电子书编辑器的完整指南

Sigil Sigil is a multi-platform EPUB ebook editor 项目地址: https://gitcode.com/gh_mirrors/si/Sigil

前言

Sigil是一款功能强大的开源电子书编辑器，支持EPUB格式的创建和编辑。本文将详细介绍如何在Windows系统上基于Qt6框架从源代码构建Sigil应用程序。本指南适合有一定开发经验的用户参考，我们将从环境准备到最终构建安装包，逐步讲解整个过程。

环境准备

1. 开发工具安装

首先需要安装以下基础开发工具：

Visual Studio 2022：社区版即可满足需求，建议安装时包含C++开发组件
CMake 3.18+：构建工具，安装后需将其bin目录加入系统PATH
Inno Setup 6.3.0+：安装程序制作工具，需选择Unicode版本并安装预处理器

2. Qt6环境配置

由于Qt6不再提供预编译的二进制安装包，我们需要自行编译：

获取Qt6.8.2源代码
应用Sigil提供的相关补丁
编译Qt6及其WebEngine组件

编译完成后，确保Qt的bin目录（包含windeployqt.exe）已加入系统PATH。

Python环境配置

Sigil依赖Python环境运行插件系统，需要特别注意：

安装**64位Python 3.13.2+**版本
建议使用默认安装路径
安装时将Python加入系统PATH

Python依赖包安装

更新pip工具后，需要安装以下Python包：

python -m pip install -U pip
pip install six html5lib regex cssselect css-parser chardet dulwich
pip install Pillow==11.1.0 lxml==5.3.0
pip install PySide6==6.8.2 Shiboken6==6.8.2 PySide6-Addons==6.8.2

获取Sigil源代码

有两种方式获取Sigil源代码：

通过Git克隆仓库（适合开发人员）
下载特定版本的ZIP压缩包（推荐稳定用户）

获取源代码后，建议将顶层目录重命名为简短名称如"sigil-src"以便后续操作。

源代码预处理

在构建安装包前，需要：

从Visual Studio目录复制vc_redist.x64.exe到<sigil-src>\installer目录
确保文件名保持不变

构建Sigil

1. 生成构建文件

使用VS2022 x64 Native Tools命令提示符，切换到构建目录后执行：

cmake -G "NMake Makefiles" ^
      -DWIN_INSTALLER_USE_64BIT_CRT=1 ^
      -DQt6_DIR="C:\Qt6.8.2\lib\cmake\Qt6" ^
      -DCMAKE_BUILD_TYPE=Release ^
      "C:\path\to\sigil-src"

或生成Visual Studio项目文件：

cmake -G "Visual Studio 17 2022" -A x64 ^
      -DWIN_INSTALLER_USE_64BIT_CRT=1 ^
      -DQt6_DIR="C:\Qt6.8.2\lib\cmake\Qt6" ^
      -DCMAKE_BUILD_TYPE=Release ^
      "C:\path\to\sigil-src"