《Unity 3D游戏客户端基础框架》tolua 框架接入

引言:

如何将 tolua 框架接入 Unity 项目中,这里假设我们已经有一个项目,并且已经实现了一些基础架构或者项目已经是完整的,此时,如何将 tolua 这个热更新框架接入进来而不影响原项目的结构?

tolua 引入:

1.资源下载:

既然要将 tolua 引入项目,第一步肯定是先到 tolua 的 github 资源库 中下载 tolua 的资源包:tolua-master.zip

2.资源引入:

将下载的资源解压缩,可以看到大致的目录结构如下:

tolua-master
|-- Assets
|-- Luajit
|-- Luajit64
|-- ProjectSettings
|-- Unity5.x

这么多文件夹,那些才是我们真正需要的,将 Assets 文件夹下面的所有文件都复制到我们项目的 Assets 目录中,由于我使用的是 Unity 5.5.1f1 ,所以需要将 Unity5.x/Assets/Plugins 文件夹也复制到我们项目的 Assets 目录中与进行替换合并。

3.其他:

Unity 编辑器导入目录下新增的资源后,会弹出一个窗口提示 “点击确定自动生成常用类型注册文件,也可通过菜单逐步完成此功能” ,这里直接点击 【确定】 即可。

lua 起点 :

ToLua\Examples 目录中提供了很多实用范例,对于刚入门的新手有很大帮助,这里就不一一赘述了,我们直接进入到正式项目的应用实践中。在 Tolua\Misc 中提供了一个 LuaClient.cs ,这个就是 tolua 提供给我们一个封装好的启动接口,可以通过继承此类来编写我们项目的 tolua 管理器,这里我创建一个 LuaEngine.cs ,继承自 LuaClient 并重写两个接口:InitLoaderLoadLuaFiles

using System.Collections;
using System.Collections.Generic;
using LuaInterface;
using UnityEngine;
/// <summary>
/// tolua 启动入口,将此脚本动态绑定到一个不销毁的 GameObject 上,通常跟游戏的 GameManagr 绑在同物体上
/// </summary>
public class LuaEngine : LuaClient {

    protected override LuaFileUtils InitLoader()
    {
        return new LuaResLoader();
    }

    /// <summary>
    /// 可添加或修改搜索 lua 文件的目录
    /// </summary>
    protected override void LoadLuaFiles()
    {
#if UNITY_EDITOR
        // 添加编辑器环境下获取 lua 脚本的路径(Assets/lua)
        luaState.AddSearchPath(Application.dataPath + "/lua");
#endif
        OnLoadFinished();
    }
}

在游戏控制中心脚本 GameManager (绑定在游戏起始场景中的一个 GameObject 上面,通常是一个 Empty GameObject)的 Awake 方法中,通过以下方式启动此脚本:

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class GameManager : MonoBehaviour {
    private static GameManager _instance = null;
    private LuaEngine _luaEngine;

    public static GameManager Instance
    {
        get { return _instance; }
    }

    void Awake()
    {
        _instance = this;
        // 设置为切换场景不被销毁的属性
        GameObject.DontDestroyOnLoad(gameObject);
        Init();
    }

    /// <summary>
    /// 游戏管理器的初始化步骤
    /// </summary>
    void Init()
    {
        _luaEngine = gameObject.AddComponent<LuaEngine>();
    }
}

执行启动场景,可以看到最后输出:

11:34:30.215-0: [Main.lua:3]:logic start
UnityEngine.Debug:Log(Object)

这是 Assets/Lua/Main.lua 的打印内容,这个脚本也就是所有 lua 逻辑的起始点:

--主入口函数。从这里开始lua逻辑
function Main()                 
    print("logic start")            
end

--场景切换通知
function OnLevelWasLoaded(level)
    collectgarbage("collect")
    Time.timeSinceLevelLoad = 0
end

目录结构优化:

导入 tolua 的资源后,Assets 目录下的资源会版的有点乱和杂,所以有必要根据项目原本的结构对 tolua 的一些目录结构进行优化:

1.*Wrap.cs 目录:

Assets/Source/Generate 是用来保存 tolua 生成的可供 lua 调用的 C# 类的绑定类,但是在我的项目中,习惯性把脚本放在 Assets/Scripts 目录中,所以这里我们只需要打开 Assets/Editor/Custom/CustomSettings.cs ,修改一下内容:

public static string saveDir = Application.dataPath + "/Scripts/Generate/";   

然后将 Source/LuaConst.cs 移动到 Assets/Scripts/Framework/tolua 目录中,在 Scripts 中创建一个 Generate 目录,关闭 Unity 在重新启动,会再像刚引入 tolua 那样弹出一个窗口提示 “点击确定自动生成常用类型注册文件,也可通过菜单逐步完成此功能” ,这里也是直接点击 【确定】 即可。此时,在 Assets/Scripts/Generate 会生成一堆 *wrap.cs 的脚本文件,说明目录修改成功。但是此时会有重名文件,必须把整个 Source 目录删掉。

2.ToLua 目录:

Assets/ToLua 目录下是 tolua 框架最为核心的一些库,当然按照我们项目的规则;外部引入的第三方插件资源主要放在 Assets/ThirdParty 目录中,这里我们我们直接将整个 ToLua 目录移动到第三方插件目录,然后需要修改几个地方:

  • LuaConst.cs 中的 toluaDir

    public static string toluaDir = Application.dataPath + "/ThirdParty/ToLua/Lua";        //tolua lua文件目录
  • CustomSettings.cs 中的 toluaBaseType

    public static string toluaBaseType = Application.dataPath + "/ThirdParty/ToLua/BaseType/"; 

完成上述两项设置及完成了目录的修改。

参考资料:

相关推荐
<p><span style="color: rgba(0,0,0,.56);"> 本套课程分为基础与中级两部分,分别就lua语言的各方面知识点进行探讨,学习完本套课程,对于后续Xlua(Tolua框架)技术的学习提供强大的语言技术保证。</span><br /><span style="color: rgba(0,0,0,.56);">       本套lua课程采用入门与商业级两种开发IDE进行教学:入门级的SciTE内置IDE与商业级的IDEA lua插件。本套课程学习完毕,对于除了传统手游外,在VR、AR、商业级大型应用程序、嵌入式设备开发等领域都有较强的指导作用。</span><br /><span style="color: rgba(0,0,0,.56);">    </span><br /><span style="color: rgba(0,0,0,.56);">       lua中级篇分为:“函数的进阶”、“字符串进阶”、“Table进阶”、“元表”、“OOP面向对象”、“协同程序”、“IO操作”、“调试与运行”等八个大的章节,详细深入讲解lua开发的方方面面。</span><br /><span style="color: rgba(0,0,0,.56);">        内容包含lua可变参数、闭包、模块、函数尾调用、字符串模式匹配、字符串不变性原理、矩阵、链表、元表详解与应用、协同的生命周期与生产消费者问题、lua文件各种读写操作、lua执行外部代码与错误异常处理垃圾收集机制等。</span><br /><span style="color: rgba(0,0,0,.56);">       最后,lua中级篇的学习,对于广大学员开发商业级lua热更新技术,具有不可替代的重要作用!</span></p> <p> </p> <div>热更新系列(技术含量:中高级):<br />B:热更新框架设计之Xlua基础视频课程<br />https://edu.csdn.net/course/detail/27110<br />C:热更新框架设计之热更流程与热补丁技术<br />https://edu.csdn.net/course/detail/27118<br />D:热更新框架设计之客户端热更框架(上)<br />https://edu.csdn.net/course/detail/27132<br />E:热更新框架设计之客户端热更框架(中)<br />https://edu.csdn.net/course/detail/27135<br />F:热更新框架设计之客户端热更框架(下)<br />https://edu.csdn.net/course/detail/27136</div> <p> </p>
©️2020 CSDN 皮肤主题: 书香水墨 设计师:CSDN官方博客 返回首页