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は引き続き正常に動作するため、これはブロック的な問題ではありません:)
【リナックス】
$ PORT=3000 vorlon
【Windows】
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 >
http://vorlonjs.com/documentation で、Vorlon.JS に関する詳細ドキュメントを参照し、独自のプラグインを作成してください。
Vorlon.JS のサーバーまたはコア プラグイン コードで作業したい場合は、このディレクトリのクローンを作成してその中で作業する必要があります。
Vorlon は typescript で書かれており、gulp でコンパイルされます。メイン ディレクトリは 2 つあります。
リポジトリのルート フォルダーにgulpfile.js
があります。これには、プラグインとサーバー用に typescript を javascript にコンパイルする gulp タスクが含まれています。さらに、コンパイルされたプラグイン コードがServer
ディレクトリ内の適切な場所に確実にコピーされます。
すべて (プラグイン、次にサーバー) をコンパイルするには、これを実行します。
gulp
プラグインのみをコンパイルするには、これを実行します。
gulp default-plugins
サーバーのみをコンパイルするには、これを実行します。
gulp default-server
Vorlon.JS を実行する最も簡単な方法は、ルート ディレクトリからnpm start
を実行することです。これにより、両方の gulpfile が実行されて typescript がコンパイルされ、サーバーが起動されます。
gulp コマンドを個別に実行することもできます。 gulp watch
typescript を自動的にコンパイルしてくれるため、特にプラグインで作業したい場合に便利です。
コマンドラインからgulp
コマンドを実行したい場合は、まず次のコマンドを使用してシステムに gulp をグローバルにインストールする必要があります。
$ npm install -g gulp
ルート ディレクトリでgulp watch
実行すると、gulp で typescript を javascript に自動的にコンパイルできるようになりました。 また、 gulp watch-plugins
またはgulp watch-server
実行して、プラグインまたはサーバーの監視とコンパイルのみを行うこともできます。
vorlon コードを含むデモ Web ページがあり、これを開いてダッシュボードの動作をテストできます。これは ./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 などもあります (これについては、コード Web サイトを参照してください)。タスク ワークフローの統合もあり、Ctrl+Shift+B を押して gulp ファイル内のデフォルト タスクを実行できるように、すべてを含むファイルをリポジトリに用意しました。
変更を加えたら、このリポジトリにプル リクエストをコミットして送信できます。変更をマージしたい場合は、Microsoft 貢献者ライセンス契約 (CLA) に電子署名する必要もあります。
変更をコミットするときは、コンパイルされた JavaScript ファイル (TypeScript からコンパイルされたファイル) がコミットされないようにし、元の TypeScript ファイルのみをコミットする必要があります。
Vorlon.JS への貢献の詳細については、CONTRIBUTING.md を参照してください。
Vorlon.JS は MIT ライセンスに基づいてリリースされています。詳細についてはライセンスを参照してください。