La version expérimentale de Blazor 0.8.0 est maintenant disponible

Blazor 0.8.0 est maintenant disponible! Cette version met à jour Blazor pour utiliser les composants Razor dans .NET Core 3.0 et ajoute quelques corrections de bogues critiques.

Obtenez Blazor 0.8.0

Pour commencer avec Blazor 0.8.0, installez les éléments suivants:

1. SDK .NET Core 3.0 Preview 2 (3.0.100-preview-010184)
2. Visual Studio 2019 (Preview 2 ou version ultérieure) avec la charge de travail ASP.NET et de développement Web sélectionnée.
3. La dernière extension Blazor de Visual Studio Marketplace.

4. Les modèles Blazor sur la ligne de commande:

   
   

   dotnet new -i Microsoft.AspNetCore.Blazor.Templates::0.8.0-preview-19104-04 

Vous pouvez trouver des instructions de démarrage, des documents et des didacticiels pour Blazor sur https://blazor.net .

Mettre à niveau vers Blazor 0.8.0

Pour mettre à niveau vos applications Blazor existantes vers Blazor 0.8.0, assurez-vous d'abord d'avoir installé les prérequis répertoriés ci-dessus.

Pour mettre à niveau un projet Blazor 0.7.0 autonome vers 0.8.0:

• Mettez à jour les packages Blazor et les références de l'outil CLI .NET vers 0.8.0-preview-19104-04.
• Remplacez toute référence de package à Microsoft.AspNetCore.Blazor.
• Remplacez BlazorComponent par ComponentBase .
• Mettez à jour les remplacements de SetParameters sur les composants pour remplacer SetParametersAsync place.
• Remplacer BlazorLayoutComponent par LayoutComponentBase
• Remplacez IBlazorApplicationBuilder par IComponentsApplicationBuilder .
• Remplacez toutes les instructions using pour Microsoft.AspNetCore.Blazor.* Avec Microsoft.AspNetCore.Components.* , Sauf laissez Microsoft.AspNetCore.Blazor.Hosting dans Program.cs
• Dans index.html, mettez à jour la référence de script pour référencer components.webassembly.js au lieu de blazor.webassembly.js

Pour mettre à niveau une application Blazor hébergée par ASP.NET Core vers 0.8.0:

• Mettez à jour le projet Blazor côté client comme décrit précédemment.
• Mettez à jour l'application ASP.NET Core hébergeant l'application Blazor vers .NET Core 3.0 en suivant les étapes de migration dans les documents ASP.NET Core .
  
  • Mettre à jour le framework cible pour être netcoreapp3.0
  • Supprimez toute référence de package à Microsoft.AspNetCore.App ou Microsoft.AspNetCore.All
  • Mettez à niveau tout Microsoft.AspNetCore non-Blazor. * Références de package vers la version 3.0.0-preview-19075-0444
  • Supprimez toute référence de package à Microsoft.AspNetCore.Razor.Design
  • Pour activer la prise en charge JSON, ajoutez une référence de package à Microsoft.AspNetCore.Mvc.NewtonsoftJson et mettez à jour Startup.ConfigureServices pour appeler services.AddMvc().AddNewtonsoftJson()
• Mettez à niveau la référence du package Microsoft.AspNetCore.Blazor.Server vers 0.8.0-preview-19104-04
• Ajoutez une référence de package à Microsoft.AspNetCore.Components.Server
• Dans Startup.ConfigureServices simplifiez tout appel à app.AddResponseCompression pour appeler la surcharge par défaut sans spécifier WebAssembly ou les données binaires comme types MIME supplémentaires à compresser.
• Dans Startup.Configure ajoutez un appel à app.UseBlazorDebugging() après l'appel existant à app.UseBlazor<App.Startup>()
• Supprimez toute utilisation inutile de l'espace de noms Microsoft.AspNetCore.Blazor.Server .

Pour mettre à niveau une bibliothèque de classes Blazor vers 0.8.0:

• Remplacez les références de package à Microsoft.AspNetCore.Components.Browser et mettez à jour les versions vers 3.0.0-preview-19075 -0444.
• Dans le fichier de projet de la bibliothèque, modifiez le SDK du projet de «Microsoft.NET.Sdk.Web» en «Microsoft.NET.Sdk.Razor».

Blazor côté serveur est désormais ASP.NET Core Razor Components dans .NET Core 3.0

Comme cela a été annoncé récemment, Blazor côté serveur est désormais disponible en tant que composants de rasoir ASP.NET Core dans .NET Core 3.0. Nous avons intégré le modèle de composant Blazor dans ASP.NET Core 3.0 et l'avons renommé Razor Components. Blazor 0.8.0 est maintenant construit sur des composants Razor et vous permet d'héberger des composants Razor dans le navigateur sur WebAssembly.

Mettre à niveau un projet Blazor côté serveur vers les composants ASP.NET Core Razor dans .NET Core 3.0

Si vous avez travaillé avec Blazor côté serveur, nous vous recommandons de procéder à une mise à niveau pour utiliser les composants ASP.NET Core Razor dans .NET Core 3.0.

Pour mettre à niveau une application Blazor côté serveur vers les composants ASP.NET Core Razor:

• Mettez à jour le projet Blazor côté client comme décrit précédemment, sauf remplacez la référence de script à blazor.server.js par components.server.js
• Mettez à jour l'application ASP.NET Core hébergeant les composants Razor vers .NET Core 3.0 comme décrit précédemment.
• Dans le projet serveur:
  
  • Mettez à niveau la référence du package Microsoft.AspNetCore.Blazor.Server vers 0.8.0-preview-19104-04
  • Ajouter une référence de package à Microsoft.AspNetCore.Components.Server version 3.0.0-preview-19075-0444
  • Remplacez l'instruction using pour Microsoft.AspNetCore.Blazor.Server par Microsoft.AspNetCore.Components.Server
  • Remplacez services.AddServerSideBlazor par services.AddRazorComponents et app.UseServerSideBlazor par app.UseRazorComponents .
  • Dans la méthode Startup.Configure , ajoutez app.UseStaticFiles() juste avant d'appeler app.UseRazorComponents .
  • Déplacez le dossier wwwroot du projet d'application Blazor vers le projet de serveur ASP.NET Core

Basculement entre les composants ASP.NET Core Razor et Blazor côté client

Parfois, il est pratique de pouvoir basculer entre l'exécution de vos composants Razor sur le serveur (ASP.NET Core Razor Components) et sur le client (Blazor). Par exemple, vous pouvez exécuter sur le serveur pendant le développement afin de pouvoir facilement déboguer, puis publier votre application pour qu'elle s'exécute sur le client.

Pour mettre à jour une application Blazor hébergée par ASP.NET Core afin qu'elle puisse être exécutée en tant qu'application de composants de rasoir ASP.NET Core:

• Déplacez le dossier wwwroot du projet Blazor côté client vers le projet de serveur ASP.NET Core.
• Dans le projet serveur:
  
  • Mettez à jour la balise de script dans index.html pour pointer vers components.server.js au lieu de components.webassembly.js .
  • Ajoutez un appel à services.AddRazorComponents<Client.Startup>() dans la méthode Startup.ConfigureServices .
  • Ajoutez un appel à app.UseStaticFiles() dans la méthode Startup.Configure avant l'appel à UseMvc .
  • Remplacez l'appel à UseBlazor par app.UseRazorComponents<Client.Startup>()
  
  
• Si vous utilisez l'injection de dépendance pour injecter un HttpClient dans vos composants, vous devrez ajouter un HttpClient tant que service dans la méthode Startup.ConfigureServices votre serveur.

L'outillage pour les projets Blazor est désormais inclus avec Visual Studio 2019

Auparavant, pour obtenir la prise en charge des outils pour les projets Blazor, vous aviez besoin d'installer l'extension Blazor pour Visual Studio. À partir de Visual Studio 2019 Preview 2, la prise en charge des outils pour les composants Razor (et donc les applications Blazor) est déjà incluse sans avoir à installer quoi que ce soit d'autre. L'extension Blazor est désormais uniquement nécessaire pour installer les modèles de projet Blazor dans Visual Studio.

Améliorations de l'exécution

Blazor 0.8.0 inclut certaines améliorations de l'exécution .NET comme l'amélioration des performances d'exécution sur Chrome et un éditeur de liens IL amélioré. Dans nos tests de performances, les performances de Blazor 0.8.0 sur Chrome sont désormais environ 25% plus rapides. Vous pouvez désormais également référencer des bibliothèques existantes comme Json.NET à partir d'une application Blazor sans aucune configuration de l'éditeur de liens supplémentaire:

 @functions { WeatherForecast[] forecasts; protected override async Task OnInitAsync() { var json = await Http.GetStringAsync("api/SampleData/WeatherForecasts"); forecasts = Newtonsoft.Json.JsonConvert.DeserializeObject<WeatherForecast[]>(json); } } 

Problèmes connus

Il y a quelques problèmes connus avec cette version que vous pouvez rencontrer:

• "Il n'a pas été possible de trouver de version de framework compatible. Le cadre spécifié «Microsoft.NETCore.App», version «2.0.0» est introuvable. » : Vous pouvez voir cette erreur lors de la création d'une application Blazor car l'éditeur de liens IL nécessite actuellement .NET Core 2.x pour fonctionner. Pour contourner ce problème, installez .NET Core 2.2 ou désactivez la liaison IL en définissant la <BlazorLinkOnBuild>false</BlazorLinkOnBuild> dans votre fichier de projet.
• "Impossible de générer deps.json, il est peut-être déjà généré." : Vous pouvez voir cette erreur lors de l'exécution d'une application Blazor autonome et vous n'avez pas encore restauré les packages pour les applications .NET Core. Pour contourner ce problème, créez une application .NET Core (ex dotnet new console ), puis réexécutez l'application Blazor.

Ces problèmes seront traités dans une future mise à jour de Blazor.

Mises à jour futures

Cette version de Blazor était principalement axée sur l'intégration des composants Razor dans ASP.NET Core 3.0, puis sur la reconstruction de Blazor en plus de cela. À l'avenir, nous prévoyons d'envoyer des mises à jour Blazor avec chaque mise à jour .NET Core 3.0.

Blazor, et la prise en charge de l'exécution de Razor Components sur WebAssembly dans le navigateur, ne seront pas livrés avec .NET Core 3.0, mais nous continuons à travailler pour expédier Blazor à une date ultérieure.

Donner des commentaires

Nous espérons que vous apprécierez cette dernière version préliminaire de Blazor. Comme pour les versions précédentes, vos commentaires sont importants pour nous. Si vous rencontrez des problèmes ou avez des questions en essayant Blazor, signalez les problèmes sur GitHub . Vous pouvez également discuter avec nous et la communauté Blazor sur Gitter si vous êtes bloqué ou pour partager comment Blazor travaille pour vous. Après avoir essayé Blazor pendant un certain temps, faites-nous savoir ce que vous pensez en répondant à notre enquête sur le produit. Cliquez sur le lien d'enquête affiché sur la page d'accueil de l'application lorsque vous exécutez l'un des modèles de projet Blazor:

Merci d'avoir essayé Blazor!