一個新的、開源的、可擴展的、與平台無關的工具,用於遠端調試和測試 JavaScript。由node.js 和socket.io 提供支援。
觀看此影片 20 分鐘內了解有關 Vorlon.js 的所有內容:https://channel9.msdn.com/Shows/codechat/046
在 VorlonJS 了解更多!
在 slack 上與我們聊天(點擊下面的徽章即可獲得免費邀請)
從 npm 安裝並執行 Vorlon.JS 伺服器:
$ npm i -g vorlon
$ vorlon
With the server is running, open http://localhost:1337 in your browser to see the Vorlon.JS dashboard.
您可能會注意到來自 Python、node-gyp 和 socket.io 的錯誤。這是已向 socket.io 團隊報告的已知問題。這不是一個阻塞問題,因為即使出現此錯誤,socket.io 仍然可以正常工作:)
[Linux]
$ PORT=3000 vorlon
[視窗]
c: > SET PORT=3000 && vorlon
//Vorlon listening on port 3000
最後一步是透過將其新增至您的應用程式來啟用 Vorlon.JS:
< script src =" http://localhost:1337/vorlon.js " > </ script >
如果您想執行支援 SSL 的伺服器,請依照下列步驟操作:
Azure 託管的 config.json 檔案範例
{
"baseURL": "",
"useSSLAzure": true,
"useSSL": false,
"SSLkey": "cert/server.key",
....
...
}
預設情況下,具有調試等級的 Vorlon.JS 應用程式日誌和檔案儲存在安裝資料夾中。如果您想自訂日誌,請按以下步驟操作:
[Windows]
C:>cd %HOMEPATH%node_modulesvorlon
C:UsersUsernamenode_modulesvorlon>notepad Server/config.json
## JSON FILE ##
{
"useSSL": true,
"SSLkey": "server/cert/server.key",
"SSLcert": "server/cert/server.crt",
"includeSocketIO": true,
"plugins": [
{ "id": "CONSOLE", "name": "Interactive Console", "panel": "bottom", "foldername" : "interactiveConsole", "enabled": true},
{ "id": "DOM", "name": "Dom Explorer", "panel": "top", "foldername" : "domExplorer", "enabled": true },
{ "id": "MODERNIZR", "name": "Modernizr","panel": "bottom", "foldername" : "modernizrReport", "enabled": true },
{ "id" : "OBJEXPLORER", "name" : "Obj. Explorer","panel": "top", "foldername" : "objectExplorer", "enabled": true },
{ "id" : "XHRPANEL", "name" : "XHR","panel": "top", "foldername" : "xhrPanel", "enabled": true },
{ "id" : "NGINSPECTOR", "name" : "ngInspector","panel": "top", "foldername" : "ngInspector", "enabled": false }
],
"logs": {
"level" : "info",
"enableConsole" : true,
"filePath" : "E:\temp",
"vorlonLogFileName": "vorlonjs.log",
"exceptionsLogFileName": "exceptions.log"
}
}
C:UsersUsernamenode_modulesvorlon>vorlon
Vorlon with SSL listening on port 1337
With the server is running, open https://localhost:1337 in your browser to see the Vorlon.JS dashboard.
最後一步是透過將其新增至您的應用程式來啟用 Vorlon.JS:
< script src =" https://localhost:1337/vorlon.js " > </ script >
閱讀有關 Vorlon.JS 的更多文檔,並在 http://vorlonjs.com/documentation 編寫您自己的插件。
如果您希望使用 Vorlon.JS 的伺服器或核心插件程式碼,您需要克隆此目錄並在其中工作。
Vorlon 用 typescript 寫,用 gulp 編譯。主要有兩個目錄:
儲存庫的根資料夾中有一個gulpfile.js
。它包含將 typescript 編譯為 javascript 以供插件和伺服器使用的 gulp 任務。此外,它還確保將編譯的插件程式碼複製到Server
目錄中的正確位置。
要編譯所有內容(插件,然後是伺服器),請執行以下命令:
gulp
若要僅編譯插件,請執行以下命令:
gulp default-plugins
若要僅編譯伺服器,請執行以下命令:
gulp default-server
運行 Vorlon.JS 最簡單的方法是從根目錄執行npm start
。這將運行兩個 gulpfiles 來編譯打字稿並啟動伺服器。
您也可以單獨執行 gulp 指令。如果您特別希望使用插件,這非常有用,因為gulp watch
會自動為您編譯打字稿。
如果你想從命令列運行gulp
命令,你需要先在你的系統上全域安裝 gulp:
$ npm install -g gulp
現在,您可以在根目錄中執行gulp watch-plugins
gulp watch
,讓 gulp 自動gulp watch-server
typescript 編譯為 javascript。
有一個演示網頁,其中包含 vorlon 程式碼,您可以打開該程式碼來測試儀表板行為。它位於 ./Plugins/samples/index.html。 Plugins
gulpfile 中有一個 gulptask 來託管它,只需執行gulp webserver
,然後導航到 http://localhost:1338/index.html 即可查看頁面。
對於 Visual Studio 用戶,我們透過 VorlonJS.sln 提供整合解決方案。為了與 Node.js 交互,您只需安裝 NodeJS Tool for Visual Studio 外掛程式。安裝插件後,只需打開解決方案,您就可以為 Vorlon.js 進行開發了
Visual Studio Code是一個全新的程式碼編輯器,它是跨平台的、免費的、輕量級的!可以進行node.js調試,還有intelliSense等等(更多關於這方面的內容請參見Code Website)。還有一個任務工作流程集成,我們在儲存庫中為您準備了一個文件,其中包含所有內容,以便您能夠按 Ctrl+Shift+B 來運行 gulp 文件中的預設任務。
進行更改後,您可以提交並向此儲存庫提交拉取請求。如果您希望合併您的更改,您還需要以電子方式簽署 Microsoft 貢獻者授權協議 (CLA)。
提交變更時,請確保不提交已編譯的 JavaScript 檔案(從 TypeScript 編譯的檔案),僅應提交原始 TypeScript 檔案。
閱讀 CONTRIBUTING.md 以了解有關為 Vorlon.JS 做出貢獻的更多資訊。
Vorlon.JS 是根據 MIT 許可證發布的。請參閱許可證以了解完整詳細資訊。