Freigeben über


Erstellen von Bootstrapperpaketen

Das Setupprogramm ist ein generisches Installationsprogramm, das für die Ermittlung und die Installation von weitervertreibbaren Komponenten wie Windows Installer (MSI-Format) und ausführbaren Programmen konfiguriert werden kann.Das Installationsprogramm wird auch als Bootstrapper bezeichnet.Der Bootstrapper wird mithilfe einer Reihe von XML-Manifesten programmiert, mit denen die Metadaten zur Verwaltung der Komponenteninstallation angegeben werden.

Der Bootstrapper ermittelt zunächst, ob erforderliche Komponenten bereits installiert sind.Ist dies nicht der Fall, werden vom Bootstrapper die Lizenzverträge angezeigt.Nachdem der Endbenutzer die Lizenzverträge akzeptiert hat, beginnt die Installation der erforderlichen Komponenten.Wurden alle erforderlichen Komponenten ermittelt, wird direkt das Installationsprogramm der Anwendung gestartet.

Erstellen von benutzerdefinierten Paketen

Sie können den Bootstrapper Manifest-Generator verwenden, um die Manifeste für das Bootstrapperpaket zu erstellen.Alternativ können Sie die Manifeste mit dem XML-Editor in Visual Studio erstellen.Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines Paketmanifests und Gewusst wie: Erstellen eines Produktmanifests.Ein Beispiel für das Erstellen eines Bootstrapperpakets finden Sie unter Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten Bootstrappers zum Anzeigen einer Datenschutzeingabeaufforderung.

Zur Erstellung eines Bootstrapperpakets muss die weitervertreibbare Komponente in Form einer EXE- oder MSI-Datei im Bootstrapper Manifest-Generator angegeben werden.Dann werden vom Bootstrapper Manifest-Generator die folgenden Dateien erstellt:

  • Das Produktmanifest, product.xml, das alle sprachneutralen Metadaten für das Paket enthält.Es enthält Metadaten, die für alle lokalisierten Versionen der verteilbaren Komponente gleich sind.

  • Das Paketmanifest, package.xml, das sprachspezifische Metadaten und in der Regel auch lokalisierte Fehlermeldungen enthält.Eine Komponente benötigt für jede lokalisierte Version dieser Komponente mindestens ein Paketmanifest.

Nachdem diese Dateien erstellt wurden, platzieren Sie die Produktmanifestdatei in einen entsprechend benannten Ordner für den benutzerdefinierten Bootstrapper.Die Paketmanifestdatei muss in einem Ordner, der dem Gebietsschema entsprechend benannt wurde, abgelegt werden.Wenn die Paketmanifestdatei z. B. für die Neuverteilung in englischer Sprache vorgesehen ist, legen Sie die Datei in einen Ordner mit der Bezeichnung "en" ab.Wiederholen Sie diesen Prozess für jedes Gebietsschema, z. B. "ja" für Japanisch und "de" für Deutsch.Das abschließende benutzerdefinierte Bootstrapperpaket könnte beispielsweise über die folgende Ordnerstruktur verfügen.

CustomBootstrapperPackage

product.xml

CustomBootstrapper.msi

de

eula.rtf

package.xml

en

eula.rtf

package.xml

ja

eula.rtf

package.xml

Schließlich kopieren Sie die verteilbaren Dateien in den Bootstrapperordner.Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines lokalisierten Bootstrapperpakets.

\Program Files\Microsoft SDKs\Windows\v7.0A\Bootstrapper\Packages

Sie können auch den Speicherort des Bootstrapperordners mithilfe des Werts Pfad im folgenden Registrierungsschlüssel bestimmen:

HKLM\Software\Microsoft\GenericBootstrapper\4.0

Auf 64 Bitsystemen verwenden Sie den folgenden Registrierungsschlüssel:

HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper\4.0

Jede verteilbare Komponente wird unter dem Paketverzeichnis in einem eigenen Unterordner angezeigt.Das Produktmanifest und die verteilbaren Dateien werden dann in diesem Unterordner abgelegt.Lokalisierte Versionen der Komponente und Paketmanifeste werden in Unterordner eingefügt, die entsprechend dem Kulturnamen benannt sind.Weitere Informationen über Kulturnamen finden Sie in der Tabelle Localization-Eigenschaft.

Nachdem diese Dateien in den Bootstrapperordner kopiert wurden, wird das Bootstrapperpaket in Visual Studio automatisch im Dialogfeld für die erforderlichen Komponenten angezeigt.Wird das benutzerdefinierte Bootstrapperpaket nicht angezeigt, schließen Sie das Dialogfeld für die erforderlichen Komponenten, und öffnen Sie es erneut.Weitere Informationen finden Sie unter Dialogfeld "Erforderliche Komponenten".

In der folgenden Tabelle werden die Eigenschaften angezeigt, die automatisch vom Bootstrapper eingetragen werden.

Property

Beschreibung

ApplicationName

Der Name der Anwendung.

ProcessorArchitecture

Der Prozessor und die Bits pro Wort für die Plattform, auf die eine ausführbare Datei zielt.Folgende Werte sind gültig:

  • Intel

  • IA64

  • AMD64

Version9x

Die Versionsnummer für Microsoft Windows 95, Windows 98 oder Windows ME.Die Syntax der Version lautet "Major.Minor.ServicePack".

VersionNT

Die Versionsnummer für Windows NT, Windows 2000, Windows XP, Windows Vista, Windows Server 2008 oder Windows 7.Die Syntax der Version lautet "Major.Minor.ServicePack".

VersionMSI

Die Version der Windows Installer-Assembly (msi.dll), die während der Installation ausgeführt wird.

AdminUser

Diese Eigenschaft wird festgelegt, wenn der Benutzer über Administratorrechte verfügt.Gültige Werte sind "true" und "false".

InstallMode

Der Installationsmodus gibt an, von welchem Speicherort die Komponente installiert werden muss.Folgende Werte sind gültig:

  • HomeSite: Die erforderlichen Komponenten werden von der Website des Anbieters installiert.

  • SpecificSite: Die erforderlichen Komponenten werden vom ausgewählten Speicherort installiert.

  • SameSite: Die erforderlichen Komponenten werden vom gleichen Speicherort wie die Anwendung installiert.

Trennen von weitervertreibbaren Komponenten von Anwendungsinstallationen

Sie können die Bereitstellung von verteilbaren Dateien in Setupprojekten auch deaktivieren.Erstellen Sie hierzu im Ordner "RedistList" im Verzeichnis von .NET Framework eine verteilbare Liste:

%ProgramFiles%\Microsoft.NET\RedistList

Die verteilbare Liste ist eine XML-Datei, die entsprechend dem folgenden Format benannt wird: Firmenname.Komponentenname.RedistList.xml.Beispiel: Wenn die Komponente "Datawidgets" heißt und von der Firma Acme stammt, nennen Sie die Datei "Acme.DataWidgets.RedistList.xml".Der Inhalt der verteilbaren Liste könnte in etwa so 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>

Siehe auch

Aufgaben

Gewusst wie: Installieren von erforderlichen Komponenten mit einer ClickOnce-Anwendung

Referenz

Dialogfeld "Erforderliche Komponenten"

Referenz zum Produkt- und Paketschema

Weitere Ressourcen

Use the Visual Studio 2005 Bootstrapper to Kick-Start Your Installation