Udostępnij za pośrednictwem

Rozwiązywanie problemów z określonymi błędami wdrożeń technologii ClickOnce

  • Artykuł

Dotyczy: Visual Studio

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

Błędy ogólne

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

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 skojarzenia rozszerzenia aplikacji z typem zawartości "application/x-ms-application".

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

Błąd: "Nie można pobrać aplikacji. Brak plików we wdrożeniu" lub "Pobieranie aplikacji zostało przerwane, sprawdź błędy sieci i spróbuj ponownie później"

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

  • Jeśli w pliku dziennika jest wyświetlany komunikat "(403) Zabronione" lub "(404) Nie znaleziono", sprawdź, czy serwer sieci Web jest skonfigurowany tak, aby nie blokował pobierania tego pliku. Aby uzyskać więcej informacji, zobacz Problemy z konfiguracją serwera i klienta w wdrożeniach Technologii ClickOnce.
  • Jeśli plik config jest blokowany przez serwer, zobacz Błąd pobierania podczas próby zainstalowania aplikacji ClickOnce z plikiem config.
  • Ustal, czy ten błąd wystąpił, ponieważ deploymentProvider adres URL w manifeście wdrożenia wskazuje inną lokalizację niż adres URL używany do aktywacji.
  • Upewnij się, że wszystkie pliki znajdują się na serwerze; Dziennik ClickOnce powinien poinformować, który plik nie został znaleziony.
  • Sprawdź, czy występują problemy z łącznością sieciową; Ten komunikat może zostać wyświetlony, jeśli komputer kliencki przeszedł do trybu offline podczas pobierania.

Błąd pobierania podczas próby zainstalowania aplikacji ClickOnce z plikiem config

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

Należy również odpowiednio ustawić typy zawartości (znane również jako typy 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 wartość "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ę.

Aplikacja została zaktualizowana 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, która deploymentProvider wskazuje.
  • Sprawdź interwał aktualizacji w manifeście wdrożenia. Jeśli ten interwał jest ustawiony na okresowy interwał, taki jak jeden raz co sześć godzin, funkcja ClickOnce nie będzie skanowana pod kątem aktualizacji, dopóki ten interwał nie przejdzie. Manifest można zmienić tak, aby skanował aktualizację za każdym razem, gdy aplikacja zostanie uruchomiona. Zmiana interwału aktualizacji jest wygodną opcją w czasie programowania w celu sprawdzenia, czy aktualizacje są instalowane, ale spowalnia aktywację aplikacji.
  • Spróbuj ponownie uruchomić aplikację na menu Start. Funkcja ClickOnce mogła 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 i spowodowały, że opis tożsamości zestawu w jednym manifeście stał się niezsynchronizuje się z drugą. 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 kolejna aktywacja z menu Start nie powiedzie się

ClickOnce używa adresu URL dostawcy wdrażania do odbierania aktualizacji dla aplikacji. Sprawdź, czy lokalizacja wskazująca adres URL jest poprawna.

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

Ten komunikat o błędzie zwykle wskazuje, że występuje problem podczas instalowania 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 poniższe czynności:

  1. Upewnij się, że tożsamość manifestu wdrożenia, tożsamość manifestu aplikacji i tożsamość głównego pliku 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 ścieżki plików, które są zbyt długie, możesz przekroczyć ograniczenia maksymalnej ścieżki, którą można przechowywać. Spróbuj skrócić ścieżki, a następnie ponownie zainstalować.

Ustawienia privatePath w pliku konfiguracji aplikacji nie są honorowane

Aby użyć ścieżki sondowania łączenia (PrivatePath), aplikacja musi zażądać uprawnienia pełnego 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 zostanie usunięty wpis Dodaj/Usuń program.

Podczas instalacji pojawia się komunikat informujący, że zależności platformy nie są zainstalowane

Brakuje wymagań wstępnych w pamięci podręcznej 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 serwerze docelowym. Jeśli na przykład logujesz się na komputerze serwera terminali jako zwykły użytkownik, a nie jako administrator, prawdopodobnie nie będziesz mieć praw wymaganych do opublikowania na lokalnym serwerze sieci Web.

Jeśli publikujesz za pomocą adresu URL, upewnij się, że na komputerze docelowym są włączone rozszerzenia serwera programu FrontPage.

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

Upewnij się, że na komputerze, z którego publikujesz, zainstalowano składnik tworzenia w sieci Web programu Microsoft Visual Studio. 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 jest wyświetlany podczas próby opublikowania aplikacji WPF z włączonymi stylami wizualnymi. Aby rozwiązać ten problem, zobacz Jak opublikować aplikację WPF z włączonymi stylami wizualnymi.

Korzystanie z narzędzia Mage

Próbowano podpisać certyfikat w magazynie certyfikatów i odebrano puste pole komunikatu

W oknie dialogowym Podpisywanie musisz:

  1. Wybierz pozycję Podpisz przy użyciu przechowywanego certyfikatu.
  2. Wybierz certyfikat z listy; pierwszy certyfikat nie jest domyślnym wyborem.

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

Ten problem jest znaną usterką. Wszystkie manifesty Technologii 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 użytkownik komputera klienckiego może otrzymać po zainstalowaniu aplikacji ClickOnce przez użytkownika. 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 występujące, gdy nie można uruchomić aplikacji i nie można odnaleźć innego konkretnego powodu. 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.

Sprawdzanie poprawności aplikacji nie powiodło 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 nieprawidłowy składniowo lub zawiera skrót, którego nie można uzgodnić 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 koń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. Na serwerze nie można odnaleźć co najmniej jednego pliku wymienionego w manifeście aplikacji. Sprawdź, czy wszystkie pliki zależne wdrożenia zostały przekazane, 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.
Element URLDownloadToCacheFile nie powiódł się z elementem HRESULT "<number>". Wystąpił błąd podczas próby pobrania pliku .<> Jeśli użytkownik ustawił opcję Zabezpieczenia zaawansowane programu Internet Explorer "Ostrzegaj, jeśli zmieni się między trybem bezpiecznym i niezabezpieczonym" na komputerze docelowym wdrożenia, a adres URL instalacji aplikacji ClickOnce zostanie przekierowany z niezabezpieczonej lokacji (lub odwrotnie), instalacja zakończy się niepowodzeniem, ponieważ ostrzeżenie programu Internet Explorer przerywa jego wersję.

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 zmienić 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 to 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ć jednocześnie. Funkcja ClickOnce ogranicza liczbę różnych aplikacji, które mogą być uruchamiane w tym samym czasie. Jest to w dużej mierze pomoc w ochronie przed złośliwymi próbami zainicjowania ataków typu "odmowa usługi" na lokalną usługę ClickOnce; użytkownicy, którzy próbują wielokrotnie uruchamiać tę samą aplikację, w krótkim odstępie czasu, będą kończyć się tylko jednym wystąpieniem aplikacji.
Nie można aktywować skrótów za pośrednictwem sieci. Skróty do aplikacji ClickOnce można uruchomić tylko na lokalnym dysku twardym. Nie można ich uruchomić, otwierając adres URL wskazujący plik skrótu na serwerze zdalnym.
Aplikacja jest zbyt duża, aby uruchomić aplikację w trybie online w częściowym zaufaniu. Skontaktuj się z dostawcą aplikacji lub administratorem systemu, aby uzyskać pomoc. Aplikacja, która działa w częściowym zaufaniu, nie może być większa niż połowa limitu przydziału aplikacji online, który domyślnie wynosi 250 MB.

Informacje