Chinar 教程效果：

1

Description —— 描述

Xlua 是騰訊出品的熱更新方案

由於其開源，且熱更新方案簡單易用，便於開發者對程式碼進行維護與修改，而得到廣泛認可

這裡 Chinar

2

Xlua Import and Open Hotfix —— Xlua匯入專案並且開啟熱更新

匯入 Xlua /到專案中後，我們需要在設定面板開啟熱更新才可以完全使用

輸入命令後，一定要回車，然後等待編譯！

3

Generate and Inject Scripts —— 生成與注入指令碼檔案

當工程中 Script /指令碼檔案有變更的時候

例如增加/刪除/增加標籤[Hotfix]/增加函式標籤[LuaCallCSharp]

注意：只要有任何變動，就需要重新生成和注入指令碼

另外如果出現花式報錯時，就清除所有，並重新生成和注入

4

Custom LuaLoader —— 自定義Loader

為了測試在工程中呼叫 Lua 檔案

新建一個指令碼 ChinarHotFix ，並掛載當前場景

新建一個 Lua 檔案放在一個目錄下（因為我們自定義的Loader，是要指定該目錄中的Lua檔案的）

注意：

Lua檔案的字尾名，要與函式中的 路徑字尾 保持一致

C# 檔案：

using System.IO;
using System.Text;
using UnityEngine;
using XLua;


/// <summary>
/// 熱更新測試指令碼——該指令碼新建一個 Lua環境，並完成對 Lua指令碼的指向呼叫
 

/// </summary>
public class ChinarHotFix : MonoBehaviour
{
    private LuaEnv luaEnv; //宣告一個Lua環境物件


    void Start()
    {
        luaEnv = new LuaEnv();                     //例項化一個
        luaEnv.AddLoader(ChinarLoader);            //新增Loader
        luaEnv.DoString("require'ChinarLuaTest'"); //引用名為： ChinarLuaTest 的 Lua 指令碼
    }


    /// <summary>
    /// 自定義一個 Loader 
    /// </summary>
    /// <param name="luaFileName">Lua檔名</param>
    /// <returns>位元組組</returns>
    private byte[] ChinarLoader(ref string luaFileName)
    {
        return Encoding.UTF8.GetBytes(File.ReadAllText(@"C:\Users\Administrator\Desktop\ChinarXLuaDemo\LuaFiles\" + luaFileName + ".lua")); //讀指定目錄下的 Lua 檔案，並返回位元組組
    }
}

Lua 檔案：

print('Chinar')

5

Before the LuaEnv.Dispose —— 釋放Lua環境之前

執行後需要對 LuaEnv 環境進行釋放

釋放 LuaEnv 之前還要反註冊，那些註冊到C#中的回撥函式

不然就會造成 LuaEnv 已經釋放了，但是 Xlua 機制中的 Delegate 中的函式回撥並沒有被釋放


直接新建一個 Lua 指令碼，專門管理並釋放 Delegate 中的函式的釋放

例如：你通過Lua指令碼 xlua.hotfix(CS.ChinarTest,'ChinarTestMethod',function) 註冊到 C# 中的函式

則通過新建一個 Lua 指令碼ChinarDispose.lua，寫上 xlua.hotfix(CS.ChinarTest,'ChinarTestMethod',nil) 質空，即可完成釋放

注意：每通過Lua指令碼修改一個C#函式，都需要在ChinarDispose.lua指令碼中新增對應函式的釋放/刪除操作

更改後，可進行雙清、釋放的 C# 檔案：

using System.IO;
using System.Text;
using UnityEngine;
using XLua;


/// <summary>
/// 熱更新測試指令碼——該指令碼新建一個 Lua環境，並完成對 Lua指令碼的指向呼叫
/// </summary>
public class ChinarHotFix : MonoBehaviour
{
    private LuaEnv luaEnv; //宣告一個Lua環境物件


    void Start()
    {
        luaEnv = new LuaEnv();                     //例項化一個
        luaEnv.AddLoader(ChinarLoader);            //新增Loader
        luaEnv.DoString("require'ChinarLuaTest'"); //引用名為： ChinarLuaTest 的 Lua 指令碼
    }


    /// <summary>
    /// 自定義一個 Loader 
    /// </summary>
    /// <param name="luaFileName">Lua檔名</param>
    /// <returns>位元組組</returns>
    private byte[] ChinarLoader(ref string luaFileName)
    {
        return Encoding.UTF8.GetBytes(File.ReadAllText(@"C:\Users\Administrator\Desktop\XluaProjects\LuaFiles\" + luaFileName + ".lua")); //讀指定目錄下的 Lua 檔案，並返回位元組組
    }

    /// <summary>
    /// 釋放掉函式
    /// 此函式會在 OnDestroy 之前呼叫
    /// </summary>
    private void OnDisable()
    {
        luaEnv.DoString("require'ChinarDispose'");
    }

    /// <summary>
    /// 釋放資源
    /// 此函式會在最後呼叫，物體被刪除時
    /// </summary>
    private void OnDestroy()
    {
        luaEnv.Dispose();
    }


}

ChinarDispose.lua檔案：

xlua.hotfix(CS.ChinarTest,'ChinarTestMethod',nil)
--xlua.hotfix(CS.ChinarTest1,'ChinarTestMethod1',nil)只要有修改C#中對應函式，都需要在這裡完成釋放操作
--xlua.hotfix(CS.ChinarTest2,'ChinarTestMethod2',nil)
--xlua.hotfix(CS.ChinarTest3,'ChinarTestMethod3',nil)

6

private Variable —— 私有變數

正常情況，我們是無法直接通過 Lua 直接訪問到 C# 中的私有變數的

然而 Xlua 機制為我們提供了一個非常簡便的解決方案

當我們需要訪問某個 C# 類中的私有變數時，只需要在 Lua 程式碼中加上一句話

xlua.private_accessible(CS.ChinarTest)

然後，我們就可以訪問到 C# ChinarTest類中的私有變量了

更改後，可進行雙清、釋放的 C# 檔案：

using UnityEngine;
using XLua;

[Hotfix]
public class ChinarTest: MonoBehaviour
{
    private int Number = 666;//私有數字變數--例如這麼一個私有變數
}

lua檔案中加上：

xlua.private_accessible(CS.ChinarTest)--只有加上這句話，才可以訪問C#對應類中的私有變數

支援

May Be —— 搞開發，總有一天要做的事！

技術交流群：806091680 ！ Chinar 歡迎你的加入

本部落格為非營利性個人原創，除部分有明確署名的作品外，所刊登的所有作品的著作權均為本人所擁有，本人保留所有法定權利。違者必究

對於需要複製、轉載、連結和傳播部落格文章或內容的，請及時和本博主進行聯絡，留言，Email: [email protected]

對於經本博主明確授權和許可使用文章及內容的，使用時請註明文章或內容出處並註明網址