安装

Conan 可以安装在多种操作系统上。它已经在 Windows、Linux(不同发行版)、macOS 上经过广泛的使用和测试,并且也在 FreeBSD 和 Solaris SunOS 中 активно 使用。据报告,它还在其他几种操作系统上可以工作。

有几种不同的方式来安装 Conan

  1. 首选和强烈推荐的安装 Conan 的方式是从 PyPI,即 Python 包索引,使用 pip 命令。

  2. 使用系统安装程序,或创建您自己的自包含 Conan 可执行文件,以避免在您的系统上需要 Python。

  3. 从源码运行 Conan。

使用 pipx 安装

在某些情况下,尝试使用 pip 安装可能会产生以下错误

error: externally-managed-environment

x This environment is externally managed
    To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.
...

这是因为一些现代 Linux 发行版已开始将其 Python 安装标记为“外部管理”,这意味着系统的软件包管理器负责管理 Python 软件包。全局甚至在用户空间中安装软件包可能会干扰系统操作,并可能破坏系统工具(查看 PEP-668 以获取更多详细信息)。

对于这些情况,建议使用 pipx 安装 Conan。pipx 为每个 Python 应用程序创建一个虚拟环境,确保依赖项不会冲突。 优点是它将 Conan 及其依赖项与系统 Python 隔离,并避免与系统软件包的潜在冲突,同时为 Conan 运行提供一个干净的环境。

要使用 pipx 安装 Conan

  1. 确保您的系统上安装了 pipx。 如果没有,请查看 pipx 文档 中的安装指南。对于基于 Debian 的发行版,您可以使用系统软件包管理器安装 pipx

    $ apt-get install pipx
    $ pipx ensurepath
    

    (注意:软件包名称可能因发行版而异)

  2. 重启您的终端,然后使用 pipx 安装 Conan

    $ pipx install conan
    
  3. 现在您可以像往常一样使用 Conan 了。

使用系统安装程序或创建自包含可执行文件

Conan 下载 中有许多现有的安装程序,适用于 macOS Homebrew、Debian、Windows、Arch Linux,这些安装程序不需要 Python 安装。

我们还在压缩文件中分发了适用于 Windows、Linux 和 macOS 的 Conan 二进制文件,您可以在系统上解压缩并直接运行。

警告

如果您使用的是 macOS,请注意 Gatekeeper 功能可能会隔离使用 Web 浏览器直接下载的压缩二进制文件。 为避免此问题,请使用 curlwget 或类似工具下载它们。

如果您的平台没有安装程序,您可以使用 repo 中的 pyinstaller.py 实用程序创建您自己的 Conan 可执行文件。 此过程能够创建一个自包含的 Conan 可执行文件,其中包含它所需的一切,包括 Python 解释器,因此无需在系统中安装 Python。

您可以使用以下命令执行此操作

$ git clone https://github.com/conan-io/conan conan_src
$ cd conan_src
$ git checkout develop2 # or to the specific tag you want to
$ pip install -e .
$ python pyinstaller.py

重要的是首先使用 pip install -e . 安装依赖项和项目,这将项目配置为“可编辑”状态,即从当前源文件夹运行。 创建可执行文件后,可以使用 pip 卸载它。

这必须在将要使用可执行文件的同一平台上运行,pyinstaller 不会交叉构建。 生成的可执行文件可以直接复制并放入运行机器的系统 PATH 中,以便能够运行 Conan。

从源码安装

您可以直接从源代码运行 Conan。 首先,您需要安装 Python 和 pip。 然后,克隆(或下载并解压缩)Conan git 仓库并安装它。

对于最新的开发版本,检出仓库的 develop2 分支

# clone folder name matters, to avoid imports issues
$ git clone https://github.com/conan-io/conan.git conan_src
$ cd conan_src
$ git fetch --all
$ git checkout -b develop2 origin/develop2
$ python -m pip install -e .

现在通过运行以下命令测试您的 conan 安装

$ conan

您应该看到 Conan 命令帮助。