Erstellen von ClickOnce-Anwendungen über die Befehlszeile

Aktualisiert: Juli 2008

In Visual Studio können Sie Projekte über die Befehlszeile erstellen, auch wenn diese mit der integrierten Entwicklungsumgebung (IDE) erstellt werden. Sie können sogar ein mit Visual Studio erstelltes Projekt auf einem anderen Computer neu erstellen, auf dem lediglich .NET Framework installiert ist. Dadurch kann ein Build mithilfe eines automatisierten Vorgangs reproduziert werden, beispielsweise in einer zentralen Kompilierungsstelle oder mit erweiterten Skripttechniken, die selbst über den Erstellungsumfang des Projekts hinausgehen.

Reproduzieren von ClickOnce-Anwendungsbereitstellungen mit MSBuild

Wenn Sie an der Befehlszeile msbuild /target:publish ausführen, wird von MSBuild das Projekt und im Veröffentlichungsordner eine ClickOnce-Anwendung erstellt. Dies hat den gleichen Effekt wie der Befehl Veröffentlichen in der IDE.

Durch diesen Befehl wird das Programm msbuild.exe ausgeführt, das sich im Pfad der Eingabeaufforderungsumgebung von Visual Studio befindet.

Der Parameter "target" (Ziel) weist MSBuild an, wie der Befehl verarbeitet wird. Die wichtigsten Ziele sind "build" und "publish". Das Buildziel entspricht in der IDE dem Befehl Erstellen (TASTE F5). Wenn Sie das Projekt nur erstellen möchten, können Sie einfach msbuildeingeben. Dieser Befehl ist zulässig, da das Buildziel für alle mit Visual Studio generierten Projekte das Standardziel ist. Dies bedeutet, dass Sie das Buildziel nicht explizit angeben müssen. Deshalb entspricht der Befehl msbuild dem Befehl msbuild /target:build.

Der /target:publish-Parameter weist MSBuild an, das Publishziel aufzurufen. Das Publishziel ist abhängig vom Buildziel. Das heißt, dass der Publishvorgang dem Buildvorgang übergeordnet ist. Wenn Sie beispielsweise eine der Visual Basic- oder C#-Quelldateien geändert haben, wird durch den Publishvorgang die entsprechende Assembly automatisch neu erstellt.

Weitere Informationen zum Generieren einer vollständigen ClickOnce-Bereitstellung mit dem Befehlszeilentool Mage.exe zum Erstellen eines ClickOnce-Manifests finden Sie unter Exemplarische Vorgehensweise: Manuelles Bereitstellen einer ClickOnce-Anwendung.

Erstellen einer einfachen ClickOnce-Anwendung mit MSBuild

So erstellen und veröffentlichen Sie ein ClickOnce-Projekt

1. Klicken Sie im Menü Datei auf Neues Projekt. Das Dialogfeld Neues Projekt wird angezeigt.

2. Wählen Sie Windows-Anwendung aus, und geben Sie dieser den Namen CmdLineDemo.

3. Klicken Sie im Menü Erstellen auf den Befehl Veröffentlichen.

   Mit diesem Schritt stellen Sie sicher, dass das Projekt ordnungsgemäß für das Erzeugen einer ClickOnce-Anwendungsbereitstellung konfiguriert ist.

   Der Webpublishing-Assistent wird angezeigt.

4. Klicken Sie im Webpublishing-Assistenten auf Fertig stellen.

   Visual Studio generiert die Standardwebseite Publish.htm und zeigt diese an.

5. Speichern Sie das Projekt, und notieren Sie sich seinen Speicherort.

Durch die oben beschriebene Vorgehensweise wird ein neu veröffentlichtes ClickOnce-Projekt erstellt. Nun können Sie den Build außerhalb der IDE reproduzieren.

So reproduzieren Sie den Build über die Befehlzeile

1. Beenden Sie Visual Studio.

2. Klicken Sie in Windows im Menü Start auf Alle Programme, klicken Sie dann auf Microsoft Visual Studio 2008 und Visual Studio-Tools, und klicken Sie anschließend auf Visual Studio 2008-Eingabeaufforderung. Dadurch wird im Stammordner des aktuellen Benutzers eine Eingabeaufforderung geöffnet.

3. Wechseln Sie an der Visual Studio 2008-Eingabeaufforderung vom aktuellen Verzeichnis zum Speicherort des eben erstellten Projekts. Geben Sie z. B. chdir Eigene Dateien\Visual Studio\Projects\CmdLineDemo ein.

4. Zum Löschen der im Abschnitt "So erstellen und veröffentlichen Sie ein ClickOnce-Projekt" erstellten Dateien geben Sie rmdir /s publish ein.

   Dieser Schritt ist optional, stellt jedoch sicher, dass die neuen Dateien alle von der Befehlszeile erstellt wurden.

5. Geben Sie msbuild /target:publish ein.

Durch die oben beschriebenen Schritte wird in einem Unterordner des Projekts mit dem Namen Publish eine vollständige ClickOnce-Anwendungsbereitstellung erstellt. CmdLineDemo.application ist das ClickOnce-Bereitstellungsmanifest. Der Ordner CmdLineDemo_1.0.0.0 enthält die Dateien CmdLineDemo.exe und CmdLineDemo.exe.manifest, das ClickOnce-Anwendungsmanifest. Setup.exe ist der Bootstrapper, durch den standardmäßig .NET Framework installiert wird. Der Ordner DotNetFX enthält die verteilbaren Komponenten für .NET Framework. Dies sind alle Dateien, die Sie für die Bereitstellung der Anwendung über das Web, einen UNC-Pfad oder CD/DVD benötigen.

Veröffentlichungseigenschaften

Nach Veröffentlichen der Anwendung mit der oben beschriebenen Vorgehensweise werden durch den Webpublishing-Assistenten die folgenden Eigenschaften in die Projektdatei eingefügt. Diese Eigenschaften beeinflussen direkt die Art und Weise der Erzeugung der ClickOnce-Anwendung.

In CmdLineDemo.vbproj / CmdLineDemo.csproj:

<AssemblyOriginatorKeyFile>WindowsApplication3.snk</AssemblyOriginatorKeyFile>
<GenerateManifests>true</GenerateManifests>
<TargetZone>LocalIntranet</TargetZone>
<PublisherName>Microsoft</PublisherName>
<ProductName>CmdLineDemo</ProductName>
<PublishUrl>https://localhost/CmdLineDemo</PublishUrl>
<Install>true</Install>
<ApplicationVersion>1.0.0.*</ApplicationVersion>
<ApplicationRevision>1</ApplicationRevision>
<UpdateEnabled>true</UpdateEnabled>
<UpdateRequired>false</UpdateRequired>
<UpdateMode>Foreground</UpdateMode>
<UpdateInterval>7</UpdateInterval>
<UpdateIntervalUnits>Days</UpdateIntervalUnits>
<UpdateUrlEnabled>false</UpdateUrlEnabled>
<IsWebBootstrapper>true</IsWebBootstrapper>
<BootstrapperEnabled>true</BootstrapperEnabled>

Sie können diese Eigenschaften an der Befehlszeile überschreiben, ohne die Projektdatei selbst zu ändern. Beispielsweise erstellt der folgende Befehl eine ClickOnce-Anwendungsbereitstellung ohne Bootstrapper:

msbuild /target:publish /property:BootstrapperEnabled=false

Veröffentlichungseigenschaften werden in Visual Studio im Projekt-Designer auf den Eigenschaftenseiten Veröffentlichen, Sicherheit und Signierung verwaltet. Im Folgenden finden Sie eine Beschreibung der Veröffentlichungseigenschaften zusammen mit einem Hinweis, wie diese im Anwendungs-Designer auf den verschiedenen Eigenschaftenseiten festgelegt werden.

• Durch AssemblyOriginatorKeyFile wird die Schlüsseldatei festgelegt, die zur Signierung der ClickOnce-Anwendungsmanifeste verwendet wird. Derselbe Schlüssel kann auch verwendet werden, um Assemblys einen starken Namen zuzuweisen. Diese Eigenschaft wird im Projekt-Designer auf der Seite Signierung festgelegt.

Auf der Seite Sicherheit werden die folgenden Eigenschaften festgelegt:

• Durch ClickOnce-Sicherheitseinstellungen aktivieren wird bestimmt, ob ClickOnce-Manifeste generiert werden. Wenn ein Projekt erstmalig erstellt wird, ist die Generierung von ClickOnce-Manifesten standardmäßig deaktiviert. Bei der ersten Veröffentlichung wird dieser Flag durch den Assistenten automatisch aktiviert.

• Durch TargetZone wird die Vertrauenswürdigkeitsstufe festgelegt, die für das ClickOnce-Anwendungsmanifest ausgegeben wird. Mögliche Werte sind "Internet", "LocalIntranet" und "Custom". Durch die Werte Internet und LocalIntranet wird ein Standardberechtigungssatz in das ClickOnce-Anwendungsmanifest ausgegeben. LocalIntranet ist der Standardwert und steht im Grunde für volle Vertrauenswürdigkeit. Durch Festlegen von Custom (Benutzerdefiniert) werden nur die in der Basisdatei app.manifest explizit angegebenen Berechtigungen an das ClickOnce-Anwendungsmanifest ausgegeben. Die Datei app.manifest ist eine partielle Manifestdatei, die nur die Vertrauenswürdigkeitsdefinitionen enthält. Es handelt sich um eine versteckte Datei, die dem Projekt automatisch hinzugefügt wird, wenn Sie auf der Seite Sicherheit Berechtigungen konfigurieren.

Auf der Seite Veröffentlichen werden die folgenden Eigenschaften festgelegt:

• PublishUrl ist der Speicherort in der IDE, an dem die Anwendung veröffentlicht wird. Dieser wird in das ClickOnce-Anwendungsmanifest eingefügt, wenn weder die InstallUrl-Eigenschaft noch die UpdateUrl-Eigenschaft angegeben ist.

• ApplicationVersion gibt die Version der ClickOnce-Anwendung an. Dies ist eine vierstellige Versionsnummer. Wenn die letzte Stelle ein "*" ist, wird ApplicationRevision durch den zur Buildzeit in das Manifest eingefügten Wert ersetzt.

• ApplicationRevision gibt die Revisionsnummer an. Dies ist eine ganze Zahl, die jedes Mal erhöht wird, wenn in der IDE veröffentlicht wird. Beachten Sie, dass diese nicht automatisch für Builds erhöht wird, die an der Befehlszeile ausgeführt werden.

• Durch Install wird festgelegt, ob es sich um eine installierte Anwendung handelt, oder um eine Anwendung, die über das Web ausgeführt wird.

• InstallUrl (nicht angezeigt) ist der Speicherort, von dem Benutzer die Anwendung installieren. Wenn dieser Wert angegeben ist, wird bei aktivierter IsWebBootstrapper-Eigenschaft dieser Wert in den Setup.exe-Bootstrapper geschrieben. Auch wenn kein UpdateUrl angegeben ist, wird er in das Anwendungsmanifest eingefügt.

• SupportUrl (nicht angezeigt) ist der Speicherort für eine installierte Anwendung, auf den die Verknüpfung im Dialogfeld Software verweist.

Die folgenden Eigenschaften werden auf der Seite Veröffentlichen im Dialogfeld Anwendungsupdates festgelegt.

• Durch UpdateEnabled wird festgelegt, ob die Anwendung nach Updates sucht.

• Durch UpdateMode wird festgelegt, ob die Aktualisierungen im Vordergrund oder im Hintergrund erfolgen.

• UpdateInterval gibt die Häufigkeit von Überprüfungen auf Updates an.

• UpdateIntervalUnits zeigt an, ob der UpdateInterval-Wert in Einheiten von Stunden, Tagen oder Wochen angegeben ist.

• UpdateUrl (nicht angezeigt) ist der Speicherort, von dem die Anwendung die Updates abruft. Dieser Wert wird in das Anwendungsmanifest eingefügt, wenn er angegeben wurde.

• Die folgenden Eigenschaften werden über die Seite Veröffentlichen im Dialogfeld Veröffentlichungsoptionen festgelegt.

• PublisherName gibt den Namen des Herausgebers an, der bei Installation oder Ausführen der Anwendung angezeigt wird. Bei einer installierten Anwendung gibt dieser Wert auch den Namen des Ordners im Startmenü an.

• ProductName gibt den Namen des Produkts an, der bei Installation oder Ausführen der Anwendung angezeigt wird. Bei einer installierten Anwendung gibt dieser Wert auch den Namen der Verknüpfung im Startmenü an.

• Die folgenden Eigenschaften werden über die Seite Veröffentlichen im Dialogfeld Erforderliche Komponenten festgelegt.

• Durch BootstrapperEnabled wird festgelegt, ob der Setup.exe-Bootstrapper generiert wird.

• Durch IsWebBootstrapper wird festgelegt, ob der Setup.exe-Bootstrapper über das Web oder einen lokalen Datenträger ausgeführt wird.

InstallURL, SupportUrl und PublishURL

Sie können drei URLs angeben: InstallURL, SupportUrl und PublishURL. Wenn Sie auf einem Web-URL veröffentlichen, muss nur der PublishURL angegeben werden. Sie müssen die anderen URLs nur angeben, wenn sie sich von dem PublishURL unterscheiden. In der IDE sollten Sie in einem anderen Pfad veröffentlichen, als jenem, den die Endbenutzer zur Installation verwenden. Sie könnten beispielsweise für den PublishURL einen FTP-Pfad verwenden, und für den InstallURL einen Web-URL. In diesem Fall dient der PublishURL in der IDE nur der Dateiübertragung und wird bei Befehlszeilenbuilds nicht verwendet. Schließlich können Sie den UpdateUrl verwenden, wenn Sie eine ClickOnce-Anwendung veröffentlichen, die nicht im Installationspfad nach Updates sucht.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Manuelles Bereitstellen einer ClickOnce-Anwendung

Konzepte

Übersicht über MSBuild

Weitere Ressourcen

ClickOnce-Bereitstellung

Änderungsprotokoll