Protocol Buffer是google于2008推出的一种数据交换的格式,它独立于语言,独立于平台。
google 提供了多种语言的实现,每一种实现都包含了相应语言的编译器以及库文件。由于它是一种二进制的格式,比使用 xml 和 json 进行数据交换快许多。
如何下载?
下载地址:点击这里
最新版本:protoc-25.1
下载后解压,直接将bin目录配置到环境变量。配置成功,可查看版本:
//查看版本
protoc --version
协议文件
Proto有2个大版本:Proto2和Proto3。proto3是Google开源的一种用于序列化结构化数据的协议,它的全称是Protocol Buffers 3。它是proto2版本的升级版,拥有更简洁、更强大的特性。
创建一个协议文件,比如: all.proto
// 不加这行,默认为proto2,推荐使用proto3
syntax = "proto3";
message CSLogin{
message User{
string name= 1;
string score= 2;
repeated string addrs = 3;
}
repeated User users= 1;
}
数据结构:
如何编译?
在unity中使用ProtoBuf,一般有google-protobuf和protobuf-net两种库。
1.protogen.exe:
仅支持proto2,且不再更新,而proto2有一些枚举、默认值序列化等问题。需要使用protobuf-net库序列化。
2.protoc.exe:
支持proto3,需要使用google-protobuf库序列化。建议使用google-protobuf和proto3。
现在版本25,支持的语言:
//编译 生成CS文件,输出目录是out_cs
protoc --csharp_out=out_cs/ all.proto
//编译 生成java文件,输出目录为当前目录
protoc --java_out=. all.proto
现在不支持ts,可以使用node,
//安装protobufjs
npm install protobufjs -g
//导出js 该js需要在程序中引入
pbjs -t static-module -w commonjs -o proto.js all.proto
//将导出的js生成对应的.d.ts文件
pbts -o proto.d.ts proto.js