适用于游戏开发的协议格式、代码生成器及相关开发API

Why ProtoPlus？

Protobuf作为行业通用的协议格式已经存在多年，各种历史遗留问题及语言设计上的缺陷对游戏开发阻碍非常大。

为了提高协议编写效率，增加协议使用灵活度，急需一套强于Protobuf的工具集提高开发效率和使用便捷性，ProtoPlus应运而生！

特性对比

___	ProtoPlus	Protobuf
生成字段Tag	自动/手动	手动
生成枚举值	自动/手动	手动
注释扩展	API简单	API复杂
字段扩展	专属API支持	手动解析注释
结构扩展	专属API支持	手动解析注释
消息ID生成	自动/手动	不支持
路由表生成	支持	不支持
扩展方式	描述文件输出JSON	复杂的插件格式，调试复杂

注：

• ProtoPlus中的枚举值，不再需要为了兼容C++而必须加上前缀，保证全局枚举值唯一

• ProtoPlus二进制编码格式与Protobuf一致，方便调试、分析、优化

描述文件格式

enum Vocation {
	Monkey
	Monk
	Pig
}

struct PhoneNumber {

	number string

	type int32
}


struct Person {

	name string

	id  int32

	email string

	phone PhoneNumber

	voc Vocation
}

struct AddressBook {

	person []Person
}

协议类型及输出语言类型对应

描述	ProtoPlus	Go	C#	Protobuf
32位整形	int32	int32	int	int32
64位整形	int64	int64	long	int64
无符号32位整形	uint32	uint32	uint	uint32
无符号64位整形	uint64	uint64	ulong	uint64
字符串	string	string	string	string
单精度浮点数	float32	float32	float	float
双精度浮点数	float64	float64	double	double
二进制数据	bytes	[]byte	byte[]	repeated byte
枚举	enum	int32类型常量封装	enum	enum
布尔	bool	bool	bool	bool
结构体	struct	struct	class	message

编译

	go get -u -v github.com/davyxu/protoplus/cmd/protoplus

功能

输出ProtoPlus编码消息序列化的Go源码

命令行示例:

protoplus --ppgo_out=msg_gen.go --package=proto proto1.proto proto2.proto

参数说明:

• ppgo_out

  Go源码文件名

• package

  指定输出时的Go包名

输出消息绑定的Go源码

输出源码被引用时, 自动注册到cellnet的消息Registry中

命令行示例:

protoplus --ppgoreg_out=msg_gen.go --package=proto proto1.proto proto2.proto

参数说明:

• ppgoreg_out

  Go源码文件名

• package

  指定输出时的Go包名

• codec
  生成消息注册的默认编码，如在消息中指定编码时，优先使用指定的编码

输出ProtoPlus编码的消息序列化C#源码

输出的C#源码, 需要配合ProtoPlus C# SDK 使用

命令行示例:

protoplus --ppcs_out=MsgGen.cs --package=Proto proto1.proto proto2.proto

参数说明:

• ppcs_out

  C#源码文件名

• package

  指定输出时的C#命名空间

• classbase

  C#代码生成时，消息类默认基类名称, 默认基类为IProtoStruct

输出消息绑定的C#源码

输出的C#源码, 需要配合ProtoPlus C# SDK 使用

命令行示例:

protoplus --ppcsreg_out=MsgGen.cs --package=Proto proto1.proto proto2.proto

参数说明:

• ppcsreg_out

  C#源码文件名

• package

  指定输出时的C#命名空间

输出Protobuf协议描述文件

输出的Protobuf协议描述文件,可使用protoc编译器编译

命令行示例:

protoplus --pbscheme_out=pb.proto --package=proto proto1.proto proto2.proto

参数说明:

• pbscheme_out

  生成protobuf 3.0协议文件

• package

  指定输出时的Protobuf包名

输出ProtoPlus描述文件

ProtoPlus协议描述文件可输出为JSON格式, 方便插件及工具链获取ProtoPlus的格式信息

命令行示例:

protoplus --ppscheme_out=pp.json proto1.proto proto2.proto

参数说明:

• ppscheme_out

  JSON格式的ProtoPlus协议描述文件, 格式参见 协议描述定义

也可将描述文件的JSON直接输出,示例如下:

protoplus --ppscheme proto1.proto proto2.proto

输出路由配置

在结构体上添加MsgDir字段,标记结构体作为消息时的消息流转方向, 格式范例:

[MsgDir: "client -> game"]
struct LoginREQ {
}

路由信息将输出为JSON格式:

{
  "Rule": [
     {
        "MsgName": "proto.LoginREQ",
        "SvcName": "game"
     }
  ]
}

MsgDir格式说明

MsgDir的格式包含3个部分

    MsgDir: From -> Mid -> To

• From

  消息的发起方,路由一般忽略此部分信息

• Mid

  消息的中间处理, 一般为网关或者路由等

• To

  消息的目标送达点,消息处理最终方, 一般为某种消息服务, 路由表的SvcName字段读取该字段

命令行示例:

protoplus --route_out=route.json --package=proto proto1.proto proto2.proto

参数说明:

• route_out

  JSON格式的ProtoPlus路由配置, 格式参见 路由定义

• package

  指定输出时消息的包名

也可将路由信息的JSON直接输出,示例如下:

protoplus --route --package=proto proto1.proto proto2.proto

备注

感觉不错请star, 谢谢!

提交bug及特性: https://github.com/davyxu/protoplus/issues