Udostępnij za pośrednictwem

Rozwiązywanie problemów z określonymi błędami we wdrożeniach ClickOnce

  • Artykuł

Dotyczy: Visual Studio

W tym artykule przedstawiono typowe błędy, które mogą wystąpić podczas wdrażania aplikacji ClickOnce, i przedstawiono kroki rozwiązywania każdego problemu.

Błędy ogólne

Podczas próby zlokalizowania pliku aplikacji nic się nie dzieje, renderowanie XML w programie Internet Explorer albo zostanie wyświetlone okno dialogowe Uruchom lub Zapisz jako

Możliwą przyczyną tego błędu jest to, że typy zawartości (znane również jako typy MIME) nie są poprawnie rejestrowane na serwerze lub kliencie.

Najpierw upewnij się, że serwer jest skonfigurowany do kojarzenia rozszerzenia .application z typem zawartości "application/x-ms-application".

Jeśli serwer jest poprawnie skonfigurowany, sprawdź, czy na komputerze jest zainstalowany .NET Framework 2.0. Jeśli .NET Framework 2.0 jest zainstalowany i nadal występuje ten problem, spróbuj odinstalować i ponownie zainstalować .NET Framework 2.0, aby ponownie zarejestrować typ zawartości na kliencie.

Błąd: "Nie można pobrać aplikacji. Brakujące pliki we wdrożeniu" lub "Pobieranie aplikacji zostało przerwane, sprawdź, czy występują błędy sieciowe i spróbuj ponownie później"

Ten komunikat wskazuje, że nie można pobrać co najmniej jednego pliku, do którego odwołuje się manifest ClickOnce. Najprostszym sposobem debugowania tego błędu jest próba pobrania adresu URL, który clickOnce mówi, że nie można pobrać. Oto kilka możliwych przyczyn:

Błąd pobierania podczas próby zainstalowania aplikacji ClickOnce zawierającej plik .config

Domyślnie aplikacja oparta na systemie Windows w języku Visual Basic zawiera plik App.config . Jeśli spróbujesz zainstalować z serwera sieci Web, który używa systemu Windows Server 2003, może wystąpić problem, ponieważ ten system operacyjny blokuje instalację plików.config ze względów bezpieczeństwa. Aby włączyć instalowanie pliku .config , wybierz pozycję Użyj rozszerzenia pliku ".deploy" w oknie dialogowym Opcje publikowania .

Należy również odpowiednio ustawić typy zawartości (nazywane również typami MIME) dla plików .application, .manifest i .deploy . Aby uzyskać więcej informacji, zobacz dokumentację serwera sieci Web.

Aby uzyskać więcej informacji, zobacz Windows Server: Zablokowane typy zawartości.

Błąd: Aplikacja jest nieprawidłowo sformatowana; Plik dziennika zawiera komunikat "Podpis XML jest nieprawidłowy"

Upewnij się, że plik manifestu został zaktualizowany i podpisany ponownie. Ponownie opublikuj aplikację przy użyciu programu Visual Studio lub użyj narzędzia Mage, aby ponownie podpisać aplikację.

Zaktualizowano aplikację na serwerze, ale klient nie pobiera aktualizacji

Ten problem można rozwiązać, wykonując jedno z następujących zadań:

  • deploymentProvider Sprawdź adres URL w manifeście wdrożenia. Upewnij się, że aktualizujesz bity w tej samej lokalizacji, na którą deploymentProvider wskazuje.
  • Sprawdź interwał aktualizacji w manifeście wdrożenia. Jeśli ten interwał jest ustawiony na interwał okresowy, taki jak jeden raz na sześć godzin, funkcja ClickOnce nie będzie skanować w poszukiwaniu aktualizacji, dopóki ten interwał nie ulegnie pomyślnie. Manifest można zmienić w celu skanowania w poszukiwaniu aktualizacji za każdym razem, gdy aplikacja zostanie uruchomiona. Zmiana interwału aktualizacji jest wygodną opcją w czasie programowania, aby sprawdzić, czy aktualizacje są instalowane, ale spowalnia aktywację aplikacji.
  • Spróbuj ponownie uruchomić aplikację w menu Start. Narzędzie ClickOnce mogło wykryć aktualizację w tle, ale wyświetli monit o zainstalowanie bitów podczas następnej aktywacji.

Podczas aktualizacji występuje błąd z następującym wpisem dziennika: "Odwołanie we wdrożeniu nie jest zgodne z tożsamością zdefiniowaną w manifeście aplikacji"

Ten błąd może wystąpić, ponieważ ręcznie edytowano manifesty wdrożenia i aplikacji, co spowodowało, że opis tożsamości zestawu w jednym manifeście nie był zsynchronizowany z drugim. Tożsamość zestawu składa się z jego nazwy, wersji, kultury i tokenu klucza publicznego. Sprawdź opisy tożsamości w manifestach i popraw wszelkie różnice.

Po raz pierwszy aktywacja z dysku lokalnego lub dysku CD-ROM zakończy się pomyślnie, ale późniejsza aktywacja z menu Start nie powiedzie się

ClickOnce używa adresu URL dostawcy wdrażania, aby otrzymywać aktualizacje dla aplikacji. Sprawdź, czy lokalizacja, na którą wskazuje adres URL, jest poprawna.

Błąd: Nie można uruchomić aplikacji

Ten komunikat o błędzie zwykle wskazuje, że wystąpił problem z zainstalowaniem tej aplikacji w magazynie ClickOnce. Aplikacja ma błąd lub magazyn jest uszkodzony. Plik dziennika może poinformować o tym, gdzie wystąpił błąd.

Aby rozwiązać ten problem, wykonaj następujące kroki:

  1. Upewnij się, że tożsamość manifestu wdrożenia, tożsamość manifestu aplikacji i tożsamość głównego środowiska EXE aplikacji są unikatowe.
  2. Upewnij się, że ścieżki plików nie są dłuższe niż 100 znaków. Jeśli aplikacja zawiera zbyt długie ścieżki plików, możesz przekroczyć ograniczenia dotyczące maksymalnej ścieżki, którą można przechowywać. Spróbuj skrócić ścieżki, a następnie ponownie zainstalować.

Ustawienia programu PrivatePath w pliku konfiguracji aplikacji nie są przestrzegane

Aby używać ścieżki PrivatePath (ścieżki sondowania fuzji), aplikacja musi zażądać pełnego uprawnienia zaufania. Spróbuj zmienić manifest aplikacji, aby zażądać pełnego zaufania, a następnie spróbuj ponownie.

Podczas odinstalowywania zostanie wyświetlony komunikat "Nie można odinstalować aplikacji"

Ten komunikat zwykle wskazuje, że aplikacja została już usunięta lub magazyn jest uszkodzony. Po wybraniu przycisku OK wpis Dodaj/Usuń program zostanie usunięty.

Podczas instalacji zostanie wyświetlony komunikat informujący, że zależności platformy nie są zainstalowane

Brak wymagań wstępnych w usłudze GAC (globalnej pamięci podręcznej zestawów), której aplikacja potrzebuje do uruchomienia.

Publikowanie za pomocą programu Visual Studio

Publikowanie w programie Visual Studio kończy się niepowodzeniem

Upewnij się, że masz prawo do publikowania na docelowym serwerze. Jeśli na przykład zalogujesz się na komputerze serwera terminalu jako zwykły użytkownik, a nie jako administrator, prawdopodobnie nie będziesz mieć uprawnień wymaganych do opublikowania na lokalnym serwerze sieci Web.

Jeśli publikujesz z adresem URL, upewnij się, że komputer docelowy ma włączone rozszerzenia serwera FrontPage.

Błąd: Nie można utworzyć witryny sieci Web "<site>". Składniki do komunikowania się z rozszerzeniami programu FrontPage Server nie są zainstalowane

Upewnij się, że na komputerze, z której publikujesz, zainstalowano składnik Microsoft Visual Studio Web Authoring Component. W przypadku użytkowników platformy Express ten składnik nie jest instalowany domyślnie.

Błąd: Nie można odnaleźć pliku "Microsoft.Windows.Common-Controls, Version=6.0.0.0, Culture=*, PublicKeyToken=6595b64144ccf1df, ProcessorArchitecture=*, Type=win32"

Ten komunikat o błędzie pojawia się podczas próby opublikowania aplikacji WPF z włączonymi stylami wizualnymi. Aby rozwiązać ten problem, zobacz Instrukcje: publikowanie aplikacji WPF z włączonymi stylami wizualnymi.

Korzystanie z narzędzia Mage

Próbowano zalogować się przy użyciu certyfikatu w magazynie certyfikatów i odebranego pustego pola komunikatu

W oknie dialogowym Podpisywanie należy wykonać następujące czynności:

  1. Wybierz pozycję Sign with a stored certificate (Podpisz przy użyciu przechowywanego certyfikatu).
  2. Wybierz certyfikat z listy; pierwszy certyfikat nie jest domyślnym wyborem.

Kliknięcie przycisku "Nie podpisuj" powoduje wyjątek

Ten problem jest znaną usterką. Wszystkie manifesty ClickOnce muszą być podpisane. Po prostu wybierz jedną z opcji podpisywania, a następnie wybierz przycisk OK.

Więcej błędów

W poniższej tabeli przedstawiono niektóre typowe komunikaty o błędach, które może otrzymywać użytkownik komputera-klienta, gdy użytkownik zainstaluje aplikację ClickOnce. Każdy komunikat o błędzie znajduje się obok opisu najbardziej prawdopodobnej przyczyny błędu.

Komunikat o błędzie Opis
Nie można uruchomić aplikacji. Skontaktuj się z wydawcą aplikacji.

Nie można uruchomić aplikacji. Skontaktuj się z dostawcą aplikacji, aby uzyskać pomoc.		 Są to ogólne komunikaty o błędach, które występują, gdy nie można uruchomić aplikacji i nie można odnaleźć żadnej innej konkretnej przyczyny. Często oznacza to, że aplikacja jest w jakiś sposób uszkodzona lub że magazyn ClickOnce jest uszkodzony.
Nie można kontynuować. Aplikacja jest nieprawidłowo sformatowana. Skontaktuj się z wydawcą aplikacji, aby uzyskać pomoc.

Weryfikacja aplikacji nie powiodła się. Nie można kontynuować.

Nie można pobrać plików aplikacji. Pliki uszkodzone we wdrożeniu.		 Jeden z plików manifestu we wdrożeniu jest syntaktycznie nieprawidłowy lub zawiera skrót, który nie może zostać uzgodniony z odpowiednim plikiem. Ten błąd może również wskazywać, że manifest osadzony wewnątrz zestawu jest uszkodzony. Utwórz ponownie wdrożenie i ponownie skompiluj aplikację lub znajdź i napraw błędy ręcznie w manifestach.
Nie można pobrać aplikacji. Błąd uwierzytelniania.

Instalacja aplikacji nie powiodła się. Nie można zlokalizować plików aplikacji na serwerze. Skontaktuj się z wydawcą aplikacji lub administratorem, aby uzyskać pomoc.		 Nie można pobrać co najmniej jednego pliku we wdrożeniu, ponieważ nie masz uprawnień dostępu do nich. Może to być spowodowane przez błąd 403 Zabronione zwracany przez serwer sieci Web, który może wystąpić, jeśli jeden z plików we wdrożeniu zakończy się rozszerzeniem, które sprawia, że serwer sieci Web traktuje go jako plik chroniony. Ponadto katalog zawierający co najmniej jeden plik aplikacji może wymagać nazwy użytkownika i hasła w celu uzyskania dostępu.
Nie można pobrać aplikacji. W aplikacji brakuje wymaganych plików. Skontaktuj się z dostawcą aplikacji lub administratorem systemu, aby uzyskać pomoc. Nie można odnaleźć co najmniej jednego pliku wymienionego w manifeście aplikacji na serwerze. Sprawdź, czy przekazano wszystkie pliki zależne od wdrożenia i spróbuj ponownie.
Pobieranie aplikacji nie powiodło się. Sprawdź połączenie sieciowe lub skontaktuj się z administratorem systemu lub dostawcą usług sieciowych. ClickOnce nie może ustanowić połączenia sieciowego z serwerem. Sprawdź dostępność serwera i stan sieci.
Błąd URLDownloadToCacheFile z "<liczbą>" HRESULT. Wystąpił błąd podczas próby pobrania pliku<>. Jeśli użytkownik ustawił opcję Zabezpieczenia zaawansowane programu Internet Explorer "Ostrzegaj, jeśli zmienia się w trybie bezpiecznym i niezabezpieczonym" na komputerze docelowym wdrożenia i jeśli adres URL konfiguracji zainstalowanej aplikacji ClickOnce zostanie przekierowany z niezabezpieczonej lokacji do bezpiecznej lokacji (lub odwrotnie), instalacja zakończy się niepowodzeniem, ponieważ ostrzeżenie programu Internet Explorer ją przerywa.

Aby rozwiązać ten błąd, możesz wykonać jedno z następujących zadań:

— Wyczyść opcję zabezpieczeń.
— Upewnij się, że adres URL konfiguracji nie jest przekierowywany w taki sposób, aby zmieniał tryby zabezpieczeń.
— Całkowicie usuń przekierowanie i wskaż rzeczywisty adres URL konfiguracji.
Wystąpił błąd podczas zapisywania na dysku twardym. Na dysku może być za mało miejsca. Skontaktuj się z dostawcą aplikacji lub administratorem systemu, aby uzyskać pomoc. Może to wskazywać na niewystarczającą ilość miejsca na dysku do przechowywania aplikacji, ale może również wskazywać na bardziej ogólny błąd we/wy podczas próby zapisania plików aplikacji na dysku.
Nie można uruchomić aplikacji. Na dysku jest za mało dostępnego miejsca. Dysk twardy jest pełny. Wyczyść miejsce i spróbuj ponownie uruchomić aplikację.
Zbyt wiele wdrożonych aktywacji próbuje załadować się jednocześnie. ClickOnce ogranicza liczbę różnych aplikacji, które mogą być uruchamiane w tym samym czasie. Jest to w dużej mierze pomocne w ochronie przed złośliwymi próbami inicjowania ataków typu "odmowa usługi" na lokalną usługę ClickOnce; użytkownicy, którzy próbują uruchomić tę samą aplikację wielokrotnie, w krótkim odstępie czasu, będą mieć tylko jedno wystąpienie aplikacji.
Skrótów nie można aktywować za pośrednictwem sieci. Skróty do aplikacji ClickOnce można uruchamiać tylko na lokalnym dysku twardym. Nie można ich uruchomić przez otwarcie adresu URL wskazującego na plik skrótów na serwerze zdalnym.
Aplikacja jest zbyt duża, aby działała w trybie online w częściowym zaufaniu. Skontaktuj się z dostawcą aplikacji lub administratorem systemu, aby uzyskać pomoc. Aplikacja działająca w częściowym zaufaniu nie może być większa niż połowa rozmiaru limitu przydziału aplikacji online, który domyślnie wynosi 250 MB.

Informacje