Vorlonjs
0.5.4
Un nouvel outil open source, extensible et indépendant de la plate-forme pour déboguer et tester à distance votre JavaScript. Propulsé par node.js et socket.io.
Comprenez tout sur Vorlon.js en 20 minutes en regardant cette vidéo : https://channel9.msdn.com/Shows/codechat/046
Apprenez-en plus sur VorlonJS !
Discutez avec nous sur Slack (obtenez une invitation gratuite en cliquant sur le badge ci-dessous)
Installez et exécutez le serveur Vorlon.JS depuis npm :
$ npm i -g vorlon
$ vorlon
With the server is running, open http://localhost:1337 in your browser to see the Vorlon.JS dashboard.Vous remarquerez peut-être des erreurs de Python, node-gyp et socket.io. Il s'agit d'un problème connu déjà signalé à l'équipe socket.io. Ce n'est pas un problème de blocage car socket.io fonctionne toujours bien même avec cette erreur :)
[Linux]
$ PORT=3000 vorlon[Fenêtres]
c: > SET PORT=3000 && vorlon //Vorlon listening on port 3000La dernière étape consiste à activer Vorlon.JS en ajoutant ceci à votre application :
< script src =" http://localhost:1337/vorlon.js " > </ script > Si vous souhaitez exécuter le serveur avec le support SSL, procédez comme suit :
Exemple de fichier config.json hébergé par Azure
{
"baseURL": "",
"useSSLAzure": true,
"useSSL": false,
"SSLkey": "cert/server.key",
....
...
} Par défaut, les journaux d'application Vorlon.JS avec le niveau de débogage et les fichiers sont stockés dans le dossier d'installation. Si vous souhaitez personnaliser les logs, procédez comme suit :
[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.La dernière étape consiste à activer Vorlon.JS en ajoutant ceci à votre application :
< script src =" https://localhost:1337/vorlon.js " > </ script > Lisez la documentation supplémentaire sur Vorlon.JS et écrivez vos propres plugins sur http://vorlonjs.com/documentation.
Si vous souhaitez travailler sur le serveur de Vorlon.JS ou sur le code du plugin principal, vous devrez cloner ce répertoire et y travailler.
Vorlon est écrit en dactylographie, qui est compilé avec gulp. Il existe deux répertoires principaux :
Il y a un gulpfile.js dans le dossier racine du référentiel. Il contient des tâches gulp pour compiler du typescript en javascript pour les plugins et le serveur. De plus, cela garantit que le code du plugin compilé est copié au bon endroit dans le répertoire Server .
Pour tout compiler (plugins, puis serveur) exécutez ceci :
gulp
Pour compiler uniquement les plugins, exécutez ceci :
gulp default-plugins
Pour compiler uniquement le serveur, exécutez ceci :
gulp default-server
Le moyen le plus simple d'exécuter Vorlon.JS est d'exécuter npm start à partir du répertoire racine. Cela exécutera les deux fichiers gulp pour compiler le texte dactylographié et démarrer le serveur.
Vous pouvez également exécuter les commandes gulp individuellement. Ceci est utile si vous souhaitez travailler sur des plugins en particulier, car gulp watch compilera automatiquement le dactylographe pour vous.
Si vous souhaitez exécuter des commandes gulp à partir de la ligne de commande, vous devrez d'abord installer gulp globalement sur votre système avec :
$ npm install -g gulp Vous pouvez maintenant exécuter gulp watch dans le répertoire racine pour que gulp compile automatiquement le typescript en javascript. Vous pouvez également exécuter gulp watch-plugins ou gulp watch-server pour surveiller et compiler uniquement les plugins ou le serveur.
Il existe une page Web de démonstration qui inclut le code Vorlon que vous pouvez ouvrir pour tester le comportement du tableau de bord. Il réside dans ./Plugins/samples/index.html. Il y a une tâche gulptask dans le fichier gulp Plugins pour l'héberger, exécutez simplement gulp webserver , puis accédez à http://localhost:1338/index.html pour afficher la page.
Pour les utilisateurs de Visual Studio, nous proposons une solution intégrée via VorlonJS.sln. Pour interagir avec Node.js, il vous suffit d'installer le plugin NodeJS Tool for Visual Studio. Une fois le plugin installé, ouvrez simplement la solution et vous serez prêt à développer pour Vorlon.js
Visual Studio Code est un tout nouvel éditeur de code multiplateforme, gratuit et léger comme l'enfer ! Vous pouvez effectuer le débogage node.js, il existe intelliSense et ainsi de suite (plus d'informations à ce sujet sur le site Web de Code). Il existe également une intégration de workflow de tâches et nous vous avons préparé un fichier dans le dépôt qui contient tout pour que vous puissiez appuyer sur Ctrl+Shift+B pour exécuter la tâche par défaut dans le fichier gulp.
Une fois que vous avez apporté une modification, vous pouvez valider et soumettre une pull request à ce référentiel. Vous devrez également signer électroniquement le contrat de licence de contributeur Microsoft (CLA) si vous souhaitez que vos modifications soient fusionnées.
Lors de la validation des modifications, assurez-vous que les fichiers JavaScript compilés (ceux compilés à partir de TypeScript) ne sont pas validés, seuls les fichiers TypeScript d'origine doivent être validés.
Lisez CONTRIBUTING.md pour plus d'informations sur la contribution à Vorlon.JS.
Vorlon.JS est publié sous la licence MIT. Veuillez consulter LICENCE pour plus de détails.
