JSBinding + SharpKit / JavaScript 加载流程

首先，现在的方案是游戏启动就加载全部的 JavaScript 代码。

 

先看下 StreamingAssets/JavaScript/ 文件夹下的目录结构：

• debug/：跟 JavaScript 调试有关的 JavaScript 代码，只有当开启调试的时候才需要加载。
• Manual/：也是用于手写 JavaScript 代码，跟 JSImp/ 有一些区别。Manual 里最有的代表性的是 Vector2 和 Vector3，这2个对象是手写实现的，在 JavaScript 中跑只会使用 JavaScript 版本的 Vector2 和 Vector3
• SharpKit/：从 SharpKit 拿过来的一些 JavaScript 库文件。可以实现类继承等
• GeneratedFiles.javascript：是由菜单 【JSB | Generate JS and CS Bindings】 产生的。用于实现将 C# 函数绑定到 JavaScript 上。比如说要在 JavaScript 中使用 GameObject 就要使用这里面的文件。这一点和 LUA 不一样，LUA 产生绑定时只有产生 C# 代码，我们是2边都有。
• SharpKitGeneratedFiles.javascript：由 SharpKit 工程编译而来的 JavaScript 代码都会放在这个文件里。
• includes.javascript：JavaScript 代码总入口

 

目前 JavaScript 加载只有一个入口，StreamingAsset/JavaScript/includes.javascript。

查看 _JSEngine.prefab 上的配置：

 

includes.javascript 里面通过 CS.require 包含了所有的 JavaScript 文件：

（此内容可能不是最新的）

/*
* Author: Qiucw
* DO NOT change order
*/


// -1)
//--------------------------------------------------
function jsb_ReplaceOrPushJsType(jst) {
    //if (!JsTypes) { JsTypes = []; }
    var found = false;
    for (var i = 0; i < JsTypes.length; i++) {
        if (JsTypes[i].fullname == jst.fullname) {
            JsTypes[i] = jst;
            found = true;
            break;
        }
    }
    if (!found) {
        JsTypes.push(jst);
    }
}


// 0) SharpKit library
//--------------------------------------------------
CS.require("SharpKit/jsclr");
CS.require("SharpKit/clrlibrary");

// 1) Files generated by JSBinding
// may overwrite some classes in step 0)
//--------------------------------------------------
CS.require("GeneratedFiles");


// 2) Manually written js
// will overwrite some classes in step 1)
//--------------------------------------------------
CS.require("Manual/UnityEngine_Vector3");
CS.require("Manual/UnityEngine_Vector2");
CS.require("Manual/UnityEngine_MonoBehaviour");
CS.require("Manual/UnityEngine_WaitForSeconds");
CS.require("Manual/MissingClasses");
//
// may be more..
//

// 3) code generated by SharpKit
//--------------------------------------------------
CS.require("SharpKitGeneratedFiles");


// 4) JavaScript implemented
// will overwrite some classes in step 1)
//--------------------------------------------------
CS.require("JSImp/Reflection");
CS.require("JSImp/Coroutine");
CS.require("JSImp/Iterator");

//
// may be more..
//

// 5) SharpKit handler (Compile)
//--------------------------------------------------
CS.require("SharpKit/myclrhandler");

// 6) Error handler
//--------------------------------------------------
CS.require("ErrorHandler");

 

JavaScript 里的类一开始都是用 JsType 对象来表示，可以打开 StreamingAssets/JavaScript/SharpKitGeneratedFiles.javascript/ 查看一下。这里贴出来 V3Test 这个 MonoBehaviour 的 JavaScript 代码：

if (typeof(JsTypes) == "undefined")
    var JsTypes = [];
var V3Test = {
    fullname: "V3Test",
    baseTypeName: "UnityEngine.MonoBehaviour",
    assemblyName: "SharpKitProj",
    Kind: "Class",
    definition: {
        ctor: function (){
            this.elapsed = 0;
            UnityEngine.MonoBehaviour.ctor.call(this);
        },
        Start: function (){
        },
        Update: function (){
            this.elapsed += UnityEngine.Time.get_deltaTime();
            if (this.elapsed > 1){
                var sb = new System.Text.StringBuilder.ctor();
                this.elapsed = 0;
                var v = new UnityEngine.Vector3.ctor$$Single$$Single$$Single(2, 3, 6);
                var w = new UnityEngine.Vector3.ctor$$Single$$Single$$Single(7, 23, 1);
                var n = v.get_normalized();
                var arr = [n.x, n.y, n.z];
                UnityEngine.Debug.Log$$Object(sb.AppendFormat$$String$$Object$Array("v.normalized = ({0}, {1}, {2})", arr).toString());
                sb.Remove(0, sb.get_Length());
                var cross = UnityEngine.Vector3.Cross(v, w);
                arr = [cross.x, cross.y, cross.z];
                UnityEngine.Debug.Log$$Object(sb.AppendFormat$$String$$Object$Array("Cross(v, w) = ({0}, {1}, {2})", arr).toString());
                UnityEngine.Debug.Log$$Object("v.magnitude = " + v.get_magnitude());
                UnityEngine.Debug.Log$$Object("w.magnitude = " + w.get_magnitude());
                UnityEngine.Debug.Log$$Object("Dot(v, w) = " + UnityEngine.Vector3.Dot(v, w));
                UnityEngine.Debug.Log$$Object("Angle(v, w) = " + UnityEngine.Vector3.Angle(v, w));
                var proj = UnityEngine.Vector3.Project(v, w);
                UnityEngine.Debug.Log$$Object("Project(v,w) = " + proj.toString());
                v.Normalize();
                w.Normalize();
                UnityEngine.Debug.Log$$Object("normalized v = " + v.toString());
                UnityEngine.Debug.Log$$Object("normalized w = " + w.toString());
            }
        }
    }
};
JsTypes.push(V3Test);

 

这个文件是由 SharpKit 工程生成的，并不是手写的。

一个 JsType 用于定义一个类。里面的字段通常有：

• fullname：表示此类的全名，也包含名字空间。V3Test 没有名字空间，所以就没有
• baseTypeName：父类的名字。在后续的步骤中，会用于实现继承。
• Kind：通常是 "Class"，表示这是一个类。也可以是 "Struct" 或 "Enum"
• definition：表示实例函数以及实例的 Property，以及构造函数。ctor表示构造函数。V3Test 只有 Start 和 Update 2个函数，是 MonoBehaviour 典型的2个函数。
• staticDefinition：表示静态函数。
• fields：实例字段。
• staticFields：静态字段。
• interfaceNames：接口的名字，是一个数组

可以看到，每一个类的文件，都是定义一个 JsType，文件最后把他 push 进 JsTypes 数组。

放到 JsTypes 数组干嘛呢？

includes.javascript 里有 require SharpKit/myclrhandler.javascript。可以打开这个文件看一下。这个文件里最重要的一句代码是：

Compile();

Compile 函数的定义是在 SharpKit/jsclr.javascript 中。有兴趣的可以看一下源代码。

Compile 主要做了2件事：

1. 设置全局对象，使你可以访问这些类。比如说 你可以使用 UnityEngine.GameObject 来访问这个类。
2. 处理继承关系。比如说，V3Test并没有定义 gameObject 这个属性，但是在 V3Test 中是可以 this.gameObject 访问的。

 

返回：Unity代码热更新方案 JSBinding + SharpKit 首页