Erstellen einer Windows Installer-"MSI" mit WiX part2

Erstellungsdatum der Seite : Mittwoch, 27. Oktober 2021

Zuerst

Beim letzten Mal haben wir die notwendigen Dateien vorbereitet und das Projekt eingerichtet. Bearbeiten Sie dieses Mal "Product.wxs" und nehmen Sie verschiedene Einstellungen des Installationsprogramms vor.

Bearbeiten der Installationseinstellungen (Product.wxs)

Der Inhalt der Datei Product.wxs wird im XML-Format beschrieben. Es gibt eine Reihe von Parametern, aber zuerst werden wir die Mindesteinstellungen vornehmen, um sicherzustellen, dass das Installationsprogramm erstellt werden kann. Wenn Sie es genauer einrichten möchten, lesen Sie bitte einen anderen Artikel oder die offizielle Website.

Zum Zeitpunkt der Projekterstellung sieht der Code wie folgt aus:

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
  <Product Id="*" Name="SetupLittleSaviorTrial_x86" Language="1033" Version="1.0.0.0" Manufacturer="" UpgradeCode="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX">
    <Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" />

    <MajorUpgrade DowngradeErrorMessage="A newer version of [ProductName] is already installed." />
    <MediaTemplate />

    <Feature Id="ProductFeature" Title="SetupLittleSaviorTrial_x86" Level="1">
      <ComponentGroupRef Id="ProductComponents" />
    </Feature>
  </Product>

  <Fragment>
    <Directory Id="TARGETDIR" Name="SourceDir">
      <Directory Id="ProgramFilesFolder">
        <Directory Id="INSTALLFOLDER" Name="SetupLittleSaviorTrial_x86" />
      </Directory>
    </Directory>
  </Fragment>

  <Fragment>
    <ComponentGroup Id="ProductComponents" Directory="INSTALLFOLDER">
      <!-- TODO: Remove the comments around this Component element and the ComponentRef below in order to add resources to this installer. -->
      <!-- <Component Id="ProductComponent"> -->
      <!-- TODO: Insert files, registry keys, and other resources here. -->
      <!-- </Component> -->
    </ComponentGroup>
  </Fragment>
</Wix>

Hier sind einige Dinge, die Sie ändern müssen: Fügen Sie Tags und Attribute hinzu, die nicht vorhanden sind.

Wix/Produkt/@Id

Legen Sie die GUID fest, die die Anwendung identifiziert.

Es gibt viele Tools zum Generieren von GUID, aber es ist schnell, die Tools zu verwenden, die mit Visual Studio kommen. Wählen Sie die Menüs "Extras" und "GUID erstellen".

Holen Sie sich einen 36-stelligen Code mit Bindestrich und setzen Sie ihn auf Wix/Product/@Id.

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

Wix/Produkt/@Name

Dies ist der Anwendungsname, der in jedem Teil des Installationsbildschirms angezeigt wird. Es kann auch der Name sein, der in der Liste Software angezeigt wird.

<Wix>
  <Product Name="リトルセイバー 体験版" />

Wix/Produkt/@Manufacturer

Geben Sie den Namen des Herstellers ein. Es wird als Autor des Installationsprogramms oder als Herausgeber der Programmliste angezeigt.

<Wix>
  <Product Manufacturer="ソーサリーフォース">

Wix/Produkt/UIRef/@Id

Geben Sie eine ID ein, die angibt, welcher Bildschirm im Installationsassistenten angezeigt werden soll. Da es diesmal die Mindestkonfiguration ist, nur die Lizenz anzuzeigen und zu installieren, wird "WixUI_Minimal" angegeben.

<Wix>
  <Product>
    <UIRef Id="WixUI_Minimal" />

Ich denke, dass die folgende Seite hilfreich sein wird, welche Art von Bezeichnung gemacht werden kann.

Verwenden des WixUI-Dialogfeldsatzes

Wix/Produkt/WixVariable/*

Gibt die Datei an, die in der Benutzeroberfläche des Assistenten verwendet werden soll. Die Mindestkonfiguration verwendet drei Dateien: Der Wert von id ist festgelegt und der Wert ist der Dateiname.

<Wix>
  <Product>
    <WixVariable Id="WixUILicenseRtf" Value="license.rtf" />
    <WixVariable Id="WixUIDialogBmp" Value="dialog.bmp" />
    <WixVariable Id="WixUIBannerBmp" Value="banner.bmp" />

Symbol für die Installationsanwendung

Es wird für Anwendungssymbole verwendet, die unter "Software" usw. angezeigt werden.

Geben Sie in der "SourceFile" des Icon-Elements die ico-Datei als relativen Pfad aus dem Projektordner an.

"Property Id="ARPPRODUCTICON" ist die Assoziationsdefinition des Symbols.

<Wix>
  <Product>
    <Icon Id="LITTLESAVIOR.ICO" SourceFile="LittleSaviorTrial\LittleSavior.ico" />
    <Property Id="ARPPRODUCTICON" Value="LITTLESAVIOR.ICO" />

Wix/Fragment (Dateiordnerkonfiguration)

Legt die zu installierende Ordnerkonfiguration fest. Ursprünglich platzieren Sie auch Dateien, erstellen jedoch zuerst nur Ordner.

Der Wert von "Name", der auf "Id="ProgramMenuDir" festgelegt ist, ist der Name des Ordners, der in der Kontextwahl im Startmenü abgelegt wird. Legen Sie auch Guids fest.

<Wix>
  <Fragment>
    <Directory Id="TARGETDIR" Name="SourceDir">
      <Directory Id="ProgramFilesFolder">
        <Directory Id="INSTALLFOLDER" Name="SetupLittleSaviorTrial_x86" />
      </Directory>
      <Directory Id="ProgramMenuFolder">
        <Directory Id="ProgramMenuDir" Name="リトルセイバー 体験版">
          <Component Id="ProgramMenuDir" Guid="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX">
            <RemoveFolder Id="ProgramMenuDir" On="uninstall" />
            <RegistryValue Root="HKCU" Key="Software\[Manufacturer]\[ProductName]" Type="string" Value="" KeyPath="yes" />
          </Component>
        </Directory>
      </Directory>
    </Directory>
  </Fragment>

Installationsdateien hinzufügen

Sie können es auch von Hand zu einer Product.wxs-Datei hinzufügen. Da für eine Datei eine GUID erforderlich ist, ist es schwierig, mit mehr Dateien zu arbeiten. Um Also, um Dateien hinzuzufügen, verwenden Sie WixEdit, um sie hinzuzufügen.

Starten Sie WixEdit.

Öffnen Sie die Datei Product.wxs.

Wählen Sie Dateien aus dem Symbol auf der linken Seite. Löschen Sie die Ordner unter ProgramFilesFolder.

Klicken Sie mit der rechten Maustaste auf den Ordner ProgramFilesFolder und wählen Sie Ordner importieren.

Wählen Sie den Ordner aus, in dem Sie die Dateien installieren möchten.

Eine Reihe von Dateien wird der Struktur hinzugefügt.

Um mit anderen Parametern zu verknüpfen, wählen Sie den hinzugefügten Ordner aus und setzen Sie "Id" wieder auf "INSTALLFOLDER".

Erstellen Sie eine Verknüpfung für das Startmenü. Wählen Sie "Neu" und "Verknüpfung" aus dem Kontextmenü der EXE-Datei.

Wenn Verknüpfung hinzugefügt wird, wählen Sie sie aus, und klicken Sie mit der rechten Maustaste auf das Leerzeichen, um die Eigenschaft hinzuzufügen.

Fügen Sie die folgenden Parameter hinzu: (Ändern Sie den eindeutigen Namen so, dass er dem Programm entspricht.)

Attributwert
Id	WENIGRETTUNG. EXE_shortcut
Name	Little Saber Trial
Verzeichnis	ProgrammMenuDir
WorkingDirectory	INSTALLDIR
Ikone	LITTLESAVIOR. ICO
IconIndex	0
Inserieren	ja

Wählen Sie dann die Registerkarte "Feature", klicken Sie mit der rechten Maustaste auf "ProductFeature" und wählen Sie Select Components to add.

Wählen Sie alle aus.

Zugefügt.

Retten.

Product.wxs sollte in etwa so aussehen:

<?xml version="1.0" encoding="utf-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
  <Product Id="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" Name="リトルセイバー 体験版" Language="1033" Version="1.0.0.0" Manufacturer="ソーサリーフォース" UpgradeCode="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX">
    <Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" />
    <MajorUpgrade DowngradeErrorMessage="A newer version of [ProductName] is already installed." />
    <MediaTemplate />
    <UIRef Id="WixUI_Minimal" />
    <WixVariable Id="WixUILicenseRtf" Value="license.rtf" />
    <WixVariable Id="WixUIDialogBmp" Value="dialog.bmp" />
    <WixVariable Id="WixUIBannerBmp" Value="banner.bmp" />
    <Icon Id="LITTLESAVIOR.ICO" SourceFile="LittleSaviorTrial\LittleSavior.ico" />
    <Property Id="ARPPRODUCTICON" Value="LITTLESAVIOR.ICO" />
    <Feature Id="ProductFeature" Title="SetupLittleSaviorTrial_x86" Level="1">
      <ComponentGroupRef Id="ProductComponents" />
      <ComponentRef Id="LITTLESAVIOR.ICO" />
      <ComponentRef Id="LITTLESAVIORTRIAL.EXE" />
      <ComponentRef Id="LITTLESAVIORTRIAL.EXE.CONFIG" />
      <ComponentRef Id="ProgramMenuDir" />
    </Feature>
    <UI />
  </Product>
  <Fragment>
    <Directory Id="TARGETDIR" Name="SourceDir">
      <Directory Id="ProgramFilesFolder">
        <Directory Id="INSTALLFOLDER" Name="LittleSaviorTrial">
          <Component Id="LITTLESAVIOR.ICO" DiskId="1" Guid="0B4DD82C-C6EF-4299-8EAB-4F9BB35FD952">
            <File Id="LITTLESAVIOR.ICO" Name="LittleSavior.ico" Source="LittleSaviorTrial\LittleSavior.ico" />
          </Component>
          <Component Id="LITTLESAVIORTRIAL.EXE" DiskId="1" Guid="8D805936-A25E-4DA6-9A0A-A5BDB2AD768D">
            <File Id="LITTLESAVIORTRIAL.EXE" Name="LittleSaviorTrial.exe" Source="LittleSaviorTrial\LittleSaviorTrial.exe" KeyPath="yes">
              <Shortcut Id="LITTLESAVIORTRIAL.EXE_shortcut" Name="リトルセイバー 体験版" Directory="ProgramMenuDir" WorkingDirectory="INSTALLDIR" Icon="LITTLESAVIOR.ICO" IconIndex="0" Advertise="yes" />
            </File>
          </Component>
          <Component Id="LITTLESAVIORTRIAL.EXE.CONFIG" DiskId="1" Guid="790C427A-A72C-4444-ACD6-ECF32AA788AD">
            <File Id="LITTLESAVIORTRIAL.EXE.CONFIG" Name="LittleSaviorTrial.exe.config" Source="LittleSaviorTrial\LittleSaviorTrial.exe.config" />
          </Component>
        </Directory>
      </Directory>
      <Directory Id="ProgramMenuFolder">
        <Directory Id="ProgramMenuDir" Name="リトルセイバー 体験版">
          <Component Id="ProgramMenuDir" Guid="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX">
            <RemoveFolder Id="ProgramMenuDir" On="uninstall" />
            <RegistryValue Root="HKCU" Key="Software\[Manufacturer]\[ProductName]" Type="string" Value="" KeyPath="yes" />
          </Component>
        </Directory>
      </Directory>
    </Directory>
  </Fragment>
  <Fragment>
    <ComponentGroup Id="ProductComponents" Directory="INSTALLFOLDER">
    </ComponentGroup>
  </Fragment>
</Wix>

Bestätigung "Erstellen und Ausführen"

Machen Sie die Projektmappenkonfiguration in Visual Studio "Release".

Beginnen Sie mit dem Erstellen von Build Solution.

Wenn die Erstellung erfolgreich ist, wird eine MSI-Datei im Ordner "bin\Release" generiert.

Wenn Sie versuchen, es auszuführen, wird das Installationsprogramm gestartet.

Wenn die Installation abgeschlossen ist, wird im Startmenü eine Verknüpfung erstellt.

Die Datei wird im Ordner Programme (x86) abgelegt.

Die Anwendung erscheint auch unter "Programme und Funktionen".

Führen Sie die Anwendung aus und stellen Sie sicher, dass sie ordnungsgemäß funktioniert.

Zusammenfassung

Hier haben wir die Schritte zum Erstellen eines MSI-Installationsprogramms mit Visual Studio und WiX beschrieben. Ich möchte die detaillierten Einstellungen in einem separaten Artikel erläutern.

Einrichten von WiX zum Erstellen von Windows Installer für die Programmverteilung

Erstellen eines Windows Installers "MSI" mit WiX part1