2022-10-22 下载安装编译使用Google_Protobuf一篇到位

Protobuf

该库的介绍自行百度，项目中使用到的话，参考这篇文档；PS：本人编写的时候，也是第一次编译，请跟随我的脚步依次进行探索。期间可能会遇到多种多样的问题，我会分享我的解决方法和思路；

---

---

前言

本文属于入门文档，进阶的使用，请参考其他网文。

---

提示：以下是本篇文章正文内容，下面案例可供参考

一、下载地址

Github地址：https://github.com/protocolbuffers/protobuf
本人下载版本： protobuf-3.21.8.tar.gz

二、环境准备

windows10+ vs2019
使用语言:C++

三、编译目标

生成Windows下x64的库

四、学习文档

1. 首先看下源码结构，如下图，可以看到大致是使用cmake编译，支持Windows和Linux编译；
   
2. 看下ReadMe文档，可以看到C++相关的在src/readme，打开文档看下编译过程：我们下一步使用cmake进行编译；
   
3. 打开…/cmake/Read.md，学习一下文档内容进行编译；

五、编译过程

1.cmake运行

1. 在源码目录下，创建solution目录并进入
   

mkdir solution & cd solution

2. 运行cmake指令

cmake -G "Visual Studio 16 2019"  ..

修改为：

cmake -G "Visual Studio 16 2019"  .. -Dprotobuf_BUILD_TESTS=OFF

生成解决方案如下：

2.编译VS工程

1. 打开protocol.sln文件，进行编译
   
   
   生成如下文件：
   

五、proto.exe转换C++

1. 编写一个proto文件，如下所示：

syntax = "proto3";
import "google/protobuf/timestamp.proto";
package test;

message  BeaconDatas
{
    google.protobuf.Timestamp dataTime = 1;        //数据时间
    int32 ss = 2;            						//信标基础信息
}

2. 供C++使用，则需要将其转换;提供一个转换的bat脚本如下：（含中文路径的需要加双引号）
   

需要注意三部分：

1. protoc.exe为绝对磁盘路径
2. –cpp_out=D:\protocol 为指定输出路径
3. test.proto为需要转换的文件
4. -I选项为指定搜索路径，注意，这个选项可以使用多次，指定多个搜索路径；我这里指定了当前路径，同时我用到了google.protobuf.Timestamp，所以我又指出了它的include文件夹；

3. 最终转换生成了test.pb.h 和test.pb.cc两个文件；
   

六、测试demo

1. 编写如下代码：

#include <iostream>

#include "test.pb.h"
int main()
{
    test::BeaconDatas aaa;
    aaa.set_ss(123);
    std::cout << "ss=" << aaa.ss() << std::endl;
    std::cout << "Hello World!\n";
    getchar();
}

2. 测试项目做如下改动：
   
   

3. 运行效果：

七、protobuf拓展知识点

1. 关键字

1. required关键字：该规则规定，消息体中该字段的值是必须要设置的。
2. optional关键字：消息体中该规则的字段的值可以存在，也可以为空，optional的字段可以根据defalut设置默认值。
3. repeated关键字：消息体中该规则字段可以存在多个（包括0个）。

2. 命名空间

例如proto文件中，“package test;”，转换以后会生成命名空间test;
如果是“package test.newtest”等有点的情况，转换以后会生成命名空间test::newtest;

3. 序列化与反序列化

SerializeToString、ParseFromString等函数；