أداة جديدة مفتوحة المصدر وقابلة للتوسيع وغير مرتبطة بالنظام الأساسي لتصحيح أخطاء JavaScript واختبارها عن بُعد. مدعوم من Node.js وsocket.io.
افهم كل شيء عن Vorlon.js في 20 دقيقة بمشاهدة هذا الفيديو: https://channel9.msdn.com/Shows/codechat/046
تعلم المزيد في VorlonJS!
تحدث معنا على Slack (احصل على دعوة مجانية بالنقر على الشارة أدناه)
تثبيت وتشغيل خادم 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. هذه مشكلة معروفة تم الإبلاغ عنها بالفعل لفريق المقبس.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 مكتوب بخط الآلة الكاتبة، والذي تم تجميعه باستخدام gulp. هناك مجلدان رئيسيان:
يوجد gulpfile.js
في المجلد الجذر للمستودع. أنه يحتوي على مهام gulp لتجميع TypeScript إلى JavaScript للمكونات الإضافية والخادم. بالإضافة إلى ذلك، فإنه يضمن نسخ رمز البرنامج المساعد المترجم إلى المكان الصحيح في دليل 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. توجد مهمة gulptask في ملف Plugins
gulpfile لاستضافتها، فقط قم بتشغيل gulp webserver
، ثم انتقل إلى http://localhost:1338/index.html لعرض الصفحة.
بالنسبة لمستخدمي Visual Studio، نحن نقدم حلاً متكاملاً من خلال VorlonJS.sln. للتفاعل مع Node.js، تحتاج فقط إلى تثبيت أداة NodeJS للمكون الإضافي Visual Studio. بمجرد تثبيت المكون الإضافي، ما عليك سوى فتح الحل وستكون جاهزًا للتطوير لـ Vorlon.js
Visual Studio Code هو محرر أكواد جديد تمامًا وهو متعدد المنصات، وهو مجاني وخفيف للغاية! يمكنك إجراء تصحيح أخطاء Node.js، وهناك IntelliSense وما إلى ذلك (المزيد حول هذا على موقع Code). يوجد أيضًا تكامل لسير عمل المهام وقد قمنا بإعداد ملف في الريبو يحتوي على كل شيء لتتمكن من الضغط على Ctrl+Shift+B لتشغيل المهمة الافتراضية في ملف gulp.
بمجرد إجراء التغيير، يمكنك الالتزام وإرسال طلب سحب إلى هذا المستودع. ستحتاج أيضًا إلى التوقيع إلكترونيًا على اتفاقية ترخيص Microsoft Contributor (CLA) إذا كنت ترغب في دمج التغييرات.
عند تنفيذ التغييرات، تأكد من عدم الالتزام بملفات JavaScript المجمعة (تلك التي تم تجميعها من TypeScript)، ويجب الالتزام بملفات TypeScript الأصلية فقط.
اقرأ CONTRIBUTING.md لمزيد من المعلومات حول المساهمة في Vorlon.JS.
تم إصدار Vorlon.JS بموجب ترخيص MIT. يرجى الاطلاع على الترخيص للحصول على التفاصيل الكاملة.