安装¶
Conan 可以安装在多种操作系统上。它已经在 Windows、Linux(不同发行版)、macOS 上经过广泛的使用和测试,并且也在 FreeBSD 和 Solaris SunOS 中 активно 使用。据报告,它还在其他几种操作系统上可以工作。
有几种不同的方式来安装 Conan
首选和强烈推荐的安装 Conan 的方式是从 PyPI,即 Python 包索引,使用
pip
命令。使用系统安装程序,或创建您自己的自包含 Conan 可执行文件,以避免在您的系统上需要 Python。
从源码运行 Conan。
使用 pip 安装(推荐)¶
要使用 pip
安装最新的 Conan 2 版本,您需要在您的机器上安装 Python >= 3.6 发行版。现代 Python 发行版都预装了 pip。但是,如果需要,您可以按照 pip 文档 中的说明安装 pip。
安装 Conan
$ pip install conan
重要提示
请仔细阅读
确保您的 pip 安装与您的 Python (>= 3.6) 版本匹配。
在 Linux 上,您可能需要 sudo 权限才能全局安装 Conan。
我们强烈建议对所有与 Python 相关的事项使用 虚拟环境 virtualenvs(virtualenvwrapper 非常好用)(查看 https://virtualenvwrapper.readthedocs.io/en/stable/,或者 Windows 上的 https://pypi.ac.cn/project/virtualenvwrapper-win/)。对于 Python 3,也可以使用内置模块
venv
(查看 https://docs.pythonlang.cn/3/library/venv.html)。如果不使用 虚拟环境 virtualenv,则 conan 依赖项可能会与先前存在的依赖项冲突,特别是当您将 Python 用于其他目的时。在 macOS 上,尤其是可能具有 系统完整性保护 System Integrity Protection 的最新版本,pip 可能会失败。尝试使用虚拟环境 virtualenvs,或使用
$ pip install --user conan
将其安装到 Python 用户安装目录。某些 Linux 发行版,例如 Linux Mint,在安装后需要重启(shell 重启,或者注销/系统重启,如果 shell 重启不够),Conan 才能在路径中找到。
pip 的已知安装问题¶
当使用 pip install --user conan 安装 Conan 时,通常会为其创建一个新目录。但是,该目录不会自动添加到 PATH 中,并且 conan 命令不起作用。这通常可以通过重启终端会话或运行以下命令来解决
$ source ~/.profile
更新¶
如果通过 pip
安装,您的 Conan 版本可以使用以下命令更新
$ pip install conan --upgrade # Might need sudo or --user
升级不应影响已安装的软件包或缓存信息。如果缓存以某种方式变得不一致,您可能需要删除其内容(删除 <userhome>/.conan2
)。
使用 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
确保您的系统上安装了
pipx
。 如果没有,请查看 pipx 文档 中的安装指南。对于基于 Debian 的发行版,您可以使用系统软件包管理器安装pipx
$ apt-get install pipx $ pipx ensurepath
(注意:软件包名称可能因发行版而异)
重启您的终端,然后使用
pipx
安装 Conan$ pipx install conan
现在您可以像往常一样使用 Conan 了。
使用系统安装程序或创建自包含可执行文件¶
在 Conan 下载 中有许多现有的安装程序,适用于 macOS Homebrew、Debian、Windows、Arch Linux,这些安装程序不需要 Python 安装。
我们还在压缩文件中分发了适用于 Windows、Linux 和 macOS 的 Conan 二进制文件,您可以在系统上解压缩并直接运行。
警告
如果您使用的是 macOS,请注意 Gatekeeper 功能可能会隔离使用 Web 浏览器直接下载的压缩二进制文件。 为避免此问题,请使用 curl、wget 或类似工具下载它们。
如果您的平台没有安装程序,您可以使用 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 命令帮助。