跳转至

Luban 的基础配置开发文档

  • 首先,笔者是出于看官方文档两个钟头大,所以自行写出了该文档记录,主要是解决如何实现自定义数据结构的配表转成json文件。所以下文也许只能给你一些参考。
  • 官方文档

Luban工具的下载

  • 安装dotnet sdk 7.0或更高版本sdk
  • 下载luban_examples项目。该项目中包含测试配置以及大量的示例项目。为方便起见,后续提及到的文件,默认都指这个项目中的文件。
  • 下载Luban工具。从release下载uban.7z文件,直接解压到Tools目录下即可,确保最终Luban程序的位置为luban_examples/Tools/Luban/Luban.dll

注意Luban文件夹不要多一个

准备文件前的初始化

  • 如果直接在官方的样例上进行修改,会多出很多令人头大又不知道哪里来的文件。所以这里笔者将很多文件全删了(备份到别处)。
  • luban_example\luban_examples-main\DataTables\Defines下的文件可以全挪走。这些是官方样例的一个定义文件。
  • luban_example\luban_examples-main\DataTables\Datas下的文件,除了保留三个,其余可以全部挪走(DELETE)。剩下三个分别是_beans_.xlsx,_tables_.xlsx,_enums_.xlsx
  • 这两个文件夹将会是我们主要的数据配置准备的文件夹。刚才第二步剩余的三个文件,将该三个文档除了前三行保留,其余全部删除。(后续笔者会讲解一下这里的基础用法。不过我也刚学一天,救命,官方文档太...)
  • 新建一个gen.bat文件,(理论上是不需要考虑该文件存放位置的,但是笔者建议放在luban_example\luban_examples-main目录下)。然后copy下面代码。
        set LUBAN_DLL=Tools\Luban\Luban.dll
        set CONF_ROOT=DataTables
    
        dotnet %LUBAN_DLL% ^
        -t client ^
        -d json  ^
        --conf %CONF_ROOT%\luban.conf ^
        -x outputCodeDir=<你的文件要输出代码的路径> ^
        -x outputDataDir=<你的json文件要输出的路径>
    pause
    

这里笔者是准备将数据配置成json文件,所以这里的-d是json。而要输出别的数据,还是需要看官方示例去进行相应的配置,修改bat文件。 And, 代码里的<>尖括号也要删掉,别傻乎乎的像我一样留着。

Summary

  • 至此,基本工作已经准备完成。请移步到基础语法讲解。