Dela via

Felsöka distribution av Office-lösning

  • Artikel

Gäller för: Visual Studio

Den här artikeln beskriver hur du löser vanliga problem som kan uppstå när du distribuerar Office-lösningar.

Informationen i den här artikeln gäller för projekt på dokumentnivå och Visual Studio Tools for Office-tilläggsprojekt (VSTO). Se Funktioner som är tillgängliga per Office-program och projekttyp.

Felsöka Office-lösningar med hjälp av loggboken

Du kan använda loggboken i Windows för att se felmeddelanden som hämtas av Visual Studio Tools for Office-körningen när du installerar eller avinstallerar Office-lösningar. Du kan använda dessa meddelanden från händelseloggaren för att lösa problem med installation och distribution. Mer information finns i Händelseloggning för Office-lösningar.

Om du ändrar sammansättningsnamnet uppstår konflikter

Om du ändrar värdet sammansättningsnamn på programsidan i Project Designer när du redan har distribuerat en lösning, ändrar publiceringsverktygen installationspaketet så att det har en Setup.exe fil och två distributionsmanifest. Om du distribuerar två manifestfiler kan följande villkor inträffa:

  • Om slutanvändaren installerar båda versionerna läser programmet in båda VSTO-tilläggen.
  • Om VSTO-tillägget installerades innan sammansättningsnamnet ändrades får slutanvändaren aldrig uppdateringar.

Undvik dessa villkor genom att inte ändra lösningens sammansättningsnamnvärde när du har distribuerat lösningen.

Det tar lång tid att söka efter uppdateringar

Visual Studio 2010 Tools for Office Runtime innehåller en registerpost som administratörer kan använda för att ange tidsgränsvärdet för att ladda ned manifesten och lösningen.

Så här anger du timeout-värdet

  1. Navigera till följande nyckel i registret:

    HKEY_CURRENT_USER\Software\Microsoft\VSTA

  2. I undernyckeln AddInTimeout anger du timeout-värdet i millisekunder.

    Om undernyckeln AddInTimeout inte finns skapar du den som en DWORD.

Det går inte att uppdatera eller publicera till en nätverksfilresurs

Office-lösningar som finns på en nätverksfilresurs kan visa ett missvisande meddelande under uppdateringar om lösningens Setup.exe fil är låst i en process medan uppdateringen publiceras. Meddelandet kan säga följande: "Det går inte att lägga till "setup.exe" på webben. Filen "setup.exe" finns redan på den här webbplatsen."

För att förhindra fillåsning kan du göra resursen skrivskyddad för slutanvändarna. Men om dokument finns på resursen blir de också skrivskyddade för slutanvändarna.

Krav för Microsoft Office är inte installerade

Du kan lägga till .NET Framework, Visual Studio Tools for Office-körningen och de primära interop-sammansättningarna för Office i installationspaketet som krav som distribueras med Din Office-lösning. Information om hur du installerar de primära interop-sammansättningarna finns i Konfigurera en dator för att utveckla Office-lösningar och Så här installerar du office-primära interop-sammansättningar.

Publicera med Hjälp av Localhost kan orsaka installationsproblem

När du använder http://localhost som publicerings- eller installationsplats för lösningar på dokumentnivå konverterar inte publiceringsguiden strängen till det riktiga datornamnet. I det här fallet måste lösningen installeras på utvecklingsdatorn. Om du vill att distribuerade lösningar ska använda IIS på utvecklingsdatorn använder du det fullständigt kvalificerade namnet för alla HTTP/HTTPS/FTP-platser i stället för localhost.

Cachelagrade sammansättningar läses in i stället för uppdaterade sammansättningar

Fusion, .NET Framework sammansättningsinläsaren, läser in den cachelagrade kopian av sammansättningar när projektutdatasökvägen finns på en nätverksfilresurs, sammansättningen signeras med ett starkt namn och anpassningsversionen ändras inte. Om du uppdaterar en sammansättning som uppfyller dessa villkor visas inte uppdateringen nästa gång du kör projektet eftersom den cachelagrade kopian läses in.

Du kan konfigurera Visual Studio så att Fusion laddar ned sammansättningar varje gång projektet körs.

Så här laddar du ned sammansättningar i stället för att läsa in cachelagrade kopior

  1. På menyraden väljer du Projekt, <ProjectName-egenskaper>.
  2. På sidan Program väljer du Sammansättningsinformation.
  3. Ange revisionsnumret, tredje fältet i sammansättningsversionen, till ett jokertecken (*). Till exempel "1.0.*". Välj sedan knappen OK .

När du har ändrat sammansättningsversionen kan du fortsätta att signera sammansättningen med ett starkt namn och Fusion läser in den senaste versionen av anpassningen.

Obs!

Från och med Visual Studio 2017 uppstår ett byggfel om du försöker använda jokertecken i sammansättningsversionen. Det beror på att jokertecken i sammansättningsversionen kommer att bryta msbuild deterministisk funktion. Du uppmanas att antingen ta bort jokertecken från sammansättningsversionen eller inaktivera determinism. Mer information om deterministisk funktion finns i: Vanliga MSBuild-projektegenskaper och Anpassa din version

Installationen misslyckas när URI:n innehåller tecken som inte är US-ASCII

När du publicerar en Office-lösning på en HTTP/HTTPS/FTP-plats kan sökvägen inte ha några Unicode-tecken som inte finns i US-ASCII. Sådana tecken kan orsaka inkonsekvent beteende i installationsprogrammet. Använd US-ASCII-tecken för installationssökvägen.

Om du uppmanas att avinstallera manuellt visas när du publicerar och installerar en lösning på utvecklingsdatorn

När du skapar en Office-lösning registreras den skapade versionen automatiskt. Om du tidigare har publicerat och installerat samma lösning på utvecklingsdatorn identifierar Visual Studio Tools for Office Runtime att installationssökvägen för den publicerade versionen och den byggda versionen skiljer sig efter att lösningen har skapats, byggts om eller publicerats. Felmeddelandet säger "anpassningen kan inte installeras eftersom en annan version för närvarande är installerad och inte kan uppgraderas från den här platsen." Registernycklarna uppdateras när en lösning återskapas. Därför måste du avinstallera den tidigare versionen innan du publicerar, felsöker eller kör den nya versionen.

Om du vill förhindra att meddelandet visas skapar du ett annat användarkonto på utvecklingsdatorn för att testa distributionen. Alternativt kan du avinstallera versionen från listan över installerade program på datorn innan du publicerar, felsöker eller återskapar lösningen.

Det gick inte att hitta ett undantag eller en metod som inte hittades när du installerar en lösning

När du installerar Office-lösningar genom att öppna distributionsmanifestet (en .vsto-fil ), Office-program, dokument eller arbetsbok kan felmeddelanden för följande villkor visas:

  • Det går inte att hitta metoden.
  • MissingMethodException.
  • Undantag utan fel.

Om du vill förhindra dessa felmeddelanden installerar du lösningen genom att köra installationsprogrammet.

När du installerar lösningen utan att köra installationsprogrammet söker installationsprogrammet inte efter eller installerar krav. Installationsprogrammet söker efter rätt version av kraven och installerar dem efter behov.

Manifestregisternycklar för tillägg ändras när ett InstallShield Limited Edition-projekt har skapats

Den manifestregisternyckel som ingår i ett VSTO-tilläggsprogram ändras ibland från .vsto till .dll.manifest när du skapar ett InstallShield Limited Edition-projekt.

Du kan lösa det här problemet genom att skapa projektet InstallShield Limited Edition i en annan lösning eller använda CompanyName.AddinName som värde för registernyckeln som innehåller namnet på VSTO-tillägget.

ClickOnce Installer för Office-lösningen installerar inte de primära interop-sammansättningarna

När du kör installationsprogrammet som ClickOnce skapar för Din Office-lösning körs installationsprogrammet för Office primära interop-sammansättningar (PIA) endast om inga PIA redan är installerade.

Om installationsprogrammet inte installerar PIA:erna korrekt installerar du dem manuellt genom att köra installationsfilen med namnet o2007pia.msi från installationskatalogen.

Installera om Office-lösningar orsakar ett undantagsfel som inte ligger inom intervallet

När du installerar om en Office-lösning kan ett ArgumentOutOfRangeException undantag visas med följande felmeddelande: Det angivna argumentet låg inom intervallet med giltiga värden.

Den här situationen inträffar om höljet för URL:en för installationsplatsen är annorlunda. Det här felet skulle till exempel visas om du installerade en Office-lösning från http://fabrikam.com/ExcelSolution.vsto första gången och sedan använde http://fabrikam.com/excelsolution.vsto den andra gången.

Om du vill förhindra att meddelandet visas använder du samma hölje när du installerar Office-lösningar.

Det går inte att installera en ClickOnce-lösning genom att öppna distributionsmanifestet från webben

Användare kan installera Office-lösningar genom att öppna distributionsmanifestet från webben. Vissa installationer av Internet Information Services (IIS) blockerar dock filnamnstillägget .vsto . Du måste definiera MIME-typen i IIS innan du använder den för att distribuera en Office-lösning.

Information om hur du definierar MIME-typen i IIS 7 finns i Lägga till en MIME-typ (IIS7).

Ange tillägget till .vsto och MIME-typen till application/x-ms-vsto.

Referenser