一个新的、开源的、可扩展的、与平台无关的工具,用于远程调试和测试 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
,让 gulp 自动将 typescript 编译为 javascript。您还可以运行gulp watch-plugins
或gulp watch-server
来仅监视和编译插件或服务器。
有一个演示网页,其中包含 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 许可证发布的。请参阅许可证了解完整详细信息。