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

Aktualisiert: November 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 einer Builddefinition beschrieben, damit die Aufgabe MSBuild Exec 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:

  • Development Edition installiert

  • Team Explorer installiert

  • Eine verfügbare Verbindung zu einem Team Foundation Server

  • Ein lokales Verzeichnis, das als Arbeitsbereich verwendet werden kann

Ein Teamprojekt mit folgenden Eigenschaften:

  • Eine erstellte Builddefinition

  • Ein Arbeitsbereich für die Quellcodeverwaltung, der dem lokalen Verzeichnis zugeordnet ist

    Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines zugeordneten Arbeitsbereichs. In dieser exemplarischen Vorgehensweise wird der lokale Arbeitsbereich C:\DeploymentProjects verwendet.

  • Aktivierte Quellcodeverwaltung

    1. Um sicherzustellen, dass Visual Studio für die Verwendung von Team Foundation-Versionskontrolle konfiguriert ist, klicken Sie im Menü Extras auf Optionen und dann auf Quellcodeverwaltung.

    2. Wählen Sie im Listenfeld Aktuelles Quellcodeverwaltungs-Plug-In die Option Visual Studio Team Foundation Server aus.

Ein Build-Agent, auf dem Team Foundation Build installiert ist. 

Auf dem Build-Agent muss Visual Studio installiert sein, damit die Aufgabe MSBuild Exec zum Aufrufen von devenv.exe verwendet werden kann, um ein Setup-Projekt zu erstellen. Weitere Informationen finden Sie unter Exec-Aufgabe und unter Devenv-Befehlszeilenschalter.

Hinweis:

Der Build-Agent ist ein Computer, auf dem die Builds ausgeführt werden. Weitere Informationen finden Sie unter Gewusst wie: Erstellen und Verwalten von Build-Agents.

Erforderliche Berechtigungen

Damit Sie diese exemplarische Vorgehensweise ausführen können, müssen die Berechtigungen Build verwalten und Arbeitsbereiche verwalten für Sie 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 Installationsprogramm ausgeführt wird, über die Berechtigung zum Installieren verfügen.

Erstellen eines Visual Studio-Projekts

In dieser exemplarischen Vorgehensweise wird eine einfache Windows Forms-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 Forms-Anwendung in Visual Studio

  1. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

  2. Wählen Sie im Dialogfeld Neues Projekt im Bereich Projekttypen die Option Visual C# aus. Wählen Sie im Bereich Vorlagen die Option Windows Forms-Anwendung aus.

  3. 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.

  4. Klicken Sie auf OK.

    HelloWorldTest wird im Projektmappen-Explorer und Form1.cs im Windows Forms-Designer angezeigt.

  5. Klicken Sie im Menü Ansicht auf Toolbox, um die Liste mit den Steuerelementen anzuzeigen.

  6. Ziehen Sie ein Button-Steuerelement auf das Formular.

  7. Doppelklicken Sie auf die neue Schaltfläche, um den Code-Editor zu öffnen.

    Visual C# hat eine Methode mit dem Namen button1_Click eingefügt.

  8. Fügen Sie der Methode folgenden Code hinzu:

    private void button1_Click(object sender, EventArgs e)
            {
                MessageBox.Show("Hello World!");
    
            }
    
  9. Klicken Sie im Menü Datei auf Alle speichern, um die Änderungen zu speichern.

  10. 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

  1. 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.

  2. Erweitern Sie im Dialogfeld Neues Projekt hinzufügen im Bereich Projekttypen den Knoten Andere Projekttypen, klicken Sie auf Setup und Bereitstellung, und klicken Sie dann im Bereich Vorlagen auf Setup-Projekt. Geben Sie im Feld Name den Namen HelloWorldTestInstaller ein.

  3. 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

  1. 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.

  2. 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.

  3. Klicken Sie im Menü Datei auf Alle speichern, um die Änderungen zu speichern.

  4. 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

  1. 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.

  2. 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.

  3. Klicken Sie im Menü Datei auf Alle speichern, um die Änderungen zu speichern.

  4. 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.

  5. 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.

  6. 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

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe HelloWorldTest, und klicken Sie dann auf Projektmappe zur Quellcodeverwaltung hinzufügen.

    Ein gelbes Pluszeichen wird neben den Dateien angezeigt. Dieses Zeichen gibt an, dass das Hinzufügen dieser Dateien zur Quellcodeverwaltung aussteht.

  2. 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 Team Foundation-Versionskontrolle eingecheckt.

    Wichtiger Hinweis:

    Stellen Sie sicher, dass Sie die ausführbare Datei deaktivieren, da Sie Team Foundation Build konfigurieren, um eine neue ausführbare Datei zu erstellen.

Ändern der Datei TFSBuild.proj

Damit Sie das Projekt HelloWorldTestInstaller mit Team Foundation Build erstellen können, müssen Sie entweder eine neue Builddefinition erstellen oder eine vorhandene Builddefinition verwenden, die geändert werden kann. Weitere Informationen finden Sie unter Gewusst wie: Erstellen einer Builddefinition. Sie müssen der Projektdatei TFSBuild.proj, die der Builddefinition zugeordnet ist, die Anweisung zur Erstellung des Setup-Projekts hinzufügen.

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

  1. Zeigen Sie im Menü Ansicht auf Weitere Fenster, und klicken Sie dann auf Quellcodeverwaltungs-Explorer.

  2. Erweitern Sie im Quellcodeverwaltungs-Explorer im Bereich Ordner das Teamprojekt, und navigieren Sie zu der Datei TFSBuild.proj, die Sie erstellt haben. Standardmäßig wird diese Datei im Ordner TeamBuildTypes im Teamprojektordner gespeichert.

  3. Wählen Sie im Anzeigebereich den Buildtyp aus, der zum Erstellen von HelloWorldTest und HelloWorldTestInstaller verwendet werden soll. Wenn Sie in Ihrem lokalen Arbeitsbereich keine Kopie der Datei haben, klicken Sie mit der rechten Maustaste auf den Ordner TeamBuildType, und klicken Sie dann auf Letzte Version abrufen.

    Dieser Vorgang ermöglicht das Auschecken der Dateien zum Bearbeiten.

  4. 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.

  5. Doppelklicken Sie auf die Datei TFSBuild.proj, um sie im XML-Editor von Visual Studio zu öffnen.

  6. Fügen Sie den folgenden Code fett formatiert am Ende der Datei TFSBuild.proj vor dem schließenden </Project>-Tag hinzu.

    <Target Name="AfterCompile">     <Exec Command="&quot;$(ProgramFiles)\Microsoft Visual Studio 9.0\Common7\IDE\devenv&quot; &quot;$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj&quot; /Build &quot;Debug|Any CPU&quot;"/>     <Copy SourceFiles="$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\HelloWorldTestInstaller.msi; SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\setup.exe" DestinationFolder="$(OutDir)" /> </Target> 
    

    Hierbei wird die Aufgabe MSBuild exec durch Aufrufen des devenv.exe-Programms zum Erstellen des Setup-Projekts HelloWorldTestInstaller verwendet. Weitere Informationen finden Sie unter Exec-Aufgabe. Die Aufgabe MSBuild copy wird verwendet, um die MSI- und die EXE-Dateien in das Ausgabeverzeichnis Team Foundation Build zu kopieren. Weitere Informationen finden Sie unter Copy-Aufgabe.

    Das AfterCompile-Ziel wird ausgeführt, wenn Team Foundation Build die Ausführung des CoreCompile-Ziels zur Kompilierung der Anwendung HelloWorldTest beendet hat. Weitere Informationen zu Zielnamen finden Sie unter Team Foundation Build-Konfigurationsdateien.

  7. Klicken Sie im Menü Datei auf Speichern, um die Änderungen zu speichern, und schließen Sie dann TFSBuild.proj.

  8. 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 der Builddefinition

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

So führen Sie die Teambuilddefinition aus

  1. Klicken Sie im Menü Build auf Neuen Build in Warteschlange.

  2. Wählen Sie im Dialogfeld Build "Teamprojektname" zu Warteschlange hinzufügen die zu verwendende Builddefinition, den Build-Agent und die Warteschlangenpriorität aus, und klicken Sie dann auf Warteschlange.

    Weitere Informationen finden Sie unter Gewusst wie: Starten oder Hinzufügen einer Builddefinition zur Warteschlange.

    Sie können den Buildprozess in Build Explorer überwachen. Weitere Informationen finden Sie unter Gewusst wie: Überwachen des Buildstatus.

  3. Klicken Sie in Build Explorer 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 Aufgabe MSBuild Exec erstellt.

So installieren Sie die generierte Setupdatei

  1. 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 unter der Überschrift Zusammenfassung in Build Explorer angezeigt.

  2. 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.

  3. 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.

  4. Navigieren Sie zum Verzeichnis <Stamm>:\Programme\Microsoft\HelloWorldTestInstaller.

  5. 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 Builddefinitionen in Team Foundation Build

Verwalten von Builds mit Team Foundation Build