conan使用(三)--打包只有头文件的库

参考：https://docs.conan.io/en/latest/howtos/header_only.html?highlight=header%20only

对于只含头文件的库打包非常简单，以rapidjson为例。

执行创建命令：

conan new rapidjson/1.1.0


然后修改生成的conanfile.py：

# -*- coding: UTF-8 -*-import osfrom conans import ConanFile, toolsclass RapidjsonConan(ConanFile):
name = "rapidjson"
version = "1.1.0"
license = "MIT"
author = "Tencent"
url = "https://github.com/Tencent/rapidjson.git"
description = "A fast JSON parser/generator for C++ with both SAX/DOM style API "
topics = ("JSON")
no_copy_source = True
# 如果是先准备好源码，可以直接使用exports_sources而不要用source方法
# exports_sources = "include/*"
_source_path = "rapidjson" def source(self):
'''retrieval of the source code here. Remember you can also put the code
in the folder and use exports instead of retrieving it with this
source() method
'''
# self.run("git clone ...") or
# tools.download("url", "file.zip")
# tools.unzip("file.zip" )
self.run("git clone -b version1.1.0 https://github.com/Tencent/rapidjson.git") def package(self):
# 只需要include中的文件
include_folder = os.path.join(self._source_path, "include")
self.copy(pattern="license.txt", dst="license", src=self._source_path)
self.copy(pattern="*", dst="include", src=include_folder) def package_id(self):
self.info.header_only()


如果是手动准备源码，请首先从GitHub上下载rapidjson源码：

git clone -b version1.1.0 https://github.com/Tencent/rapidjson.git


确保conanfile.py和rapidjson目录在同一级。

然后执行：

conan create . tencent/stable


不报错误的话，就会生成成功，在系统conan缓存目录下就可以发现已经生成好了包：



最后将生成的包上传到服务器：

conan upload rapidjson/1.1.0@tencent/stable -r develope --all


查询服务器仓库上的包，表明已经上传成功：



接下来我们在Ubuntu下写个测试程序测试一下看是否能成功使用。

首先在工程目录下写一个conanfile.txt:

[requires]
rapidjson/1.1.0@tencent/stable[imports]
include, * -> ./include


因为只是引入一个纯头文件库，所以配置写的很简单。imports是将库中include目录下的所有文件拷贝到编译目录的include目录下。

然后创建源代码main.cpp，吧rapidjson官网的例子拷贝过来：

// rapidjson/example/simpledom/simpledom.cpp`
#include "rapidjson/document.h"
#include "rapidjson/writer.h"
#include "rapidjson/stringbuffer.h"
#include <iostream>using namespace rapidjson;int main() {
// 1. 把 JSON 解析至 DOM。
const char* json = "{\"project\":\"rapidjson\",\"stars\":10}";
Document d;
d.Parse(json); // 2. 利用 DOM 作出修改。
Value& s = d["stars"];
s.SetInt(s.GetInt() + 1); // 3. 把 DOM 转换（stringify）成 JSON。
StringBuffer buffer;
Writer<StringBuffer> writer(buffer);
d.Accept(writer); // Output {"project":"rapidjson","stars":11}
std::cout << buffer.GetString() << std::endl;
return 0;
}


然后编写CMakeLists.txt:

project(rapidjsonTest)
cmake_minimum_required(VERSION 2.8.12)include_directories(${PROJECT_BINARY_DIR}/include)add_executable(${PROJECT_NAME} main.cpp)


这样，我们创建一个build目录，来进行编译：



进入build目录执行：

conan isntall ..
cmake ..
make./rapidjsonTest


表明引入成功。

这里补充一个conan使用技巧，就是默认搜索库的顺序是先搜索它先先加入的conan-cnter，没有的话才会搜索我们后来加入的develope库，但是实际应用中我们肯定期望优先搜索我们自己的库，因此应该改变搜索顺序。方法就是找到conan缓存目录(一般就是用户根目录下的.conan文件)，下面有一个remotes.json，修改里面库的顺序即可。

下一步计划是将chromium-base库打包实现conan管理，加油！