Freigeben über

Erstellen Sie Bootstrapper-Pakete

Das Setupprogramm ist ein generisches Installationsprogramm, das so konfiguriert werden kann, dass redistributable-Komponenten wie Windows Installer (.msi) Dateien und ausführbare Programme erkannt und installiert werden können. Das Installationsprogramm wird auch als Bootstrapper bezeichnet. Es wird über eine Reihe von XML-Manifesten programmiert, die die Metadaten zum Verwalten der Installation der Komponente angeben. Jede weiterverteilbare Komponente oder Voraussetzung, die im Dialogfeld "Voraussetzungen " für ClickOnce angezeigt wird, ist ein Bootstrapper-Paket. Ein Bootstrapper-Paket ist eine Gruppe von Verzeichnissen und Dateien, die Manifestdateien enthalten, die beschreiben, wie die Voraussetzung installiert werden soll.

Der Bootstrapper erkennt zunächst, ob eine der erforderlichen Komponenten bereits installiert ist. Wenn die Erforderlichen nicht installiert sind, zeigt der Bootstrapper zuerst die Lizenzverträge an. Zweitens, nachdem der Endbenutzer die Lizenzvereinbarungen akzeptiert hat, beginnt die Installation der erforderlichen Komponenten. Andernfalls, wenn alle Voraussetzungen erkannt werden, startet der Bootstrapper einfach das Anwendungsinstallationsprogramm.

Erstellen von benutzerdefinierten Bootstrapperpaketen

Sie können die Bootstrapper-Manifeste mithilfe des XML-Editors in Visual Studio generieren. Um ein Beispiel für die Erstellung eines Bootstrapper-Pakets zu sehen, lesen Sie den Abschnitt Anleitung: Erstellen Sie einen benutzerdefinierten Bootstrapper mit einer Datenschutzmeldung.

Um ein Bootstrapper-Paket zu erstellen, müssen Sie ein Produktmanifest erstellen und für jede lokalisierte Version einer Komponente auch ein Paketmanifest erstellen.

  • Das Produktmanifest ,product.xml, enthält alle sprachneutralen Metadaten für das Paket. Dies enthält Metadaten, die allen lokalisierten Versionen der verteilbaren Komponente gemeinsam sind. Informationen zum Erstellen dieser Datei finden Sie unter How to: Create a Product Manifest.

  • Das Paketmanifest, package.xml, enthält sprachspezifische Metadaten; sie enthält in der Regel lokalisierte Fehlermeldungen. Eine Komponente muss mindestens ein Paketmanifest für jede lokalisierte Version dieser Komponente aufweisen. Informationen zum Erstellen dieser Datei finden Sie unter How to: Create a Package Manifest.

Nachdem diese Dateien erstellt wurden, fügen Sie die Produktmanifestdatei in einen Ordner ein, der für den benutzerdefinierten Bootstrapper benannt ist. Die Paketmanifestdatei wird in einen Ordner mit dem Namen des Gebietsschemas verschoben. Wenn die Paketmanifestdatei beispielsweise für die englische Umverteilung vorgesehen ist, legen Sie die Datei in einen Ordner namens "en" ein. Wiederholen Sie diesen Vorgang für jede Sprache, z. B. ja für Japanisch und de für Deutsch. Das endgültige benutzerdefinierte Bootstrapper-Paket könnte die folgende Ordnerstruktur aufweisen.

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

Kopieren Sie als Nächstes die Redistributable-Dateien in den Bootstrapper-Ordner. Weitere Informationen finden Sie unter Erstellen eines lokalisierten Bootstrapper-Pakets.

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

oder

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

Hinweis

Der oben unter dem Visual Studio-Installationspfad aufgeführte Pfad funktioniert ab der Visual Studio 2019 Update 7-Version.

Sie können auch den Ordnerspeicherort des Bootstrappers aus dem Pfadwert im folgenden Registrierungsschlüssel finden:

*HKLM\Software\Microsoft\GenericBootstrapper*

Verwenden Sie auf 64-Bit-Systemen den folgenden Registrierungsschlüssel:

*HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper*

Jede weiterverteilbare Komponente wird in einem eigenen Unterordner unter dem Paketverzeichnis angezeigt. Das Produktmanifest und die weiterverteilbaren Dateien müssen in diesen Unterordner eingefügt werden. Lokalisierte Versionen der Komponenten- und Paketmanifeste müssen in Unterordnern mit dem Namen "Kulturname" eingefügt werden.

Nachdem diese Dateien in den Bootstrapperordner kopiert wurden, wird das Bootstrapper-Paket automatisch im Dialogfeld "Voraussetzungen von Visual Studio" angezeigt. Wenn Ihr benutzerdefiniertes Bootstrapperpaket nicht angezeigt wird, schließen Sie das Dialogfeld "Voraussetzungen ", und öffnen Sie es erneut. Weitere Informationen finden Sie im Dialogfeld "Voraussetzungen".

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die automatisch vom Bootstrapper ausgefüllt werden.

Eigentum BESCHREIBUNG
Anwendungsname Der Name der Anwendung.
Prozessorarchitektur Der Prozessor und die Bits pro Wort der Plattform, auf die eine ausführbare Datei ausgerichtet ist. Folgende Werte sind gültig:

-Intel
- IA64
- AMD64
VersionNT Die Versionsnummer für die Windows-Betriebssysteme. Die Syntax der Version lautet "Major.Minor.ServicePack".
VersionMSI Die Version der Windows Installer-Assembly (msi.dll), die während der Installation ausgeführt werden soll.
AdminUser Diese Eigenschaft wird festgelegt, wenn der Benutzer über Administratorrechte verfügt. Werte sind wahr oder falsch.
Installationsmodus Der Installationsmodus gibt an, wo die Komponente installiert werden muss. Folgende Werte sind gültig:

- HomeSite – Voraussetzungen werden von der Webseite des Anbieters heruntergeladen und installiert.
- SpecificSite – Erforderliche Komponenten werden vom von Ihnen ausgewählten Speicherort installiert.
- SameSite – Erforderliche Komponenten werden von demselben Speicherort wie die Anwendung installiert.

Trennen Sie Weiterverteilungskomponenten von Anwendungsinstallationen

Sie können verhindern, dass Ihre weiterverteilbaren Dateien in Setupprojekten bereitgestellt werden. Erstellen Sie dazu eine verteilbare Liste im Ordner "RedistList" in Ihrem .NET Framework-Verzeichnis:

%ProgramFiles%\Microsoft.NET\RedistList

Die verteilbare Liste ist eine XML-Datei, die Sie mit dem folgenden Format benennen sollten: <Firmenname>.<Komponentenname>.RedistList.xml. Wenn die Komponente z. B. "DataWidgets" von Acme genannt wird, verwenden Sie Acme.DataWidgets.RedistList.xml. Ein Beispiel für den Inhalt der weiterverteilten Liste könnte wie folgt aussehen:

<?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>

Verwandte Inhalte

  • Last updated on