Znane problemy i porady dotyczące rozwiązywania problemów z narzędziem MSIX Packaging Tool

W tym artykule opisano znane problemy i przedstawiono wskazówki dotyczące rozwiązywania problemów, które należy wziąć pod uwagę podczas konwertowania aplikacji na plik MSIX przy użyciu narzędzia do tworzenia pakietów MSIX. Zapoznaj się z naszymi innymi dokumentami, jeśli musisz uzyskać narzędzie MSIX Packaging Tool lub sterownik w środowiskach bez połączenia.

Znane problemy

Pobieranie najnowszej kompilacji Insider Preview narzędzia MSIX Packaging Tool

Jeśli przystąpiłeś do naszego Programu Insiderów, upewnij się, że masz poprawną wersję narzędzia do tworzenia pakietów MSIX:

• Przejdź do sekcji Informacje w narzędziu MSIX Packaging Tool, aby sprawdzić, której wersji używasz.
• Przejdź tutaj , aby określić najnowszą wersję programu Insider Preview i upewnij się, że zainstalowano tę wersję narzędzia MSIX Packaging Tool.
• Upewnij się, że konto MSA, które zostało zarejestrowane w celu lotu, to konto, które jest zalogowane w sklepie Microsoft Store.
• Ręcznie zaktualizuj narzędzie do tworzenia pakietów MSIX za pośrednictwem sklepu Microsoft Store na komputerze. Jeśli ta opcja jest dostępna, otwórz sklep, przejdź do pozycji Pliki do pobrania i aktualizacje, a następnie kliknij pozycję Pobierz aktualizacje. Alternatywnie wyszukaj narzędzie MSIX Packaging Tool, a następnie na stronie produktu możesz wywołać aktualizację.
• Aby zainstalować narzędzie do tworzenia pakietów MSIX do użycia w trybie offline, postępuj zgodnie z tymi instrukcjami , aby upewnić się, że najnowsza aplikacja jest uzyskiwana za pośrednictwem naszego procesu offline.

Jeśli interesuje Cię dołączenie do programu insider, przejdź do strony Dołącz do niejawnych testerów narzędzi do tworzenia pakietów MSIX!.

Sterownik narzędzia do tworzenia pakietów MSIX

Sterownik narzędzia do tworzenia pakietów MSIX jest dostarczany jako pakiet funkcji na żądanie (FOD) z usługi Windows Update. Instalacja nie powiedzie się, jeśli usługa Windows Update jest wyłączona na komputerze lub jeśli ustawienia pierścienia Windows Insider nie są zgodne z kompilacją systemu operacyjnego komputera.

Jeśli masz problemy z uzyskaniem sterownika lub pracujesz w środowisku offline, możesz znaleźć linki do pobrania sterownika tutaj.

Jeśli sterownik został pobrany i występują problemy podczas konwersji pakietu, może to być jeden z następujących problemów.

Problemy z łącznością sieciową

Następujące kody błędów mogą wskazywać, że występują problemy z połączeniem:

• -2145107924 (0x8024402c)
• -2145107945 (0x80244017)
• -2145123272 (0x80240438)

Usługa Windows Server Update Service (WSUS), program Configuration Manager lub zasady grupy wpływające na łączność z usługą Windows Update

Poniższy kod błędu może wskazywać, że zasady na komputerze mają wpływ na łączność z usługą Windows Update: -2145124306 (0x8024002e).

Jeśli zostanie wyświetlony ten kod błędu, może być konieczne sprawdzenie ustawień i zasad środowiska.

Sterownik wymaga ponownej instalacji

W tym scenariuszu narzędzie MSIX Packaging Tool powiadomi Cię w komunikacie o błędzie i rejestruje, że sterownik wymaga ponownego uruchomienia. Uruchom ponownie komputer i ponownie uruchom konwersję, aby rozwiązać ten problem.

Błąd podczas uruchamiania sterownika narzędzia do pakowania MSIX 0x80131500

Jeśli podczas konwersji wystąpi ten błąd, podczas sprawdzania pliku dziennika powinien zostać wyświetlony wpis podobny do następującego:

[Error] Error monitoring: Insufficient system resources exist to complete the requested service

Ten błąd występuje, gdy narzędzie uruchamia nową sesję śledzenia zdarzeń systemu, ale przekroczono maksymalną liczbę sesji, które system Windows może utworzyć dla całego systemu. Jeśli przekroczysz limit domyślny (64), wystąpi błąd ERROR_NO_SYSTEM_RESOURCES, co powoduje niepowodzenie sterownika.

Rozwiązaniem jest zatrzymanie niektórych istniejących sesji śledzenia zdarzeń, wykonując następujące kroki:

1. Otwórz menu Start i poszukaj monitora wydajności.
2. Kliknij go prawym przyciskiem myszy i wybierz pozycję Więcej —> Uruchom jako administrator.
3. Z menu drzewa wybierz pozycję Zestawy zbiorów danych —> Sesje śledzenia zdarzeń.
4. Kliknij prawym przyciskiem myszy niektóre z istniejących sesji na liście i wybierz polecenie Zatrzymaj.

Teraz możesz spróbować ponownie wykonać konwersję za pomocą narzędzia MSIX Packaging Tool.

Minimalna wersja

Istnieje kilka funkcji, o których należy pamiętać, ponieważ automatycznie zmieniają obsługę minimalnej wersji w pakiecie MSIX.

Wymuszanie wymagań dotyczących przechowywania wersji w sklepie Microsoft

Jeśli przekonwertujesz istniejący instalator, używając wersji narzędzia MSIX Packaging Tool wcześniejszej niż 1.2019.701.0, przy włączonej opcji wymuszania wymagań wersjonowania Microsoft Store, lub jeśli użyto innego narzędzia do utworzenia pakietu, które nie ustawiło minimalnej wersji na 10.0.16299.0 (Windows 10, wersja 1709). Spowoduje to wyświetlenie komunikatu o błędzie podczas wdrażania aplikacji w systemie Windows 10 w wersji 1709 lub nowszej.

Aby rozwiązać ten problem, otwórz narzędzie do tworzenia pakietów MSIX i edytuj aplikację za pomocą Edytora pakietów. Otwórz manifest i ustaw MinVersion atrybut TargetDeviceFamily elementu na "10.0.16299.0".

<Dependencies>
    <TargetDeviceFamily> Name="Windows.Desktop" MinVersion="10.0.16299.0" MaxVersionTested = "10.0.17763.0" />
</Dependencies>

MSIX z usługami

W wersji 1.2019.1220.0 narzędzia MSIX Packaging Tool dodaliśmy obsługę tworzenia pakietu MSIX z usługami. Ze względu na ograniczenia systemu operacyjnego z obsługą usług narzędzie MSIX Packaging Tool automatycznie zmienia minimalną wersję obsługiwaną w pakiecie MSIX z usługami na 10.0.19025.0. Oznacza to, że nie można zainstalować pliku MSIX z usługami w systemie operacyjnym niższym niż Windows 10 w wersji 2004, ale można utworzyć ten plik MSIX przy użyciu narzędzia MSIX Packaging Tool w dół do systemu Windows 10 1809. Jeśli musisz zainstalować tę aplikację w niższym systemie operacyjnym, zaktualizuj minimalną wersję odpowiednio, ale pamiętaj, że obsługa usług nie będzie działać.

Struktury i sterowniki

Jeśli aplikacja wymaga struktury, upewnij się, że platforma jest zainstalowana w fazie monitorowania konwersji. Przejrzyj dzienniki, aby upewnić się, że tak się dzieje. Jeśli aplikacja wymaga zainstalowania sterownika, należy ocenić, czy jest to wymagane do prawidłowego działania aplikacji. MSIX obecnie nie obsługuje instalacji sterowników.

Maszyna zdalna

Jeśli występują problemy z używaniem zdalnej maszyny wirtualnej do konwersji, zobacz Instrukcje dotyczące instalacji konwersji maszyn zdalnych.

Problemy podczas konwersji

• Niektóre instalatory mogą nie zostać przekonwertowane z kodem zakończenia 259. Oznacza to, że instalator uruchomił wątek i nie czekał na jego ukończenie. Innymi słowy, główny wątek zakończył instalację, ale wystąpił błąd 259, ponieważ utworzył wątek, który nadal działa. Zalecamy użycie odpowiedniej opcji instalacji dla setup.exe.

Problemy podczas podpisywania

Nieprawidłowy certyfikat PE (0x800700C1)

Ten problem występuje, gdy pakiet zawiera plik binarny, który ma uszkodzony certyfikat. Aby rozwiązać ten problem, użyj dumpbin.exe /headers polecenia , aby zrzucić nagłówki plików i sprawdzić pod kątem nieprawidłowych elementów. Ręcznie przepisz nagłówki, aby rozwiązać problem. Ogólnie rzecz biorąc, narzędzie do tworzenia pakietów MSIX automatycznie wykrywa nieprawidłowe nagłówki. Jeśli ten problem będzie się powtarzać, prześlij opinię. Więcej informacji można znaleźć tutaj.

Podpisywanie Device Guard

Upewnij się, że wykonujesz te kroki i że przypisujesz odpowiednie role w Sklepie Microsoft dla Firm.

Wygasły certyfikat

• Użyj znacznika czasu podczas podpisywania pakietu.
• Możesz złożyć rezygnację z użyciem prawidłowego certyfikatu podpisu lub sygnatury czasowej.

Możesz zrezygnować z aplikacji przy użyciu skryptu konwersji wsadowej w zestawie narzędzi MSIX Toolkit — Scripts.

Rozwiązywanie problemów

Pliki dziennika

Niezależnie od tego, czy konwersja zakończyła się pomyślnie, pliki dziennika są generowane dla każdej konwersji. Można je znaleźć tutaj:

%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\

Kody błędów są zapisywane i wskazują dowolny punkt awarii podczas procesu konwersji. Kody błędów mają być przyjazne dla użytkownika.

Pliki dziennika z urządzeń zdalnych lub maszyn wirtualnych

Jeśli konwersja jest wykonywana na urządzeniu zdalnym lub maszynie wirtualnej, zalecamy skopiowanie plików dziennika z tego urządzenia i dołączenie ich w ramach elementu opinii. Pomoże nam to w bardziej wydajnym diagnozowaniu i rozwiązywaniu problemów.

Dzienniki z konwersji zdalnych znajdziesz tutaj: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Byłoby jeszcze bardziej korzystne, jeśli można udostępnić cały folder Logs, który będzie zawierać operacje występujące na kliencie lokalnym, a także na serwerze zdalnym.

Typowe problemy

Błędy tłumaczenia makePri/Manifest

Ten błąd występuje, gdy występuje problem z manifestem pakietu. Aby zidentyfikować problem, przejdź do edytora pakietów i otwórz manifest. Po otwarciu manifestu możesz zidentyfikować problem i podać właściwą poprawkę.

Nie znaleziono pliku

Plik może być otwarty lub nie istnieje. Aby rozwiązać ten problem, dodaj odpowiedni plik lub zamknij plik, który jest obecnie używany. Pamiętaj, że nie zostanie wyświetlony File not Found błąd, jeśli jest otwarty. Zamiast tego wyświetli się błąd Access Denied lub File in Use.

Powiązania typów plików

Problemy dotyczące skojarzeń typów plików (FTA) różnią się w zależności od pakietu. Narzędzie MSIX Packaging Tool obsługuje skojarzenia plików umożliwiające instalację poprzez dwukrotne kliknięcie. Jeśli na przykład aplikacja ma menu kontekstowe, nie jest automatycznie dodawana, dlatego musisz dodać ją ręcznie do manifestu. Zobacz przykładowy element manifestu desktop4:FileExplorerContextMenus .

Skróty z parametrami

Narzędzie MSIX Packaging przechwytuje wszystkie skróty na poziomie użytkownika wraz z argumentami. Jeśli te skróty nie są prawidłowo wykrywane, możesz dodać je ręcznie do manifestu. Zobacz desktop7:Skrót , aby uzyskać więcej szczegółów.

Instalowanie katalogu

Jest to bardziej typowe dla tych, którzy używają dysku pomocniczego do przeprowadzania konwersji aplikacji. Jeśli zdecydujesz się zmienić lokalizację instalacji, zmienia ścieżkę główną, gdzie są umieszczane wszystkie pliki. Oznacza to, że narzędzie do tworzenia pakietów MSIX musi wiedzieć, gdzie przechodzą wszystkie te pliki i zostaną przechwycone podczas konwersji.

Aby rozwiązać ten problem, możesz użyć poprawki zapisu do katalogu instalacyjnego w ramach Package Support Framework. Dodaliśmy to jako funkcję domyślnie w narzędziu MSIX, co pozwala na to do 1809 roku. Jeśli aplikacja nie działa w wersji 1709 i znajduje się w wersji 1809, prawdopodobnie jest to problem.

Wysyłanie opinii

Najlepszym sposobem wysyłania opinii jest centrum opinii.

1. Otwórz centrum opinii lub wpisz Windows + F.
2. Podaj tytuł i kroki niezbędne do odtworzenia problemu.
3. W obszarze Kategoria wybierz pozycję Aplikacje i wybierz pozycję Narzędzie do tworzenia pakietów MSIX.
4. Dołącz wszystkie pliki dziennika skojarzone z konwersją. Dzienniki można znaleźć w folderze podanym powyżej.
5. Dołącz przekonwertowany pakiet MSIX (jeśli to możliwe).
6. Kliknij przycisk Prześlij.

Możesz również wysłać nam opinię bezpośrednio z narzędzia do tworzenia pakietów MSIX, przechodząc do karty Opinie w obszarze Ustawienia.