Créer un programme d’installation dans WiX pour distribuer des applications mises à niveau

Date de création de la page :

environnement

Visual Studio
  • Communauté Visual Studio 2017
  • Communauté Visual Studio 2019
Ensemble d’outils WiX
3.11.2

※ Cela fonctionne dans d’autres versions, mais ce n’est pas confirmé

Au début

Découvrez comment créer un programme d’installation lors de la mise à niveau d’une application. Il est basé sur l’article sur la procédure de création de la première version du programme d’installation. Il peut y avoir des différences dans la façon dont vous le faites.

Si vous souhaitez conserver le projet précédent avant la mise à jour, sauvegardez-le d’une manière ou d’une autre, par exemple en copiant le fichier.

Préparation à l’avance

  • La première version du programme d’installation a été créée et le projet existe.

À propos des types de mise à niveau

Il existe plusieurs méthodes de mise à niveau pour la mise à niveau, comme mentionné dans l’article suivant. La procédure décrite ici décrit une mise à niveau majeure. À moins que vous n’ayez des circonstances particulières, c’est bien.

Modifications apportées à Product.wxs

Lancez Visual Studio et ouvrez le projet (fichier solution) que vous avez déjà créé.

Ouvrez Product.wxs et modifiez les paramètres suivants :

Wix/Produit/@Id

Remplacez cet ID par le nouveau GUID si vous effectuez une mise à niveau majeure.

Les mises à niveau mineures et les petites mises à niveau n’ont pas besoin d’être modifiées, mais dépassent le cadre de ce document.

<Wix>
  <Product Id="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />

Wix/Produit/@Version

Il est utilisé pour déterminer s’il s’agit d’une version plus récente lors de l’installation, alors augmentez le nombre par rapport à la version précédente. Il existe quatre numéros de « version majeure.version mineure.revision.build », Trois éléments déterminent si une version a augmenté : version majeure.version mineure.révision.

Au fur et à mesure que le nombre augmente, il peut s’agir de n’importe quel nombre, mais fondamentalement, il est prudent de le faire correspondre à la version de l’application.

<Wix>
  <Product Version="1.8.0.0" />

Wix/Produit/@UpgradeCode

Ce code identifie s’il s’agit d’une mise à niveau de version vers la même application. Par conséquent, si vous souhaitez effectuer une mise à niveau avec une installation d’écrasement, ne la modifiez pas à partir du code lors de sa première publication.

Inversement, si vous souhaitez l’installer en tant qu’application distincte bien qu’il s’agit d’une mise à niveau de version, remplacez-la par un nouveau GUID.

<Wix>
  <Product UpgradeCode="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX">

Wix/Produit/MajorUpgrade/@DowngradeErrorMessage

Ce message s’affiche lorsque vous démarrez l’ancien programme d’installation avec une version plus récente de l’application installée. Il est utilisé pour les anciennes versions du programme d’installation, donc si vous avez déjà configuré des messages dans les versions précédentes, vous n’avez pas besoin de les modifier. Si vous souhaitez le modifier, veuillez le réécrire.

Si vous souhaitez afficher le japonais, vous devez définir les attributs de Languages et SummaryCodepage sur japonais (la prise en charge du japonais est présentée dans un article séparé). ProductName est remplacé par le nom du produit.

<Wix>
  <Product>
    <MajorUpgrade DowngradeErrorMessage="すでに新しいバージョンの [ProductName] がインストールされているため、インストールを中断します。" />

image

Comment installer des fichiers

Comme lorsque vous avez créé le programme d’installation pour la première fois Veuillez saisir à nouveau le nouveau programme et les fichiers associés. Supprimez les fichiers que vous n’utilisez plus.

image

Mettre à jour la licence.rtf

Si vous souhaitez modifier le contrat de licence affiché sur l’écran d’installation, veuillez modifier le contenu.

image

Mise à jour des informations sur le fichier d’installation Product.wxs

* Vous n’avez pas besoin de travailler sur cet élément si la configuration du fichier ou du dossier à installer n’a pas du tout changé par rapport à la version précédente.

La tâche de haut niveau de cet élément consiste à supprimer et à recréer tous les paramètres d’installation de fichiers précédents. Si vous n’avez ajouté ou diminué qu’un seul fichier, il peut être plus rapide de lire directement avec le code product.wxs.

Lancez WixEdit.

image

Ouvrez le fichier Product.wxs.

image

image

Sélectionnez Fichiers dans l’icône à gauche. Supprimez les dossiers sous ProgramFilesFolder.

image

Cliquez avec le bouton droit sur le dossier ProgramFilesFolder et sélectionnez Importer le dossier.

image

Sélectionnez le dossier dans lequel vous souhaitez installer les fichiers.

image

Un ensemble de fichiers est ajouté à l’arborescence.

image

Pour l’associer à d’autres paramètres, sélectionnez le dossier ajouté et remettez « Id » sur « INSTALLFOLDER ».

image

Créez un raccourci pour le menu Démarrer. Parce que ce travail de création de raccourcis devient le même travail à chaque fois, Il peut être plus rapide d’enregistrer le code XML et de le coller plus tard. (Sélection de la partie de l’image ci-dessous)

image

sélectionnez « Nouveau » et « Raccourci » dans le menu contextuel du fichier exe.

image

Lorsque le raccourci est ajouté, sélectionnez-le et cliquez avec le bouton droit sur le blanc pour ajouter la propriété.

image

Ajoutez les paramètres suivants : (Modifiez le nom unique pour qu’il corresponde au programme.)

Valeur de l’attribut
Id LITTLESAVIORTRIAL. EXE_shortcut
Nom Procès du Petit Sabre
Répertoire ProgrammeMenuDir
WorkingDirectory (En) INSTALLDIR
Icône LITTLESAVIOR. ICO
IconIndex 0
Annoncer oui

image

Sélectionnez ensuite l’onglet « Fonctionnalité ».

Ajoutez tous les fichiers que vous avez ajoutés et supprimez tous les fichiers dont vous n’avez plus besoin.

image

image

image

Si vous rencontrez des difficultés avec l’interface utilisateur, vous pouvez modifier directement le code XML.

image

Sauvegarder.

image

Confirmation de la génération et de l’exécution

Générez-le dans Visual Studio et créez un programme d’installation.

Exécutez la nouvelle version du programme d’installation avec la version précédente installée et assurez-vous qu’elle est écrasée et installée.

Essayez également de vous assurer que vous ne pouvez pas installer la version précédente du programme d’installation lorsque vous exécutez le programme d’installation alors qu’une nouvelle version est installée.