⌂ Entity Framework
Fiche 3 sur 8

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 :

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.

MorceauDans 10.0.3Son nomQuand il change
1er10version majeureGrosse nouveauté. Le package peut ne plus fonctionner avec l'ancien code.
2e0version mineureDe nouvelles possibilités, sans rien casser.
3e3correctifUn 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
Résultat (exemple)
   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

  1. Repérer le package fautif Ouvrez le .csproj ou lancez dotnet list package, et cherchez le numéro majeur qui ne ressemble pas aux autres.
  2. 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.
  3. Nettoyer et recompiler Lancez dotnet clean puis dotnet 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émentVersion
Votre projetnet10.0 (.NET 10)
Entity Framework Core10.0.x
Npgsql.EntityFrameworkCore.PostgreSQL10.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

1Écrire la commandeRecopier

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.

2Trouver l'intrusModifier

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>
  1. Quelle ligne pose problème ?
  2. É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.

3Le jour où .NET 11 sera la normeCréer

Dans un an, vous créez un nouveau projet sur .NET 11 (net11.0).

  1. Quelle version majeure devrez-vous demander pour les packages ?
  2. Écrivez la commande pour ajouter Npgsql (le dernier nombre est inconnu : écrivez x).
  3. 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.x

3. 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

Une case qui coince ? Relisez la partie concernée avant de passer à la fiche suivante.

← Fiche 2 Fiche 4 : Une classe = une table →