unity强力配置插件Luban【Next最新版本】（一）部署

---

前言

luban是一个强大、易用、优雅、稳定的游戏配置解决方案。它设计目标为满足从小型到超大型游戏项目的简单到复杂的游戏配置工作流需求。
该项目在2023下半年进行了重构，旧版本命名为Classic版，新版为Next版。如果追求稳定建议使用Classic版，想学习使用可以参考我博客内的luban相关文章。
Next版的意义是为了简化之前繁重的流程，将各种功能模块化、定制化，比以前更加轻量具有针对性，话不多说，走。
官方文档

---

一、准备

1. 安装dotnet sdk 7.0或更高版本sdk
2. 下载luban_examples项目。
3. 确立目标：实现示例的c#代码生成，生成位置为StreamingAssets下，在unity运行时加载数据并打印信息

二、快速配置

在目标工程新建Luban文件夹

将下载示例中的DesignerConfigs和Tools文件夹拷贝进Luban文件夹

将luban_examples-main\Projects\Csharp_Unity_json\Assets\LubanLib文件夹拷贝到目标项目的Asset文件夹下

在luban文件夹下新建gen.bat脚本，填入以下文本：

set GEN_CLIENT=Tools\Luban\Luban.dll
set CONF_ROOT=DesignerConfigs

dotnet %GEN_CLIENT% ^
    -t all ^
    -c cs-simple-json ^
    -d json  ^
    --schemaPath %CONF_ROOT%\Defines\__root__.xml ^
    -x inputDataDir=%CONF_ROOT%\Datas ^
    -x outputCodeDir=..\Assets/Scripts/Luban ^
    -x outputDataDir=..\Assets/StreamingAssets/json ^
    -x pathValidator.rootDir=E:\GitProject\UnityCesiumLibrary ^
    -x l10n.textProviderFile=*@E:\GitProject\UnityCesiumLibrary\Luban\DesignerConfigs\Datas\l10n\texts.json

pause

运行，成功（对应的Assets/Scripts/Luban文件夹下生成c#脚本）

是不是非常迅速，顺便注意bat脚本的配置参数需要根据目标项目进行调整。

三、加载

进入unity工程，添加Main脚本，运行。

using System.Collections;
using System.Collections.Generic;
using System.IO;
using UnityEngine;
using SimpleJSON;

public class Main : MonoBehaviour
{
    void Start()
    {
        var tables = new cfg.Tables(LoadByteBuf);
        Debug.Log("加载"+tables.TbItem[1].Name);
    }

    private static JSONNode LoadByteBuf(string file)
    {
        return JSON.Parse(File.ReadAllText(Application.streamingAssetsPath +"/json/" + file + ".json", System.Text.Encoding.UTF8));
    }
}

加载成功

四、优化整理

• 目录E:\GitProject\UnityCesiumLibrary\Luban\DesignerConfigs\Datas下无用文件删除，只留__beans__.xlsx、enums.xlsx、tables.xlsx三个（表格里也一并清空）。
• 目录E:\GitProject\UnityCesiumLibrary\Luban\DesignerConfigs\Defines同理，除了__root__.xml和builtin.xml全部清理。
• builtin.xml里面是适配unity的现有的枚举和结构，比如vector、double3、矩阵这样的类型，建议保留；官方适配了常用的几种，至于矩阵之类的需要自己添加。
  至此，Luban Next版部署完成。（Jenkins上直接调用bat脚本即可）

嫌麻烦的，我这里做好了一个专属unity的示例项目，放到E盘下即可食用。 链接：LubanExample For Unity

---

总结

快速上手新版luban，有多个项目需求的可以将精简的文件进行备份以便下次使用。