陈硕的Blog

整合 Google 开源 C++ 代码

Google 开源了很多优秀的 C++ 程序库,本文介绍如何将其中几个整合到一起。

本文涉及的 Google 库有:

  1. gflags - 命令行参数解析。可以完全用命令行来配置应用程序,省去配置文件。
  2. gtest - C++ 单元测试框架
  3. gmock - C++ 单元测试中用到的 mock
  4. glog - 日志库
  5. protobuf - 高效的网络协议格式

还有第三方的 libunwind 和 zlib。

这些库每个都是独立的,可以单独安装使用。不过它们之间有内在的依赖关系,如果配合使用的话效果更加。下面这张图表示了依赖关系:

glog

本文以 64-bit Debian squeeze 为例,安装路径为默认的 /usr/local。按这个图的后续遍历开始依次安装这些库。这些库的安装都没什么困难,无非 ./configure && make && sudo make install 而已。下面开始这篇流水账日志。

gflags 1.3

在传统的 C 语言程序里,命令行参数解析是用 getopt(3) 函数,所有的参数放到一块儿解析。这种方式有一个明显的缺点,即命令行参数必须集中在一个地方定义,而不能分散到程序的各处。设想一个网络程序用到了三个库 (1) 数据库 (2) 网络 (3) 日志,这几样东西通常都需要在运行时配置,比如连到哪个数据库服务器,在哪个端口侦听连接,日志文件写到哪个目录等等。通常我们会用配置文件,主程序读取配置文件,然后分别初始化各个库。或者从命令行(或环境变量)指定多个配置文件,如数据库配置文件、网络配置文件、日志配置文件等等,主程序把配置文件的路径作为参数来初始化各个库。

gflags 能让程序库各自定义命令行参数,然后集中到一起解析。即分散定义,集中解析。这样应用程序本身就不用管各个库的配置了,反正都在命令行里指定,各个库自己就能从命令行读到想要的配置信息。

gflags 的安装很简单,它不依赖于其他库。

$ wget http://google-gflags.googlecode.com/files/gflags-1.3.tar.gz

$ tar zxf gflags-1.3.tar.gz

$ cd gflags-1.3/

$ ./configure

$ make –j4

$ make check

$ sudo make install

gtest 1.4.0 (可选), gmock 1.4.0 (可选)

gtest 和 gmock 是 Google 的开源 C++ 单元测试框架,glog 会用到它们。这两个库的安装与 gflags 类似,不再赘述。

先装 http://googletest.googlecode.com/files/gtest-1.4.0.tar.gz

再装 http://googlemock.googlecode.com/files/gmock-1.4.0.tar.gz

注意在安装 gmock 的时候,make check 可能会失败,因为 LD_LIBRARY_PATH 没有设置好,这个小问题相信读者能解决。

glog 0.3.0

glog 是一个日志库,并且带运行期检查的宏,例如 CHECK_EQ 等等。这些宏遍布 Google 的开源 C++ 代码。

glog 能自动检测已经安装好的 gflags, gtest, gmock。

glog 会用 libunwind 做 stack unwinding (函数调用栈展开),Debian 下安装这个库很简单:

$ sudo apt-get install libunwind7-dev

如果是 Ubuntu,可以去下载合适的 .deb 文件自己安装。

但是,由于 glog configure 的 bug,这个库没有被检测到。要解决这个问题,指标的办法是修改 configure:

--- configure.old       2010-04-17 13:51:27.000000000 +0800
+++ configure   2010-04-17 13:57:22.000000000 +0800
@@ -24120,7 +24120,7 @@
# Unfortunately, we need to check the header file in addition to the
# lib file to check if libunwind is available since libunwind-0.98
# doesn't install all necessary header files.
-if test x"$ac_cv_have_libunwind_h" = x"1"; then
+if test x"$ac_cv_header_libunwind_h" = x"yes"; then
  { echo "$as_me:$LINENO: checking for backtrace in -lunwind" >&5
echo $ECHO_N "checking for backtrace in -lunwind... $ECHO_C" >&6; }
if test "${ac_cv_lib_unwind_backtrace+set}" = set; then

治本的办法是在上游修改 configure.ac。我已把这个问题向 glog 的作者报告,http://code.google.com/p/google-glog/issues/detail?id=42

$ wget http://google-glog.googlecode.com/files/glog-0.3.0.tar.gz

$ tar zxf glog-0.3.0.tar.gz

$ cd glog-0.3.0/

# 修改 configure

$ ./configure

$ make –j4

# 为了通过 ./src/demangle_unittest.sh 测试,需要建一些符号链接

$ cd .libs

$ ln -s /usr/local/lib/libgflags.so.0

$ ln -s /usr/local/lib/libgtest.so.0

$ ln -s /usr/local/lib/libgmock.so.0

$ cd ..

$ make check

$ sudo make install

protobuf 2.3.0

protobuf 的安装与前面的库无关。它可以用 zlib 来压缩数据,先安装 zlib dev

$ sudo apt-get install zlib1g-dev

为了能让 protoc 直接运行,需要在编译的时候指定 run path:

$ ./configure

$ LD_RUN_PATH=/usr/local/lib make

$ make check

$ sudo make install

为了检验成果,我们编译一个用到了以上这些库的程序 evproto。

evproto

evproto 简单地用 libevent2 实现了 Google Protocol Buffers RPC。

evproto 采用 CMake 构建,先安装它:

$ sudo apt-get install cmake

然后下载源代码

$ mkdir evproto && cd evproto

$ svn checkout http://evproto.googlecode.com/svn/trunk trunk

下载并修补 libevent-2.0.4-alpha

$ wget http://www.monkey.org/~provos/libevent-2.0.4-alpha.tar.gz

$ tar zxf libevent-2.0.4-alpha.tar.gz

$ cd libevent-2.0.4-alpha

再编译 libevent 之前,要打两个补丁,这两个补丁的作用是让 evrpc 和 protobuf rpc 对接起来,见:

http://archives.seul.org/libevent/users/Mar-2010/msg00059.html

补丁已经在 evproto 源码里提供,可直接打到 libevent-2.0.4-alpha 上

$ patch -p1 < ~/evproto/trunk/libevent-2.0.4-alpha-msg-new-with-arg.patch

$ patch -p1 < ~/evproto/trunk/libevent-2.0.4-alpha-get-request-reply.patch

$ ./configure && make && sudo make install

然后试着编译 evproto

$ cd ~/evproto/trunk

$ ./build.sh

如果编译成功,说明前面这些库已经全都装好了。

注:这两个 patch 已经收入 libevent 的官方源码库,将来应该不用再手动 patch 了。

http://levent.git.sourceforge.net/git/gitweb.cgi?p=levent/levent;a=commitdiff;h=755fbf16c3ce94bfa09e1bf5da27ccdfc1e7e725

http://levent.git.sourceforge.net/git/gitweb.cgi?p=levent/levent;a=commitdiff;h=07edf784fab4e25c31eef3fdcccec3975e2741db

 

本文没有涉及 google-perftools,这个库是能独立安装使用的。

posted on 2010-04-17 21:43 陈硕 阅读(13124) 评论(9)  编辑 收藏 引用

评论

# re: 整合 Google 开源 C++ 代码 2010-04-18 14:56 凡客诚品专卖店

是多少的发挥的  回复  更多评论   

# re: 整合 Google 开源 C++ 代码[未登录] 2010-04-19 10:21 junglevass

protocol buffer 确实不错。  回复  更多评论   

# re: 整合 Google 开源 C++ 代码 2010-04-19 22:59 asme

都很发用呀。。。  回复  更多评论   

# re: 整合 Google 开源 C++ 代码 2012-02-01 16:04 loan

All people deserve good life and business loans or just commercial loan would make it much better. Just because freedom is based on money state.   回复  更多评论   


只有注册用户登录后才能发表评论。
【推荐】超50万行VC++源码: 大型组态工控、电力仿真CAD与GIS源码库
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理


<2017年4月>
2627282930311
2345678
9101112131415
16171819202122
23242526272829
30123456

导航

统计

常用链接

随笔分类

随笔档案

相册

搜索

最新评论

阅读排行榜

评论排行榜