Skip to content

从源码构建

如果你希望自行修改代码或为不支持的平台构建 Ghost Downloader,可以按照以下步骤从源代码进行构建。

环境准备

  1. 安装 Python: 确保你安装了 Python (推荐 3.10 或更高版本)。可以从 Python 官网 下载。
  2. 安装 Git: 用于克隆项目仓库。可以从 Git 官网 下载。
  3. 安装 C/C++ 编译器: Nuitka 需要 C/C++ 编译器来编译 Python 代码。
    • Windows:
    • macOS: 安装 Xcode Command Line Tools (xcode-select --install)。
    • Linux: 安装 build-essential (Debian/Ubuntu) 或 base-devel (Arch Linux) 或类似的包组,确保包含 GCC/Clang。

获取源码

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 参数。