vs2019 中编译和使用 protobuf 库

背景

protobuf 是一种跨平台的序列化结构数据的方法，可用于网络数据传输及存储。

本文对使用 vs2019 编译 protobuf 库文件进行说明，相关代码及安装文件均来自官网下载。

VS2019 编译 protobuf

①．生成 sln 工程文件

打开 cmake ,然后选择 protobuf-v3.19.4 目录中的 cmake 文件夹

单击 configure 按钮，在打开界面中配置 生成器及平台

取消 protobuf_BUILD_TESTS 选项，若要生成动态库需要选择 protobuf_BUILD_SHARED_LIBS

单击 Generate 按钮生成 sln 工程目录

②．编译 sln 工程

用 VS2019 打开生成的 sln 项目文件

右键解决方案分别生成 Debug 和 Release 版的库文件

③．整理生成的结果

新建 bin 文件夹，把生成的 libprotobuf.dll、libprotobuf-lite.dll、libprotoc.dll 三个动态库文件放入文件夹

新建 lib 文件夹，把生成的 libprotobuf.lib、libprotobuf-lite.lib、libprotoc.lib三个库文件放入文件夹

新建 include 文件夹，把 protobuf-v3.19.4 目录中的 src\google 文件夹拷贝放入

新建 tools 文件夹，把 protoc.exe、libprotobuf.dll、libprotoc.dll 三个文件放入，用于编译生成 c++ 文件

最终生成的完整目录如下，在使用时把 protobuf-x86 放在对应的工程路径下即可

VS2019 使用 protobuf

①．项目属性配置

在附加包含目录中配置 include 路径

在附加库目录中配置 lib 路径

在附加依赖项中配置 libprotobufd.lib

②．编写测试用的 .proto 文件

syntax = "proto3";
package protoTest;

message DemoMsg
{
  string name = 1;
  int32 id = 2;
}

③．生成对应的 C++ 文件

为方便使用可在同目录编写一个 generate.bat 文件

cd /d %~dp0
..\protobuf-x86\tools\protoc.exe *.proto --cpp_out=.
pause

双击运行即可生成 .h 和 .cc 文件

把生成的文件添加到项目中，并且在生成的 .h 文件最开头添加 #define PROTOBUF_USE_DLLS，否则编译会出错

④．测试代码

#include <iostream>
#include "proto/protoDemo.pb.h"
int main()
{
    protoTest::DemoMsg msg;
    msg.set_id(1);
    msg.set_name("hello");

    std::cout << msg.SerializePartialAsString() << std::endl;
}