Genomgång: Distribuera ett ClickOnce-program manuellt som inte kräver omsignering och som bevarar varumärkesinformation

När du skapar ett ClickOnce-program och sedan ger det till en kund att publicera och distribuera, har kunden traditionellt varit tvungen att uppdatera distributionsmanifestet och signera om det. Det är fortfarande den bästa metoden i de flesta fall, men med .NET Framework 3.5 kan du skapa ClickOnce-distributioner som kan distribueras av kunder utan att behöva återskapa ett nytt distributionsmanifest. Mer information finns i Distribuera ClickOnce-program för testning och produktionsservrar utan att avgå.

När du skapar ett ClickOnce-program och sedan ger det till en kund att publicera och distribuera kan programmet använda kundens varumärke eller bevara ditt varumärke. Om programmet till exempel är ett enda proprietärt program kanske du vill bevara ditt varumärke. Om programmet är mycket anpassat för varje kund kanske du vill använda kundens varumärke. Med .NET Framework 3.5 kan du bevara varumärkes-, utgivarinformationen och säkerhetssignaturen när du ger ett program till en organisation att distribuera. Mer information finns i Skapa ClickOnce-program för andra att distribuera.

Förutsättningar

För att utföra stegen i den här genomgången behöver du följande:

• Ett Windows Forms-program som du är redo att distribuera. Det här programmet kallas WindowsFormsApp1.

• Visual Studio eller Windows SDK.

Distribuera ett ClickOnce-program med stöd för flera distributioner och varumärken med hjälp av Mage.exe

1. Öppna en Visual Studio-kommandotolk eller en Windows SDK-kommandotolk och ändra till katalogen där du ska lagra dina ClickOnce-filer.

2. Skapa en katalog med namnet efter den aktuella versionen av distributionen. Om det är första gången du distribuerar programmet väljer du förmodligen 1.0.0.0.

   Anmärkning

   Distributionsversionen kan skilja sig från versionen av dina programfiler.

3. Skapa en underkatalog med namnet bin och kopiera alla dina programfiler här, inklusive körbara filer, sammansättningar, resurser och datafiler.

4. Generera programmanifestet med ett anrop till 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. Signera programmanifestet med ditt digitala certifikat.

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

6. Generera distributionsmanifestet med ett anrop till Mage.exe. Som standard markerar Mage.exe din ClickOnce-distribution som ett installerat program så att den kan köras både online och offline. Om du bara vill göra programmet tillgängligt när användaren är online använder du -i argumentet med värdet f. Eftersom det här programmet kommer att dra nytta av funktionen för flera distributioner, utelämna -providerUrl-argumentet till Mage.exe. (I versioner av .NET Framework före version 3.5 resulterar exkludering -providerUrl för ett offlineprogram i ett fel.)

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

7. Signera inte distributionsmanifestet.

8. Ange alla filer till kunden, som distribuerar programmet i sitt nätverk.

9. I det här läget måste kunden signera distributionsmanifestet med sitt eget självgenererade certifikat. Om kunden till exempel arbetar för ett företag med namnet Adventure Works kan han generera ett självsignerat certifikat med hjälp av verktygetMakeCert.exe . Använd sedan verktygetPvk2pfx.exe för att kombinera de filer som skapats av MakeCert.exe till en PFX-fil som kan skickas till Mage.exe.

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

10. Kunden använder sedan det här certifikatet för att signera distributionsmanifestet.

    mage -Sign WindowsFormsApp1.application -CertFile MyCert.pfx
    

11. Kunden distribuerar programmet till sina användare.

Distribuera ett ClickOnce-program med stöd för flera distributioner och varumärken med hjälp av MageUI.exe

1. Öppna en Visual Studio-kommandotolk eller en Windows SDK-kommandotolk och navigera till katalogen där du ska lagra dina ClickOnce-filer.

2. Skapa en underkatalog med namnet bin och kopiera alla dina programfiler här, inklusive körbara filer, sammansättningar, resurser och datafiler.

3. Skapa en underkatalog med namnet efter den aktuella versionen av distributionen. Om det är första gången du distribuerar programmet väljer du förmodligen 1.0.0.0.

   Anmärkning

   Distributionsversionen kan skilja sig från versionen av dina programfiler.

4. Flytta katalogen \bin till den katalog som du skapade i steg 2.

5. Starta det grafiska verktyget MageUI.exe.

   MageUI.exe
   

6. Skapa ett nytt programmanifest genom att välja Arkiv, Nytt, Programmanifest på menyn.

7. På fliken Namn som standard anger du namn och versionsnummer för den här distributionen. Ange också ett värde för Publisher, som ska användas som mappnamn för programmets genvägslänk på Start-menyn när det distribueras.

8. Välj fliken Programalternativ och klicka på Använd programmanifest för förtroendeinformation. Detta aktiverar varumärkesanpassning från tredje part för det här ClickOnce-programmet.

9. Välj fliken Filer och klicka på knappen Bläddra bredvid textrutan Application Directory .

10. Välj den katalog som innehåller dina programfiler som du skapade i steg 2 och klicka på OK i dialogrutan för mappval.

11. Klicka på knappen Fyll i för att lägga till alla programfiler i fillistan. Om programmet innehåller mer än en körbar fil markerar du den körbara huvudfilen för den här distributionen som startprogram genom att välja Startpunkt i listrutan Filtyp . (Om ditt program bara innehåller en körbar fil markerarMageUI.exe den åt dig.)

12. Välj fliken Behörigheter som krävs och välj den förtroendenivå som du behöver för programmet. Standardvärdet är Fullständigt förtroende, vilket är lämpligt för de flesta program.

13. Välj Arkiv, Spara på menyn och spara programmanifestet. Du uppmanas att signera programmanifestet när du sparar det.

14. Om du har ett certifikat som lagras som en fil i filsystemet använder du alternativet Signera som certifikatfil och väljer certifikatet från filsystemet med hjälp av ellipsknappen (...).

    -or-

    Om certifikatet sparas i ett certifikatarkiv som kan nås från datorn väljer du alternativet Signera med lagrat certifikat och väljer certifikatet i listan som anges.

15. Välj Arkiv, Nytt, Distributionsmanifest på menyn för att skapa distributionsmanifestet och ange sedan ett namn och versionsnummer (1.0.0.0 i det här exemplet på fliken Namn).

16. Växla till fliken Uppdatera och ange hur ofta du vill att programmet ska uppdateras. Om ditt program använder Api:et för ClickOnce-distribution för att söka efter själva uppdateringarna avmarkerar du kryssrutan med etiketten Det här programmet bör söka efter uppdateringar.

17. Växla till fliken Programreferens . Du kan fylla i alla värden på den här fliken i förväg genom att klicka på knappen Välj manifest och välja programmanifestet som du skapade i föregående steg.

18. Välj Spara och spara distributionsmanifestet på disken. Du uppmanas att signera programmanifestet när du sparar det. Klicka på Avbryt för att spara manifestet utan att signera det.

19. Tillhandahåll alla programfiler till kunden.

20. I det här läget måste kunden signera distributionsmanifestet med sitt eget självgenererade certifikat. Om kunden till exempel arbetar för ett företag med namnet Adventure Works kan han generera ett självsignerat certifikat med hjälp av verktygetMakeCert.exe . Använd sedan verktygetPvk2pfx.exe för att kombinera de filer som skapats av MakeCert.exe till en PFX-fil som kan skickas till MageUI.exe.

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

21. När certifikatet har genererats signerar kunden nu distributionsmanifestet genom att öppna distributionsmanifestet i MageUI.exeoch sedan spara det. När dialogrutan signering visas väljer kunden alternativet Signera som certifikatfil och väljer den PFX-fil som han har sparat på disken.

22. Kunden distribuerar programmet till sina användare.

Relaterat innehåll

• Mage.exe (manifestgenererings- och redigeringsverktyg)
• MageUI.exe (manifestgenererings- och redigeringsverktyg, grafisk klient)
• MakeCert