从源码构建
如果你希望自行修改代码或为不支持的平台构建 Ghost Downloader,可以按照以下步骤从源代码进行构建。
环境准备
- 安装 Python: 确保你安装了 Python (推荐 3.10 或更高版本)。可以从 Python 官网 下载。
- 安装 Git: 用于克隆项目仓库。可以从 Git 官网 下载。
- 安装 C/C++ 编译器: Nuitka 需要 C/C++ 编译器来编译 Python 代码。
- Windows:
- 安装 Microsoft Visual C++ Build Tools (勾选 C++ build tools)。
- 或者安装 MinGW-w64 (项目
deploy.py
脚本默认使用 MinGW)。
- macOS: 安装 Xcode Command Line Tools (
xcode-select --install
)。 - Linux: 安装
build-essential
(Debian/Ubuntu) 或base-devel
(Arch Linux) 或类似的包组,确保包含 GCC/Clang。
- Windows:
获取源码
bash
git clone https://github.com/XiaoYouChR/Ghost-Downloader-3.git
cd Ghost-Downloader-3
安装依赖
项目使用 requirements.txt
文件管理依赖。
bash
pip install -r requirements.txt
这将安装 PySide6, PyQt-Fluent-Widgets, Nuitka, httpx, loguru 等必要的库。
运行 (不编译)
你可以直接通过 Python 解释器运行主程序进行测试或开发:
bash
python Ghost-Downloader-3.py
编译为可执行文件
项目提供了 deploy.py
脚本来简化 Nuitka 的编译过程。
bash
python deploy.py
该脚本会自动检测当前操作系统,并执行相应的 Nuitka 命令,将应用打包为独立的可执行文件。编译后的文件会输出到 dist/
目录下。
编译选项说明:
--standalone
: 将所有依赖项打包进可执行文件。--plugin-enable=pyside6
: 启用 Nuitka 的 PySide6 插件。--windows-console-mode=disable
: (Windows) 创建无控制台窗口的 GUI 应用。--macos-create-app-bundle
: (macOS) 创建标准的.app
包。--mingw64
/--msvc=latest
: (Windows) 选择使用的 C++ 编译器。- 其他选项用于设置图标、版本信息、公司名称等元数据。
你可以根据需要修改 deploy.py
文件中的 Nuitka 参数。