安装

Conan 可以在多种操作系统上安装。它已在 Windows、Linux(不同发行版)和 macOS 上得到广泛使用和测试,并也积极用于 FreeBSD 和 Solaris SunOS。此外,还有其他几个操作系统报告称其可以正常工作。

Conan 有不同的安装方式:

  1. 安装 Conan 的首选和强烈推荐方式是从 Python Package Index (PyPI) 使用 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 功能可能会隔离直接通过网络浏览器下载的压缩二进制文件。为避免此问题,请使用 curlwget 或类似工具下载它们。

如果您的平台没有安装程序,您可以使用存储库中的 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 命令帮助。