老版本鏈接如下:http://www.cnblogs.com/answerwinner/p/4469021.html
新用戶不要再使用老版本了。
新版本 JSBinding 將拋棄 SharpKit 轉而使用 Bridge.NET(老版本仍然維護)。
理由是
1. 把 C# 編譯成 Js 后,Bridge 幾乎100%確定轉換后可運行。
Bridge 在編譯時不允許引用外部 Dll(System.dll也不行)。允許使用的 C# Api 都是 Bridge 已嚴格測試過的。一般來說,編譯能過,就能跑。SharpKit 的 C# 源代碼和 Js 源代碼都比較混亂。在最初引入 SharpKit 后,群主做了大量的修補工作,仍然存在遺漏的可能。而后者不管是 C# 還是 Js,都特別嚴謹。
Bridge 在 Js 端對 C# 類型系統進行了很完整的模擬。
解決了 SharpKit 存在的許多問題。例如:塊作用域閉包問題,64位整數支持。
2. Bridge 對許多 C# 庫都進行了支持。例如,你可以在 C# 中使用正則表達式,可以使用 Linq 等。
3. Bridge 生成的代碼更好看,更嚴謹。
4. SharpKit 已經不維護了,Bridge.NET 仍在持續維護並有論壇可討論問題。我問過兩三個問題,都是當天回復。
JSBinding+SharpKit 和 JSBining+Bridge.NET 的區別和聯系
前者有替換 C# MonoBehaviour 為 Js MonoBehaviour 的功能。后者沒有,他不允許在 gameObject 上掛邏輯代碼的 MonoBehaviour,偏向於把框架代碼和邏輯代碼分在2個不同的工程。
試用步驟:
1. 先安裝 VS2015(原因是 Bridge 源代碼使用了 C#6.0)。可以從這里下載:https://www.visualstudio.com/zh-hans/downloads/
2. 自己試玩一下 Bridge.NET。可以從這里下載:http://bridge.net/download/,下載第1項即可,即 Bridge.NET.15.3.0.vsix。下載完后安裝。使用起來很簡單的,看一下Bridge的文檔:http://bridge.net/docs/。
3. 還可以下載 Bridge 源代碼:https://github.com/bridgedotnet/Bridge
在試玩過 Bridge 后應該對 Bridge 有一點點了解了。
4. 下載 JSB + Bridge 代碼(最好用 git 克隆):https://github.com/qcwgithub/qjsbunitynew_bridge
目錄說明
UnityProjCs
純 C# 版本 Unity 工程。里面(幾乎)沒有 JSB 的任何東西。代碼都在 Assets\Scripts\ 下。其中,GameFramework 是框架代碼,GameLogic 是邏輯代碼。他們的關系是,框架代碼不可以訪問邏輯代碼。為了方便制作 Js 版本,Assets\ 下最好都以文件夾組織,不要放文件,Assets\GameIcon 只是演示。
簡稱Cs工程。
UnityProjJs
Js 版本的 Unity 工程。這個工程在初始化之前,里面就只有 JSB 相關的東西。
簡稱Js工程。
BridgeProj
這是 Bridge 工程,用於把 C# 代碼編譯為 Js 代碼。安裝好 VS2015 和 Bridge 插件后,直接雙擊 BridgeProj.sln 打開即可。
簡稱 Bridge工程。
Cs Demo 運行步驟
1. 用 Unity 打開 Cs工程
2. 打開 Scenes/Demo 場景
3. Play
Js Demo 運行步驟
1. 運行 1_link.bat
2. 用 Unity 打開 Js工程
3. Build Settings 切換平台至 PC
4. 點擊菜單 JSB | Gen Bindings。這一步的產出有3個:(注意點1)
- UnityProjJs/Assets/Scripts/JSBinding/G/
- UnityProjJs/Assets/StreamingAssets/JavaScript/Gen1.javascript
- BridgeProj/csw.cs (?)
5. 用 VS2015 打開 BridgeProj 工程並編譯。將生成 Js 代碼,產出的 Js 文件在 BridgeProj/Bridge/output/下
6. 回到 UnityProjJs,點擊菜單 JSB | Update JavaScript。這一步會拷貝上一步的 Js 文件內容到 StreamingAssets/JavaScript/Gen2.javascript
7. 拷貝 UnityProjJs/Assets/Plugins/ x86 或 x86_64 /mozjs-31.dll 至 Unity安裝目錄 Editor 下
8. 打開 Scenes/Demo 場景
9. Play
這個設計是不允許 GameObject 上掛腳本的(Framework的腳本是可以的),也就是說 Prefab 和 邏輯代碼不會有靜態依賴關系。UnityProjJs 工程只能見到 Js 版本的邏輯代碼。
BridgeProj/csw.cs 是什么?
在 Bridge 工程里是不允許引用外部 Dll 的,只能放源代碼。所以就生成這么一個文件,放置框架代碼的空實現文件。
如何同時維護游戲的 C# 版本和 Js 版本
運行 1_link.bat 后,會將 Cs 工程中的除邏輯代碼以外的所有東西映射至 Js 工程中,邏輯代碼則以 Js 文本文件的形式注入到 Js 工程中,這樣就得到了 Js 版本的游戲。
你需要自己修改 1_link.bat 來自定義要映射哪些東西。
因為只能映射文件夾不能映射文件,所以 Cs 工程 Assets\ 下都要以文件夾形式組織,不要直接放文件。
另外注意,在 BridgeProj 和 UnityProjJs 工程中都定義了 "JS" 編譯符號。有一些代碼只能跑在 Js ,只好加個符號來區分是哪種版本,如果不樂意可以干掉。
未解決問題
- 目前JSComponent只能響應一部分腳本事件,例如 Awake、Start。如果需要響應其他事件,例如 OnWillRenderObject,一種方式是增加新的 JSComponentXX(繼承 JSComponent),然后在 AddComponent 時,指定要用哪個。我會加入一個示例來演示怎么做。但這只是一種方式,可根據需要自定義實現。
注意點1:如果你切換平台(如從 Windows 切換為 iOS),需要重新執行 JSB | Gen Bindings,並去 BridgeProj 重新編譯生成 Js,然后再回 Unity 執行 JSB | Update JavaScript
List.Find
List.RemoveAll
Dictionary<,>.Enumerator
常見問題
運行后,報錯:Bridge.javascript(2640): Error: Y.inherits[0] is null!
Bridge 有一個已知問題是 Gen2.javascript 里的類順序不對。比如說 X 是 Y 的父類,Y.inherits[0] 就是 X。在 Gen2.javascript 里如果 Y 在 X 前面的話,就會報這個錯。
解決辦法:先手動調整一下順序,把 X 放前面。
如何使用此框架
此框架的主要思路是讓 Cs和Js版本(以下簡稱“2種版本”)同時可維護,任何時候想跑其中一種版本都是可以的。2種版本的區別和聯系:
- Cs版本的邏輯代碼是C#代碼,Js版本的邏輯代碼是Js代碼
- Js版本一開始是沒有任何資源的,只有 JSB 本身的源代碼。1_link.bat 從Cs工程映射文件夾到Js版本中,從而使Js版本“獲得”了Cs版本中的所有的資源。這些映射不包括對邏輯代碼的映射。邏輯代碼是從Cs工程映射到BridgeProj工程中,產出Js代碼,注入到Js工程中。
- 2種版本的Prefab是一模一樣的。都可以掛腳本(ScriptAgent),都可以在Inspector里給public變量賦值。ScriptAgent自動處理2種版本的差異性,用戶無需關心。
Js版本中目前腳本都是放在 StreamingAssets 下,只是為了Demo運行方便。這個目錄在安卓或蘋果上都是不可寫的,因此不適合熱更新。實現整個更新流程還需要自己打包 asset bundle 等,你需要自己決定把 Js 代碼放到另一個位置。
編譯iOS可能遇到鏈接錯誤,嘗試添加這2個庫(感謝@那個少年)
- libz.1.dylib
- libstdc++.6.0.9.dylib
更多文章:
JSBinding+Bridge.Net:框架代碼與邏輯代碼的關系
JSBinding+Bridge.NET:Inspector拖變量支持(!)
有任何問題請在群里提出,或私聊群主。