Partager via

Créer des paquets de programme d’amorçage

Le programme d’installation est un programme d’installation générique qui peut être configuré pour détecter et installer des composants redistribuables tels que les fichiers Windows Installer (.msi) et les programmes exécutables. Le programme d’installation est également appelé programme d’amorçage. Il est programmé via un ensemble de manifestes XML qui spécifient les métadonnées pour gérer l’installation du composant. Chaque composant redistribuable, ou prérequis, qui apparaît dans la boîte de dialogue Conditions préalables pour ClickOnce est un package de programme d’amorçage. Un package de programme d’amorçage est un groupe de répertoires et de fichiers qui contiennent des fichiers manifeste qui décrivent la façon dont la configuration requise doit être installée.

Le programme d’amorçage détecte d’abord si l’un des prérequis est déjà installé. Si les prérequis ne sont pas installés, l'assistant d'installation affiche d'abord les contrats de licence. Ensuite, une fois que l’utilisateur final a accepté les contrats de licence, l’installation commence pour les prérequis. Sinon, si tous les prérequis sont détectés, le programme d’amorçage démarre simplement le programme d’installation de l’application.

Créer des packages d’amorçage personnalisés

Vous pouvez générer les manifestes du programme d’amorçage à l’aide de l’éditeur XML dans Visual Studio. Pour voir un exemple de création d’un package d’amorçage, consultez Procédure pas à pas : Créer un programme d’amorçage personnalisé avec une invite de confidentialité.

Pour créer un package de programme d’amorçage, vous devez également créer un manifeste de produit et, pour chaque version localisée d’un composant, un manifeste de package.

  • Le manifeste du produit, product.xml, contient toutes les métadonnées neutres en langage pour le package. Cela contient des métadonnées communes à toutes les versions localisées du composant redistribuable. Pour créer ce fichier, consultez Guide pratique pour créer un manifeste de produit.

  • Le manifeste du package, package.xml, contient des métadonnées propres à la langue ; il contient généralement des messages d’erreur localisés. Un composant doit avoir au moins un manifeste de package pour chaque version localisée de ce composant. Pour créer ce fichier, consultez Guide pratique pour créer un manifeste de package.

Une fois ces fichiers créés, placez le fichier manifeste du produit dans un dossier nommé pour le programme d’amorçage personnalisé. Le fichier manifeste du package est placé dans un dossier nommé pour les paramètres régionaux. Par exemple, si le fichier manifeste du package est destiné à la redistribution anglaise, placez le fichier dans un dossier appelé en. Répétez ce processus pour chaque paramètre régional, tel que "ja" pour le japonais et "de" pour l'allemand. Le package de programme d’amorçage personnalisé final peut avoir la structure de dossiers suivante.

CustomBootstrapperPackage
  product.xml
  CustomBootstrapper.msi
  de
    eula.rtf
    package.xml
  en
    eula.rtf
    package.xml
  ja
    eula.rtf
    package.xml

Ensuite, copiez les fichiers redistribuables dans l’emplacement du dossier du programme d’amorçage. Pour plus d’informations, consultez Guide pratique pour créer un package de programme d’amorçage localisé.

*\Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages*

ou

*<VS Install Path>\MSBuild\Microsoft\VisualStudio\BootstrapperPackages*

Remarque

Le chemin d’accès répertorié ci-dessus sous le chemin d’installation de Visual Studio fonctionne à partir de la version de Visual Studio 2019 Update 7.

Vous pouvez également trouver l’emplacement du dossier bootstrapper depuis la valeur Path dans la clé de Registre suivante :

*HKLM\Software\Microsoft\GenericBootstrapper*

Sur les systèmes 64 bits, utilisez la clé de Registre suivante :

*HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper*

Chaque composant redistribuable apparaît dans son propre sous-dossier sous le répertoire des packages. Le manifeste du produit et les fichiers redistribuables doivent être placés dans ce sous-dossier. Les versions localisées du composant et des manifestes de package doivent être placées dans des sous-dossiers nommés en fonction du nom de la culture.

Une fois ces fichiers copiés dans le dossier du programme d’amorçage, le package de programme d’amorçage s’affiche automatiquement dans la boîte de dialogue Conditions préalables de Visual Studio. Si votre programme d'amorçage personnalisé n’apparaît pas, fermez puis rouvrez la boîte de dialogue Prérequis. Pour plus d’informations, consultez la boîte de dialogue Prérequis.

Le tableau suivant montre les propriétés qui sont automatiquement remplies par le bootstrapper.

Propriété Descriptif
Nom de l'application Le nom de l’application.
Architecture du processeur Processeur et bits par mot de la plateforme ciblée par un exécutable. Les valeurs sont notamment les suivantes :

-Intel
- IA64
- AMD64
VersionNT Numéro de version pour les systèmes d’exploitation Windows. La syntaxe de la version est Major.Minor.ServicePack.
VersionMSI Version de l’assembly Windows Installer (msi.dll) à exécuter pendant l’installation.
AdminUser Cette propriété est définie si l’utilisateur dispose de privilèges d’administrateur. Les valeurs sont vraies ou fausses.
Mode d'installation Le mode d’installation indique à partir duquel le composant doit être installé. Les valeurs sont notamment les suivantes :

- HomeSite : les prérequis sont installés à partir du site web du fournisseur.
- SpecificSite : les prérequis sont installés à partir de l’emplacement que vous sélectionnez.
- SameSite : les prérequis sont installés à partir du même emplacement que l’application.

Séparer les redistribuables des installations d'applications

Vous pouvez empêcher le déploiement de vos fichiers redistribuables dans les projets d’installation. Pour ce faire, créez une liste redistribuable dans le dossier RedistList de votre répertoire .NET Framework :

%ProgramFiles%\Microsoft.NET\RedistList

La liste redistribuable est un fichier XML que vous devez nommer au format suivant : <Nom> de la société.<Nom> du composant.RedistList.xml. Par exemple, si le composant est appelé DataWidgets effectué par Acme, utilisez Acme.DataWidgets.RedistList.xml. Un exemple du contenu de la liste redistribuable peut ressembler à ceci :

<?xml version="1.0" encoding="UTF-8"?>
<FileList Redist="Acme.DataWidgets" >
<File AssemblyName="Acme.DataGrid" Version="1.0.0.0" PublicKeyToken="b03f5f7f11d50a3a" Culture="neutral" ProcessorArchitecture="MSIL" InGAC="true" />
</FileList>

Contenu connexe