Skip to content

Latest commit

 

History

History
113 lines (86 loc) · 3.54 KB

start_up.md

File metadata and controls

113 lines (86 loc) · 3.54 KB

huatuo

参考资料

使用

以下为了方便起见，发布win下pc版本。其他平台同理。

安装

  • 为你所用的Unity版本安装适当的il2cpp模块，（如果你发布其他平台，要选择相应平台的il2cpp模块）。
  • 从il2cpp_huatuo clone你所用的unity版本对应的分支
  • 将huatuo项目下的huatuo目录（注意不是huatuo项目根目录，而是根目录下的huatuo目录）复制（推荐用建立目录链接的方法，linux下用ln，Win下用mlink）到 il2cpp_huatuo/libil2cpp下，最终目录为il2cpp_huatuo/libil2cpp/huatuo。
  • 将这个添加了huatuo目录的libil2cpp目录替换你当前所用的Unity的Editor安装目录下的 Editor/Data/il2cpp/libil2cpp 目录。

简单来说，就是将 il2cpp_huatuo 项目的libil2cpp与 huatuo项目的huatuo目录合并，形成最终的libil2cpp目录，再替换安装目录的原始libil2cpp目录。

至此即完成huatuo安装，后续打包出的app就能支持c#热更新。

项目的准备工作

  • 使用 Unity的 Assembly def 创建一个专门的 HotFix 模块（你也可以使用创建第三方工程的方式，只不过麻烦了点）。
  • 将示例项目Assets/Main/HuatuoLib 、Assets/Editor/HuaTuo 以及Assets/link.xml 拷贝到 你项目中。link.xml文件可酌情调整。
  • 参考MonoBehaviour相关工作流 作一些必要的设置

代码中使用

  • 在HotFix模块中创建第一个热更新脚本，类似如下
public class App
{
    public static int Main()
    {
        Debug.Log("hello,huatuo");
        return 0;
    }
}

  • 主工程中，使用标准反射函数加载Hotfix.dll,以示例 LoadDll.cs 为例

  • 如果需要加载AssetBundle, 请查看示例工程中的LoadDllFromAssetBundle.cs文件

    同时也在菜单中添加了简单hotfix.dll文件的ab制作工具

public class LoadDll : MonoBehaviour
{
    void Start()
    {
        LoadGameDll();
        RunMain();
    }

    private System.Reflection.Assembly gameAss;

    private void LoadGameDll()
    {
#if !UNITY_EDITOR
        // 此代码在Android等平台下并不能工作，请酌情调整
        string gameDll = Application.streamingAssetsPath + "/HotFix.dll";
        gameAss = System.Reflection.Assembly.LoadFile(File.ReadAllBytes(gameDll));
        #else
        gameAss = AppDomain.CurrentDomain.GetAssemblies().FirstOrDefault(assembly => assembly.GetName().Name == "HotFix");
#endif
    }

    public void RunMain()
    {
        if (gameAss == null)
        {
            UnityEngine.Debug.LogError("dll未加载");
            return;
        }
        var appType = gameAss.GetType("App");
        var mainMethod = appType.GetMethod("Main");
        mainMethod.Invoke(null, null);
    }
}

  • Build & Run

    • 将 HotFix.dll拷到StreamingAssets下
    • 发布选项设置
      • Scripting Backend 选择 il2cpp backend
      • 取消 use incremental GC
    • 发布 (必须选择相应平台64位版本)
    • 进入场景后，应该能看到日志 "hello,huatuo"

  • 测试热更新

修改HotFix模块中的 App::Main代码。改成

public class App
{
    public static int Main()
    {
        Debug.Log("hello,world");
        return 0;
    }
}

将编译后的Hotfix.dll 复制替换发布目标目录下的 StreamingAssets下的Hotfix.dll，重新运行程序。 你应该会看到打印出 "hello,world"。

至此完成。