Conan教程（2）—— 安装

本文档译自：https://docs.conan.io/en/latest/installation.html

一、前言

        Conan可以安装到很多操作系统中。它已经在Windows、Linux（不同发行版）、OSX中得到了广泛的使用和测试，在FreeBSD和Solaris SunOS也得到了积极的使用。还有一些其他的操作系统已反馈也可以运行。
        安装Conan有三种方式：

• 首选和强烈推荐的方式是使用pip命令从PyPI（Python Package Index）安装Conan。
• 对于不同的系统，还有对应可用的安装程序，它们可能附带绑定一个Python解释器，这样我们就不必首先安装Python。注意：其中一些安装程序可能会有一些限制，特别是那些使用pyinstaller创建的（如：Windows exe和Linux deb）。
• 通过源码运行Conan。

二、通过pip安装（推荐）

        要通过pip安装Conan，需要在机器上安装Python >= 3.5发行版。Python 3.4的支持已经被放弃，Python 2已经被弃用。现代的Python发行版都预装了pip，但是，如果有必要的话，可以按照pip文档中的说明安装pip。
        安装Conan：$ pip install conan
重要，请仔细阅读：

• 确保pip安装与Python（2.7 或 >= 3.5）版本匹配。Python 3.4版本支持已经被放弃。
• 在Linux中，可能需要sudo权限来全局安装Conan。
• 强烈建议使用virtualenvs（virtualenvwrapper非常好用）来处理所有与Python相关的事情。（查看https://virtualenvwrapper.readthedocs.io/en/stable/，或者在Windows上查看https://pypi.org/project/virtualenvwrapper-win/）在Python 3中，内建模块venv是可以被替换的（查看https://docs.python.org/3/library/venv.html）。如果不使用virtualenv，Conan依赖项可能会与先前已有的依赖项相冲突，特别是当前有使用Python用于其他工作时。
• 在Windows中，Python 2.7需要使用32位发行版（这是Windows默认的），而不是64位。
• 在OSX中，特别是有系统完整性保护的最新版本中，pip可能会失败。尝试使用virtualenvs，或者携带其他用户向安装：$ pip install --user conan。
• 在一些Linux发行版中，如Linux Mint，安装后需要重启（shell重启，如果不行的话需要系统重登），以便于可以在路径中找到Conan。
• 在Windows中，由于pip的bug，Python 3可能无法安装wrapt依赖项。关于这个问题和解决方法可以参考：https://github.com/GrahamDumpleton/wrapt/issues/112
• Conan使用Python 2.7时，从1.6版本开始，并不是所有特性都有效（如果不使用Python 3.x的话）。

已知的pip安装问题

• 当使用pip install --user 安装Conan时，通常为它新建一个目录。然后，该目录不会自动附加到PATH，导致conan命令也不生效。通常可以通过重启会话终端或者运行一下命令来解决：$ source ~/.profile。

三、通过brew安装（OSX）

        在OSX中，可以根据下面步骤安装Conan：

$ brew update
$ brew install conan

四、通过AUR安装（Arch Linux）

        在Arch Linux上安装Conan最简单的方法是使用Arch User Repository（AUR）助手，如：yay、aurman或pakku。例如，下面的命令使用yay安装Conan：$ yay -S conan。
        或者，按照Arch Wiki中的描述，使用makepkg和pacman手动构建和安装Conan。Conan的构建文件可以从AUR：https://aur.archlinux.org/packages/conan/中下载。确保首先安装下面三个Conan依赖项，它们同样可以在AUR中找到：

• python-patch-ng
• python-node-semver
• python-pluginbase

五、安装二进制文件

        打开Conna网站，下载指定平台的安装包。执行安装包。不再需要单独安装Python。

六、初始化配置

        检测Conan是否安装成功，在控制台中运行命令：$ conan。响应可能类似如下：

Consumer commands
  install    Installs the requirements specified in a recipe (conanfile.py or conanfile.txt).
  config     Manages Conan configuration.
  get        Gets a file or list a directory of a given reference or package.
  info       Gets information about the dependency graph of a recipe.
  ...

七、从源码安装

        可以从源码直接运行Conan，首先，需要安装Python和pip。
        克隆（或下载和解压）git仓库，并安装依赖项：

$ git clone https://github.com/conan-io/conan.git
$ cd conan
$ pip install -r conans/requirements.txt

        创建脚本来运行Conan，并添加到PATH中。

#!/usr/bin/env python

import sys

conan_repo_path = "/home/your_user/conan" # ABSOLUTE PATH TO CONAN REPOSITORY FOLDER

sys.path.append(conan_repo_path)
from conans.client.command import main
main(sys.argv[1:])

        测试conan脚本：$ conan。
        将会看到Conan命令帮助。

八、更新

        如果是通过pip安装，Conan可以很简单的更新：

$ pip install conan --upgrade  # Might need sudo or --user

        如果是通过安装包（.exe或.deb）安装的话，下载最新的安装程序并执行。
        如果没有检测到本地变化，默认的/.conan/settings.yml文件（包含了编译器版本等定义）将会被升级，否则它将会用新的设置创建一个settings.yml.new文件。如果想要重新生成设置，可以手动删除settings.yml文件，它将在首次需要时使用新的信息创建。
        升级不会影响已安装的包或缓存信息。如果缓存变得不一致，可能就需要删除它的内容（/.conan）；