从源代码构建

准备工作

1. 克隆源代码仓库以及子组件：

   git clone --recurse-submodules https://github.com/cpeditor/cpeditor.git
   # 或者分成两条命令
   # git clone https://github.com/cpeditor/cpeditor.git
   # git submodule update --init --recursive
   cd cpeditor
   

2. 安装 Qt （5.15）, CMake （3.12 或更高版本）以及 Python3 。

   • 在一些 Linux 发行版和 macOS 系统上，你可以直接使用包管理器安装 Qt。例如，在 Arch Linux 上可以使用 sudo pacman -S qt5-base，在 macOS 上可以使用 brew install qt@5。
   • 你还可以使用 aqtinstall 来下载并安装。

3. 如果 CMake 提示找不到 Qt 路径，你应该设置环境变量：CMAKE_PREFIX_PATH=%QtPath%/%QtVersion%/%Compiler%/lib/cmake。例如，在 macOS 上，你可以运行 export CMAKE_PREFIX_PATH="/usr/local/Cellar/qt/5.15.2"。

4. 安装 KDE (kf5) Extra CMake Modules。

   • 在一些 Linux 发行版和 macOS 系统上，你可以直接使用包管理器安装它们。例如，在 Arch Linux 上可以使用 sudo pacman -S syntax-highlighting5，在 macOS 上可以使用 Homebrew KDE 然后 brew install kde-mac/kde/kf5-syntax-highlighting。

   • 否则，你需要使用 CMake 先构建并安装 Extra CMake Modules 然后再是 KSH：

     cd third_party/extra-cmake-modules
     cmake -B build -S . -DBUILD_HTML_DOCS=OFF -DBUILD_MAN_DOCS=OFF -DBUILD_QTHELP_DOCS=OFF -DBUILD_TESTING=OFF
     cmake --build build --config Release --target install # 可能需要 sudo
     cd ../syntax-highlighting
     cmake -B build -S . -DBUILD_HTML_DOCS=OFF -DBUILD_MAN_DOCS=OFF -DBUILD_QTHELP_DOCS=OFF -DBUILD_TESTING=OFF
     cmake --build build --config Release --target install
     

构建

• Linux/macOS:

  cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
  cmake --build build
  

• Windows:

  cmake -S . -B build
  cmake --build build --config Release
  

在 Linux 上，你会得到 build/cpeditor。

在 macOS 上，你会得到 build/cpeditor.app。

在 Windows 上，你会得到 build/cpeditor.exe 或 build/Release/cpeditor.exe。如果打开时提示 DLL 缺失，你可以将 %QtPath%\%QtVersion%\%Compiler%\bin（例如：D:\Qt\5.15.2\msvc2019_64\bin）加入 PATH 环境变量。