Les versions des packages
Pourquoi il faut toujours préciser la version, et comment réparer quand ça se passe mal.
Après cette fiche, vous saurez :
- lire un numéro de version comme 10.0.3
- expliquer pourquoi tous les packages doivent avoir la même version majeure
- ajouter un package en précisant sa version
- repérer et corriger une version incompatible
1Lire un numéro de version
Chaque package a un numéro de version, par exemple 10.0.3. Ce numéro
se lit en trois morceaux.
| Morceau | Dans 10.0.3 | Son nom | Quand il change |
|---|---|---|---|
| 1er | 10 | version majeure | Grosse nouveauté. Le package peut ne plus fonctionner avec l'ancien code. |
| 2e | 0 | version mineure | De nouvelles possibilités, sans rien casser. |
| 3e | 3 | correctif | Un bug réparé. |
Retenez surtout le premier nombre, la version majeure. Il suit celui de
.NET : avec un projet net10.0, on utilise les packages en 10.x.
2Pourquoi tout doit être en version 10
Entity Framework Core et Npgsql sont deux packages écrits par deux équipes, mais ils sont construits l'un pour l'autre. Npgsql en version 10 est fait pour Entity Framework Core en version 10.
Mélanger les versions, c'est comme brancher une prise européenne dans une prise d'un autre pays : ça ressemble à ce qu'il faut, mais ça ne va pas.
Attention
Un cas réel. Lors d'un projet, le package Entity Framework Core
Design a été ajouté en version 11.0, alors que Npgsql était en version
10.0. Résultat : les deux ne sont pas compatibles.
Selon les cas, le problème se voit à la compilation (un message de conflit de versions) ou plus tard, quand le programme se lance et plante. Dans les deux cas, votre code n'y est pour rien.
Pourquoi ça arrive
Quand on ajoute un package sans préciser la version, NuGet prend la plus récente. Or la plus récente n'est pas forcément celle qui va avec le reste : dès qu'une nouvelle version majeure sort, elle devient le choix par défaut.
# Sans version : NuGet choisit la plus récente (peut-être la 11 !) dotnet add package Microsoft.EntityFrameworkCore.Design # Avec version : on choisit nous-mêmes dotnet add package Microsoft.EntityFrameworkCore.Design --version 10.0.15
À retenir
Toujours écrire --version quand on ajoute un package.
Et la version majeure (le premier nombre) doit être la même pour tous les packages Entity Framework et Npgsql, et pour .NET.
3Vérifier ses versions
Deux endroits permettent de voir les versions installées.
Dans le fichier .csproj
C'est le fichier de configuration du projet. Chaque package y est listé avec sa version. Voici un projet correct :
<ItemGroup> <PackageReference Include="Microsoft.EntityFrameworkCore" Version="10.0.15" /> <PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="10.0.3" /> </ItemGroup>
Et un projet à problème :
<ItemGroup> <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="11.0.0" /> <!-- 11 !! --> <PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="10.0.3" /> </ItemGroup>
Le défaut se voit tout de suite : un 11 au milieu de 10.
Avec une commande
dotnet list package
Top-level Package Requested Resolved > Microsoft.EntityFrameworkCore 10.0.15 10.0.15 > Npgsql.EntityFrameworkCore.PostgreSQL 10.0.3 10.0.3
4Réparer une version incompatible
- Repérer le package fautif
Ouvrez le
.csprojou lancezdotnet list package, et cherchez le numéro majeur qui ne ressemble pas aux autres. - Le remettre dans la bonne version
Soit en modifiant le nombre dans le fichier
.csproj, soit en relançant la commande avec la bonne version : elle remplace l'ancienne. - Nettoyer et recompiler
Lancez
dotnet cleanpuisdotnet build.
dotnet add package Microsoft.EntityFrameworkCore.Design --version 10.0.15 dotnet clean dotnet build
Dans Visual Studio, la même réparation se fait par un clic droit sur le projet, puis Gérer les packages NuGet, onglet Installé : on choisit le package, puis la bonne version dans la liste.
Attention
Quand vous ajoutez un package avec Visual Studio, regardez toujours quelle version est proposée avant de valider. Elle doit commencer par le même nombre que les autres.
5Quelle version choisir ?
Pour ce cours, la règle est simple :
| Élément | Version |
|---|---|
| Votre projet | net10.0 (.NET 10) |
| Entity Framework Core | 10.0.x |
| Npgsql.EntityFrameworkCore.PostgreSQL | 10.0.x |
Les nombres après le premier (le 0.15 de 10.0.15) peuvent
différer d'un package à l'autre : ce n'est pas un problème. Seul compte le
premier.
→Exercices
Recopiez cette commande, puis lancez-la dans votre projet Demo_Cinema :
dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL --version 10.0.3
Puis lancez dotnet list package. Quelle version est affichée dans la colonne
Resolved ?
Solution
La colonne Resolved affiche 10.0.3. Requested est la
version demandée, Resolved celle qui est vraiment utilisée.
Voici le .csproj d'un projet qui ne fonctionne pas :
<ItemGroup> <PackageReference Include="Microsoft.EntityFrameworkCore" Version="10.0.15" /> <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="11.0.0" /> <PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="10.0.3" /> </ItemGroup>
- Quelle ligne pose problème ?
- Écrivez la commande qui la répare.
Solution
1. La ligne Microsoft.EntityFrameworkCore.Design : elle est en
version 11, alors que tout le reste est en 10.
2.
dotnet add package Microsoft.EntityFrameworkCore.Design --version 10.0.15
On peut aussi simplement remplacer 11.0.0 par 10.0.15 dans
le fichier. Dans les deux cas, terminez par dotnet clean et
dotnet build.
Dans un an, vous créez un nouveau projet sur .NET 11 (net11.0).
- Quelle version majeure devrez-vous demander pour les packages ?
- Écrivez la commande pour ajouter Npgsql (le dernier nombre est inconnu : écrivez
x). - Pourquoi ne faut-il pas simplement faire confiance à « la plus récente » ?
Solution
1. La version 11, la même que .NET.
2.
dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL --version 11.0.x3. Parce que « la plus récente » change avec le temps, et qu'un jour elle peut ne plus correspondre au reste du projet. Préciser la version, c'est garder le contrôle : le projet fonctionne de la même façon aujourd'hui et dans un an.
Je sais faire
- Je sais lire un numéro de version (majeure, mineure, correctif).
- Je sais que mes packages Entity Framework et Npgsql doivent avoir la même version majeure.
- J'écris toujours --version quand j'ajoute un package.
- Je sais corriger une version dans le fichier .csproj.
Une case qui coince ? Relisez la partie concernée avant de passer à la fiche suivante.