Felsöka specifika fel i ClickOnce-distributioner
Gäller för: Visual Studio
Den här artikeln beskriver vanliga fel som kan uppstå när du distribuerar ClickOnce-programmet och innehåller steg för att lösa varje problem.
Allmänna fel
När du försöker hitta en programfil sker ingenting eller XML-återgivningar i Internet Explorer, eller så får du dialogrutan Kör eller Spara som
Den möjliga orsaken till det här felet är att innehållstyper (även kallade MIME-typer) inte registreras korrekt på servern eller klienten.
Kontrollera först att servern är konfigurerad för att associera .application-tillägget med innehållstypen "application/x-ms-application".
Om servern är korrekt konfigurerad kontrollerar du att .NET Framework 2.0 är installerad på datorn. Om .NET Framework 2.0 är installerat och du fortfarande ser det här problemet kan du prova att avinstallera och installera om .NET Framework 2.0 för att registrera innehållstypen på klienten igen.
Fel: "Det gick inte att hämta programmet. Filer som saknas i distributionen eller "Programhämtningen har avbrutits, sök efter nätverksfel och försök igen senare"
Det här meddelandet anger att en eller flera filer som ClickOnce-manifestreferensen inte kan laddas ned. Det enklaste sättet att felsöka det här felet är att försöka ladda ned URL:en som ClickOnce säger att det inte går att ladda ned. Här är några möjliga orsaker:
- Om loggfilen säger "(403) Förbjudet" eller "(404) Hittades inte" kontrollerar du att webbservern är konfigurerad så att den inte blockerar nedladdningen av den här filen. Mer information finns i Problem med server- och klientkonfiguration i ClickOnce-distributioner.
- Om .config-filen blockeras av servern läser du Ladda ned fel när du försöker installera ett ClickOnce-program som har en .config fil.
- Kontrollera om det här felet uppstod eftersom
deploymentProvider
URL:en i distributionsmanifestet pekar på en annan plats än den URL som används för aktivering. - Kontrollera att alla filer finns på servern. ClickOnce-loggen ska ange vilken fil som inte hittades.
- Se om det finns problem med nätverksanslutningen. du kan få det här meddelandet om klientdatorn gick offline under nedladdningen.
Nedladdningsfel när du försöker installera ett ClickOnce-program som har en .config fil
Som standard innehåller ett Visual Basic Windows-baserat program en App.config fil. Du kan stöta på ett problem om du försöker installera från en webbserver som använder Windows Server 2003, eftersom operativsystemet blockerar installationen av .config filer av säkerhetsskäl. Om du vill att den.config filen ska installeras väljer du Använd filnamnstillägget ".deploy" i dialogrutan Publiceringsalternativ .
Du måste också ange innehållstyperna (kallas även MIME-typer) på lämpligt sätt för .application-, .manifest- och .deploy-filer . Mer information finns i webbserverdokumentationen.
Mer information finns i Windows Server: Låsta innehållstyper.
Fel: Programmet är felaktigt formaterat; Loggfilen innehåller "XML-signaturen är ogiltig"
Se till att du har uppdaterat manifestfilen och signerat den igen. Publicera om programmet med hjälp av Visual Studio eller använd Mage för att signera programmet igen.
Du har uppdaterat programmet på servern, men klienten laddar inte ned uppdateringen
Det här problemet kan lösas genom att utföra någon av följande uppgifter:
-
deploymentProvider
Granska URL:en i distributionsmanifestet. Se till att du uppdaterar bitarna på samma plats somdeploymentProvider
pekar på. - Kontrollera uppdateringsintervallet i distributionsmanifestet. Om det här intervallet är inställt på ett periodiskt intervall, till exempel en gång var sjätte timme, söker ClickOnce inte efter en uppdatering förrän det här intervallet har passerat. Du kan ändra manifestet så att det söker efter en uppdatering varje gång programmet startas. Att ändra uppdateringsintervallet är ett praktiskt alternativ under utvecklingstiden för att verifiera att uppdateringar installeras, men det saktar ned programaktiveringen.
- Försök att starta programmet igen på Start-menyn. ClickOnce kan ha identifierat uppdateringen i bakgrunden, men du uppmanas att installera bitarna vid nästa aktivering.
Under uppdateringen får du ett felmeddelande med följande loggpost: "Referensen i distributionen matchar inte den identitet som definierats i programmanifestet"
Det här felet kan inträffa eftersom du har redigerat distributions- och programmanifesten manuellt och gjort att beskrivningen av identiteten för en sammansättning i ett manifest har blivit osynkroniserad med den andra. Identiteten för en sammansättning består av dess namn, version, kultur och offentliga nyckeltoken. Granska identitetsbeskrivningarna i manifesten och korrigera eventuella skillnader.
Första gången aktiveringen från den lokala disken eller CD-ROM lyckas, men efterföljande aktivering från Start-menyn lyckas inte
ClickOnce använder URL:en för distributionsprovidern för att ta emot uppdateringar för programmet. Kontrollera att platsen som URL:en pekar på är korrekt.
Fel: Det går inte att starta programmet
Det här felmeddelandet anger vanligtvis att det är problem med att installera programmet i ClickOnce-arkivet. Antingen har programmet ett fel eller så är arkivet skadat. Loggfilen kan visa var felet inträffade.
Lös problemet genom att följa dessa steg:
- Kontrollera att identiteten för distributionsmanifestet, identiteten för programmanifestet och identiteten för huvudprogrammet EXE är unika.
- Kontrollera att filsökvägarna inte är längre än 100 tecken. Om ditt program innehåller sökvägar som är för långa kan du överskrida begränsningarna för den maximala sökväg som du kan lagra. Försök att förkorta sökvägarna och installera sedan om.
PrivatePath-inställningar i programkonfigurationsfilen respekteras inte
Om du vill använda PrivatePath (Fusion-avsökningssökvägar) måste programmet begära fullständig förtroendebehörighet. Försök att ändra programmanifestet för att begära fullständigt förtroende och försök sedan igen.
Under avinstallationen visas ett meddelande med texten "Det gick inte att avinstallera programmet"
Det här meddelandet anger vanligtvis att programmet redan har tagits bort eller att arkivet är skadat. När du har valt OK tas posten Lägg till/ta bort program bort.
Under installationen visas ett meddelande om att plattformsberoendena inte är installerade
Du saknar ett krav i GAC (global sammansättningscache) som programmet behöver för att kunna köras.
Publicera med Visual Studio
Det går inte att publicera i Visual Studio
Se till att du har rätt att publicera på den server som du riktar in dig på. Om du till exempel är inloggad på en terminalserverdator som en vanlig användare, inte som administratör, har du förmodligen inte de behörigheter som krävs för att publicera till den lokala webbservern.
Om du publicerar med en URL kontrollerar du att servertillägg för FrontPage-servern är aktiverade på måldatorn.
Fel: Det går inte att skapa webbplatsens webbplats<>. Komponenterna för kommunikation med FrontPage Server-tillägg är inte installerade
Kontrollera att du har Microsoft Visual Studio Web Authoring Component installerat på den dator som du publicerar från. För Express-användare är den här komponenten inte installerad som standard.
Fel: Det gick inte att hitta filen 'Microsoft.Windows.Common-Controls, Version=6.0.0.0, Culture=*, PublicKeyToken=6595b64144ccf1df, ProcessorArchitecture=*, Type=win32'
Det här felmeddelandet visas när du försöker publicera ett WPF-program med visuella format aktiverade. Information om hur du löser det här problemet finns i How to: Publish a WPF Application with Visual Styles Enabled (Så här gör du: Publicera ett WPF-program med aktiverade visuella format).
Använda Mage
Du försökte logga in med ett certifikat i certifikatarkivet och en tom meddelanderuta
I dialogrutan Signering måste du:
- Välj Signera med ett lagrat certifikat.
- Välj ett certifikat i listan. det första certifikatet är inte standardvalet.
Om du klickar på knappen "Logga inte" genereras ett undantag
Det här problemet är en känd bugg. Alla ClickOnce-manifest måste signeras. Välj bara ett av signeringsalternativen och välj sedan OK.
Fler fel
I följande tabell visas några vanliga felmeddelanden som en klientdatoranvändare kan få när användaren installerar ett ClickOnce-program. Varje felmeddelande visas bredvid en beskrivning av den troligaste orsaken till felet.
Felmeddelande | Beskrivning |
---|---|
Det går inte att starta programmet. Kontakta programutgivaren. Det går inte att starta programmet. Kontakta programleverantören om du vill ha hjälp. |
Det här är allmänna felmeddelanden som inträffar när programmet inte kan startas och ingen annan specifik orsak kan hittas. Ofta innebär det att programmet på något sätt är skadat eller att ClickOnce-arkivet är skadat. |
Det går inte att fortsätta. Programmet är felaktigt formaterat. Kontakta programutgivaren om du vill ha hjälp. Programverifieringen lyckades inte. Det går inte att fortsätta. Det går inte att hämta programfiler. Filer som är skadade i distributionen. |
En av manifestfilerna i distributionen är syntaktiskt ogiltig eller innehåller en hash som inte kan stämmas av med motsvarande fil. Det här felet kan också tyda på att manifestet som är inbäddat i en sammansättning är skadat. Återskapa distributionen och kompilera om programmet, eller hitta och åtgärda felen manuellt i manifesten. |
Det går inte att hämta programmet. Autentiseringsfel. Programinstallationen lyckades inte. Det går inte att hitta programfiler på servern. Kontakta programutgivaren eller administratören om du vill ha hjälp. |
Det går inte att ladda ned en eller flera filer i distributionen eftersom du inte har behörighet att komma åt dem. Detta kan bero på att ett 403 Forbidden-fel returneras av en webbserver, vilket kan inträffa om en av filerna i distributionen slutar med ett tillägg som gör att webbservern behandlar den som en skyddad fil. En katalog som innehåller en eller flera av programmets filer kan också kräva ett användarnamn och lösenord för att få åtkomst. |
Det går inte att ladda ned programmet. Programmet saknar nödvändiga filer. Kontakta programleverantören eller systemadministratören om du vill ha hjälp. | Det går inte att hitta en eller flera av filerna i programmanifestet på servern. Kontrollera att du har laddat upp alla distributionens beroende filer och försök igen. |
Programnedladdningen lyckades inte. Kontrollera nätverksanslutningen eller kontakta systemadministratören eller nätverkstjänstleverantören. | ClickOnce kan inte upprätta en nätverksanslutning till servern. Granska serverns tillgänglighet och nätverkets tillstånd. |
URLDownloadToCacheFile misslyckades med HRESULT-talet<>. Ett fel uppstod när filen<> skulle laddas ned. | Om en användare har angett alternativet "Varna om du byter mellan säkert och inte säkert läge" på distributionsmåldatorn, och om installations-URL:en för ClickOnce-programmet som installeras omdirigeras från en icke-säker plats till en säker plats (eller vice versa), misslyckas installationen eftersom Internet Explorer-varningen avbryter den. Du kan lösa det här felet genom att utföra någon av följande uppgifter: - Rensa säkerhetsalternativet. – Kontrollera att installations-URL:en inte omdirigeras på ett sådant sätt att säkerhetslägen ändras. – Ta bort omdirigeringen helt och peka på den faktiska installations-URL:en. |
Ett fel uppstod vid skrivning till hårddisken. Det kanske inte finns tillräckligt med ledigt utrymme på disken. Kontakta programleverantören eller systemadministratören om du vill ha hjälp. | Detta kan tyda på otillräckligt diskutrymme för att lagra programmet, men det kan också tyda på ett mer allmänt I/O-fel när du försöker spara programfilerna på enheten. |
Det går inte att starta programmet. Det finns inte tillräckligt med ledigt utrymme på disken. | Hårddisken är full. Ta bort utrymme och försök köra programmet igen. |
För många distribuerade aktiveringar försöker läsas in samtidigt. | ClickOnce begränsar antalet olika program som kan starta samtidigt. Detta är till stor del för att skydda mot skadliga försök att initiera överbelastningsattacker mot den lokala ClickOnce-tjänsten. användare som försöker starta samma program upprepade gånger, i snabb följd, får bara en enda instans av programmet. |
Genvägar kan inte aktiveras över nätverket. | Genvägar till ett ClickOnce-program kan bara startas på den lokala hårddisken. Det går inte att starta dem genom att öppna en URL som pekar på en genvägsfil på en fjärrserver. |
Programmet är för stort för att köras online i partiellt förtroende. Kontakta programleverantören eller systemadministratören om du vill ha hjälp. | Ett program som körs i partiellt förtroende får inte vara större än hälften av storleken på onlineprogramkvoten, vilket som standard är 250 MB. |