Ange Egenskaper för ClickOnce-publicering

Du kan konfigurera egenskaper för ClickOnce Publish på sidan Publicera i Projektdesignern eller med hjälp av publiceringsguiden. I den här artikeln får du lära dig hur du anger egenskaper som publiceringsplats, installations-URL:en, online- eller offlineinstallationsläget och publiceringsversionen.

Ange en publiceringsplats

När du publicerar ett program med hjälp av ClickOnce Publish Location anger egenskapen den plats där programfilerna och manifestet placeras. Det kan vara en enhetssökväg (C:\deploy\myapplication), en filresurs (\\server\myapplication) eller en FTP-server (ftp://ftp.microsoft.com/myapplication). Observera att texten måste finnas i rutan Publiceringsplats för att b&ingsknappen (...) ska fungera.

Du kan ange egenskapen Publish Location på sidan Publicera i Projektdesignern eller med hjälp av publiceringsguiden. Mer information finns i Publicera ett ClickOnce-program med hjälp av publiceringsguiden.

1. När ett projekt har valts i Solution Explorer går du till projektmenyn och klickar på Egenskaper.

2. Klicka på fliken Publicera .

3. I fältet Publicera plats anger du publiceringsplatsen med något av följande format:

   • Om du vill publicera till en filresurs eller disksökväg anger du sökvägen med antingen en UNC-sökväg (\\Server\ApplicationName) eller en filsökväg (C:\Deploy\ApplicationName).

   • Om du vill publicera till en FTP-server anger du sökvägen med formatet ftp://ftp.microsoft.com/<ApplicationName>.

     Observera att texten måste finnas i rutan Publiceringsplats för att knappen Bläddra (...) ska fungera.

Ange den plats där slutanvändarna ska installera från

När du publicerar ett ClickOnce-program är den plats där användarna går för att ladda ned och installera programmet inte nödvändigtvis den plats där du först publicerar programmet. I vissa organisationer kan en utvecklare till exempel publicera ett program till en mellanlagringsserver och sedan skulle en administratör flytta programmet till en webbserver.

I det här fallet kan du använda Installation URL egenskapen för att ange den webbserver där användarna ska gå för att ladda ned programmet. Detta är nödvändigt så att programmanifestet vet var uppdateringar ska sökas.

Egenskapen Installation URL kan anges på sidan Publicera i Projektdesignern.

Ange en installations-URL

1. När ett projekt har valts i Solution Explorer går du till projektmenyn och klickar på Egenskaper.

2. Klicka på fliken Publicera .

3. I fältet Installations-URL anger du installationsplatsen med hjälp av en fullständigt kvalificerad URL med formatet https://www.contoso.com/ApplicationNameeller en UNC-sökväg med formatet \Server\ApplicationName.

Ange installationsläget ClickOnce offline eller online

Install Mode För ett ClickOnce-program avgör om programmet ska vara tillgängligt offline eller online. När du väljer Programmet är endast tillgängligt online måste användaren ha åtkomst till clickOnce-publiceringsplatsen (antingen en webbsida eller en filresurs) för att kunna köra programmet. När du väljer Programmet är också tillgängligt offline lägger programmet till poster på Start-menyn och dialogrutan Lägg till eller ta bort program . användaren kan köra programmet när de inte är anslutna.

Install Mode kan anges på sidan Publicera i Projektdesignern.

Gör ett ClickOnce-program endast tillgängligt online

1. När ett projekt har valts i Solution Explorer går du till projektmenyn och klickar på Egenskaper.

2. Klicka på fliken Publicera .

3. I området Installera läge och inställningar klickar du på alternativet Programmet är endast tillgängligt online .

Gör ett ClickOnce-program tillgängligt online eller offline

1. När ett projekt har valts i Solution Explorer går du till projektmenyn och klickar på Egenskaper.

2. Klicka på fliken Publicera .

3. I området Installera läge och inställningar klickar du på alternativknappen Programmet är också tillgängligt offline.

   När programmet har installerats lägger det till poster på Start-menyn och lägger till eller tar bort program på Kontrollpanelen.

Ställ in ClickOnce-publiceringsversionen

Egenskapen ClickOnce Publish Version avgör om programmet som du publicerar ska behandlas som en uppdatering. Varje gång versionen ökas publiceras programmet som en uppdatering.

Egenskapen Publish Version kan anges på sidan Publicera i Projektdesignern.

När versionsnumret ändras publiceras programmet som en uppdatering. Varje del av publiceringsversionen (Major, Minor, Build, Revision) kan ha ett maximalt värde på 65535 (MaxValue), det högsta tillåtna av Version.

När du installerar mer än en version av ett program med hjälp av ClickOnce flyttas tidigare versioner av programmet till en mapp med namnet Arkiv på den publiceringsplats som du anger. Om du arkiverar tidigare versioner på det här sättet blir installationskatalogen fri från mappar från den tidigare versionen.

Ändra publiceringsversionen

1. När ett projekt har valts i Solution Explorer klickar du på Egenskaper på Projekt-menyn.

2. Klicka på fliken Publicera .

3. I fältet Publicera version ökar du versionsnumren Major, Minor, Build eller Revision .

   Anmärkning

   Du bör aldrig minska ett versionsnummer. detta kan orsaka oförutsägbart uppdateringsbeteende.

Inkrementera automatiskt ClickOnce-publiceringsversionen

När du publicerar ett ClickOnce-program publiceras programmet som en uppdatering om du ändrar Publish Version egenskapen. Som standardinställning ökar Visual Studio automatiskt Revision-numret på Publish Version varje gång du publicerar programmet.

Du kan inaktivera det här beteendet på sidan Publicera i Projektdesignern.

Inaktivera automatisk inkrementering av publiceringsversionen

1. När ett projekt har valts i Solution Explorer går du till projektmenyn och klickar på Egenskaper.

2. Klicka på fliken Publicera .

3. I avsnittet Publicera version avmarkerar du kryssrutan Öka automatiskt med varje version .

Ange en publiceringssida för ett ClickOnce-program

När du publicerar ett ClickOnce-program genereras en standardwebbsida (publish.htm) och publiceras tillsammans med programmet. Den här sidan innehåller namnet på programmet, en länk för att installera programmet och/eller eventuella krav och en länk till ett hjälpavsnitt som beskriver ClickOnce. Med egenskapen Publicera sida för projektet kan du ange ett namn på webbsidan för ditt ClickOnce-program.

När publiceringssidan har angetts kopieras den till publiceringsplatsen nästa gång du publicerar den. Det skrivs inte över om du publicerar igen. Om du vill anpassa utseendet på sidan kan du göra det utan att behöva oroa dig för att förlora ändringarna. Mer information finns i Anpassa standardwebbsidan ClickOnce.

Egenskapen Publicera sida kan anges i dialogrutan Publiceringsalternativ som är tillgänglig från fönstret Publicera i Projektdesignern.

Så här anger du en anpassad webbsida för ett ClickOnce-program:

1. När ett projekt har valts i Solution Explorer klickar du på Egenskaper på Projekt-menyn.

2. Välj fönstret Publicera .

3. Klicka på knappen Alternativ för att öppna dialogrutan Publiceringsalternativ .

4. Klicka på Distribution.

5. I dialogrutan Publiceringsalternativ kontrollerar du att kryssrutan Öppna distributionswebbsidan efter publicering är markerad (den bör vara markerad som standard).

6. I rutan Distributionswebbsida anger du namnet på webbsidan och klickar sedan på OK.

Så här förhindrar du att publiceringssidan startas varje gång du publicerar:

1. När ett projekt har valts i Solution Explorer klickar du på Egenskaper på Projekt-menyn.

2. Välj fönstret Publicera .

3. Klicka på knappen Alternativ för att öppna dialogrutan Publiceringsalternativ .

4. Klicka på Distribution.

5. I dialogrutan Publiceringsalternativ avmarkerar du kryssrutan Öppna distributionswebbsidan efter publicering .

Anpassa standardwebbsidan för ett ClickOnce-program

När du publicerar ett ClickOnce-program på webben genereras och publiceras en webbsida automatiskt tillsammans med programmet. Standardsidan innehåller namnet på programmet och länkar för att installera programmet, installera krav eller få åtkomst till hjälp på MSDN.

Standardnamnet för webbsidan är Publish.htm; du kan ändra namnet i Projektdesignern. Mer information finns i Ange en publiceringssida för ett ClickOnce-program.

Den Publish.htm webbsidan publiceras endast om en nyare version identifieras.

Så här anpassar du publiceringswebbsidan:

1. Publicera ditt ClickOnce-program på en webbplats. Mer information finns i Så här publicerar du ett ClickOnce-program med hjälp av publiceringsguiden.

2. Öppna filenPublish.htm i Visual Web Designer eller en annan HTML-redigerare på webbservern.

3. Anpassa sidan efter behov och spara den.

4. Valfritt. Om du vill förhindra att Visual Studio skriver över den anpassade publiceringswebbplatsen avmarkerar du Skapa distributionswebbsida automatiskt efter varje publicering i dialogrutan Publiceringsalternativ .

Ange en länk för teknisk support

När du publicerar ett ClickOnce-program identifierar egenskapen Support-URL en webbsida eller filresurs där användarna kan gå för att hämta information om programmet. Den här egenskapen är valfri. Om den tillhandahålls visas URL:en i dialogrutan Lägg till eller ta bort program i programmet.

Egenskapen Support-URL kan anges på sidan Publicera i Projektdesignern.

Så här anger du en support-URL:

1. När ett projekt har valts i Solution Explorer går du till projektmenyn och klickar på Egenskaper.

2. Klicka på fliken Publicera .

3. Klicka på knappen Alternativ för att öppna dialogrutan Publiceringsalternativ .

4. Klicka på Beskrivning.

5. I fältet Support-URL anger du en fullständigt kvalificerad sökväg till en webbplats, webbsida eller UNC-resurs.

Ange en support-URL för enskilda krav i en ClickOnce-distribution

En ClickOnce-distribution kan testas för ett antal krav som måste vara tillgängliga på klientdatorn för att ClickOnce-programmet ska kunna köras. Dessa beroenden omfattar den nödvändiga lägsta versionen av .NET Framework, versionen av operativsystemet och eventuella sammansättningar som måste förinstalleras i den globala sammansättningscachen (GAC). ClickOnce kan dock inte installera någon av dessa krav. Om en förutsättning inte hittas stoppar den helt enkelt installationen och visar en dialogruta som förklarar varför installationen misslyckades.

Det finns två metoder för att installera krav. Du kan installera dem med hjälp av ett bootstrapper-program. Du kan också ange en support-URL för enskilda krav, som visas för användare i dialogrutan om förutsättningen inte hittas. Sidan som refereras till av den URL:en kan innehålla länkar till instruktioner för att installera den nödvändiga förutsättningen. Om ett program inte anger en support-URL för en enskild förutsättning visar ClickOnce den support-URL som anges i distributionsmanifestet för programmet som helhet, om det har definierats.

Visual Studio, Mage.exeoch MageUI.exe kan användas för att generera ClickOnce-distributioner, men inget av dessa verktyg har direkt stöd för att ange en support-URL för enskilda förutsättningar. Det här dokumentet beskriver hur du ändrar distributionens programmanifest och distributionsmanifest så att de innehåller dessa support-URL:er.

Ange en support-URL för en enskild förutsättning

1. Öppna programmanifestet ( manifestfilen ) för ClickOnce-programmet i en textredigerare.

2. För ett operativsystemkrav lägger du till supportUrl attributet i elementet dependentOS :

    <dependency>
       <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
         <osVersionInfo>
           <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
         </osVersionInfo>
       </dependentOS>
     </dependency>
   

3. För att ange ett förhandskrav för en viss version av Common Language Runtime (CLR), lägg till attributet supportUrl i posten dependentAssembly som specificerar beroendet av Common Language Runtime.

     <dependency>
       <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
         <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
       </dependentAssembly>
     </dependency>
   

4. För en förutsättning för en sammansättning som måste förinstalleras i den globala sammansättningscachen anger du supportUrl för det dependentAssembly element som anger den nödvändiga sammansättningen:

     <dependency>
       <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm">
         <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" />
       </dependentAssembly>
     </dependency>
   

5. Valfritt. För program som riktar sig mot .NET Framework 4 öppnar du distributionsmanifestet ( .application-filen ) för ClickOnce-programmet i en textredigerare.

6. För ett krav för .NET Framework 4 lägger du till supportUrl attributet i elementet compatibleFrameworks :

   <compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
     <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
     <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
   </compatibleFrameworks>
   

7. När du har ändrat programmanifestet manuellt måste du signera om programmanifestet med ditt digitala certifikat och sedan uppdatera och signera om distributionsmanifestet. Använd Mage.exe - eller MageUI.exe SDK-verktygen för att utföra den här uppgiften, eftersom återskapande av dessa filer med Visual Studio raderar dina manuella ändringar. Mer information om hur du använder Mage.exe för att signera om manifest finns i Så här: Signera om program- och distributionsmanifest.

.NET Framework-säkerhet

Support-URL:en visas inte i dialogrutan om programmet har markerats för att köras i partiellt förtroende.

Ändra publiceringsspråket för ett ClickOnce-program

När du publicerar ett ClickOnce-program visas användargränssnittet under installationen som standard till språket och kulturen på utvecklingsdatorn. Om du publicerar ett lokaliserat program måste du ange ett språk och en kultur som matchar den lokaliserade versionen. Detta bestäms av egenskapen Publish language för ditt projekt.

Egenskapen Publish language kan anges i dialogrutan Publiceringsalternativ som är tillgänglig från sidan Publicera i Projektdesignern.

Så här ändrar du publiceringsspråket:

1. När ett projekt har valts i Solution Explorer går du till projektmenyn och klickar på Egenskaper.

2. Klicka på fliken Publicera .

   Anmärkning

   I ClickOnce för .NET Core 3.1 och .NET 5 eller senare anger du distributionsegenskaper med verktyget Publicera i stället för publiceringsguiden och sidan Publicera i Projektdesignern. Mer information finns i Distribuera ett .NET Windows-program med ClickOnce och ClickOnce för .NET.

3. Klicka på knappen Alternativ för att öppna dialogrutan Publiceringsalternativ .

4. Klicka på Beskrivning.

5. I dialogrutan Publiceringsalternativ väljer du ett språk och en kultur i listrutan Publicera språk och klickar sedan på OK.

Ange ett Start-menynamn för ett ClickOnce-program

När ett ClickOnce-program har installerats för både online- och offlineanvändning läggs en post till på Start-menyn och listan Lägg till eller ta bort program . Som standard är visningsnamnet samma som namnet på programsammansättningen, men du kan ändra visningsnamnet genom att ange Produktnamn i dialogrutan Publiceringsalternativ .

Produktnamnet visas på sidanpublish.htm . för ett installerat offlineprogram är det namnet på posten på Start-menyn och det är även namnet som visas i Lägg till eller ta bort program.

Utgivarens namn visas på sidanpublish.htm ovanför Produktnamn, och för ett installerat offlineprogram är det även namnet på den mapp som innehåller programmets ikon på Start-menyn .

Genvägen till Start-menyn eller appreferensen skapas i %appdata%\Microsoft\Windows\Start-menyn\Program\<utgivarens namn>. Genvägen eller appreferensen har samma namn som produktnamnet.

Du kan ange egenskaperna Produktnamn och Utgivarnamn i dialogrutan Publiceringsalternativ , som är tillgängliga på sidan Publicera i Projektdesignern.

Så här anger du ett Start-menynamn:

1. När ett projekt har valts i Solution Explorer går du till projektmenyn och klickar på Egenskaper.

2. Klicka på fliken Publicera .

3. Klicka på knappen Alternativ för att öppna dialogrutan Publiceringsalternativ .

4. Klicka på Beskrivning.

5. I dialogrutan Publiceringsalternativ anger du namnet som ska visas i Produktnamn.

6. Du kan också ange ett utgivarnamn i Utgivarens namn.

Aktivera autostart för CD-installationer

När du distribuerar ett ClickOnce-program med hjälp av flyttbara medier, till exempel CD-ROM eller DVD-ROM, kan du aktivera AutoStart så att ClickOnce-programmet startas automatiskt när mediet infogas.

AutoStart kan aktiveras på sidan Publicera i projektdesignern.

Så här aktiverar du Autostart:

1. När ett projekt har valts i Solution Explorer klickar du på Egenskaper på Projekt-menyn.

2. Klicka på fliken Publicera .

3. Klicka på knappen Alternativ .

   Dialogrutan Publiceringsalternativ visas.

4. Klicka på Distribution.

5. Markera kryssrutan För CD-installationer startar du automatiskt installationsprogrammet när CD infogas .

   En Autorun.inf-fil kopieras till publiceringsplatsen när programmet publiceras.

Relaterat innehåll

• Publicera ClickOnce-applikationer
• Anvisningar: Publicera ett ClickOnce-program med hjälp av publiceringsguiden