---

Octobre 2015

Volume 30, numéro 10

Cet article a fait l'objet d'une traduction automatique.

ASP.NET - ASP.NET 5 Partout avec OmniSharp et Yeoman

Par Sayed Ibrahim Ibrahim | Octobre 2015

Comme les équipes de développement ont se diversifient dans leurs choix d'outils, structures doivent également fournir des choix sans friction. ASP.NET 5 a adopté la prise en charge inter-plateformes, notamment le développement via open source outils tels que OmniSharp et l'hébergement dans Microsoft Azure à l'aide de conteneurs tels que Docker. Dans cet article, nous allons vous montrer comment vous pouvez commencer avec ASP.NET 5 sur la plate-forme de votre choix. Nous traiterons tous dont vous avez besoin pour commencer le développement d'applications Web avec ASP.NET 5.

Route un projet peuvent être difficiles, comme le développement d'applications Web modern est également truffé de choix. En tant qu'un utilisateur de Visual Studio, vous pourriez avoir été presque endommagé en bénéficiant de l'IDE, les modèles intégrés et des outils comme Web Essentials pour vous aider à obtenir un nouveau projet sur le sol. Mais ne pas à l'aide de Windows et un IDE riche, tel que Visual Studio, les développeurs utilisaient généralement des outils de ligne de commande Yeoman, rébarbative choses ou Node.js à construire et à générer des applications Web. Maintenant ASP.NET 5 a été reconstruite dès le départ avec toutes les plates-formes à l'esprit, l'approche « choix est roi » pour les outils de développement. Maintenant vous pouvez l'utiliser pour vos projets Windows, mais également pour Linux et OS X. Voici un bref coup de œil à la configuration et la création d'un projet à partir d'une perspective Windows système d'exploitation à l'aide d'ASP.NET 5.

Configuration de votre environnement

Vous aurez besoin de quelques pièces pour obtenir votre environnement configuré, mais le processus est bien documenté pour OS X et Linux. Vous trouverez des instructions détaillées sur bit.ly/1Ljhj68. Pour cet article, nous supposerons que la plupart d'entre vous utilisez OS X.

La première étape consiste à installer les outils que nous allons utiliser pour créer notre application Web de 5 ASP.NET. Finalement, CoreCLR (github.com/dotnet/coreclr) sera l'exécution de l'infrastructure de base. Pour le moment, cependant, ASP.NET 5 nécessite toujours le runtime Mono. Pour installer Mono, utilisez HomeBrew (brew.sh) :

$ brew install mono

Ensuite, installez le Gestionnaire de Version .NET (DNVM), un ensemble d'utilitaires de ligne de commande qui vous permet de mettre à jour et configurer votre environnement d'exécution .NET (DNX), qui permet essentiellement de développement interplateforme à l'aide du .NET Core 5 (docs.asp.net/en/latest/dnx/). Pour installer DNVM et DNX depuis votre terminal, exécutez les commandes suivantes :

$ brew tap aspnet/dnx
$ brew update
$ brew install dnvm

Maintenant, vous avez installé le runtime Mono, ainsi que les DNVM et les DNX. Pour vérifier votre version DNVM, tapez « $ dnvm » au terminal, comme indiqué dans Figure 1. Notez que si votre interpréteur de commandes ne reconnaît pas la commande dnvm, vous devrez peut-être exécuter « source dnvm.sh » pour le charger.

Figure 1 la vérification de la Version DNVM

Choix d'un éditeur

Si vous utilisez Windows, ne pas largement débattue ; vous allez utiliser une version de Visual Studio. Toutefois, sur OS X ou Linux, vous avez un nombre de choix, à partir d'un simple éditeur de texte comme TextMate à divers éditeurs très utilisés tels que Sublime, Atom, Emacs ou Vim. Mais il existe un nouvel ajout à la liste des éditeurs de développement multiplateforme, Code Visual Studio (code.visualstudio.com) de Microsoft, et il est notre éditeur de choix non seulement de 5 ASP.NET, mais également pour AngularJS, Node.js et générales de développement JavaScript (voir Figure 2).

Figure 2 Page d'accueil du Code de Visual Studio

Quel que soit l'outil que vous décidez d'utiliser, la clé d'éclairage l'éditeur pour ASP.NET 5 sur OS X et Linux est OmniSharp (omnisharp.net). Code de Visual Studio est fourni avec OmniSharp intégré ; autres éditeurs ont extension ou « complément » les référentiels où le composant peut être téléchargé.

Démarrage de votre premier projet

Sans l'environnement de développement Visual Studio 2015 riche, vous devrez compter sur une approche différente pour le développement d'une application ASP.NET 5 sur OS X. Entrez Yeoman (yeoman.io) et le projet de générateur d'ASP.NET (bit.ly/1MPe5KY). Yeoman est une plateforme de génération de modèles automatique basée sur Node.js qui vous permet de créer des générateurs de basé sur le modèle pour les projets ou les fichiers de code. C'est un utilitaire de ligne de commande et car il s'appuie sur Node.js, il existe quelques dépendances que vous aurez besoin pour prendre en charge de la première.

Pour commencer, installez Node.js et le Gestionnaire de package node (NPM) via HomeBrew ou directement à partir de nodejs.org:

$ brew install node

Lorsque cette opération terminée, installez les générateurs de npm :

$ npm install -g yo generator-aspnet

Si vous n'utilisez pas déjà Bower, rébarbative ou choses, prenez ces outils. Vous devrez vous familiariser avec ces outils dans le cadre de la pile de développement modernes nouvelle (voir l'article « outils modernes de développement Web : Bower » dans ce numéro) :

$ npm install -g bower grunt-cli gulp-cli

Bower est un gestionnaire de package pour le développement Web frontal et un référentiel pour les ressources Web tels que JavaScript et CSS. Rébarbative et les choses sont des bibliothèques d'exécution de la tâche pour effectuer le processus de génération tels que la minimisation de script et d'image et transpiling (TypeScript ou CoffeeScript).

C'est tout pour installer les outils que vous avez besoin pour le développement, quel que soit l'éditeur. Maintenant, pour déclencher le nouveau type de projet, exécutez « $ yo aspnet » pour initialiser la Yeoman generator et sélectionnez le projet que vous souhaitez créer. Dans ce cas, sélectionnez « Web Application Basic [sans abonnement et autorisation]. » comme indiqué dans Figure 3, puis tapez le nom de votre projet et appuyez sur ENTRÉE.

Figure 3 en sélectionnant le Type de projet dans Yeoman

Une fois le générateur est terminée, vous avez la possibilité d'exécuter l'application à l'aide du serveur Web Kestrel inter-plateformes. Tout d'abord, cependant, vous devez installer le npm, les dépendances Bower et NuGet, par conséquent, exécutez la commande de restauration pour obtenir ces ressources :

$ cd [projectname]
$ dnu restore

Cette commande télécharge tous les packages NuGet pour le projet référencé dans le fichier project.json.

(Nous avons également exécuter « $ npm install » et « $ bower installer » pour garantir la JavaScript et l'interface utilisateur des ressources de composant sont à jour, mais ce n'est pas obligatoire.)

Ensuite, exécutez la commande de démarrage Kestrel :

$ dnx . kestrel

(Notez qu'après la publication d'ASP.NET 5 bêta 7, cette commande modifie à simplement « dnx kestrel. »)

Maintenant, le mot « Démarré » apparaît dans la fenêtre de terminal et vous pourrez afficher le site Web en accédant à http://localhost: 5000. À ce stade avoir créé le projet, restaurer des packages et exécuter le site sans Windows ou de Visual Studio. Ensuite, vous allez ouvrir le code dans le Code de Visual Studio.

Modification d'ASP.NET

Comme indiqué précédemment, Code Visual Studio est un excellent éditeur pour le développement multiplateforme. Ouvrez le projet soit habituel façon ou à l'aide du raccourci clavier « code » à partir du dossier de projet. (Voir bit.ly/1LwonPN pour savoir comment configurer le raccourci « code ».)

Une fois que vous avez ouvert le dossier source de Code Visual Studio, vous pouvez commencer à développer l'application. Figure 4 présente le résultat lorsque vous ouvrez le projet dans le Code.

Figure 4 l'ouverture d'un projet dans l'éditeur de Code Visual Studio

Comme vous pouvez le voir, vous obtenez la mise en surbrillance de la syntaxe complète pour les fichiers c# que vous devez — dans Mac OS X ! Si vous examinez attentivement, vous verrez une ampoule près du curseur à la ligne 2. L'ampoule, comme dans Visual Studio, permet de réaliser des actions rapides sont contextuelles. Dans ce cas, Code de Visual Studio propose la suggestion pour supprimer les instructions using inutiles. Maintenant nous allons ajouter de nouveaux fichiers à votre projet.

Pour ajouter un nouveau fichier à votre projet ASP.NET 5, vous n'avez pas besoin de faire quelque chose de spécial. Ajoutez simplement un fichier dans le répertoire et elle sera automatiquement inclus. Dans le Code, vous pouvez utiliser le bouton Ajouter un fichier dans l'arborescence, ou sur Ctrl + N pour ajouter un nouveau fichier vierge. Si vous souhaitez commencer avec un contenu initial, vous pouvez utiliser « yo aspnet. » Pour ajouter des fichiers pour les projets ASP.NET 5 existants, vous appelez un générateur secondaire à l'aide de la syntaxe suivante :

$ yo aspnet:<Name> <options>

Pour illustrer cela, ajoutez un nouveau contrôleur MVC et afficher une nouvelle page d'administration de l'application Web. Nous allons ajouter tout d'abord le contrôleur MVC. Lorsqu'yo aspnet s'exécute, il ajoutera les fichiers vers le répertoire de travail actuel, et il vous faudra sur cd dans le répertoire approprié avant d'exécuter les commandes. Pour ajouter le contrôleur MVC, exécutez la commande suivante dans le dossier contrôleurs :

yo aspnet:MvcController AdminController

Après avoir exécuté la commande, vous verrez un nouveau fichier, Hello.cs, dans le répertoire de travail avec le contenu présenté dans Figure 5.

Figure 5 Hello.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNet.Mvc;
// For more information on enabling MVC for empty projects, visit
// go.microsoft.com/fwlink/?LinkID=397860
namespace MyNamespace
{
  public class AdminController : Controller
  {
    // GET: /<controller>/
    public IActionResult Index()
    {
      return View();
    }
  }
}

Le fichier ressemble à lorsque vous utilisez le fichier | Un nouvel élément dans Visual Studio et sélectionnez contrôleur MVC, à l'exception de ce dernier ici le nom de l'espace de noms n'est pas automatiquement mis à jour ; au lieu de cela, il est codé en dur comme MyNamespace. Pour l'instant, vous devrez mettre à jour de la déclaration d'espace de noms pour faire correspondre à vos attentes, mais il sera mis à jour dans une version ultérieure. Le Générateur de sous-répertoire MvcController est l'une des nombreuses générateurs secondaire disponibles dans yo aspnet. Pour afficher la liste complète des générateurs de sous-élément, vous pouvez exécuter :

$ yo aspnet --help

Les générateurs de sous-dossier d'yo aspnet sont équivalentes aux modèles d'élément dans Visual Studio lorsque vous utilisez le fichier | Ajouter un nouvel élément. Pour ajouter une vue, utilisez le Générateur de sous-répertoire MvcView. Pour ajouter la vue administration, exécutez la commande suivante à partir du dossier de vues :

$ yo aspnet:MvcView Index

La vue résultante, Index.cshtml, est plutôt Basique :

@*
  // For more information on
  // enabling MVC for empty projects,
  // visit bit.ly/1PBdyKc
*@
@{
  // ViewBag.Title = "Index Page";
}

Une fois encore, le contenu généré à l'aide d'yo aspnet est équivalent à la boîte de dialogue Ajouter un nouvel élément dans Visual Studio. Dans le fichier Index.cshtml, vous pouvez ajouter un en-tête afin de pouvoir accéder à cette page et vérifier que tout fonctionne :

<h1>Admin Page</h1>

Maintenant nous allons voir ce que nous devons faire pour générer et exécuter cette application.

Nous avons mentionné précédemment que vous pouvez utiliser la commande « dnx. kestrel » pour exécuter votre application. Si vous utilisez un Code vous pouvez démarrer le serveur Web à l'aide de la palette de commande indiquée dans Figure 6.

Figure 6 démarrage d'un serveur Web dans le Code de Visual Studio

Lorsque vous utilisez du Code, votre projet sera généré en arrière-plan à l'aide de OmniSharp chaque fois que la modification de vos fichiers source. Pour voir les erreurs et avertissements dans le Code, telles que celles illustrées dans Figure 7, utilisez les erreurs et le bouton avertissements dans la barre d'état. Comme vous pouvez le voir, le Code est indiquant code incorrect au niveau de la ligne 16.

Figure 7 affichage des erreurs et avertissements dans le Code de Visual Studio

Vous pouvez également créer votre projet à partir de la ligne de commande. Supposons que votre nouvelle classe AdminController comporte une erreur de build. Pour générer l'application sur la ligne de commande, exécutez :

$ dnu build

Cela devrait vous donner les erreurs et les avertissements qui montre du Code même. Maintenant que vous avez vu comment générer et exécuter votre application, passons maintenant présenter brièvement le débogage et le déploiement.

Débogage

Actuellement, le débogage ASP.NET 5 n'est pas pris en charge sur toutes les plates-formes sauf Windows et Visual Studio, et cela signifie que vous ne pouvez pas déboguer une application ASP.NET 5 s'exécutant sur Mono pour OS X ou Linux. ASP.NET 5 les applications sont compilées à l'aide du compilateur Roslyn, pas le compilateur Mono, et aucune information de débogage n'est émise. Code de Visual Studio ne prend pas en charge le débogage encore, mais vous pouvez toujours utiliser Visual Studio sur un ordinateur virtuel sur votre ordinateur Mac ou Linux. J'espère que l'équipe Visual Studio Code sera prend en charge le débogage après le lancement de CoreCLR.

déploiement

Vous avez appris à développer votre application localement ; Maintenant examinons rapidement sur les options d'hébergement. Un examen détaillé de cette rubrique requiert son propre article, nous allons simplement présenter une vue d'ensemble et vous indiquons des ressources externes. Visitez bit.ly/1fvDQ41 pour obtenir les dernières informations.

À un niveau élevé, voici les options de publication pour ASP.NET 5 :

• Publication en ligne de commande à l'aide de l'utilitaire de ligne de commande « Publier dnu »
• Publication sur Azure des applications Web à l'aide de Git
• Publication sur un conteneur Docker en cours d'exécution dans Azure

Dnu de la ligne de commande Publier sur le centre de chaque méthode de publication. Il sera empaquetez votre application dans un format exécutable sur des serveurs Web. Voyons cela de plus près.

Pour commencer et à afficher les options de ligne de commande disponibles, exécutez :

dnu publish –help

Figure 8 montre le résultat de l'exécution de cette commande.

Figure 8 obtention d'aide avec le « publier dnu » commande

L'option de ligne de commande la plus importante est la--hors (-o) argument, qui vous permet de spécifier le dossier dans lequel vos fichiers doivent être publiées. Mais vous souhaiterez également Explorer les autres options en fonction des besoins.

Une fois que vous avez publié l'application dans un dossier, il vous suffit de copier ce dossier sur votre serveur Web. Si vous publiez sur un ordinateur Windows exécutant IIS, vous pouvez configurer votre site Web, tout comme vous avez toujours. Pour plus d'informations sur l'obtention de votre serveur Web configuré sur Linux, consultez bit.ly/1E8uebl.

Si vous publiez sur Azure, une prise en charge de ne possédait vous pouvez utiliser pour commencer. Azure prend en charge les applications ASP.NET 5 dans des applications Web Azure, ainsi que dans des conteneurs Docker. Pour déployer sur Azure des applications Web à partir d'un ordinateur non Windows, vous pouvez utiliser FTP ou Git. Dans le cas FTP, vous publiez les résultats de dnu de publication. Voir bit.ly/1LnFC2T pour plus d'informations.

Basée sur le Git publier modèle est facile à utiliser et peut prendre en charge les scénarios de déploiement continu. Pour commencer à publier sur Azure des applications Web à l'aide de Git, consultez bit.ly/1hQljS0. Voilà, vous devez savoir pour commencer à développer et exécuter des applications ASP.NET 5 sur la plate-forme de votre choix.

Synthèse

Développement d'applications Web avec ASP.NET utilisée pour exiger l'utilisation de Windows et Visual Studio. Maintenant, vous pouvez utiliser ASP.NET 5 et les utilitaires de ligne de commande associés et les outils sur n'importe quelle plate-forme. Et c'est qu'un début. Pour garder un œil sur les dernières actualités de ASP.NET 5, visitez github.com/aspnet/Home. L'yo aspnet projet est complètement communautaire. Si vous êtes intéressé de vous aider, ouvrez un problème à bit.ly/1PvtcGX.

---

Shayne Boyerest ASP.NET MVP, intervenant de la Communauté et un architecte de solutions dans Orlando, Floride Il a développé des solutions Microsoft pour les 20 dernières années. Sur les 10 dernières années, il a travaillé sur les applications Web à grande échelle, l'accent sur la productivité et les performances. Vous pouvez le contacter Shayne sur Twitter @spboyer et son site Web à l'adresse tattoocoder.com.

Sayed Ibrahim Hashimiest responsable de programme senior chez Microsoft dans l'équipe Web de Visual Studio. Il a écrit plusieurs ouvrages sur les technologies Microsoft et est le créateur de SideWaffle et TemplateBuilder, ainsi que les coordonnées créateur de OmniSharp. Vous pouvez le contacter Sayed sur Twitter à l'adresse @SayedIHashimi et son blog sedodream.com.

Merci à l'experte technique Microsoft suivante d'avoir relu cet article : Scott Hanselman