CP Editor – 安装

Docs: 在 Releases 中下载

Mon, 01 Jan 0001 00:00:00 +0000

你需要在 Releases 页面找到你需要的版本，然后根据你的操作系统选择相应的文件并下载安装。

如果你访问 GitHub 的速度较慢，你还可以尝试 Gitee 镜像或者 FastGit 镜像。

Windows

使用安装包安装

使用安装包在你的电脑上进行安装。配置文件将会存储在你的系统的配置目录下，CP Editor 将会出现在你的系统的已安装程序列表中。

下载 setup.exe 以进行安装。

便携式版本

使用便携式版本，无需安装即可使用 CP Editor。这意味着你可以将 CP Editor 存储在 U 盘等可移动介质中。

配置文件将存储在可执行文件所在的文件夹，CP Editor 将不会出现在你的系统的已安装程序列表中。

下载 portable.zip，将其解压到任意一个你想要存放的位置。

绝大部分 Linux 发行版

下载 AppImage，执行 chmod +x <AppImagePath> 给其添加执行权限，随后运行该文件。

Debian 系 Linux 发行版

如果你使用的是 Debian 系的 Linux 发行版（Ubuntu，Linux Mint 等），可以下载 .deb 包，并在终端中执行如下命令：

sudo apt install <path to .deb package>

接下来输入密码，确认安装。你也可以使用 Gdebi 等图形化工具安装 deb 包，要求系统版本不低于 Debian 10 Buster，Ubuntu 18.04 Bionic Beaver，Linux Mint 19 Tara 或其他基于前述发行版的系统的相应版本。

macOS

下载 .dmg 文件然后安装。如果出现“未识别的开发者”等提示消息，请依然允许 CP Editor 运行。可以在 System Preferences -> Security & Privacy -> General 中将 CP Editor 添加到白名单里。

Docs: 使用包管理器

Mon, 01 Jan 0001 00:00:00 +0000

打包情况

其中有的包是官方维护的，而大多数的包是由社区维护的。

然而，目前很多软件包仓库都没有包含 CP Editor。如果需要帮助，软件包维护者可以联系我们。例如，我们可以在我们的 CI/CD 工作流中加入一些脚本。

下面是一些安装软件包的指导。

Snapcraft

你可以使用 Snapcraft 来安装 cpeditor ，它在大多数 Linux 发行版上都可用。

有两个 channel 可供选择：latest/stable 和 latest/edge。

由于技术原因，它以 classic confinement 发布，所以你需要 --classic 选项来安装它。

安装最新的稳定版本：sudo snap install cpeditor --classic

安装最新的测试（alpha）版本： sudo snap install cpeditor --classic --channel=latest/edge

AUR

如果你使用的是 Arch Linux ，你可以从 AUR 安装 CP Editor。AUR 通常情况下也在 Manjaro 等基于 Arch 的发行版可用，但偶尔会因为主仓库不同等原因而出错。

CP Editor 在 AUR 上有两个包：稳定版 cpeditor 和 alpha 版 cpeditor-git 。

如果你对 AUR 不熟悉，你可以安装 paru 并使用 paru -S cpeditor 来安装。你也可以阅读关于手动安装 AUR 包或者 AUR 工具的 wiki。

安装完成后，你就可以在终端中运行 cpeditor 或在开始菜单中运行 CP Editor 了。

Docs: 从源代码构建

Mon, 01 Jan 0001 00:00:00 +0000

准备工作

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

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

安装 Qt （5.15）, CMake （3.12 或更高版本）以及 Python3 。
- 在一些 Linux 发行版和 macOS 系统上，你可以直接使用包管理器安装 Qt。例如，在 Arch Linux 上可以使用 sudo pacman -S qt5-base，在 macOS 上可以使用 brew install qt@5。
- 你还可以使用 aqtinstall 来下载并安装。
如果 CMake 提示找不到 Qt 路径，你应该设置环境变量：CMAKE_PREFIX_PATH=%QtPath%/%QtVersion%/%Compiler%/lib/cmake。例如，在 macOS 上，你可以运行 export CMAKE_PREFIX_PATH="/usr/local/Cellar/qt/5.15.2"。

安装 Extra CMake Modules 和 KDE (kf5) Syntax Highlighting 。它们不再作为子模块捆绑，必须在构建前安装到系统中。

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

否则，你需要手动克隆并构建安装：

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 ..

构建

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 环境变量。

Docs: 使用 Artifacts

Mon, 01 Jan 0001 00:00:00 +0000

如果你想要使用最新版本（比 beta 还要新），但是不想从源代码构建，你可以从 GitHub Actions 下载 Artifacts。

然而，我们不建议你使用 Artifacts，因为它们比 beta 版本更加不稳定，可能正在开发中。在使用 Artifacts 之前，你应该阅读 commit 日志甚至源代码。

为了在 Windows/macOS 上运行它，你应该首先从 Releases 安装（通常任何版本都可以，除非出现了 DLL 丢失等问题）。在 Windows 上，将安装文件夹中的 cpeditor.exe 替换为 Artifact 版本的。在 macOS 上，运行 cp path/to/Artifact cpeditor.app/Contents/MacOs，其中 cpeditor.app 是你的计算机上已安装的那个。

为了在 Ubuntu 18.04 上运行它，你需要安装 Qt。其他 Linux 发行版可能不支持在 Ubuntu 18.04 上编译的二进制文件。