Exemplarische Vorgehensweise: Konfigurieren von Team Foundation Build zum Erstellen eines Visual Studio-Setup-Projekts

Artikel
08/20/2007

Sie können Team Foundation Build anpassen, indem Sie benutzerdefinierte Aufgaben hinzufügen oder MSBuild-Aufgaben verwenden, die zu einem bestimmten Zeitpunkt während des Buildprozesses ausgeführt werden. In diesem Thema werden die erforderlichen Schritte zum Anpassen eines Buildtyps beschrieben, damit die MSBuild Exec-Aufgabe zum Erstellen eines Visual Studio-Setup-Projekts verwendet werden kann.

Vorbereitungsmaßnahmen

Für diese exemplarische Vorgehensweise wird Folgendes benötigt:

Ein Clientcomputer mit folgenden Eigenschaften:

Visual Studio Team Edition for Developers ist installiert.
Team Explorer ist installiert.
Eine Verbindung zu einem Team Foundation Server ist verfügbar.
Ein lokales Verzeichnis, das als Arbeitsbereich verwendet werden kann.
Ein Teamprojekt mit folgenden Eigenschaften:
- Ein erstellter Team Foundation Build-Typ.
- Ein Arbeitsbereich für die Quellcodeverwaltung, der dem lokalen Verzeichnis zugeordnet ist. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines Arbeitsbereichs. In dieser exemplarischen Vorgehensweise wird der lokale Arbeitsbereich C:\DeploymentProjects verwendet.
- Aktivierte Quellcodeverwaltung
  
  Um sicherzustellen, dass Visual Studio für die Verwendung von Quellcodeverwaltung in Team Foundation konfiguriert ist, klicken Sie im Menü Extras auf Optionen und dann auf Quellcodeverwaltung. Wählen Sie im Listenfeld Aktuelles Quellcodeverwaltungs-Plug-In die Option Visual Studio Team Foundation Server aus.

Ein Buildcomputer mit folgenden Eigenschaften:

Team Foundation Build ist installiert.
Auf dem Buildcomputer muss Visual Studio installiert sein, damit zum Erstellen eines Setup-Projekts devenv.exe von der MSBuild Exec-Aufgabe aufgerufen werden kann.

Erforderliche Berechtigungen

Für dieses Verfahren müssen die Berechtigungen Build verwalten und Arbeitsbereiche verwalten auf Zulassen festgelegt sein. Weiterhin müssen die Berechtigungen Einchecken und Auschecken auf Zulassen festgelegt sein.

Zum Erstellen eines Teamprojekts muss die Neue Projekte erstellen-Berechtigung auf Zulassen festgelegt sein. Weiterhin müssen Sie Mitglied der Gruppe SharePoint Central Admins von Windows SharePoint Server sein und in SQL Reporting Services über Inhalts-Manager-Berechtigungen verfügen.

Sie müssen auf dem Computer, auf dem das von Team Foundation Build erstellte Installationsprogamm ausgeführt wird, über die Berechtigung zum Installieren verfügen.

Erstellen eines Visual Studio-Projekts

In dieser exemplarischen Vorgehensweise wird eine einfache Windows-Anwendung in C# als Beispiel für die Konfiguration von Team Foundation Build zum Erstellen eines Visual Studio-Setup-Projekts erstellt.

So erstellen Sie eine Windows-Anwendung in Visual Studio

Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Wählen Sie im Dialogfeld Neues Projekt im Bereich Projekttypen die Option Visual C# aus. Wählen Sie im Bereich Vorlagen die Option Windows-Anwendung aus.
Geben Sie im Feld Name den Namen HelloWorldTest ein. Geben Sie im Feld Speicherort den Pfad C:\DeploymentProjects ein, oder öffnen Sie den für das Teamprojekt ausgewählten lokalen Arbeitsbereich.
Klicken Sie auf OK.

HelloWorldTest wird im Projektmappen-Explorer und Form1.cs im Windows Forms-Designer angezeigt.
Klicken Sie im Menü Ansicht auf Toolbox, um die Liste mit den Steuerelementen anzuzeigen.
Ziehen Sie ein Button-Steuerelement auf das Formular.
Doppelklicken Sie auf die neue Schaltfläche, um den Code-Editor zu öffnen. Eine Methode mit der Bezeichnung button1_Click wurde von Visual C# eingefügt.

Fügen Sie der Methode folgenden Code hinzu:

private void button1_Click(object sender, EventArgs e)
        {
            MessageBox.Show("Hello World!");

        }

Klicken Sie im Menü Datei auf Alle speichern, um die Änderungen zu speichern.
Klicken Sie im Menü Erstellen auf HelloWorldTest erstellen, um die Projektmappe zu erstellen und sich zu vergewissern, dass keine Fehler aufgetreten sind.

So erstellen Sie ein Bereitstellungsprojekt

Wählen Sie im Projektmappen-Explorer die Projektmappe HelloWorldTest aus. Zeigen Sie im Menü Datei auf Hinzufügen, und klicken Sie dann auf Neues Projekt.
Öffnen Sie im Dialogfeld Neues Projekt hinzufügen im Bereich Projekttypen den Knoten Andere Projekttypen. Klicken Sie dann auf Setup- und Bereitstellungsprojekte und anschließend im Bereich Vorlagen auf Setup-Projekt. Geben Sie im Feld Name den Namen HelloWorldTestInstaller 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.

So fügen Sie die HelloWorldTest-Anwendung zum Installationsprogramm hinzu

Wählen Sie im Projektmappen-Explorer HelloWorldTestInstaller aus. Klicken Sie im Dateisystem-Editor mit der rechten Maustaste auf den Knoten Anwendungsordner, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Datei.
Navigieren Sie im Dialogfeld Dateien hinzufügen zum Speicherort von HelloWorldTest.exe, wählen Sie die Anwendung aus, und klicken Sie dann auf Öffnen.

In dieser exemplarischen Vorgehensweise ist der Speicherort C:\DeploymentProjects\HelloWorldTest\HelloWorldTest\obj\Debug\HelloWorldTest.exe. Je nach Speicherort des lokalen Arbeitsbereichs kann der Dateipfad hiervon abweichen.
Klicken Sie im Menü Datei auf Alle speichern, um die Änderungen zu speichern.
Klicken Sie im Menü Erstellen auf HelloWorldTestInstaller erstellen, um eine lokale Kopie des Installationsprogramms zu erstellen und sich zu vergewissern, dass keine Fehler aufgetreten sind.

Um zu überprüfen, dass das Installationsprogramm vom Setup-Projekt erstellt wurde, öffnen Sie den Speicherort der Ausgabedatei. Am Speicherort der Ausgabedatei sollten HelloWorldTestInstaller.msi und setup.exe angezeigt werden.

Hinweis

Um die Ausgabedatei zu finden, klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt HelloWorldTestInstaller und dann auf Eigenschaften. Der Speicherort der Installationsdateien wird im Dialogfeld HelloWorldTestInstaller-Eigenschaftenseiten im Feld Ausgabedateiname angezeigt.

So ändern Sie die Datei vdproj für die Verwendung in Team Foundation Build

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt HelloWorldTestInstaller, und klicken Sie dann auf Eigenschaften. Klicken Sie im Dialogfeld HelloWorldTestInstaller-Eigenschaftenseiten auf den Konfigurations-Manager. Stellen Sie sicher, dass das Kontrollkästchen Erstellen für sowohl HelloWorldTest als auch HelloWorldTestInstaller aktiviert ist.
Klicken Sie auf Schließen, um das Dialogfeld Konfigurations-Manager zu schließen. Klicken Sie auf OK, um das Dialogfeld HelloWorldTestInstaller-Eigenschaftenseiten zu schließen.
Klicken Sie im Menü Datei auf Alle speichern, um die Änderungen zu speichern.
Suchen Sie die Datei HelloWorldTestInstaller.vdproj.

In dieser exemplarischen Vorgehensweise lautet der Speicherort C:\DeploymentProjects\HelloWorldTest\HelloWorldTestInstaller. Je nach Speicherort des lokalen Arbeitsbereichs kann der Dateipfad hiervon abweichen.
Klicken Sie mit der rechten Maustaste auf HelloWorldTestInstaller.vdproj, zeigen Sie auf Öffnen mit, und klicken Sie dann auf Programm auswählen. Wählen Sie im Dialogfeld Öffnen mit im Bereich Programme die Anwendung Editor aus. Klicken Sie dann auf OK, um HelloWorldTestInstaller in Editor zu öffnen.
Stellen Sie sicher, dass alle Dateipfade relativ zum Speicherort der Dateien HelloWorldTestInstaller.vdproj angegeben sind. Es sollte keine absoluten Pfade angezeigt werden.

So fügen Sie HelloWorldTest zur Team Foundation-Quellcodeverwaltung hinzu und checken die Projektmappe in die Quellcodeverwaltung ein

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe HelloWorldTest, und klicken Sie dann auf Projektmappe zur Quellcodeverwaltung hinzufügen. Neben allen Dateien wird ein gelbes Pluszeichen angezeigt. Dieses Zeichen gibt an, dass das Hinzufügen dieser Dateien zur Quellcodeverwaltung aussteht. Weitere Informationen finden Sie unter Gewusst wie: Identifizieren des Status von Elementen unter Quellcodeverwaltung im Projektmappen-Explorer.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe HelloWorldTest, und klicken Sie dann auf Einchecken. Führen Sie im Dialogfeld Einchecken - Quelldateien - Arbeitsbereich: <Arbeitsbereichname> einen Bildlauf zu den ausgewählten Dateien durch. Löschen Sie für HelloWorldTest.exe den Eintrag im Feld Name, und klicken Sie dann auf Einchecken. Die Dateien sind nun in Quellcodeverwaltung in Team Foundation eingecheckt.

Die ausführbare Datei muss nicht eingecheckt werden, da eine neue ausführbare Datei von Team Foundation Build erstellt wird.

Ändern des Team Foundation-Buildtyps

Bevor Sie die Projektmappe HelloWorldTestInstaller mit Team Foundation Build erstellen können, müssen Sie entweder einen neuen Buildtyp erstellen oder einen vorhandenen Buildtyp verwenden, der geändert werden kann. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines neuen Buildtyps. Sie müssen der Buildtyp-Projektdatei Anweisungen zum Erstellen des Setup-Projekts hinzufügen.

So ändern Sie die Datei TFSBuild.proj zum Erstellen des Setup-Projekts

Zeigen Sie im Menü Ansicht auf Weitere Fenster, und klicken Sie dann auf Quellcodeverwaltungs-Explorer.
Erweitern Sie im Quellcodeverwaltungs-Explorer im Bereich Ordner das Teamprojekt, und wählen Sie TeamBuildTypes aus.
Wählen Sie im Anzeigebereich den Buildtyp aus, der zum Erstellen von HelloWorldTest und HelloWorldTestInstaller verwendet werden soll. Wenn Sie einen neuen Team Foundation-Buildtyp verwenden, klicken Sie mit der rechten Maustaste auf den Teambuildtyp-Ordner und dann auf Letzte Version abrufen. Dieser Vorgang ermöglicht das Auschecken der Dateien zum Bearbeiten.
Doppelklicken Sie im Anzeigebereich auf den Buildtyp, klicken Sie mit der rechten Maustaste auf TFSBuild.proj, und klicken Sie dann auf Auschecken zum Bearbeiten. Wählen Sie im Dialogfeld Auschecken die Option Keine - Gemeinsames Auschecken zulassen aus, und klicken Sie dann auf Auschecken.

Neben der Datei TFSBuild.proj wird ein rotes Häkchen angezeigt, das den Quellcodeverwaltungsstatus der Datei angibt.
Doppelklicken Sie auf die Datei TFSBuild.proj, um sie im XML-Editor von Visual Studio zu öffnen.
Fügen Sie den folgenden Code fett formatiert am Ende der Datei TFSBuild.proj hinzu. Ersetzen Sie den Laufwerkbuchstaben C durch einen anderen Laufwerkbuchstaben, wenn es sich bei Ihrem Laufwerk nicht um C handelt.
```
</ItemGroup>
<Target Name="AfterCompile">
    <Exec Command="&quot;C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\devenv&quot;&quot;$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj /Build &quot;Debug|Any CPU&quot;"/>
    <Copy SourceFiles="$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\HelloWorldTestInstaller.msi" DestinationFolder="$(OutDir)" />
<Copy SourceFiles="$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\setup.exe"
DestinationFolder="$(OutDir)" />
</Target>
</Project>
```
Hierbei wird die MSBuild exec-Aufgabe durch Aufrufen des devenv.exe-Programms zum Erstellen des Setup-Projekts HelloWorldTestInstaller verwendet. Durch Release|Any CPU wird die Buildkonfiguration angegeben. Weitere Informationen finden Sie unter Exec-Aufgabe. Mithilfe der MSBuild copy-Aufgabe wird die MSI-Datei in den Ordner Release kopiert. Weitere Informationen finden Sie unter Copy-Aufgabe.

Der AfterCompile-Zielname gibt an, dass devenv.exe die VDPROJ-Datei nach Abschluss des Kompilierungsvorgangs erstellt. Weitere Informationen zu Zielnamen finden Sie unter Team Foundation Build-Konfigurationsdateien.
Klicken Sie im Menü Datei auf Speichern, um die Änderungen zu speichern, und schließen Sie dann TFSBuild.proj.
Klicken Sie im Quellcodeverwaltungs-Explorer mit der rechten Maustaste auf TFSBuild.proj, und klicken Sie dann auf Ausstehende Änderungen einchecken. Wahlweise können Sie im Dialogfeld Einchecken - Quelldateien - Arbeitsbereich: <Arbeitsbereichname> einen Kommentar eingeben. Klicken Sie auf Einchecken, um TFSBuild.proj in die Quellcodeverwaltung einzuchecken.

Ausführen des Team Foundation-Buildtyps

Nachdem Sie die Datei TFSBuild.proj geändert und die Änderungen in Quellcodeverwaltung in Team Foundation gespeichert haben, führen Sie zum Erstellen des Bereitstellungsprojekts den Buildtyp aus.

So führen Sie den Teambuildtyp aus

Klicken Sie im Menü Erstellen auf Teamprojekt erstellen: <Teamprojektname>.
Wählen Sie im Dialogfeld "Teamprojektname" erstellen den zu verwendenden Buildtyp aus, und klicken Sie dann auf Erstellen.

Sie können den Buildprozess in Team Build Browser überwachen. Weitere Informationen finden Sie unter Gewusst wie: Überwachen des Buildstatus.
Klicken Sie in Team Build Browser unter der Überschrift Zusammenfassung auf die Protokolldatei. Untersuchen Sie die Protokolldatei auf Fehler.

Hinweis

Die folgende Warnung MSB4078 kann ignoriert werden: Die Projektdatei "HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj" wird nicht von MSBuild unterstützt und kann nicht erstellt werden. Die Datei wird vom devenv.exe-Programm mithilfe der MSBuild Exec-Aufgabe erstellt.

So installieren Sie die generierte Setupdatei

Suchen Sie den Ablagespeicherort des Builds \\<Ablagespeicherort>\Public_build\HelloWorldTestBuild_<Buildnummer>\Release.

Der Ablagespeicherort befindet sich in der gleichen Dateifreigabe wie der Speicherort der Protokolldatei und wird in Team Build Browser unter der Überschrift Zusammenfassung angezeigt.
Kopieren Sie die Dateien HelloWorldTestInstaller.msi und setup.exe auf einen Computer, auf dem Sie Mitglied der Sicherheitsgruppe Windows-Administrator sind bzw. über die Installieren-Berechtigung verfügen.
Doppelklicken Sie auf die Datei setup.exe, und befolgen Sie die Anweisungen des Installations-Assistenten.

HelloWorldTestInstaller.exe wird im Verzeichnis <Stamm>:\Programme\Microsoft\HelloWorldTestInstaller installiert.
Navigieren Sie zum Verzeichnis <Stamm>:\Programme\Microsoft\HelloWorldTestInstaller.
Doppelklicken Sie auf die EXE-Datei, um die Anwendung auszuführen.

Nächste Schritte

Sie können das Visual Studio-Setup-Projekt bearbeiten, um den Installations-Assistenten für weitere Schritte zu konfigurieren. Weitere Informationen finden Sie unter Konzepte der Windows Installer-Bereitstellung.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Anpassen von Team Foundation Build mithilfe einer benutzerdefinierten Aufgabe

Weitere Ressourcen

Arbeiten mit Buildtypen in Team Foundation Build
Verwalten von Builds mit Team Foundation Build

Freigeben über