編譯原始碼

1. Clone 儲存庫及 submodules：

   git clone --recurse-submodules https://github.com/cpeditor/cpeditor.git
   cd cpeditor
   

2. 安裝 Qt (5.15 or higher), CMake (3.12 or higher) 及 Python3 。

   • 在 macOS 及某些 Linux 發行版，您可以透過套件管理系統來安裝。例如在 Arch Linux 上使用 sudo pacman -S qt5，在 macOS 上使用brew install qt5。
   • 您也可以用 aqtinstall 安裝 Qt。

3. 若 CMake 找不到 Qt 的安裝路徑，需要設定環境變數：CMAKE_PREFIX_PATH=%QtPath%/%QtVersion%/%Compiler%/lib/cmake。以 macOS 而言，執行這個命令 export CMAKE_PREFIX_PATH="/usr/local/Cellar/qt/5.15.1"。

4. 安裝 Extra CMake Modules 和 KDE (kf5) Syntax Highlighting 。它們不再作為子模組捆綁，必須在建置前安裝到系統中。

   • 在 macOS 及某些 Linux 發行版，您可以透過套件管理系統來安裝。例如在 Arch Linux 上使用 sudo pacman -S syntax-highlighting5，在 macOS 上使用 Homebrew KDE 然後 brew install kde-mac/kde/kf5-syntax-highlighting。

   • 否則，您需要手動 clone 並建置安裝：

     git clone --branch kf5 https://github.com/KDE/extra-cmake-modules.git
     cd 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 ..
     
     git clone --branch kf5 https://github.com/KDE/syntax-highlighting.git
     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 # 可能需要 sudo
     cd ..
     

5. 執行下列命令。

   • Linux/macOS:

     mkdir build
     cd build
     cmake .. -DCMAKE_BUILD_TYPE=Release
     cmake --build .
     

   • Windows:

      mkdir build
      cd build
      cmake ..
      cmake --build . --config Release
     

依據不同的系統，建置的檔案位於

Linux：build/cpeditor

macOS：build/cpeditor.app

Windows：build\cpeditor.exe 或 build\Release\cpeditor.exe 若執行時發生缺少 DLL 的錯誤，您可以在 PATH 環境變數加上%QtPath%\%QtVersion%\%Compiler%\bin (例如： D:\Qt\5.15.1\msvc2019_64\bin)。