Udostępnij za pośrednictwem


Rozwiązywanie problemów z instalacją pliku Instalatora aplikacji

Jeśli podczas instalowania aplikacji z pliku Instalatora aplikacji znajdziesz jakiekolwiek problemy, ten temat zawiera wskazówki dotyczące rozwiązywania problemów, które mogą pomóc.

Wymagania wstępne

Aby móc ładować bezpośrednio aplikacje w systemie Windows 10, urządzenie użytkownika musi spełniać następujące wymagania:

Windows 10:

  • Certyfikat używany do podpisywania pakietu musi być uznawany przez urządzenie za zaufany. Aby uzyskać więcej informacji, zobacz sekcję Zaufane certyfikaty poniżej.
  • Wersja systemu Windows 10 musi obsługiwać .appinstaller schemat plików i protokół dystrybucji.

Windows 10 1909 i starsze:

Typowe problemy

Podczas pierwszego sideloadingu aplikacji na komputerze użytkownika występują pewne typowe problemy. W następnych kilku sekcjach opisano najczęstsze problemy i ich rozwiązania.

Wersja dla systemu Windows

Każda wersja systemu Windows 10 ulepsza środowisko ładowania bezpośredniego, w poniższej tabeli znajdziesz funkcje dostępne w każdej wersji głównej. Jeśli spróbujesz załadować aplikację bezpośrednio przy użyciu metody, która nie jest obsługiwana w wersji systemu Windows 10, zostanie wyświetlony błąd wdrożenia.

wersja Uwagi dotyczące ładowania bezpośredniego
Kompilacja 17134 (aktualizacja z kwietnia 2018 r., wersja 1803) Dostęp .appinstaller do pliku można uzyskać za pośrednictwem folderów UNC/Share. Dostępne są również konfigurowalne testy aktualizacji.
Build 16299 (Fall Creators Update, wersja 1709) Wprowadzono plik .appinstaller w celu automatycznego aktualizowania twojej aplikacji. Ta wersja obsługuje tylko punkty końcowe HTTP. Sprawdzanie aktualizacji nie jest konfigurowalne i odbywa się co 24 godziny.
Build 15063 (aktualizacja dla twórców, wersja 1703) Instalator aplikacji może pobierać zależności aplikacji (tylko w trybie publicznym) ze Sklepu.
Kompilacja 14393 (rocznicowa aktualizacja, wersja 1607) Wprowadzono aplikację Instalatora aplikacji do instalowania plików .appx i appxbundle, plik appinstaller nie jest obsługiwany.
Kompilacja 10586 (aktualizacja z listopada, wersja 1511) Ładowanie bezpośrednie jest dostępne tylko za pośrednictwem programu PowerShell za pomocą polecenia Add-AppxPackage .
Build 10240 (Windows 10, wersja 1507) Ładowanie bezpośrednie jest dostępne tylko za pośrednictwem programu PowerShell za pomocą polecenia Add-AppxPackage .

Zaufane certyfikaty

Pakiety aplikacji muszą być podpisane przy użyciu certyfikatu zaufanego przez urządzenie. Certyfikaty udostępniane przez wspólne urzędy certyfikacji są domyślnie zaufane w systemie operacyjnym Windows.

Jeśli jednak certyfikat używany do podpisywania pakietu aplikacji nie jest zaufany lub jest lokalnie generowany/z podpisem własnym certyfikat używany podczas programowania, instalator aplikacji może zgłosić, że pakiet jest niezaufany i uniemożliwi zainstalowanie go:

MSIX podpisany z brakującym lub niezaufanym certyfikatem

Aby rozwiązać ten problem, użytkownik z uprawnieniami administratora lokalnego do urządzenia musi użyć narzędzia Certyfikaty komputera , aby zaimportować certyfikat do jednego z następujących kontenerów:

  1. Komputer lokalny: Zaufane osoby
  2. Komputer lokalny: zaufane urzędy główne (niezalecane)

Ważne

Nie należy importować certyfikatów podpisywania pakietów do magazynu certyfikatów użytkownika. Instalator aplikacji nie wyszukuje certyfikatów użytkownika podczas weryfikowania tożsamości pakietu.

Narzędzie do zarządzania certyfikatami komputerów można łatwo znaleźć, wyszukując w menu Start:

Znajdź narzędzie Certyfikaty komputera lokalnego za pomocą menu Start

Po pomyślnym zaimportowaniu certyfikatu podpisywania ponownie uruchomiony instalator aplikacji pokaże, że pakiet jest zaufany i można go zainstalować:

Plik MSIX podpisany przy użyciu zaufanego certyfikatu

Zależności nie zostały zainstalowane

Aplikacje systemu Windows 10 mogą mieć zależności struktury na podstawie platformy aplikacji używanej do generowania aplikacji. Jeśli używasz języka C# lub VB, aplikacja będzie wymagać pakietów środowiska uruchomieniowego .NET i platformy .NET Framework. Aplikacje języka C++ wymagają bibliotek VCLibs.

Ważne

Jeśli pakiet aplikacji jest zbudowany w konfigurację trybu Release, zależności frameworka zostaną uzyskane ze sklepu Microsoft Store. Jeśli jednak aplikacja jest wbudowana w konfigurację trybu debugowania, zależności zostaną uzyskane z lokalizacji określonej w .appinstaller pliku.

Pliki, które nie są dostępne

Podczas instalowania z punktu końcowego HTTP ważne jest, aby sprawdzić, czy wszystkie wymagane pliki są dostępne. Najprostszą metodą weryfikacji jest skorzystanie z linków dostępnych na stronie HTML wygenerowanej przez program Visual Studio. Należy sprawdzić następujące pliki:

  • plik .appinstaller znaleziony na Additional Links > App Installer File stronie wygenerowanej w programie Visual Studio
  • plik .appx, .appxbundle.misx lub msixbundle znaleziony na Additional Links > Package Bundle stronie wygenerowanej przez program Visual Studio

Uwaga / Notatka

W zależności od konfiguracji może być więcej niż jeden .appx plik, .appxbundle, .misx lub msixbundle plik zaangażowany we wdrożenie. Upewnij się, że wszystkie z nich są dostępne.

Pliki obsługiwane z nieprawidłowym typem MIME

Podczas instalowania z punktu końcowego HTTP wszystkie pliki muszą być obsługiwane przy użyciu poprawnego typu MIME w nagłówku Content-Type przez serwer internetowy.

Pliki serwowane bez nagłówka Content-Length

Podczas instalowania z punktu końcowego HTTP wszystkie odpowiedzi muszą zawierać poprawny Content-Length nagłówek. Obejmuje to zarówno GET, jak i HEAD żądania. Upewnij się, że wszystkie z nich prawidłowo określą swoje Content-Length . Nieprzestrzeganie tego może prowadzić do błędów, takich jak App installation failed with error message: Appinstaller operation failed with error code 0x80072F76. Detail: Unknown error (0x80072f76) lub inne.

Instalacja aplikacji nie powiodła się z komunikatem o błędzie: Parametr jest nieprawidłowy

Ponieważ adresy URL vanity nie są obecnie obsługiwane, w przypadku korzystania z protokołu ms-appinstaller parametr źródłowy MUSI kończyć się ciągiem .appinstaller. Nie ma znaczenia, czy nastąpi przekierowanie do pliku kończącego się ciągiem .appinstaller. To również nie powiedzie się w ten sam sposób. Jedynym sposobem naprawienia tego problemu jest upewnienie się, że oryginalny adres URL kończy się ciągiem .appinstaller.

Izolowanie problemów z aplikacją App Installer

Jeśli Instalator aplikacji nie może zainstalować aplikacji, te kroki pomogą zidentyfikować problem z instalacją.

Weryfikowanie instalacji pliku pakietu aplikacji

  • Pobierz plik pakietu aplikacji do folderu lokalnego i spróbuj go zainstalować przy użyciu polecenia Add-AppxPackage programu PowerShell.

  • .appinstaller Pobierz plik do folderu lokalnego i spróbuj go zainstalować przy użyciu Add-AppxPackage -Appinstaller polecenia programu PowerShell.

Dzienniki zdarzeń Instalatora aplikacji

Infrastruktura wdrażania aplikacji emituje dzienniki, które są często przydatne do debugowania problemów z instalacją za pośrednictwem Podglądu zdarzeń systemu Windows: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server. Dodatkowe pliki dziennika są tworzone w tym folderze: %LocalAppData%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\LocalState\DiagOutputDir