lua-protobuf-rs

此项目使用的是rust的protobuf实现，编写的可以在lua中解析protobuf的库

可以做到在运行时加载proto文件，将protobuf二进制数据解析成lua table、将lua table编码成二进制数据以及protobuf在lua下的反射功能

绑定的API可以到这里 查看，绑定了几个比较关键的struct， FileDescriptor MessageDescriptor FieldDescriptor EnumDescriptor，这几个结构其实就表示了proto的文件、消息、以及字段、枚举的信息

使用

lua里直接解析proto

--- @type LuaProtoc
local luaProtoc = require("lua_protobuf_rs")

---@language "protobuf"
local proto = [[
syntax="proto3";

message Player{
  int64 id = 1;
  int64 world_id = 2;
  string nickname = 3;
  int32 exp = 4;
}

message LoginRequest{
  int64 id = 1;
  int64 world_id = 2;
}

message LoginResponse{
  Player player = 1;
}
]]

local protoc = luaProtoc.parse_proto(proto)

local player = {
    id = 2347239423213,
    world_id = 234872389,
    nickname = "mikai233",
    exp = 22000,
}

local player_bytes = protoc:encode("Player", player)
local decode_player = protoc:decode("Player", player_bytes)
print(decode_player.id)

local login_response_bytes = protoc:encode("LoginResponse", {})
local decode_login_response = protoc:decode("LoginResponse", login_response_bytes)
print(decode_login_response.player.id)

lua里解析proto文件

• player.proto

syntax = "proto3";

package com.mikai233;

message Player{
  int64 id = 1;
  int64 world_id = 2;
  string nickname = 3;
  int32 exp = 4;
}

• login.proto

syntax = "proto3";
import "player.proto";

package com.mikai233;

message LoginRequest{
  int64 id = 1;
  int64 world_id = 2;
}

message LoginResponse{
  Player player = 1;
}

--- @type LuaProtoc
local luaProtoc = require("lua_protobuf_rs")

local protos = luaProtoc.list_protos({ "proto" })

local protoc = luaProtoc.parse_files(protos, { "proto" })

local player = {
    id = 2347239423213,
    world_id = 234872389,
    nickname = "mikai233",
    exp = 22000,
}

local player_bytes = protoc:encode("com.mikai233.Player", player)
local decode_player = protoc:decode("com.mikai233.Player", player_bytes)
print(decode_player.id)

local login_response_bytes = protoc:encode("com.mikai233.LoginResponse", {})
local decode_login_response = protoc:decode("com.mikai233.LoginResponse", login_response_bytes)
print(decode_login_response.player.id)

反射

更多的反射API请查看文档

--- @type LuaProtoc
local luaProtoc = require("lua_protobuf_rs")

local protos = luaProtoc.list_protos({ "proto" })

local protoc = luaProtoc.parse_files(protos, { "proto" })

local player_descriptor = protoc:message_descriptor_by_name("com.mikai233.Player")

for _, field in pairs(player_descriptor:fields()) do
    print("field name: " .. field:name() .. " number: " .. field:number())
end

print("====")

local login_response_descriptor = protoc:message_descriptor_by_name("com.mikai233.LoginResponse")

for _, field in pairs(login_response_descriptor:fields()) do
    local rt = field:runtime_field_type()
    if rt.singular then
        local singular = rt.singular
        print(singular.message:name())
    end
end

proto代码提示

可以使用gen_lua 来生成lua的proto模板文件，来获得更好的代码编写体验，本项目是基于EmmyLua 插件做的注解提示

---@class LoginRequest
---@field id number
---@field world_id number
local LoginRequest

---@class LoginResponse
---@field player Player
local LoginResponse

xLua插件集成

设置环境变量 LUA_LIB_NAME LUA_LIB为xlua的头文件目录以及xlua的库名，然后重新编译此项目即可 注意xlua的版本一定要和此项目的lua版本要对应

[DllImport("lua_protobuf_rs", CallingConvention = CallingConvention.Cdecl)]
public static extern int luaopen_lua_protobuf_rs(System.IntPtr L);

[MonoPInvokeCallback(typeof(LuaDLL.lua_CSFunction))]
public static int LoadProtobufRs(System.IntPtr L)
{
    return luaopen_lua_protobuf_rs(L);
}

编译

得益于Cargo，编译变得非常简单，只需要安装Rust，然后执行cargo build --release就可以得到当前平台的库文件

对于不同的Lua版本，只需要修改Cargo.toml中的default字段重新编译即可

交叉编译

如果需要编译到不同平台，可以使用交叉编译，需要Docker，操作难度很小

• 编译到Linux：cross build --target x86_64-unknown-linux-gnu --release
• 编译到Android cross build --target armv7-linux-androideabi --release

注意事项

对于非oneof类型的字段，在将二进制消息解析成table时，如果该字段没有设置值，都会给一个默认值，而对于oneof类型的字段，如果都没有设置过值， 那么这些字段都将不存在，也就是说oneof的所有字段只可能存在一个或者都不存在