conan使用(二)--创建私有仓库

前面我们已经能够使用conan来从公共服务器上拉取C/C++包来集成进我的工程中，但是在实际开发中，我们可能需要自己封装或使用非公开的库，那么自己搭建一个私服是个很现实的需求。

搭建conan私服有几种方式，这里介绍一种目前使用比较多的Artifactory方式。

1. 安装和配置Artifactory

我们以docker的方式拉取Artifactory镜像（这一步可能花费时间会比较久）：

docker pull docker.bintray.io/jfrog/artifactory-cpp-ce

然后安装：

sudo docker run -d -p 8081:8081 --name artifactory-cpp-ce docker.bintray.io/jfrog/artifactory-cpp-ce

那么我们就已经创建了一个Artifactory服务器。通过8081端口可以直接访问。默认账号密码：admin(password)。

登录后我们可以跳过proxy设置，直接创建一个名为develope的conan仓库：

然后直接点击develope，它会告诉你怎么在客户端进行配置：

按照它的提示进行配置，注意替换、等字样；如果是不在同一台机器上，也请修正ip地址。

2. 本地创建conan包

首先创建一个新的目录conanpkg，然后在该目录下执行

conan new Hello/1.0.1 -t

使用-t参数的意义是生成一个测试包。

conanfile.py文件非常关键，它定义了如何打包，如何导入源文件：

from conans import ConanFile, CMake, tools
class HelloConan(ConanFile):
    name = "Hello"
    version = "1.0.1"
    license = "<Put the package license here>"
    author = "<Put your name here> <And your email here>"
    url = "<Package recipe repository url here, for issues about the package>"
    description = "<Description of Hello here>"
    topics = ("<Put some tag here>", "<here>", "<and here>")
    settings = "os", "compiler", "build_type", "arch"
    options = {"shared": [True, False]}
    default_options = {"shared": False}
    generators = "cmake"
    def source(self):
        self.run("git clone https://github.com/conan-io/hello.git")
        # This small hack might be useful to guarantee proper /MT /MD linkage
        # in MSVC if the packaged project doesn't have variables to set it
        # properly
        tools.replace_in_file("hello/CMakeLists.txt", "PROJECT(HelloWorld)",
                              '''PROJECT(HelloWorld)
include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake)
conan_basic_setup()''')
    def build(self):
        cmake = CMake(self)
        cmake.configure(source_folder="hello")
        cmake.build()
        # Explicit way:
        # self.run('cmake %s/hello %s'
        #          % (self.source_folder, cmake.command_line))
        # self.run("cmake --build . %s" % cmake.build_config)
    def package(self):
        self.copy("*.h", dst="include", src="hello")
        self.copy("*hello.lib", dst="lib", keep_path=False)
        self.copy("*.dll", dst="bin", keep_path=False)
        self.copy("*.so", dst="lib", keep_path=False)
        self.copy("*.dylib", dst="lib", keep_path=False)
        self.copy("*.a", dst="lib", keep_path=False)
    def package_info(self):
        self.cpp_info.libs = ["hello"]

source函数是表示如何导入源文件，这里是指明了代码仓库；
build指明要如何编译；
package是打包你的项目。

test_package 目录下的代码是测试包代码，创建好包后你可以用它进行测试。

现在执行create命令进行打包：

conan create . demo/testing

create命令会执行以下操作：

将conanfile.py从用户文件夹拷贝到conan的本地缓存中；
安装包，强制从源构建它；
移动到test_package文件夹并创建临时构建文件夹；
执行conan install …，以安装test_package/conanfile.py的要求；
构建并启动示例程序，分别调用test_package/conanfile.py文件的build()和test()方法。

即相当于执行了以下命令：

conan export . demo/testing
$ conan install Hello/1.0.1@demo/testing --build=Hello
# test
$ conan test test_package Hello/1.0.1@demo/testing

如此一个包就已经创建好了。

3. 上传包到服务器

上传包命令是：

conan upload <RECIPE> -r <REMOTE> --all

<RECIPE> 即是我们在经常用到的一个包名字：/@/。我们上面创建的包名字就是Hello/1.0.1@demo/testing。（上传需要进行账户密码验证）

此时远程服务器上就有了我们的包：

此时就可以像其它包一样正常在其它地方使用。

4. 用法补充

4.1 不使用git导入源码

上面的例子中是在source中使用git拉取代码，如果我们的代码不是在git上怎么办？

（1）HTTP下载

同样是在source函数中，可以使用http下载源码：

zip_name = "XXX"
tools.download("https://github.com/XXXXXXXXXXXXX/%s" % zip_name, zip_name)
tools.unzip(zip_name)
...

（2）本地代码

此时就不能使用source函数，需要删掉它，增加一个exports_sources 配置来代表你的源码目录：

class HelloConan(ConanFile):
    name = "Hello"
    version = "0.1"
    license = "<Put the package license here>"
    url = "<Package recipe repository url here, for issues about the package>"
    description = "<Description of Hello here>"
    settings = "os", "compiler", "build_type", "arch"
    options = {"shared": [True, False]}
    default_options = {"shared": False}
    generators = "cmake"
    exports_sources = "src/*"
    ...