เครื่องมือโอเพ่นซอร์สใหม่ ขยายได้ และไม่เชื่อเรื่องแพลตฟอร์ม สำหรับการดีบักและทดสอบ JavaScript ของคุณจากระยะไกล ขับเคลื่อนโดย node.js และ socket.io
เข้าใจทุกอย่างเกี่ยวกับ Vorlon.js ใน 20 นาทีโดยดูวิดีโอนี้ : https://channel9.msdn.com/Shows/codechat/046
เรียนรู้เพิ่มเติมที่ VorlonJS !
แชทกับเราแบบหย่อน (รับคำเชิญฟรีคลิกที่ป้ายด้านล่าง)
ติดตั้งและรันเซิร์ฟเวอร์ Vorlon.JS จาก npm:
$ 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
[หน้าต่าง]
c: > SET PORT=3000 && vorlon
//Vorlon listening on port 3000
ขั้นตอนสุดท้ายคือการเปิดใช้งาน Vorlon.JS โดยเพิ่มสิ่งนี้ลงในแอปของคุณ:
< script src =" http://localhost:1337/vorlon.js " > </ script >
หากคุณต้องการรันเซิร์ฟเวอร์ที่รองรับ SSL ให้ดำเนินการดังนี้:
ตัวอย่างไฟล์ config.json ที่โฮสต์โดย Azure
{
"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 ซึ่งคอมไพล์ด้วยอึก มีสองไดเรกทอรีหลัก:
มี gulpfile.js
อยู่ในโฟลเดอร์รูทของที่เก็บ มันมีงานอึกเพื่อรวบรวม typescript เป็น javascript สำหรับปลั๊กอินและเซิร์ฟเวอร์ นอกจากนี้ยังช่วยให้แน่ใจว่าโค้ดปลั๊กอินที่คอมไพล์แล้วถูกคัดลอกไปยังตำแหน่งที่ถูกต้องในไดเร็กทอรี Server
หากต้องการคอมไพล์ทุกอย่าง (ปลั๊กอิน จากนั้นเซิร์ฟเวอร์) ให้รันสิ่งนี้:
gulp
หากต้องการคอมไพล์เฉพาะปลั๊กอินให้รันสิ่งนี้:
gulp default-plugins
หากต้องการคอมไพล์เฉพาะเซิร์ฟเวอร์ให้รันสิ่งนี้:
gulp default-server
วิธีที่ง่ายที่สุดในการรัน Vorlon.JS คือการรัน npm start
จากไดเร็กทอรีรูท สิ่งนี้จะเรียกใช้ gulpfiles ทั้งสองเพื่อคอมไพล์ typescript และเริ่มต้นเซิร์ฟเวอร์
คุณยังสามารถรันคำสั่ง gulp ทีละคำสั่งได้ สิ่งนี้มีประโยชน์หากคุณต้องการทำงานกับปลั๊กอินโดยเฉพาะ เนื่องจาก gulp watch
จะรวบรวม typescript ให้คุณโดยอัตโนมัติ
หากคุณต้องการรันคำสั่ง gulp
จากบรรทัดคำสั่ง คุณจะต้องติดตั้ง gulp ในระบบของคุณก่อนด้วย:
$ npm install -g gulp
ตอนนี้คุณสามารถเรียกใช้ gulp watch
ในไดเร็กทอรีรากเพื่อให้ typescript คอมไพล์ gulp เป็น javascript โดยอัตโนมัติ คุณยังสามารถเรียกใช้ gulp watch-plugins
หรือ gulp watch-server
เพื่อรับชมและคอมไพล์ปลั๊กอินหรือเซิร์ฟเวอร์เท่านั้น
มีหน้าเว็บสาธิตที่มีโค้ด vorlon ที่คุณสามารถเปิดเพื่อทดสอบพฤติกรรมของแดชบอร์ดได้ มันอาศัยอยู่ที่ ./Plugins/samples/index.html มี gulptask ใน Plugins
gulpfile ที่จะโฮสต์มัน เพียงแค่เรียกใช้ gulp webserver
จากนั้นไปที่ http://localhost:1338/index.html เพื่อดูเพจ
สำหรับผู้ใช้ Visual Studio เรามีโซลูชันแบบรวมผ่าน VorlonJS.sln ในการโต้ตอบกับ Node.js คุณเพียงแค่ต้องติดตั้ง NodeJS Tool สำหรับปลั๊กอิน Visual Studio เมื่อติดตั้งปลั๊กอินแล้ว เพียงเปิดโซลูชันแล้วคุณก็พร้อมที่จะพัฒนาสำหรับ Vorlon.js
Visual Studio Code เป็นตัวแก้ไขโค้ดใหม่ที่สมบูรณ์แบบซึ่งข้ามแพลตฟอร์มได้ฟรีและเบาเหมือนนรก! คุณสามารถทำการดีบัก node.js ได้ มี IntelliSense และอื่นๆ (เพิ่มเติมเกี่ยวกับสิ่งนี้บนเว็บไซต์ Code) นอกจากนี้ยังมีการผสานรวมเวิร์กโฟลว์งาน และเราได้เตรียมไฟล์ให้คุณใน repo ซึ่งมีทั้งหมดเพื่อให้คุณสามารถกด Ctrl+Shift+B เพื่อรันงานเริ่มต้นในไฟล์ gulp
เมื่อคุณทำการเปลี่ยนแปลงแล้ว คุณสามารถคอมมิตและส่งคำขอดึงข้อมูลไปยังที่เก็บนี้ได้ คุณจะต้องลงนามในข้อตกลง Microsoft Contributor License Agreement (CLA) ทางอิเล็กทรอนิกส์ หากคุณต้องการให้การเปลี่ยนแปลงของคุณถูกรวมเข้าด้วยกัน
เมื่อทำการเปลี่ยนแปลง ตรวจสอบให้แน่ใจว่าไฟล์ JavaScript ที่คอมไพล์แล้ว (ที่คอมไพล์จาก TypeScript) ไม่ได้ถูกคอมมิต ควรคอมมิตเฉพาะไฟล์ TypeScript ดั้งเดิมเท่านั้น
อ่าน CONTRIBUTING.md เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการมีส่วนร่วมใน Vorlon.JS
Vorlon.JS เปิดตัวภายใต้ใบอนุญาต MIT โปรดดูใบอนุญาตสำหรับรายละเอียดทั้งหมด