Exemplarische Vorgehensweise: Bereitstellen einer Windows-basierten Anwendung

Artikel
09/03/2008

Aktualisiert: November 2007

In dieser exemplarischen Vorgehensweise wird der Vorgang des Erstellens eines Installationsprogramms für eine Windows-basierte Anwendung beschrieben, die den Editor startet. In dieser exemplarischen Vorgehensweise erstellen Sie die Windows-basierte Anwendung. Anschließend erstellen Sie ein Installationsprogramm, das während der Installation Verknüpfungen und Dateizuordnungen einrichtet, einen Eintrag zur Registrierung hinzufügt, benutzerdefinierte Dialogfelder anzeigt und die Version von Internet Explorer überprüft.

Beim Erstellen eines eigenen Installationsprogramms sind nicht alle der folgenden Schritte notwendig. Ziel dieser exemplarischen Vorgehensweise ist es, Sie mit einigen – für Sie unter Umständen hilfreichen – optionalen Bereitstellungsmöglichkeiten bekannt zu machen. Führen Sie die ersten vier Vorgehensweisen aus, um ein einfaches Installationsprogramm zu erstellen.

Hinweis:
Die angezeigten Dialogfelder und Menübefehle können sich je nach den aktiven Einstellungen oder der verwendeten Version von den in der Hilfe beschriebenen unterscheiden. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren, um die Einstellungen zu ändern. Weitere Informationen hierzu finden Sie unter Visual Studio-Einstellungen.

Hinweis:
In den folgenden Anweisungen wird erläutert, wie ein Bereitstellungsobjekt mithilfe eines Visual Basic-Projekts erstellt wird. Die allgemeinen Prinzipien gelten für alle Visual Studio-Sprachprojekte, die das Bereitstellen von Windows-basierten Anwendungen unterstützen.

Grundlegende Anwendungserstellung und -bereitstellung

So erstellen Sie eine Windows-basierte Anwendung

Klicken Sie im Menü Datei auf Neues Projekt.
Wählen Sie im Dialogfeld Neues Projekt im Bereich Projekttypen den Typ Visual Basic aus, und klicken Sie dann im Bereich Vorlagen auf Windows-Anwendung. Geben Sie im Feld Name die Zeichenfolge My Notepad ein.
Klicken Sie auf OK, um das Dialogfeld zu schließen.

Das Projekt wird dem Projektmappen-Explorer hinzugefügt, und der Windows Forms-Designer wird geöffnet.
Wählen Sie in der Toolbox die Registerkarte Alle Windows Forms aus, und ziehen Sie ein Button-Steuerelement auf das Formular.
Doppelklicken Sie auf das Button-Steuerelement, um einen Ereignishandler für die Schaltfläche hinzuzufügen. Fügen Sie im Ereignishandler folgenden Code hinzu:
```
Shell("Notepad.exe", AppWinStyle.NormalFocus)
```
Dadurch wird Notepad.exe gestartet und erhält den Eingabefokus.
Klicken Sie im Menü Erstellen auf My Notepad erstellen, um die Anwendung zu erstellen.

So erstellen Sie ein Bereitstellungsprojekt

Zeigen Sie im Menü Datei auf Hinzufügen, und klicken Sie auf Neues Projekt.
Öffnen Sie im Dialogfeld Neues Projekt hinzufügen im Bereich Projekttypen den Knoten Andere Projekttypen, klicken Sie auf Setup- und Bereitstellungsprojekte, und klicken Sie dann im Bereich Vorlagen auf Setup-Projekt. Geben Sie im Feld Name die Zeichenfolge My Notepad Installer ein.
Klicken Sie auf OK, um das Dialogfeld zu schließen.

Das Projekt wird zum Projektmappen-Explorer hinzugefügt, und der Dateisystem-Editor wird geöffnet.
Wählen Sie das Projekt My Notepad Installer im Projektmappen-Explorer aus. Wählen Sie im Eigenschaftenfenster die ProductName-Eigenschaft aus, und geben Sie My Notepad ein.

Hinweis:

Die ProductName-Eigenschaft gibt den Namen an, der in Ordnernamen und im Dialogfeld Software für die Anwendung angezeigt wird.

Hinweis:
Die ProductName-Eigenschaft gibt den Namen an, der in Ordnernamen und im Dialogfeld Software für die Anwendung angezeigt wird.

So fügen Sie die Windows-basierte Anwendung dem Installationsprogramm hinzu

Wählen Sie das Projekt My Notepad Installer im Projektmappen-Explorer aus. Markieren Sie im Dateisystem-Editor den Knoten Anwendungsordner.
Zeigen Sie im Menü Projekt auf Hinzufügen, und klicken Sie dann auf Projektausgabe.
Wählen Sie im Dialogfeld Projektausgabegruppe hinzufügen in der Liste Projekt den Eintrag My Notepad aus.
Wählen Sie die Gruppe Primäre Ausgabe aus der Liste aus. Wählen Sie im Feld Konfiguration die Option (Aktiv) aus. Klicken Sie auf OK, um das Dialogfeld zu schließen.
Klicken Sie im Menü Erstellen auf My Notepad Installer erstellen.

So stellen Sie die Anwendung bereit (einfaches Installationsprogramm)

Wählen Sie das Projekt My Notepad Installer im Projektmappen-Explorer aus. Klicken Sie im Menü Projekt auf Installieren.

Dadurch wird das Installationsprogramm (Setup-Assistent) ausgeführt und My Notepad auf dem Entwicklungscomputer installiert.

Hinweis:

Zum Ausführen des Installationsprogramms benötigen Sie entsprechende Installationsberechtigungen für den Computer.

Hinweis:
Zum Ausführen des Installationsprogramms benötigen Sie entsprechende Installationsberechtigungen für den Computer.

Optionale Bereitstellungsmöglichkeiten

Dieser Schritt beschreibt optionale Bereitstellungsmöglichkeiten; es wird eine Verknüpfung mit der Anwendung erstellt, die während der Installation auf dem Desktop eines Zielcomputers platziert wird.

So erstellen Sie Verknüpfungen für die Windows-basierte Anwendung

Wählen Sie das Projekt My Notepad Installer im Projektmappen-Explorer aus.
Wählen Sie im Dateisystem-Editor den Knoten Primäre Ausgabe von My Notepad aus.
Klicken Sie im Menü Aktion auf Verknüpfung erstellen zu Primäre Ausgabe von My Notepad.

Dadurch wird der Knoten Verknüpfung zur primären Ausgabe von My Notepad hinzugefügt.
Benennen Sie die Verknüpfung in Shortcut to My Notepad um.
Wählen Sie Shortcut to My Notepad aus, und ziehen Sie diese in den Ordner Desktop des Benutzers im linken Bereich.

Erstellen einer Dateizuordnung

In diesem Schritt wird eine Dateizuordnung für My Notepad hinzugefügt, sodass durch Doppelklicken auf eine VBN-Datei die Anwendung My Notepad gestartet wird.

So erstellen Sie Dateizuordnungen für die Windows-basierte Anwendung

Wählen Sie das Projekt My Notepad Installer im Projektmappen-Explorer aus. Zeigen Sie im Menü Ansicht auf Editor, und klicken Sie dann auf Dateitypen. Der Dateityp-Editor wird angezeigt.
Wählen Sie im Dateityp-Editor den Knoten Dateitypen auf dem Zielcomputer aus. Klicken Sie im Menü Aktion auf Dateityp hinzufügen.

Der Knoten Neuer Dokumenttyp #1 wird hinzugefügt und für das Umbenennen geöffnet.
Ändern Sie die Bezeichnung Neuer Dokumenttyp #1 in Vbn.doc.
Legen Sie im Eigenschaftenfenster die Extensions-Eigenschaft des Dateityps auf vbn fest.
Wählen Sie die Command-Eigenschaft aus, und klicken Sie auf die Schaltfläche mit den Auslassungszeichen (...). Navigieren Sie im Dialogfeld Element im Projekt auswählen zum Anwendungsordner, und wählen Sie Primäre Ausgabe von My Notepad aus.
Klicken Sie auf OK, um das Dialogfeld zu schließen.

Hinzufügen eines Registrierungseintrags

Dieser Schritt fügt der Registrierung einen Registrierungsschlüssel und einen Wert hinzu. Sie können aus dem Code der Anwendung auf diesen Registrierungsschlüssel verweisen, um zur Laufzeit benutzerspezifische Informationen abzurufen.

So fügen Sie einen Registrierungseintrag für die Windows-basierte Anwendung hinzu

Wählen Sie das Projekt My Notepad Installer im Projektmappen-Explorer aus. Zeigen Sie im Menü Ansicht auf Editor, und wählen Sie dann Registrierung aus. Der Registrierungs-Editor wird angezeigt.

Wählen Sie im Registrierungs-Editor den Knoten HKEY_CURRENT_USER aus, erweitern Sie ihn, erweitern Sie dann den Knoten Software, und wählen Sie den Knoten [Manufacturer] aus.

Hinweis:
Der Knoten [Manufacturer] ist in eckige Klammern gesetzt, um anzugeben, dass dies eine Eigenschaft ist. Er wird durch den Wert ersetzt, der für das Bereitstellungsprojekt für die Manufacturer-Eigenschaft eingesetzt wird.

Zeigen Sie im Menü Aktion auf Neu, und klicken Sie dann auf Schlüssel.
Benennen Sie den Schlüssel in UserChoice um, und wählen Sie ihn aus.
Zeigen Sie im Menü Aktion auf Neu, und klicken Sie dann auf Zeichenfolgenwert.
Benennen Sie den Zeichenfolgenwert in TextColor um.
Wählen Sie im Eigenschaftenfenster die Value-Eigenschaft aus, und geben Sie Black ein.

Hinzufügen eines benutzerdefinierten Installationsdialogfelds

In diesem Schritt wird ein benutzerdefiniertes Dialogfeld der Benutzeroberfläche hinzugefügt und konfiguriert, das während der Installation angezeigt wird.

So fügen Sie ein benutzerdefiniertes Installationsdialogfeld hinzu

Wählen Sie das Projekt My Notepad Installer im Projektmappen-Explorer aus. Zeigen Sie im Menü Ansicht auf Editor, und klicken Sie dann auf Benutzeroberfläche. Der Benutzeroberflächen-Editor wird angezeigt.
Wählen Sie im Benutzeroberflächen-Editor unter dem Knoten Installieren den Knoten Starten aus.
Klicken Sie im Menü Aktion auf Dialogfeld hinzufügen.
Wählen Sie im Dialogfeld Dialogfeld hinzufügen die Option Kontrollkästchen (A) aus.
Klicken Sie auf OK, um das Dialogfeld zu schließen.
Klicken Sie mit der rechten Maustaste in das Dialogfeld Kontrollkästchen (A), und wählen Sie zweimal Nach oben aus, um es über dem Dialogfeld Installationsordner zu positionieren.
Legen Sie im Eigenschaftenfenster die BannerText-Eigenschaft auf Samples fest.
Legen Sie die BodyText-Eigenschaft wie folgt fest:

The Install Samples check box controls whether the sample files are installed. If left unselected, the samples will not be installed.
Legen Sie die CheckBox1Label-Eigenschaft auf Install samples?
Legen Sie die Eigenschaften Checkbox2Visible, Checkbox3Visible und Checkbox4Visible auf False fest. Dadurch werden die zusätzlichen Kontrollkästchen ausgeblendet.

Arbeiten mit Beispielen

In diesem Schritt wird ein Unterordner Samples erstellt, der unterhalb des Anwendungsordners installiert wird.

So fügen Sie einen Beispielordner hinzu

Wählen Sie das Projekt My Notepad Installer im Projektmappen-Explorer aus. Zeigen Sie im Menü Ansicht auf Editor, und klicken Sie dann auf Dateisystem. Wählen Sie Anwendungsordner aus, wenn dies nicht bereits ausgewählt ist.
Klicken Sie mit der rechten Maustaste auf Anwendungsordner, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Ordner.
Benennen Sie Neuer Ordner #1 in Beispiele um.

In diesem Schritt werden zwei Beispieltextdateien erstellt, die installiert werden, wenn der Benutzer im benutzerdefinierten Dialogfeld die Option Beispiele installieren auswählt.

So erstellen Sie Beispieldateien für die Anwendung

Erstellen Sie mit Editor oder einem anderen Text-Editor eine Textdatei, die den Text This is rules.vbn enthält. Speichern Sie sie unter dem Namen Rules.vbn.

Hinweis:

Damit Editor nicht automatisch eine TXT-Erweiterung anhängt, wählen Sie in der Dropdownliste Dateityp den Eintrag Alle Dateien aus.
Erstellen Sie eine weitere Textdatei, die den Text This is memo.vbn enthält. Speichern Sie sie unter dem Namen Memo.vbn.

Hinweis:
Damit Editor nicht automatisch eine TXT-Erweiterung anhängt, wählen Sie in der Dropdownliste Dateityp den Eintrag Alle Dateien aus.

In diesem Schritt werden die Beispieldateien dem Beispielordner hinzugefügt, und es wird eine Bedingung festgelegt, die bestimmt, ob die Dateien installiert werden sollen.

So fügen Sie die Beispiele dem Installationsprogramm hinzu

Wählen Sie das Projekt My Notepad Installer im Projektmappen-Explorer aus. Zeigen Sie im Menü Ansicht auf Editor, zeigen Sie auf Dateisystem, und wählen Sie dann den Ordner Beispiele aus.
Zeigen Sie im Menü Aktion auf Hinzufügen, und klicken Sie dann auf Datei. Fügen Sie die beiden Dateien Rules.vbn und Memo.vbn zum Ordner Beispiele hinzu.
Wählen Sie im Dateisystem-Editor die Datei Rules.vbn aus.
Legen Sie im Eigenschaftenfenster die Condition-Eigenschaft auf CHECKBOXA1=1 fest. Wenn das Installationsprogramm ausgeführt wird, wird die Datei Rules.vbn nur dann installiert, wenn das benutzerdefinierte Kontrollkästchen aktiviert ist.
Wählen Sie die Datei Memo.vbn im Dateisystem-Editor aus.
Legen Sie im Eigenschaftenfenster die Condition-Eigenschaft auf CHECKBOXA1=1 fest. Wenn das Installationsprogramm ausgeführt wird, wird die Datei Memo.vbn nur dann installiert, wenn das benutzerdefinierte Kontrollkästchen aktiviert ist.

Hinzufügen von Startbedingungen

In diesem Schritt wird überprüft, ob auf einem Zielcomputer Internet Explorer 5.0 oder eine spätere Version installiert ist. Wenn dies nicht der Fall ist, wird die Installation beendet.

So fügen Sie eine Startbedingung hinzu, um die Version von Internet Explorer zu prüfen

Wählen Sie das Projekt My Notepad Installer im Projektmappen-Explorer aus. Zeigen Sie im Menü Ansicht auf Editor, und klicken Sie anschließend auf Startbedingungen.

Hinweis:

Dieser Schritt soll lediglich das Konzept von Startbedingungen veranschaulichen; die Anwendung My Notepad weist keine Abhängigkeit von Internet Explorer auf.
Wählen Sie im Editor für Startbedingungen den Knoten Anforderungen für den Zielcomputer aus.
Klicken Sie im Menü Aktion auf Dateistartbedingung hinzufügen.

Der Knoten Nach der Datei 1 suchen wird unterhalb des Knotens Zielcomputer durchsuchen hinzugefügt, und ein Knoten Bedingung 1 wird unterhalb des Knotens Startbedingungen hinzugefügt.
Benennen Sie Nach der Datei 1 suchen in Search for Internet Explorer um.
Legen Sie im Eigenschaftenfenster die FileName-Eigenschaft auf Iexplore.exe, die Folder-Eigenschaft auf [ProgramFilesFolder], die Depth-Eigenschaft auf 2 und die MinVersion-Eigenschaft auf 5.00 fest.
Markieren Sie den Knoten Bedingung 1.
Legen Sie die Message-Eigenschaft wie folgt fest:

This program requires Microsoft Internet Explorer 5.0 or later. Please install Internet Explorer and rerun the Notepad installer.

Hinweis:
Dieser Schritt soll lediglich das Konzept von Startbedingungen veranschaulichen; die Anwendung My Notepad weist keine Abhängigkeit von Internet Explorer auf.

Festlegen von Eigenschaften für erforderliche Komponenten

In diesem Schritt wird eine Eigenschaft festgelegt, durch die automatisch .NET Framework installiert wird, wenn auf dem Zielcomputer nicht die richtige Version vorhanden ist. Beachten Sie, dass das .NET Framework 2.0-Paket auch die Windows Installer 2.0-Dateien installiert.

Wenn die Eigenschaften für erforderliche Komponenten wie folgt festgelegt sind, wird durch Klicken auf die Datei setup.exe automatisch das .NET Framework installiert, bevor die MSI-Datei ausgeführt wird (Dies ist die Standardeinstellung). Weitere Informationen zum Festlegen von erforderlichen Komponenten finden Sie unter Dialogfeld "Erforderliche Komponenten".

So legen Sie optionale Eigenschaften für das Bereitstellungsprojekt fest

Wählen Sie das Projekt My Notepad Installer im Projektmappen-Explorer aus. Klicken Sie im Menü Ansicht auf die Option Eigenschaftenseiten.
Geben Sie im Dialogfeld My Notepad Installer Property Pages unter URL für Installation den URL eines Servers oder einer Website an, von dem bzw. der die Anwendung und/oder die erforderlichen Komponenten installiert werden. Klicken Sie auf die Schaltfläche Erforderliche Komponenten.
Vergewissern Sie sich, dass im Dialogfeld Erforderliche Komponenten unter Zu installierende erforderliche Komponenten auswählen die Option .NET Framework ausgewählt ist (Diese sollte standardmäßig ausgewählt sein). Akzeptieren Sie unter Installationsort für erforderliche Komponenten angeben die Standardeinstellung.
Klicken Sie im Menü Erstellen auf My Notepad Installer erstellen.

Installieren auf dem Entwicklungscomputer

Mit diesem Schritt wird das Installationsprogramm ausgeführt und My Notepad auf dem Entwicklungscomputer installiert.

So installieren Sie "My Notepad" auf dem Entwicklungscomputer

Wählen Sie das Projekt My Notepad Installer im Projektmappen-Explorer aus. Klicken Sie im Menü Projekt auf Installieren.

Hinweis:

Zum Ausführen des Installationsprogramms benötigen Sie entsprechende Installationsberechtigungen für den Computer.

Hinweis:
Zum Ausführen des Installationsprogramms benötigen Sie entsprechende Installationsberechtigungen für den Computer.

Bereitstellen an einen anderen Computer

Mit diesem Schritt wird das Installationsprogramm ausgeführt und My Notepad auf einem anderen Computer installiert.

So geben Sie "My Notepad" an einen anderen Computer weiter

Navigieren Sie in Windows Explorer zu dem Projektverzeichnis, und suchen Sie das erstellte Installationsprogramm. Der Standardpfad lautet \Dokumente und Einstellungen\Ihr Anmeldename\Eigene Dateien\Visual Studio 9.0\Projects\Name des Projektmappenordners\My Notepad Installer\Projektkonfiguration\My Notepad Installer.msi (Die standardmäßige Projektkonfiguration lautet entweder Debug oder Relase).

Kopieren Sie My Notepad Installer.msi, Setup.exe und alle anderen Dateien und Unterverzeichnisse im Verzeichnis auf einen anderen Computer.

Hinweis:
Wenn Sie die Installation auf einem Computer durchführen möchten, der nicht mit einem Netzwerk verbunden ist, kopieren Sie die Dateien auf ein Medium, beispielsweise eine CD-ROM.

Doppelklicken Sie auf dem Zielcomputer auf die Datei Setup.exe, um das Installationsprogramm auszuführen.

Hinweis:

Zum Ausführen des Installationsprogramms benötigen Sie entsprechende Installationsberechtigungen für den Zielcomputer.

Hinweis:
Zum Ausführen des Installationsprogramms benötigen Sie entsprechende Installationsberechtigungen für den Zielcomputer.

Testen

In diesem Schritt werden das Starten der Anwendung über eine Desktopverknüpfung sowie das Deinstallieren der Anwendung getestet.

So testen Sie die Installation

Überprüfen Sie, ob die Verknüpfung auf dem Desktop installiert ist und die Anwendung My Notepad damit ordnungsgemäß gestartet werden kann.
Deinstallieren Sie die Anwendung mithilfe der Option Software in der Systemsteuerung. Wählen Sie im Dialogfeld Software die Anwendung My Notepad aus, und klicken Sie dann auf die Schaltfläche Entfernen.

Hinweis:

Zum Deinstallieren der Anwendung auf Ihrem Entwicklungscomputer klicken Sie im Menü Projekt auf Deinstallieren.
Das Symbol sollte von dem Desktop entfernt werden, und die installierten Anwendungsdateien und -ordner sollten von dem Computer gelöscht werden.