整合 Google 开源 C++ 代码

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，这个库是能独立安装使用的。

from: http://www.cppblog.com/Solstice/archive/2010/04/17/112867.aspx