Verwenden des Bootstrapperbeispiels für "Setup.exe" mit einer Anwendung

Artikel
09/02/2008

Aktualisiert: November 2007

Die mit dem Bootstrapperbeispiel für Setup.exe durchgeführten Operationen finden automatisch statt. Wenn Sie jedoch Setup.exe die Verwendung der Anwendung ermöglichen möchten, müssen Sie eine benutzerdefinierte Datei Settings.ini mit den erforderlichen Informationen zur Anwendung erstellen. Weiterhin wird empfohlen, das Setupprogramm mit einer Infodatei auszustatten, in der Benutzer die Mindestkonfigurationsanforderungen zum Installieren der Anwendung und Dotnetfx.exe finden. Die folgenden Abschnitte enthalten ausführliche Informationen über das Erstellen der Datei Settings.ini und der Infodatei:

Erstellen einer Settings.ini-Datei
Erstellen einer "Readme"-Datei für das Setupprogramm

Erstellen einer Settings.ini-Datei

Im Bootstrapperbeispiel für Setup.exe wird mithilfe der externen Datei Settings.ini Folgendes bestimmt:

Der Speicherort für Dotnetfx.exe und die Hostanwendung
Die zu suchende Sprachversion von .NET Framework
Die für Setup.exe-Dialogfelder zu verwendenden benutzerdefinierten Zeichenfolgen

Der Standardspeicherort von Settings.ini ist der Ordner, in dem auch Setup.exe gespeichert ist. Erstellen Sie eine Datei Settings.ini, die es dem Bootstrapperbeispiel für Setup.exe ermöglicht, zusammen mit der Anwendung ausgeführt zu werden. Sie können die im Bootstrapperbeispiel für Setup.exe enthaltene Datei Settings.ini kopieren und nach Bedarf bearbeiten, um die richtigen Werte für die Anwendung anzugeben.

Angeben des Speicherortes für "Dotnetfx.exe" und die Hostanwendung

Für das Bootstrapperbeispiel für Setup.exe müssen sich Dotnetfx.exe und die .NET Framework-Hostanwendung in Relation zu Setup.exe an einem bekannten Speicherort befinden. Im Bootstrapperbeispiel für Setup.exe wird mithilfe der externen Datei Settings.ini der Speicherort der Dotnetfx.exe und der Hostanwendung bestimmt. Sie können die im Beispiel enthaltene Datei Settings.ini kopieren und so bearbeiten, dass sie auf den Speicherort der .NET Framework-Hostanwendung und auf Dotnetfx.exe verweist.

In den folgenden Beispielen für Settings.ini-Dateien wird veranschaulicht, wie Sie auf ein Windows Installer-Paket (mySetup.msi) für eine .NET Framework-Hostanwendung und für Dotnetfx.exe verweisen, das sich relativ zu Setup.exe an verschiedenen Speicherorten befindet.

In der folgenden Settings.ini-Beispieldatei befinden mySetup.msi und Dotnetfx.exe im selben Ordner wie Setup.exe. Nicht angepasste Zeilen werden mit einem Apostroph (') auskommentiert.

[Bootstrap]
Msi=mySetup.msi
'LanguageDirectory=
ProductName= My Application 
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\

In der folgenden Settings.ini-Beispieldatei befinden mySetup.msi und Dotnetfx.exe getrennt von Setup.exe auf einer Netzwerkfreigabe.

[Bootstrap]
Msi=\\myNetworkShare\myProjectFolder\mySetup.msi
'LanguageDirectory=
ProductName=My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=\\myNetworkShare\myProjectFolder\

In der folgenden Settings.ini-Beispieldatei befinden mySetup.msi und Dotnetfx.exe auf demselben Computer wie Setup.exe, jedoch in anderen Verzeichnissen.

[Bootstrap]
Msi=c:\myInstallerFiles\mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myExecutables\

In der folgenden Settings.ini-Beispieldatei befinden mySetup.msi und Dotnetfx.exe auf derselben CD wie Setup.exe, jedoch in anderen Verzeichnissen.

[Bootstrap]
Msi=myInstallerFiles/mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=myExecutables/

Angeben der Sprachversion

Wenn Setup.exe eine Buildnummer und eine Sprachversion von .NET Framework ermitteln soll, müssen Sie den Kulturnamen der zu suchenden Sprache in der Datei Settings.ini angeben. Wenn Sie keinen Kulturnamen angeben, sucht Setup.exe standardmäßig nach der englischen Sprachversion.

Die folgende Tabelle enthält eine Auflistung der verfügbaren Sprachversionen sowie die jeweiligen in der Datei Settings.ini anzugebenden Kulturnamen. Bei Kulturnamen wird die Groß- und Kleinschreibung berücksichtigt.

Sprache	Kulturname
Chinesisch (vereinfacht)	chs
Chinesisch (traditionell)	cht
Französisch	fr
Deutsch	de
Italienisch	it
Japanisch	ja
Koreanisch	ko
Spanisch	es

Die folgende Settings.ini-Beispieldatei weist Setup.exe an, die französische Sprachversion von Dotnetfx.exe zu suchen.

[Bootstrap]
Msi=mySetup.msi
LanguageDirectory=fr
ProductName= My Application 
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\

Anpassen von Zeichenfolgen für "Setup.exe"-Dialogfelder

Sie können in der Datei Settings.ini die folgenden Variablen bearbeiten, um die in den Dialogfeldern von Setup.exe angezeigten Zeichenfolgen anzupassen.

ProductName gibt den Namen der .NET Framework-Anwendung an, die von Setup.exe installiert wird. Der angegebene Produktname wird zum Anpassen des Texts im Dialogfelder verwendet, das nach dem Starten von Setup.exe angezeigt wird. Wenn Sie beispielsweise unter ProductName die Zeichenfolge My Application angeben, wird im Dialogfeld der folgende Text angezeigt: "Klicken Sie zum Starten des My Application-Setups auf OK. Um Setup zu beenden, ohne die Anwendung zu installieren, klicken Sie auf Abbrechen."

Wenn Sie die Variable CaptionText nicht anpassen, wird ProductName auch zum Anpassen der Titelleiste des Dialogfelds verwendet, das nach dem Starten von Setup.exe angezeigt wird. Wenn Sie unter ProductName beispielsweise My Application angeben, wird in der Titelleiste "My Application-Setup" angezeigt. Wenn Sie sowohl ProductName als auch CaptionText angeben, wird zum Anpassen der Titelleiste dieses Dialogfelds CaptionText verwendet.

ProductName wird auch verwendet, um den Titelleistentext in dem Dialogfeld anzupassen, das nach Abschluss der Installation angezeigt wird. Wenn Sie ProductName nicht anpassen, wird der Standardtext "Anwendungs-Setup" angezeigt.
DialogText gibt den im Dialogfeld anzuzeigenden benutzerdefinierten Text an, der nach dem Starten von Setup.exe angezeigt wird. Wenn Sie DialogText nicht anpassen, wird der Standardtext "Klicken Sie zum Starten des Anwendungs-Setups auf OK. Um Setup zu beenden, ohne die Anwendung zu installieren, klicken Sie auf Abbrechen."
CaptionText gibt den benutzerdefinierten Text für die Titelleiste des Dialogfelds an, der nach dem Starten von Setup.exe angezeigt wird. Wenn Sie CaptionText nicht anpassen, wird ProductName angezeigt. Wenn Sie ProductName nicht anpassen, wird der Standardtext "Anwendungs-Setup" angezeigt.
ErrorCaptionText gibt den in der Titelleiste der Fehlerdialogfelder von Setup.exe anzuzeigenden benutzerdefinierten Text an. Wenn Sie ErrorCaptionText nicht anpassen, wird der Standardtext "Fehler beim Setup für eine Anwendung" angezeigt.

Erstellen einer "Readme"-Datei für das Setupprogramm

Es wird empfohlen, das Setupprogramm mit einer Infodatei zu verteilen, in der die Mindestkonfigurationsanforderungen für einen Computer angegeben sind, auf dem das Setupprogramm ausgeführt werden soll. Führen Sie mindestens Microsoft Windows 98 oder höher und Internet Explorer 5.01 oder höher als Anforderung für die Installation auf. Weiterhin sollte Microsoft Data Access Components (MDAC), Version 2.6 oder höher, mit der Angabe aufgelistet werden, dass dieses Programm nicht zu den Installationsvoraussetzungen zählt, jedoch für .NET Framework-Anwendungen erforderlich ist, die Datenzugriff verwenden. Weitere Informationen zu den Mindestkonfigurationsanforderungen für die Installation von Dotnetfx.exe finden Sie unter Mindestkonfigurationsanforderungen.