13. Annexes
13.1. Installation du SDK .NET
Le SDK [.NET] 10 se télécharge sur dotnet.microsoft.com/download : on choisit la version 10 (LTS), puis l'installateur de son système ([Windows] x64, [macOS], [Linux]). Sous [Windows], on peut aussi utiliser le gestionnaire de paquets [winget] :
Sous [Linux] ([Ubuntu], par exemple), le paquet [dotnet-sdk-10.0] est disponible dans les dépôts de la distribution ou de Microsoft. On vérifie l'installation dans une console ([PowerShell] ou invite de commandes) :
qui doit afficher un numéro de version commençant par 10. Le SDK contient tout ce qu'il faut : le compilateur [C#], le framework [ASP.NET Core] et l'outil [dotnet] ([dotnet new], [dotnet build], [dotnet run], [dotnet watch]...). Les bibliothèques supplémentaires (paquets [NuGet]) sont téléchargées automatiquement depuis nuget.org à la première compilation d'un projet qui les déclare : il faut alors une connexion Internet.
13.2. Installation de Visual Studio Code
[Visual Studio Code] se télécharge sur code.visualstudio.com. On y ajoute l'extension [C# Dev Kit] de Microsoft (menu Affichage / Extensions, puis rechercher « C# Dev Kit ») : elle apporte la coloration syntaxique et la complétion du code [C#] et [Razor], la liste des projets d'une solution (vue « Explorateur de solutions ») et le débogueur. On ouvre le dossier [exemples] ou le dossier de l'étude de cas (menu Fichier / Ouvrir le dossier) ; le terminal intégré (menu Terminal / Nouveau terminal) permet de lancer les commandes [dotnet] sans quitter l'éditeur. La touche F5 exécute l'application sous le contrôle du débogueur.
13.3. Installation de MySQL avec Laragon
[Laragon] (laragon.org) installe sous [Windows] un serveur [MySQL] (ou [MariaDB]) prêt à l'emploi, avec l'outil d'administration [HeidiSQL]. Après installation :
- le bouton Démarrer tout lance le serveur [MySQL], sur le port 3306 ;
- l'utilisateur [root] n'a pas de mot de passe : ce sont les valeurs par défaut des chaînes de connexion de l'exemple 28 et de l'étude de cas ;
- le bouton Base de données ouvre [HeidiSQL], où le menu Fichier / Exécuter un fichier SQL exécute les scripts [dbpersonnes.sql] (exemple 28) et [dbrdvmedecins2.sql] (étude de cas).
Sous [Linux] ou [macOS], on installera [MySQL] ou [MariaDB] avec le gestionnaire de paquets du système, et l'on exécutera les scripts avec le client en ligne de commande [mysql]. Avec [MariaDB], on indiquera sa version dans [appsettings.json] (clé [MySql:ServerVersion], par exemple [10.11.0-mariadb]).
13.4. Installation de curl
[curl] est livré avec [Windows] 10 et 11, [macOS] et la plupart des distributions [Linux]. Sous [PowerShell], il faut taper [curl.exe] et non [curl] : dans les anciennes versions de [PowerShell], [curl] est un alias d'une autre commande ([Invoke-WebRequest]), dont les options sont différentes.