Téléchargement de composants .NET hors-ligne

Le plus souvent, les fichiers d’installation des composants .NET impliquent d’être connecté à internet au moment de l’installation. Par exemple, c’est le cas pour Visual Studio Community ou les Build tools. Parfois, on peut ne pas disposer d’une connexion au moment de l’installation, en particulier si on effectue l’installation sur un serveur qui se trouve sur un réseau fermé.

Ces fichiers d’installation peuvent être exécutés hors-ligne toutefois ils nécessitent une manipulation au préalable.

Préparation du fichier d’installation

Pour utiliser les fichiers d’installation hors-ligne, il faut, d’abord, télécharger toutes les dépendances du fichier en exécutant la ligne:

<fichier d'installation> --layout <répertoire de sortie> --lang <code langue> 

Par exemple, dans le cadre des Build Tools, pour télécharger tous les fichiers d’installation, il faut exécuter la ligne suivante:

vs_buildtools.exe --layout C:\OfflineBuildTools --lang en-US 

D’autres langues sont possibles:

  • pour le français, il faut utiliser le code fr-FR.
  • D’autres codes de langues sont disponibles sur la page suivante: List of language locales.

Le gros inconvénient de cette méthode est qu’elle entraîne le téléchargement de toutes les dépendances. Ce qui représente 12GB de fichiers d’installation dans le cas des Build Tools.

Pour éviter de tout télécharger, il est possible d’indiquer les composants à télécharger en les indiquant en utilisant l’option --add <nom du composant>.

Par exemple:

<fichier d'installation> --layout <répertoire de sortie> --lang <code langue> 
    --add <composant 1> 
    --add <composant 2>

Une liste exhaustive des composants par fichier d’installation se trouve sur la page suivante:
Visual Studio 2017 workload and component IDs

On peut ensuite ajouter des options pour télécharger certaines dépendances des composants comme:

  • --includeRecommended pour télécharger les composants conseillés
  • --includeOptional pour télécharger les composants optionels.
Téléchargement interrompu

Si jamais le téléchargement s’interrompt, il suffit de ré-exécuter la commande avec les mêmes arguments. Le téléchargement reprendra où il s’est interrompu. Les fichiers déjà téléchargés ne seront, alors, pas re-téléchargés.

Exécuter l’installateur hors-ligne

Après avoir copié les fichiers d’installation sur la machine cible, il faut d’abord installer les certificats:

  1. Aller dans le répertoire téléchargé:
    <répertoire des fichiers d'installation>\certificates
  2. Double-cliquer sur chaque fichier de certificat (fichiers avec une extension .p12).
    Dans le cas où l’assistant demande un mot de passe, il faut le laisser vide.
  3. Ensuite, on peut exécuter l’installateur qui se trouve dans le répertoire téléchargé.
    Dans le cas des Build Tools, le fichier est vs_buildtools.exe.

Si tous les composants ont été correctement téléchargés, une connexion internet n’est pas requise.

Dans le cas où on souhaite modifier, réparer, mettre à jour ou désinstaller une installation existante, on peut exécuter l’exécutable dans le répertoire téléchargé en double-cliquant dessus ou exécuter à la ligne de commandes une instruction du type:

<répertoire des fichiers d'installation>\<fichier d'installation> <commande>

Par exemple, pour les Build Tools:

vs_buildtools.exe <commande> 

Les commandes possibles sont:

  • modify pour modifier une installation existante.
  • update pour mettre à jour une composant déjà installé
  • repair pour réparer une installation existante
  • uninstall pour désinstaller.
Erreur quand on modifie une installation existante

Si un erreur survient au cours de l’exécution d’une commande, il faut essayer de désinstaller complétement le composant en allant dans le panneau de configuration. Puis le réinstaller sans utiliser de commande particulière.

Leave a Reply