Partage via

Didacticiel : Créer une application ASP.NET Core avec Vue dans Visual Studio

  • Article

Dans cet article, vous allez apprendre à créer un projet ASP.NET Core en tant que back-end d’API et un projet Vue en tant qu’interface utilisateur.

Visual Studio inclut les modèles d’applications monopage (SPA) ASP.NET Core qui prennent en charge Angular, React et Vue. Les modèles fournissent un dossier d’application client intégré dans vos projets ASP.NET Core qui contient les fichiers de base et les dossiers de chaque infrastructure.

Vous pouvez utiliser la méthode décrite dans cet article pour créer des applications monopages ASP.NET qui :

  • Placent l’application cliente dans un projet distinct, en dehors du projet ASP.NET Core
  • Créent le projet client en fonction de l’interface CLI installée sur votre ordinateur

Remarque

Cet article décrit le processus de création de projet en utilisant le modèle mis à jour dans Visual Studio 2022 version 17.8, qui utilise l’interface CLI Vite.

Prérequis

Veillez à installer les éléments suivants :

  • Visual Studio 2022 version 17.8 ou ultérieure avec la charge de travail Développement web et ASP.NET installée. Accédez à la page de téléchargements de Visual Studio pour l’installer gratuitement. Si vous devez installer la charge de travail et que vous avez déjà installé Visual Studio, cliquez sur Outils>Obtenir les outils et les fonctionnalités..., ce qui ouvre Visual Studio Installer. Choisissez la charge de travail Développement web et ASP.NET, puis Modifier.
  • npm (https://www.npmjs.com/), inclus avec Node.js.

Créer l’application front-end

  1. Dans la fenêtre Démarrage (choisissez Fichier> Fenêtre de démarrage à ouvrir), sélectionnez Créer un nouveau projet.

    Screenshot showing Create a new project

  2. Recherchez Vue dans la barre de recherche en haut, puis sélectionnez Vue et ASP.NET Core (préversion) avec JavaScript ou TypeScript comme langage sélectionné.

    Screenshot showing choosing a template.

  3. Nommez le projet VueWithASP, puis choisissez Créer.

    L’Explorateur de solutions affiche les informations sur le projet suivantes :

    Screenshot showing Solution Explorer.

    Par rapport au modèle Vue autonome, vous voyez de nouveaux fichiers et des fichiers modifiés pour l’intégration à ASP.NET Core :

    • vite.config.json (modifié)
    • HelloWorld.vue (modifié)
    • package.json (modifié)

Définissez les propriétés du projet

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le VueWithASP.Server, puis choisissez Propriétés.

    Screenshot showing Open project properties.

  2. Dans la page Propriétés, ouvrez l’onglet Déboguer et sélectionnez l’option Ouvrir l’interface utilisateur de profils de lancement de débogage. Décochez l’option Lancer le navigateur pour le profil nommé après le projet ASP.NET Core (ou https, le cas échéant).

    Screenshot showing Debug launch profiles UI.

    Cette valeur empêche l’ouverture de la page web avec les données météorologiques sources.

    Remarque

    Dans Visual Studio, launch.json stocke les paramètres de démarrage associés au bouton Démarrer dans la barre d’outils Débogage. Actuellement, launch.json doit se trouver sous le dossier .vscode.

Démarrer le projet

Appuyez sur F5 ou sélectionnez le bouton Démarrer en haut de la fenêtre pour démarrer l’application. Deux invites de commandes s’affichent :

  • Projet API ASP.NET Core en cours d’exécution
  • Interface CLI Vite affichant un message de type VITE v4.4.9 ready in 780 ms

Remarque

Vérifiez la présence de messages dans la sortie de la console. Par exemple, il est possible qu’un message indique de mettre à jour Node.js.

L’application Vue s’affiche qui est renseignée via l’API. Si vous ne voyez pas l’application, consultez Résolution des problèmes.

Publication du projet

À partir de Visual Studio 2022 version 17.3, vous pouvez publier la solution intégrée à l’aide de l’outil de publication de Visual Studio.

Notes

Pour utiliser la publication, créez votre projet JavaScript à l’aide de Visual Studio 2022 version 17.3 ou ultérieure.

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet VueWithASP.Server, puis sélectionnez Ajouter>Référence du projet.

    Assurez-vous que le projet vuewithasp.client est sélectionné.

  2. Choisissez OK.

  3. Cliquez de nouveau avec le bouton droit sur le projet ASP.NET Core et sélectionnez Modifier le fichier projet.

    Cela ouvre le fichier .csproj pour le projet.

  4. Dans le fichier .csproj, vérifiez que la référence de projet inclut un élément <ReferenceOutputAssembly> avec la valeur définie sur false.

    Cette référence doit ressembler à ce qui suit.

     <ProjectReference Include="..\vuewithasp.client\vuewithasp.client.esproj">
   <ReferenceOutputAssembly>false</ReferenceOutputAssembly>
 </ProjectReference>

  5. Cliquez avec le bouton droit sur le projet ASP.NET Core, puis choisissez Recharger le projet si l’option est disponible.

  6. Dans Program.cs, vérifiez que le code suivant est présent.

    app.UseDefaultFiles();
app.UseStaticFiles();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
   app.UseSwagger();
   app.UseSwaggerUI();
}

  7. Pour publier, cliquez avec le bouton droit sur le projet ASP.NET Core, choisissez Publier, puis sélectionnez les options qui correspondent à votre scénario de publication souhaité, comme Azure, publier dans un dossier, etc.

    Le processus de publication prend plus de temps que pour un projet ASP.NET Core, car la commande npm run build est appelée lors de la publication. BuildCommand exécute npm run build par défaut.

Dépannage

Erreur proxy

L'erreur suivante peut apparaître :

[HPM] Error occurred while trying to proxy request /weatherforecast from localhost:4200 to https://localhost:5173 (ECONNREFUSED) (https://nodejs.org/api/errors.html#errors_common_system_errors)

Si vous voyez ce problème, le front-end a probablement démarré avant le back-end. Une fois que vous voyez l’invite de commandes back-end en cours d’exécution, actualisez simplement l’application Vue dans le navigateur.

Sinon, si le port est en cours d’utilisation, essayez d’incrémenter le numéro de port de 1 dans launchSettings.json et vite.config.js.

Erreur de confidentialité

Vous pouvez voir l’erreur de certificat suivante :

Your connection isn't private

Essayez de supprimer les certificats Vue dans %appdata%\local\asp.net\https ou %appdata%\roaming\asp.net\https, puis réessayez.

Vérifier les ports

Si les données météorologiques ne se chargent pas correctement, il est possible que vous deviez également vérifier que vos ports sont corrects.

  1. Vérifiez que les numéros de port correspondent. Accédez au fichier launchSettings.json dans votre projet ASP.NET Core (dans le dossier Propriétés). Obtenez le numéro de port à partir de la propriété applicationUrl.

    S’il existe plusieurs propriétés applicationUrl, recherchez-en une à l’aide d’un point de terminaison https. Elle doit ressembler à https://localhost:7142.

  2. Accédez ensuite au fichier vite.config.js de votre projet Vue. Mettez à jour la propriété target pour qu’elle corresponde à la propriété applicationUrl dans launchSettings.json. Lorsque vous le mettez à jour, cette valeur doit ressembler à ceci :

    target: 'https://localhost:7142/',

Version obsolète de Vue

Si vous voyez le message de console Fichier « C:\Users\Me\source\repos\vueprojectname\package.json » introuvable quand vous créez le projet, vous devez peut-être mettre à jour votre version de l’interface CLI Vite. Après avoir mis à jour l’interface CLI Vite, vous devez peut-être également supprimer le fichier .vuerc dans C:\Users\[yourprofilename].

Docker

Si vous activez la prise en charge de Docker pendant la création du projet d’API web, le back-end peut démarrer en utilisant le profil Docker et ne pas écouter sur le port 5173 configuré. Pour résoudre ce problème :

Modifiez le profil Docker dans launchSettings.json en ajoutant les propriétés suivantes :

"httpPort": 5175, 
"sslPort": 5173

Vous pouvez également réinitialiser à l’aide de la méthode suivante :

  1. Dans les propriétés de la solution, définissez votre application back-end comme projet de démarrage.
  2. Dans le menu Déboguer, basculez le profil à l’aide du menu déroulant du bouton Démarrer sur le profil de votre application back-end.
  3. Ensuite, dans les propriétés de la solution, réinitialisez plusieurs projets de démarrage.

Étapes suivantes

Pour plus d’informations sur les applications SPA dans ASP.NET Core, consultez Développement d’applications monopage. L’article en lien fournit un contexte supplémentaire pour les fichiers projet comme aspnetcore-https.js, bien que les détails de l’implémentation diffèrent en raison de différences entre les modèles de projet et l’infrastructure Vue.js par rapport aux autres infrastructures. Par exemple, au lieu d’un dossier ClientApp, les fichiers Vue sont contenus dans un projet distinct.

Pour les informations MSBuild spécifiques au projet client, consultez propriétés MSBuild pour JSPS.