Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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:
- Urządzenie musi być włączone dla aplikacji trybu dewelopera lub ładowania bezpośredniego. Aby dowiedzieć się więcej, zobacz Włączanie urządzenia na potrzeby programowania .
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:
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:
- Komputer lokalny: Zaufane osoby
- 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:
Po pomyślnym zaimportowaniu certyfikatu podpisywania ponownie uruchomiony instalator aplikacji pokaże, że pakiet jest zaufany i można go zainstalować:
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 naAdditional Links > App Installer File
stronie wygenerowanej w programie Visual Studio - plik
.appx
,.appxbundle
.misx
lubmsixbundle
znaleziony naAdditional 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życiuAdd-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