Alat baru, sumber terbuka, dapat diperluas, dan agnostik platform untuk melakukan debug dan menguji JavaScript Anda dari jarak jauh. Didukung oleh node.js dan socket.io.
Pahami semua tentang Vorlon.js dalam 20 menit dengan menonton video ini : https://channel9.msdn.com/Shows/codechat/046
Pelajari lebih lanjut di VorlonJS!
Ngobrol dengan kami saat slack (dapatkan undangan gratis dengan mengklik lencana di bawah)
Instal dan jalankan server Vorlon.JS dari npm:
$ npm i -g vorlon
$ vorlon
With the server is running, open http://localhost:1337 in your browser to see the Vorlon.JS dashboard.
Anda mungkin melihat kesalahan dari Python, node-gyp dan socket.io. Ini adalah masalah umum yang telah dilaporkan ke tim socket.io. Ini bukan masalah pemblokiran karena socket.io masih berfungsi dengan baik meskipun dengan kesalahan ini :)
[Linux]
$ PORT=3000 vorlon
[jendela]
c: > SET PORT=3000 && vorlon
//Vorlon listening on port 3000
Langkah terakhir adalah mengaktifkan Vorlon.JS dengan menambahkan ini ke aplikasi Anda:
< script src =" http://localhost:1337/vorlon.js " > </ script >
Jika Anda ingin menjalankan server dengan dukungan SSL, lakukan hal berikut:
Contoh file config.json yang dihosting Azure
{
"baseURL": "",
"useSSLAzure": true,
"useSSL": false,
"SSLkey": "cert/server.key",
....
...
}
Secara default log aplikasi Vorlon.JS dengan tingkat debug dan file disimpan di folder instalasi. Jika Anda ingin menyesuaikan log, lakukan sebagai berikut:
[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.
Langkah terakhir adalah mengaktifkan Vorlon.JS dengan menambahkan ini ke aplikasi Anda:
< script src =" https://localhost:1337/vorlon.js " > </ script >
Baca dokumentasi lebih lanjut tentang Vorlon.JS, dan menulis plugin Anda sendiri di http://vorlonjs.com/documentation.
Jika Anda ingin bekerja di server Vorlon.JS atau kode plugin inti, Anda harus mengkloning direktori ini dan bekerja di dalamnya.
Vorlon ditulis dalam skrip ketikan, yang dikompilasi dengan gulp. Ada dua direktori utama:
Ada gulpfile.js
di folder root repositori. Ini berisi tugas gulp untuk mengkompilasi skrip ketikan ke javascript untuk plugin dan server. Selain itu, ini memastikan bahwa kode plugin yang dikompilasi disalin ke tempat yang tepat di direktori Server
.
Untuk mengkompilasi semuanya (plugin, lalu server) jalankan ini:
gulp
Untuk mengkompilasi hanya plugin, jalankan ini:
gulp default-plugins
Untuk mengkompilasi hanya server, jalankan ini:
gulp default-server
Cara paling sederhana untuk menjalankan Vorlon.JS adalah dengan menjalankan npm start
dari direktori root. Ini akan menjalankan kedua gulpfile untuk mengkompilasi skrip ketikan dan memulai server.
Anda juga dapat menjalankan perintah gulp satu per satu. Ini berguna jika Anda ingin bekerja pada plugin khususnya, karena gulp watch
akan mengkompilasi skrip ketikan untuk Anda secara otomatis.
Jika Anda ingin menjalankan perintah gulp
dari baris perintah, Anda harus terlebih dahulu menginstal gulp secara global di sistem Anda dengan:
$ npm install -g gulp
Anda sekarang dapat menjalankan gulp watch
di direktori root agar gulp mengkompilasi skrip ketikan ke javascript secara otomatis. Anda juga dapat menjalankan gulp watch-plugins
atau gulp watch-server
untuk hanya menonton dan mengkompilasi plugin atau server.
Ada halaman web demo yang menyertakan kode vorlon yang dapat Anda buka untuk menguji perilaku dasbor. Itu ada di ./Plugins/samples/index.html. Ada gulptask di Plugins
gulpfile untuk menampungnya, jalankan saja gulp webserver
, lalu navigasikan ke http://localhost:1338/index.html untuk melihat halamannya.
Bagi pengguna Visual Studio, kami menyediakan solusi terintegrasi melalui VorlonJS.sln. Untuk berinteraksi dengan Node.js, Anda hanya perlu menginstal plugin NodeJS Tool for Visual Studio. Setelah plugin diinstal, cukup buka solusinya dan Anda akan siap mengembangkan untuk Vorlon.js
Visual Studio Code adalah editor kode baru yang bersifat lintas platform, gratis dan ringan! Anda bisa melakukan debugging node.js, ada intelliSense dan sebagainya (lebih lanjut tentang ini di Code Website). Ada juga integrasi alur kerja tugas dan kami menyiapkan Anda file di repo yang berisi semuanya agar Anda dapat menekan Ctrl+Shift+B untuk menjalankan tugas default di file gulp.
Setelah Anda melakukan perubahan, Anda dapat mengkomit dan mengirimkan permintaan tarik ke repositori ini. Anda juga harus menandatangani Perjanjian Lisensi Kontributor Microsoft (CLA) secara elektronik jika Anda ingin perubahan Anda digabungkan.
Saat melakukan perubahan, pastikan bahwa file JavaScript yang dikompilasi (yang dikompilasi dari TypeScript) tidak dikomit, hanya file TypeScript asli yang harus dikomit.
Baca CONTRIBUTING.md untuk informasi lebih lanjut tentang berkontribusi pada Vorlon.JS.
Vorlon.JS dirilis di bawah lisensi MIT. Silakan lihat LISENSI untuk rincian selengkapnya.