Google 开源了很多优秀的 C++ 程序库,本文介绍如何将其中几个整合到一起。
本文涉及的 Google 库有:
- gflags - 命令行参数解析。可以完全用命令行来配置应用程序,省去配置文件。
- gtest - C++ 单元测试框架
- gmock - C++ 单元测试中用到的 mock
- glog - 日志库
- protobuf - 高效的网络协议格式
还有第三方的 libunwind 和 zlib。
这些库每个都是独立的,可以单独安装使用。不过它们之间有内在的依赖关系,如果配合使用的话效果更加。下面这张图表示了依赖关系:
本文以 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,这个库是能独立安装使用的。