使用 Protocol Buffer 交换数据


Protocol Buffer 是 google 开发的一个用于定义通信双方数据格式定义库。项目参考地址:https://developers.google.cn/protocol-buffers

1. Protocol Buffer 通过一个 .proto 文件,来定义通信内容的数据结构

    .proto 文件定义规范参考:https://developers.google.cn/protocol-buffers/docs/proto3

2. Protocol Buffer 通过编译 .proto 文件,生成各种语言的源代码(C# 对应 .cs 文件)

    要把 .proto 文件编译成指定语言(C#)源代码,需要下载 proto 编译器,下载地址为:https://github.com/protocolbuffers/protobuf/releases/latest

    下载文件列表中,下载指定的平台及版本:protoc-{版本}-{平台}.zip,eg. protoc-3.19.1-win64.zip

    下载完成后,建议复制到 C:\Program Files\ 下,并在 PATH 中添加下级 bin 目录,然后命令行执行 protoc --version,查看是否安装成功

     在命令行中,先进入(cd)到 .proto 文件目录,然后执行编译,详细的编译选项使用 protoc --help 查看

     目前主要用到的 --csharp_out 即选择输出为 C# 代码并指定生成的 .cs 文件存放目录

     eg. protoc --csharp_out=. rawdata.proto

3. 在项目中使用生成的源代码

    在项目中包含编译器生成的 .cs 文件,编译项目会报错,此时需要通过 nuget 安装运行时

    在 nuget 中搜索 Protobuf 并安装对应的版本即可,到此安装完成

4. 使用 Protocol Buffer