Distribuera en Office-lösning med hjälp av ClickOnce

Du kan distribuera Din Office-lösning i färre steg om du använder ClickOnce. Om du publicerar uppdateringar identifierar och installerar lösningen dem automatiskt. ClickOnce kräver dock att du installerar lösningen separat för varje användare av en dator. Därför bör du överväga att använda Windows Installer (.msi) om fler än en användare kör lösningen på samma dator.

I det här avsnittet

• Publicera lösningen

• Bestäm hur du vill bevilja lösningen förtroende

• Hjälp användarna att installera lösningen

• Placera dokumentet för en lösning på slutanvändarens dator (endast anpassningar på dokumentnivå)

• Placera dokumentet för en lösning på en server som kör SharePoint (endast anpassningar på dokumentnivå)

• Skapa ett anpassat installationsprogram

• Publicera en uppdatering

• Ändra installationsplatsen för en lösning

• Återställa en lösning till en tidigare version

  Mer information om hur du distribuerar en Office-lösning genom att skapa en Windows Installer-fil finns i Distribuera en Office-lösning med hjälp av Windows Installer.

Publicera lösningen

Du kan publicera lösningen med hjälp av publiceringsguiden eller Projektdesignern. I den här proceduren använder du Projektdesignern eftersom den innehåller en fullständig uppsättning publiceringsalternativ. Se Guiden Publicera (Office-utveckling i Visual Studio).

Publicera lösningen

1. I Solution Explorer väljer du den nod som är namngiven för projektet.

2. På menyraden väljer du Projekt, ProjectName-egenskaper.

3. I Projektdesignern väljer du fliken Publicera , som följande bild visar.

   

4. I rutan Plats för publiceringsmapp (ftp-server eller filsökväg) anger du sökvägen till den mapp där du vill att Projektdesignern ska kopiera lösningsfilerna.

   Du kan ange någon av följande typer av sökvägar.

   • En lokal sökväg (till exempel C:\FolderName\FolderName).

   • En UNC-sökväg (Uniform Naming Convention) till en mapp i nätverket (till exempel \\ServerName\FolderName).

   • En relativ sökväg (till exempel PublishFolder\, som är den mapp där projektet publiceras som standard).

5. I rutan URL för installationsmapp anger du den fullständigt kvalificerade sökvägen till den plats där slutanvändarna hittar din lösning.

   Om du inte känner till platsen ännu ska du inte ange något i det här fältet. Som standard letar ClickOnce efter uppdateringar i mappen som användarna installerar lösningen från.

6. Välj knappen Förutsättningar .

7. I dialogrutan Förutsättningar kontrollerar du att kryssrutan Skapa installationsprogram för att installera nödvändiga komponenter är markerad.

8. I listan Välj vilka krav som krävs för att installera markerar du kryssrutorna för Windows Installer 4.5 och lämpligt .NET Framework-paket.

   Om din lösning till exempel är inriktad på .NET Framework 4.5 markerar du kryssrutorna för Windows Installer 4.5 och Microsoft .NET Framework 4.5 Full.

9. Om din lösning är inriktad på .NET Framework 4.5 markerar du även kryssrutan Visual Studio 2010 Tools for Office Runtime .

   Anmärkning

   Som standard visas inte den här kryssrutan. Om du vill visa den här kryssrutan måste du skapa ett Bootstrapper-paket. Se Skapa ett Bootstrapper-paket för ett Office 2013 VSTO-tillägg med Visual Studio 2012.

10. Under Ange installationsplatsen för krav väljer du något av alternativen som visas och väljer sedan knappen OK .

    I följande tabell beskrivs varje alternativ.

    Option	Description
    Ladda ned krav från komponentleverantörens webbplats	Användaren uppmanas att ladda ned och installera dessa krav från leverantören.
    Ladda ned krav från samma plats som mitt program	Den nödvändiga programvaran installeras med lösningen. Om du väljer det här alternativet kopierar Visual Studio alla nödvändiga paket till publiceringsplatsen åt dig. För att det här alternativet ska fungera måste de nödvändiga paketen finnas på utvecklingsdatorn.
    Ladda ned förutsättningar från följande plats	Visual Studio kopierar alla nödvändiga paket till den plats där du anger och installerar dem med lösningen.

    Se dialogrutan Förutsättningar.

11. Välj knappen Uppdateringar , ange hur ofta du vill att varje slutanvändares VSTO-tillägg eller anpassning ska söka efter uppdateringar och välj sedan knappen OK .

    Anmärkning

    Om du distribuerar med hjälp av en CD eller en flyttbar enhet väljer du alternativet Sök aldrig efter uppdateringar .

    Information om hur du publicerar en uppdatering finns i Publicera en uppdatering.

12. Välj knappen Alternativ , granska alternativen i dialogrutan Alternativ och välj sedan knappen OK .

13. Välj knappen Publicera nu .

    Visual Studio lägger till följande mappar och filer i den publiceringsmapp som du angav tidigare i den här proceduren.

    • Mappen Applikationsfiler.

    • Installationsprogrammet.

    • Ett distributionsmanifest som pekar på distributionsmanifestet för den senaste versionen.

      Mappen Application Files innehåller en undermapp för varje version som du publicerar. Varje versionsspecifik undermapp innehåller följande filer.

    • Ett applikationsmanifest.

    • Ett distributionsmanifest.

    • Anpassningsmoduler.

      Följande bild visar strukturen för publiceringsmappen för ett Outlook VSTO-tillägg.

      

    Anmärkning

    ClickOnce lägger till .deploy-tillägget i sammansättningar så att en säker installation av Internet Information Services (IIS) inte blockerar filerna på grund av ett osäkert tillägg. När användaren installerar lösningen tar ClickOnce bort .deploy-tillägget .

14. Kopiera lösningsfilerna till den installationsplats som du angav tidigare i den här proceduren.

Bestäm hur du vill bevilja lösningen förtroende

Innan en lösning kan köras på användardatorer måste du antingen bevilja förtroende eller så måste användarna svara på en fråga om förtroende när de installerar lösningen. Om du vill bevilja lösningen förtroende signerar du manifesten med hjälp av ett certifikat som identifierar en känd och betrodd utgivare. Se Lita på lösningen genom att signera program- och distributionsmanifesten.

Om du distribuerar en anpassning på dokumentnivå och vill placera dokumentet i en mapp på användarens dator eller göra dokumentet tillgängligt på en SharePoint-webbplats kontrollerar du att Office litar på dokumentets plats. Se Bevilja förtroende till dokument.

Hjälp användarna att installera lösningen

Användare kan installera lösningen genom att köra installationsprogrammet, öppna distributionsmanifestet eller under anpassningen på dokumentnivå och öppna dokumentet direkt. Som bästa praxis bör användarna installera din lösning med hjälp av installationsprogrammet. De andra två metoderna säkerställer inte att den nödvändiga programvaran är installerad. Om användarna vill öppna dokumentet från installationsplatsen måste de lägga till det i listan över betrodda platser i Säkerhetscenter för Office-programmet.

Öppna dokumentet för en anpassning på dokumentnivå

Användare kan öppna dokumentet för en anpassning på dokumentnivå direkt från installationsplatsen eller genom att kopiera dokumentet till sin lokala dator och sedan öppna kopian.

Som bästa praxis bör användarna öppna en kopia av dokumentet på sina datorer så att flera användare inte försöker öppna samma kopia samtidigt. Om du vill tillämpa den här metoden kan du konfigurera installationsprogrammet för att kopiera dokumentet till användardatorer. Se Placera dokumentet för en lösning på slutanvändarens dator (endast anpassningar på dokumentnivå).

Installera lösningen genom att öppna distributionsmanifestet från en IIS-webbplats

Användare kan installera en Office-lösning genom att öppna distributionsmanifestet från webben. En säker installation av Internet Information Services (IIS) blockerar dock filer som har .vsto-tillägget . MIME-typen måste definieras i IIS innan du kan distribuera en Office-lösning med hjälp av IIS.

Så här lägger du till .vsto MIME-typen i IIS 6.0

1. På den server som kör IIS 6.0 väljer du Starta>alla program>Administrationsverktyg>Internet Information Services (IIS) Manager.

2. Välj datornamnet, mappen Webbplatser eller den webbplats som du konfigurerar.

3. På menyraden väljer du Åtgärdsegenskaper>.

4. På fliken HTTP-huvuden väljer du knappen MIME-typer .

5. I fönstret MIME-typer väljer du knappen Nytt .

6. I fönstret MIME-typ anger du .vsto som tillägg, anger application/x-ms-vsto som MIME-typ och tillämpar sedan de nya inställningarna.

   Anmärkning

   För att ändringarna ska börja gälla måste du starta om World Wide Web Publishing Service eller vänta tills arbetsprocessen återvinns. Du måste sedan tömma webbläsarens diskcache och sedan försöka öppna .vsto-filen igen.

Så här lägger du till .vsto MIME-typen i IIS 7.0

1. På servern som kör IIS 7.0 väljer du Starta>alla programtillbehör>.

2. Öppna snabbmenyn för Kommandotolken och välj sedan Kör som administratör.

3. I rutan Öppna anger du följande sökväg och väljer sedan knappen OK .

   %windir%\system32\inetsrv
   

4. Ange följande kommando och tillämpa sedan de nya inställningarna.

   set config /section:staticContent /+[fileExtension='.vsto',mimeType='application/x-ms-vsto']
   

   Anmärkning

   För att ändringarna ska börja gälla måste du starta om World Wide Web Publishing Service, eller så måste du vänta tills arbetsprocessen återstartas. Du måste sedan tömma webbläsarens diskcache och sedan försöka öppna .vsto-filen igen.

Placera dokumentet för en lösning på slutanvändarens dator (endast anpassningar på dokumentnivå)

Du kan kopiera dokumentet för din lösning till slutanvändarens dator för dem genom att skapa en åtgärd efter distributionen. På så sätt behöver användaren inte kopiera dokumentet manuellt från installationsplatsen till datorn när de har installerat lösningen. Du måste skapa en klass som definierar åtgärden efter distributionen, skapa och publicera lösningen, ändra programmanifestet och signera om program- och distributionsmanifestet.

Följande procedurer förutsätter att projektnamnet är ExcelWorkbook och att du publicerar lösningen i en skapad mapp med namnet C:\publish på datorn.

Skapa en klass som definierar åtgärden efter distributionen

1. På menyraden väljer du Arkiv>Lägg till>nytt projekt.

2. I dialogrutan Lägg till nytt projekt går du till fönstret Installerade mallar och väljer mappen Windows .

3. I fönstret Mallar väljer du mallen Klassbibliotek .

4. I fältet Namn anger du FileCopyPDA och väljer sedan knappen OK .

5. I Solution Explorer väljer du Projektet FileCopyPDA .

6. På menyraden väljer du Projekt>Lägg till referens.

7. På fliken .NET lägger du till referenser till Microsoft.VisualStudio.Tools.Applications.Runtime och Microsoft.VisualStudio.Tools.Applications.ServerDocument.

8. Byt namn på klassen till FileCopyPDAoch ersätt sedan innehållet i filen med koden. Den här koden utför följande uppgifter:

   • Kopierar dokumentet till användarens skrivbord.

   • Ändrar egenskapen _AssemblyLocation från en relativ sökväg till en fullständigt kvalificerad sökväg för distributionsmanifestet.

   • Tar bort filen om användaren avinstallerar lösningen.

     • C#
     • VB

     using Microsoft.VisualStudio.Tools.Applications.Deployment;
     using Microsoft.VisualStudio.Tools.Applications;
     using System.IO;
     
     namespace FileCopyPDA
     {
         public class FileCopyPDA : IAddInPostDeploymentAction
         {
             public void Execute(AddInPostDeploymentActionArgs args) 
             {
                 string dataDirectory = @"Data\ExcelWorkbook.xlsx";
                 string file = @"ExcelWorkbook.xlsx";
                 string sourcePath = args.AddInPath;
                 Uri deploymentManifestUri = args.ManifestLocation;
                 string destPath = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory);
                 string sourceFile = System.IO.Path.Combine(sourcePath, dataDirectory);
                 string destFile = System.IO.Path.Combine(destPath, file);
     
                 switch (args.InstallationStatus)
                 {
                     case AddInInstallationStatus.InitialInstall:
                     case AddInInstallationStatus.Update:
                         File.Copy(sourceFile, destFile);
                         ServerDocument.RemoveCustomization(destFile);
                         ServerDocument.AddCustomization(destFile, deploymentManifestUri);
                         break;
                     case AddInInstallationStatus.Uninstall:
                         if (File.Exists(destFile))
                         {
                             File.Delete(destFile);
                         }
                         break;
                 }
             }
         }
     }
     

   ---

Skapa och publicera lösningen

1. Öppna snabbmenyn för FileCopyPDA-projektet i Solution Explorer och välj sedan Skapa.

2. Öppna snabbmenyn för ExcelWorkbook-projektet och välj sedan Skapa.

3. Öppna snabbmenyn för ExcelWorkbook-projektet och välj sedan Lägg till referens.

4. I dialogrutan Lägg till referens väljer du fliken Projekt , väljer FileCopyPDA och sedan knappen OK .

5. I Solution Explorer väljer du ExcelWorkbook-projektet .

6. På menyraden väljer du Projekt>Ny mapp.

7. Ange Data och välj sedan returnyckeln .

8. I Solution Explorer väljer du mappen Data .

9. På menyraden väljer du ProjectAdd Existing Item (Lägg >till befintligt objekt).

10. I dialogrutan Lägg till befintligt objekt bläddrar du till utdatakatalogen för ExcelWorkbook-projektet , väljer filenExcelWorkbook.xlsx och väljer sedan knappen Lägg till .

11. I Solution Explorer väljer du filenExcelWorkbook.xlsx .

12. I fönstret Egenskaper ändrar du egenskapen Skapa åtgärd till Innehåll och egenskapen Kopiera till utdatakatalog till Kopiera om nyare.

    När du har slutfört de här stegen liknar projektet följande bild.

    

13. Publicera ExcelWorkbook-projektet .

Ändra programmanifestet

1. Öppna lösningskatalogen c:\publish med hjälp av Utforskaren.

2. Öppna mappen Application Files och öppna sedan mappen som motsvarar den senaste publicerade versionen av lösningen.

3. Öppna ExcelWorkbook.dll.manifest-filen i en textredigerare, till exempel Notepad.

4. Lägg till följande kod efter elementet </vstav3:update> . Använd följande syntax för elementets <vstav3:entryPoint> klassattribut: NamespaceName.ClassName. I följande exempel är namnområdet och klassnamnen desamma, så det resulterande startpunktsnamnet är FileCopyPDA.FileCopyPDA.

   <vstav3:postActions>
     <vstav3:postAction>
       <vstav3:entryPoint
         class="FileCopyPDA.FileCopyPDA">
         <assemblyIdentity
           name="FileCopyPDA"
           version="1.0.0.0"
           language="neutral"
           processorArchitecture="msil" />
       </vstav3:entryPoint>
       <vstav3:postActionData>
       </vstav3:postActionData>
     </vstav3:postAction>
   </vstav3:postActions>
   

Signera om program- och distributionsmanifesten

1. I mappen %USERPROFILE%\Documents\Visual Studio 2013\Projects\ExcelWorkbook\ExcelWorkbook kopierar du certifikatfilen ExcelWorkbook_TemporaryKey.pfx och klistrar sedan in den i mappen PublishFolder\Application Files\ExcelWorkbook_MostRecentPublishedVersion .

2. Öppna Kommandotolken i Visual Studio och ändra sedan kataloger till mappen c:\publish\Application Files\ExcelWorkbook_MostRecentPublishedVersion (till exempel c:\publish\Application Files\ExcelWorkbook_1_0_0_4).

3. Signera det ändrade programmanifestet genom att köra följande kommando:

   mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx
   

   Meddelandet "ExcelWorkbook.dll.manifest har signerats framgångsrikt" visas.

4. Ändra till mappen c:\publish och uppdatera och signera distributionsmanifestet genom att köra följande kommando:

   mage -update ExcelWorkbook.vsto -appmanifest "Application Files\Ex
   celWorkbookMostRecentVersionNumber>\ExcelWorkbook.dll.manifest" -certfile "Application Files\ExcelWorkbookMostRecentVersionNumber>\ExcelWorkbook_TemporaryKey.pfx"
   

   Anmärkning

   I föregående exempel ersätter du MostRecentVersionNumber med versionsnumret för den senast publicerade versionen av lösningen (till exempel 1_0_0_4).

   Meddelandet "ExcelWorkbook.vsto successfully signed" visas.

5. Kopiera excelworkbook.vsto-filen till katalogen c:\publish\Application Files\ExcelWorkbook_MostRecentVersionNumber .

Placera dokumentet för en lösning på en server som kör SharePoint (endast anpassningar på dokumentnivå)

Du kan publicera anpassningen på dokumentnivå till slutanvändare med hjälp av SharePoint. När användarna går till SharePoint-webbplatsen och öppnar dokumentet installerar körningen automatiskt lösningen från den delade nätverksmappen till användarens lokala dator. När lösningen har installerats lokalt fungerar anpassningen fortfarande även om dokumentet kopieras någon annanstans, till exempel skrivbordet.

Så här placerar du dokumentet på en server som kör SharePoint

1. Lägg till lösningsdokumentet i ett dokumentbibliotek på en SharePoint-webbplats.

2. Utför stegen för någon av följande metoder:

   • Använd Office-konfigurationsverktyget för att lägga till den server som kör SharePoint i Säkerhetscenter i Word eller Excel på alla användardatorer.

     Se Säkerhetsprinciper och inställningar i Office 2010.

   • Se till att varje användare utför följande steg.

     1. Öppna Word eller Excel på den lokala datorn, välj fliken Arkiv och välj sedan knappen Alternativ .

     2. I dialogrutan Säkerhetscenter väljer du knappen Betrodda platser .

     3. Markera kryssrutan Tillåt betrodda platser i mitt nätverk (rekommenderas inte) och välj sedan knappen Lägg till ny plats .

     4. I rutan Sökväg anger du URL:en för SharePoint-dokumentbiblioteket som innehåller det dokument som du laddade upp (till exempel http://SharePointServerName/TeamName/ProjectName/DocumentLibraryName).

        Lägg inte till namnet på standardwebbsidan, till exempel default.aspx eller AllItems.aspx.

     5. Markera kryssrutan Undermappar för den här platsen är också betrodda och välj sedan knappen OK .

        När användarna öppnar dokumentet från SharePoint-webbplatsen öppnas dokumentet och anpassningen installeras. Användare kan kopiera dokumentet till skrivbordet. Anpassningen körs fortfarande eftersom egenskaperna i dokumentet pekar på dokumentets nätverksplats.

Skapa ett anpassat installationsprogram

Du kan skapa ett anpassat installationsprogram för din Office-lösning i stället för att använda det installationsprogram som skapas åt dig när du publicerar lösningen. Du kan till exempel använda ett inloggningsskript för att starta installationen, eller så kan du använda en batchfil för att installera lösningen utan användarinteraktion. De här scenarierna fungerar bäst om förhandskraven redan är installerade på slutanvändarens datorer.

Som en del av din anpassade installationsprocess anropar du installationsprogrammet för Office-lösningar (VSTOInstaller.exe), som installeras på följande plats som standard:

%commonprogramfiles%\microsoft shared\VSTO\10.0\VSTOInstaller.exe

Om verktyget inte finns på den platsen kan du använda registernyckelnHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath eller HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath för att hitta sökvägen till verktyget.

Du kan använda följande parametrar med VSTOinstaller.exe.

När du kör VSTOinstaller.exekan följande felkoder visas.

Publicera en uppdatering

Om du vill uppdatera en lösning publicerar du den igen med hjälp av projektdesignern eller publiceringsguiden och kopierar sedan den uppdaterade lösningen till installationsplatsen. När du kopierar filerna till installationsplatsen kontrollerar du att du skriver över de tidigare filerna.

Nästa gång lösningen söker efter en uppdatering kommer den att hitta och läsa in den nya versionen automatiskt.

Ändra installationsplatsen för en lösning

Du kan lägga till eller ändra installationssökvägen när en lösning har publicerats. Du kanske vill ändra installationssökvägen av en eller flera av följande orsaker:

• Installationsprogrammet kompilerades innan installationssökvägen var känd.

• Lösningsfilerna har kopierats till en annan plats.

• Servern som är värd för installationsfilerna har ett nytt namn eller en ny plats.

  Om du vill ändra installationssökvägen för en lösning måste du uppdatera installationsprogrammet och sedan måste användarna köra det. För anpassningar på dokumentnivå måste användarna också uppdatera en egenskap i sitt dokument för att peka på den nya platsen.

Ändra installationssökvägen i installationsprogrammet

1. Öppna ett kommandotolkfönster och ändra sedan kataloger till installationsmappen.

2. Kör installationsprogrammet och inkludera parametern /url som tar den nya installationssökvägen som en sträng.

   I följande exempel visas hur du ändrar installationssökvägen till en plats på Fabrikam-webbplatsen, men du kan ersätta url:en med den sökväg du vill ha:

   setup.exe /url="http://www.fabrikam.com/newlocation"
   

   Anmärkning

   Om ett meddelande visas och anger att signaturen för den körbara filen kommer att ogiltigförklaras är certifikatet som användes för att signera lösningen inte längre giltigt och utgivaren är okänd. Därför måste användarna bekräfta att de litar på lösningens källa innan de kan installera den.

   Anmärkning

   Om du vill visa det aktuella värdet för URL:en kör du setup.exe /url.

   För anpassningar på dokumentnivå måste användarna öppna dokumentet och sedan uppdatera dess egenskap _AssemblyLocation. Följande steg beskriver hur användare kan utföra den här uppgiften.

Uppdatera egenskapen _AssemblyLocation i ett dokument

1. På fliken Arkiv väljer du Info, som följande bild visar.

   

2. I listan Egenskaper väljer du Avancerade egenskaper, vilket visas i följande bild.

   

3. På fliken Anpassad i listan Egenskaper väljer du _AssemblyLocation, som följande bild visar.

   

   Rutan Värde innehåller identifieraren för distributionsmanifestet.

4. Innan identifieraren anger du dokumentets fullständigt kvalificerade sökväg följt av ett streck i formatet Sökväg|Identifierare (till exempel File://ServerName/FolderName/FileName|74744e4b-e4d6-41eb-84f7-ad20346fe2d9.

   Mer information om hur du formaterar den här identifieraren finns i Översikt över anpassade dokumentegenskaper.

5. Välj ok-knappen och spara och stäng sedan dokumentet.

6. Kör installationsprogrammet utan parametern /url för att installera lösningen på den angivna platsen.

Återställa en lösning till en tidigare version

När du återställer en lösning återställer du användarna till en tidigare version av lösningen.

Så här återställer du en lösning

1. Öppna installationsplatsen för lösningen.

2. Ta bort distributionsmanifestet ( vsto-filen ) i den översta publiceringsmappen.

3. Leta upp undermappen för den version som du vill återställa till.

4. Kopiera distributionsmanifestet från undermappen till den översta publiceringsmappen.

   Om du till exempel vill återställa en lösning med namnet OutlookAddIn1 från version 1.0.0.1 till version 1.0.0.0 kopierar du filen OutlookAddIn1.vsto från mappen OutlookAddIn1_1_0_0_0 . Klistra in filen i den översta publiceringsmappen och skriv över det versionsspecifika distributionsmanifestet för OutlookAddIn1_1_0_0_1 som redan fanns där.

   Följande bild visar strukturen för publicera mapp i det här exemplet.

   

   Nästa gång en användare öppnar programmet eller det anpassade dokumentet identifieras ändringen av distributionsmanifestet. Den tidigare versionen av Office-lösningen körs från ClickOnce-cachen.

Relaterat innehåll

• Distribuera en Office-lösning
• Publicera Office-lösningar
• Gör så här: Publicera en Office-lösning med hjälp av ClickOnce
• Anvisningar: Installera en ClickOnce Office-lösning
• Anvisningar: Publicera en Office-lösning på dokumentnivå till en SharePoint-server med hjälp av ClickOnce
• Skapa ett anpassat installationsprogram för en ClickOnce Office-lösning