Créer un premier projet
Cette page résume les étapes de création et de démarrage d'une première application Lagoon.
Prérequis
SDK .NET 8
Lagoon cible .NET 8 pour les applications actuelles. Installez le SDK .NET 8 avant de restaurer ou compiler une solution.
Outil global lgn
L'outil global lgn, fourni par le package LGN, est requis pour les builds Release des modules Lagoon.UI*. Il minifie le JavaScript pendant la précompilation. En configuration Debug, cette minification est contournée et les scripts sont seulement concaténés.
Installation :
dotnet tool install -g LGN
Mise à jour :
dotnet tool update -g LGN
Codes d'erreur de build connus :
| Code | Signification | Action |
|---|---|---|
9009 | L'outil lgn n'est pas installé. | Installer LGN avec dotnet tool install -g LGN. |
7007 | L'outil lgn est obsolète. | Mettre à jour LGN avec dotnet tool update -g LGN. |
Feed NuGet privé
Les applications Lagoon utilisent un feed NuGet privé. Dans la solution de démonstration, Apps\Demo\NuGet.Config configure :
https://api.nuget.org/v3/index.jsonpour les packages généraux ;https://nuget.lagoon-toolkit.com/index.jsonpour les packagesLagoon.*etLGN.*.
Les identifiants du feed privé doivent être présents dans la configuration NuGet locale. Sinon, dotnet restore échoue lors de la résolution des packages Lagoon.
Créer la solution
La commande de création est :
lgn new
Elle lance un assistant interactif et scaffold une solution Lagoon avec les projets applicatifs usuels, comme Client, Server, Model, Shared, et selon le besoin Services ou Batch.
Les options exactes proposées par l'assistant dépendent de la version de l'outil. Suivez les questions affichées par lgn new sans supposer d'option non documentée.
Restaurer les packages
Depuis le dossier de la solution applicative :
dotnet restore
Pour la solution de démonstration, la restauration s'appuie sur Apps\Demo\NuGet.Config afin de résoudre les packages publics et les packages Lagoon.
Compiler la solution
Compilez la solution applicative :
dotnet build
Vous pouvez aussi cibler explicitement une solution, par exemple :
dotnet build Apps\Demo\Demo.sln
Pour les builds Release des modules Lagoon.UI*, l'outil lgn doit être installé et à jour. En Debug, l'étape de minification JS est contournée.
Lancer l'application
L'application web est hébergée par le projet Server. Lancez donc le projet serveur :
dotnet run --project Apps\Demo\Server\Demo.Server.csproj
Le Program.cs serveur démarre l'application avec LagoonWebApplication.Run<Main>(args). La classe Main configure le DbContext, les services, le pipeline HTTP, l'authentification et les autorisations.