整合 Google 开源 C++ 代码

以你之姓@ 2022-07-12 04:48 217阅读 0赞

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][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_googletest.googlecode.com_files_gtest-1.4.0.tar.gz]

再装 [http://googlemock.googlecode.com/files/gmock-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][http_code.google.com_p_google-glog_issues_detail_id_42] 。

$ wget [http://google-glog.googlecode.com/files/glog-0.3.0.tar.gz][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][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  
][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][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_755fbf16c3ce94bfa09e1bf5da27ccdfc1e7e725]

[http://levent.git.sourceforge.net/git/gitweb.cgi?p=levent/levent;a=commitdiff;h=07edf784fab4e25c31eef3fdcccec3975e2741db][http_levent.git.sourceforge.net_git_gitweb.cgi_p_levent_levent_a_commitdiff_h_07edf784fab4e25c31eef3fdcccec3975e2741db]

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

[glog]: /images/20220711/d59cacce2ca7477d81efed379de0d827.png
[http_google-gflags.googlecode.com_files_gflags-1.3.tar.gz]: http://google-gflags.googlecode.com/files/gflags-1.3.tar.gz
[http_googletest.googlecode.com_files_gtest-1.4.0.tar.gz]: http://googletest.googlecode.com/files/gtest-1.4.0.tar.gz
[http_googlemock.googlecode.com_files_gmock-1.4.0.tar.gz]: http://googlemock.googlecode.com/files/gmock-1.4.0.tar.gz
[http_code.google.com_p_google-glog_issues_detail_id_42]: http://code.google.com/p/google-glog/issues/detail?id=42
[http_google-glog.googlecode.com_files_glog-0.3.0.tar.gz]: http://google-glog.googlecode.com/files/glog-0.3.0.tar.gz
[http_evproto.googlecode.com_svn_trunk]: http://evproto.googlecode.com/svn/trunk
[http_www.monkey.org_provos_libevent-2.0.4-alpha.tar.gz]: http://www.monkey.org/~provos/libevent-2.0.4-alpha.tar.gz
[http_archives.seul.org_libevent_users_Mar-2010_msg00059.html]: http://archives.seul.org/libevent/users/Mar-2010/msg00059.html
[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=755fbf16c3ce94bfa09e1bf5da27ccdfc1e7e725
[http_levent.git.sourceforge.net_git_gitweb.cgi_p_levent_levent_a_commitdiff_h_07edf784fab4e25c31eef3fdcccec3975e2741db]: http://levent.git.sourceforge.net/git/gitweb.cgi?p=levent/levent;a=commitdiff;h=07edf784fab4e25c31eef3fdcccec3975e2741db