lua-protobuf-rs

Crates.iolua-protobuf-rs
lib.rslua-protobuf-rs
version0.1.2
sourcesrc
created_at2023-10-13 17:07:15.949623
updated_at2024-05-10 13:58:19.676548
descriptionlua protobuf
homepagehttps://github.com/mikai233/lua-protobuf-rs
repositoryhttps://github.com/mikai233/lua-protobuf-rs
max_upload_size
id1002492
size3,051,237
mikai233 (mikai233)

documentation

README

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的所有字段只可能存在一个或者都不存在

Commit count: 18

cargo fmt