Anleitung: Manuelles Bereitstellen einer ClickOnce-Anwendung, die kein erneutes Signieren erfordert und Brandinginformationen beibehält.

Wenn Sie eine ClickOnce-Anwendung erstellen und dann einem Kunden das Veröffentlichen und Bereitstellen übergeben, musste der Kunde das Bereitstellungsmanifest traditionell aktualisieren und erneut signieren. Obwohl dies in den meisten Fällen immer noch die bevorzugte Methode ist, können Sie mit .NET Framework 3.5 ClickOnce-Bereitstellungen erstellen, die von Kunden bereitgestellt werden können, ohne ein neues Bereitstellungsmanifest neu generieren zu müssen. Weitere Informationen finden Sie unter Anwendungen mit ClickOnce für Test- und Produktionsserver bereitstellen, ohne sie neu zu signieren.

Wenn Sie eine ClickOnce-Anwendung erstellen und sie dann einem Kunden zur Veröffentlichung und Bereitstellung übergeben, kann die Anwendung das Branding des Kunden verwenden oder Ihr Branding beibehalten. Wenn es sich bei der Anwendung beispielsweise um eine einzige proprietäre Anwendung handelt, sollten Sie Ihr Branding beibehalten. Wenn die Anwendung für jeden Kunden stark angepasst ist, sollten Sie das Branding des Kunden verwenden. Mit .NET Framework 3.5 können Sie Ihre Branding-, Herausgeberinformationen und Sicherheitssignatur beibehalten, wenn Sie einer Organisation eine Anwendung zur Bereitstellung zugeben. Weitere Informationen finden Sie unter ClickOnce-Anwendungen erstellen, die von anderen bereitgestellt werden sollen.

Voraussetzungen

Zum Ausführen der Schritte in dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

• Eine Windows Forms-Anwendung, die Sie bereitstellen können. Diese Anwendung wird als WindowsFormsApp1 bezeichnet.

• Visual Studio oder das Windows SDK.

Zum Bereitstellen einer ClickOnce-Anwendung mit Unterstützung für mehrere Bereitstellungen und Markenbildung mithilfe von Mage.exe

1. Öffnen Sie eine Visual Studio-Eingabeaufforderung oder eine Windows SDK-Eingabeaufforderung, und wechseln Sie in das Verzeichnis, in dem Sie Ihre ClickOnce-Dateien speichern.

2. Erstellen Sie ein Verzeichnis, das nach der aktuellen Version Ihrer Bereitstellung benannt ist. Wenn Sie die Anwendung zum ersten Mal bereitstellen, wählen Sie wahrscheinlich "1.0.0.0.0" aus.

   Hinweis

   Die Version Ihrer Bereitstellung unterscheidet sich möglicherweise von der Version Ihrer Anwendungsdateien.

3. Erstellen Sie ein Unterverzeichnis namens "bin ", und kopieren Sie alle Ihre Anwendungsdateien hier, einschließlich ausführbarer Dateien, Assemblys, Ressourcen und Datendateien.

4. Generieren Sie das Anwendungsmanifest mit einem Aufruf von Mage.exe.

   mage -New Application -ToFile 1.0.0.0\WindowsFormsApp1.exe.manifest -Name "Windows Forms App 1" -Version 1.0.0.0 -FromDirectory 1.0.0.0\bin -UseManifestForTrust true -Publisher "A. Datum Corporation"
   

5. Signieren Sie das Anwendungsmanifest mit Ihrem digitalen Zertifikat.

   mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfx
   

6. Generieren Sie das Bereitstellungsmanifest mit einem Aufruf von Mage.exe. Standardmäßig kennzeichnet Mage.exe Ihre ClickOnce-Bereitstellung als installierte Anwendung, sodass sie sowohl online als auch offline ausgeführt werden kann. Um die Anwendung nur verfügbar zu machen, wenn der Benutzer online ist, verwenden Sie das -i Argument mit einem Wert von f. Da diese Anwendung die Funktion für mehrere Bereitstellungen nutzt, schließen Sie das -providerUrl-Argument bei der Ausführung von Mage.exe aus. (In Versionen von .NET Framework vor Version 3.5 führt das Ausschließen -providerUrl einer Offlineanwendung zu einem Fehler.)

   mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest
   

7. Signieren Sie das Bereitstellungsmanifest nicht.

8. Stellen Sie dem Kunden alle Dateien bereit, damit er die Anwendung in seinem Netzwerk bereitstellen kann.

9. Zu diesem Zeitpunkt muss der Kunde das Bereitstellungsmanifest mit seinem eigenen selbst generierten Zertifikat signieren. Wenn der Kunde beispielsweise für ein Unternehmen mit dem Namen Adventure Works arbeitet, kann er mithilfe des toolsMakeCert.exe ein selbstsigniertes Zertifikat generieren. Verwenden Sie als Nächstes das Pvk2pfx.exe Tool, um die von MakeCert.exe erstellten Dateien in einer PFX-Datei zu kombinieren, die an Mage.exeübergeben werden kann.

   makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
   pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx
   

10. Der Kunde verwendet dieses Zertifikat als Nächstes, um das Bereitstellungsmanifest zu signieren.

    mage -Sign WindowsFormsApp1.application -CertFile MyCert.pfx
    

11. Der Kunde stellt die Anwendung für ihre Benutzer bereit.

So stellen Sie eine ClickOnce-Anwendung mit Unterstützung für mehrere Bereitstellungen und Branding mithilfe von MageUI.exe bereit.

1. Öffnen Sie eine Visual Studio-Eingabeaufforderung oder eine Windows SDK-Eingabeaufforderung, und navigieren Sie zu dem Verzeichnis, in dem Sie Ihre ClickOnce-Dateien speichern.

2. Erstellen Sie ein Unterverzeichnis namens "bin ", und kopieren Sie alle Ihre Anwendungsdateien hier, einschließlich ausführbarer Dateien, Assemblys, Ressourcen und Datendateien.

3. Erstellen Sie ein Unterverzeichnis, das nach der aktuellen Version Ihrer Bereitstellung benannt ist. Wenn Sie die Anwendung zum ersten Mal bereitstellen, wählen Sie wahrscheinlich "1.0.0.0.0" aus.

   Hinweis

   Die Version Ihrer Bereitstellung unterscheidet sich möglicherweise von der Version Ihrer Anwendungsdateien.

4. Verschieben Sie das Verzeichnis "\bin " in das Verzeichnis, das Sie in Schritt 2 erstellt haben.

5. Starten Sie das grafische Tool MageUI.exe.

   MageUI.exe
   

6. Erstellen Sie ein neues Anwendungsmanifest, indem Sie im Menü "Datei", " Neu", " Anwendungsmanifest " auswählen.

7. Geben Sie auf der Registerkarte " Standardname " den Namen und die Versionsnummer dieser Bereitstellung ein. Geben Sie außerdem einen Wert für Publisher an, der beim Bereitstellen als Ordnername für den Verknüpfungslink der Anwendung im Startmenü verwendet wird.

8. Wählen Sie die Registerkarte "Anwendungsoptionen " aus, und klicken Sie auf " Anwendungsmanifest für Vertrauensinformationen verwenden". Dadurch wird das Branding von Drittanbietern für diese ClickOnce-Anwendung aktiviert.

9. Wählen Sie die Registerkarte "Dateien " aus, und klicken Sie auf die Schaltfläche " Durchsuchen " neben dem Textfeld "Anwendungsverzeichnis ".

10. Wählen Sie das Verzeichnis aus, das Ihre Anwendungsdateien enthält, die Sie in Schritt 2 erstellt haben, und klicken Sie im Dialogfeld "Ordnerauswahl" auf "OK ".

11. Klicken Sie auf die Schaltfläche " Auffüllen ", um alle Anwendungsdateien zur Dateiliste hinzuzufügen. Wenn Ihre Anwendung mehr als eine ausführbare Datei enthält, markieren Sie die ausführbare Hauptdatei für diese Bereitstellung als Startanwendung, indem Sie den Einstiegspunkt aus der Dropdownliste " Dateityp " auswählen. (Wenn Ihre Anwendung nur eine ausführbare Datei enthält, markierenMageUI.exe sie für Sie.)

12. Wählen Sie die Registerkarte "Berechtigungen erforderlich" und dann die Vertrauensstufe aus, die Ihre Anwendung bestätigen muss. Die Standardeinstellung ist "Voll vertrauenswürdig", die für die meisten Anwendungen geeignet ist.

13. Wählen Sie "Datei", " Speichern " aus dem Menü aus, und speichern Sie das Anwendungsmanifest. Sie werden aufgefordert, das Anwendungsmanifest zu signieren, wenn Sie es speichern.

14. Wenn Sie ein Zertifikat als Datei im Dateisystem gespeichert haben, verwenden Sie die Option " Als Zertifikatdatei signieren ", und wählen Sie das Zertifikat aus dem Dateisystem mithilfe der Schaltfläche mit den Auslassungspunkten (...) aus.

    -oder-

    Wenn Ihr Zertifikat in einem Zertifikatspeicher gespeichert ist, auf den von Ihrem Computer aus zugegriffen werden kann, wählen Sie die Option "Mit gespeichertem Zertifikat signieren" aus, und wählen Sie das Zertifikat aus der bereitgestellten Liste aus.

15. Wählen Sie im Menü "Datei", "Neu", " Bereitstellungsmanifest " aus, um Ihr Bereitstellungsmanifest zu erstellen, und geben Sie dann auf der Registerkarte "Name " einen Namen und eine Versionsnummer an (in diesem Beispiel 1.0.0.0 ).

16. Wechseln Sie zur Registerkarte "Aktualisieren ", und geben Sie an, wie oft diese Anwendung aktualisiert werden soll. Wenn Ihre Anwendung die ClickOnce-Bereitstellungs-API verwendet, um nach Updates selbst zu suchen, deaktivieren Sie das Kontrollkästchen "Diese Anwendung sollte auf Updates überprüfen".

17. Wechseln Sie zur Registerkarte "Anwendungsreferenz ". Sie können alle Werte auf dieser Registerkarte vorab auffüllen, indem Sie auf die Schaltfläche " Manifest auswählen " klicken und das Anwendungsmanifest auswählen, das Sie in den vorherigen Schritten erstellt haben.

18. Wählen Sie "Speichern" aus, und speichern Sie das Bereitstellungsmanifest auf dem Datenträger. Sie werden aufgefordert, das Anwendungsmanifest zu signieren, wenn Sie es speichern. Klicken Sie auf "Abbrechen ", um das Manifest zu speichern, ohne es zu signieren.

19. Stellen Sie dem Kunden alle Anwendungsdateien bereit.

20. Zu diesem Zeitpunkt muss der Kunde das Bereitstellungsmanifest mit seinem eigenen selbst generierten Zertifikat signieren. Wenn der Kunde beispielsweise für ein Unternehmen mit dem Namen Adventure Works arbeitet, kann er mithilfe des toolsMakeCert.exe ein selbstsigniertes Zertifikat generieren. Verwenden Sie als Nächstes das Pvk2pfx.exe Tool, um die von MakeCert.exe erstellten Dateien in einer PFX-Datei zu kombinieren, die an MageUI.exeübergeben werden kann.

    makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
    pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx
    

21. Nachdem das Zertifikat generiert wurde, signiert der Kunde nun das Bereitstellungsmanifest, indem er das Bereitstellungsmanifest in MageUI.exeöffnet und dann speichert. Wenn das Dialogfeld "Signieren" angezeigt wird, wählt der Kunde die Option " Als Zertifikatdatei signieren " aus und wählt die PFX-Datei aus, die er auf dem Datenträger gespeichert hat.

22. Der Kunde stellt die Anwendung für ihre Benutzer bereit.

Verwandte Inhalte

• Mage.exe (Manifestgenerierung und Bearbeitungstool)
• MageUI.exe (Manifestgenerierungs- und Bearbeitungstool, grafischer Client)
• MakeCert