Известные проблемы и советы по устранению неполадок средства упаковки MSIX

В этой статье описываются известные проблемы и приводятся советы по устранению неполадок при преобразовании приложений в MSIX с помощью средства упаковки MSIX. Ознакомьтесь с нашими другими документами, если вам нужно приобрести средство упаковки MSIX или драйвер в отключенных средах.

Известные проблемы

Получение последней предварительной версии сборки средства упаковки MSIX

Если вы приняли участие в нашей программе предварительной оценки, убедитесь, что у вас есть правильная версия средства упаковки MSIX:

• Перейдите в раздел "Сведения" в средстве упаковки MSIX, чтобы просмотреть версию, в которой вы находитесь.
• Перейдите сюда, чтобы определить последнюю версию Insider Preview, и убедитесь, что у вас установлена эта версия средства упаковки MSIX.
• Убедитесь, что та же учетная запись Microsoft (УЗМ), зарегистрированная для участия в предварительном тестировании, используется для входа в Microsoft Store.
• Вручную обновите средство упаковки MSIX с помощью Microsoft Store на компьютере. Если этот параметр доступен, откройте Магазин, перейдите в раздел "Загрузки и обновления" и нажмите кнопку "Получить обновления". Для поиска средства упаковки MSIX перейдите на страницу продукта, где вы можете запросить его обновление.
• Чтобы установить средство упаковки MSIX для автономного использования, следуйте этим инструкциям , чтобы убедиться, что вы получите последнее приложение через наш автономный процесс.

Если вы заинтересованы в участии в нашей программе инсайдеров, перейдите к присоединению к программе MSIX Packaging Tool Insiders!

Драйвер средства упаковки MSIX

Драйвер средства упаковки MSIX поставляется в виде пакета Feature on Demand (FOD) из клиентский компонент Центра обновления Windows. Оно не удастся установить, если служба клиентский компонент Центра обновления Windows отключена на компьютере или если параметры полётного круга Windows Insider не соответствуют сборке ОС компьютера.

Если у вас возникли проблемы с получением драйвера или вы работаете в автономной среде, вы можете найти ссылки на скачивание драйвера здесь.

Если вы скачали драйвер и возникли проблемы во время преобразования пакета, это может быть одна из следующих проблем.

Проблемы, связанные с подключением к сети

Следующие коды ошибок могут указывать на то, что возникают проблемы с подключением:

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

Служба обновления Windows Server (WSUS), Configuration Manager или группы политик, влияющие на подключение к клиентский компонент Центра обновления Windows

Следующий код ошибки может указывать на то, что политики на компьютере влияют на подключение клиентский компонент Центра обновления Windows: -2145124306 (0x8024002e).

Если вы получите этот код ошибки, может потребоваться проверить параметры и политики среды.

Драйверу требуется переустановка

В этом сценарии средство упаковки MSIX уведомит вас в сообщении об ошибке и журналах, что вашему драйверу требуется перезагрузка. Перезапустите компьютер и снова запустите преобразование, чтобы устранить эту проблему.

Ошибка при запуске драйвера средства упаковки MSIX 0x80131500

Если вы получите эту ошибку во время преобразования, при проверке файла журнала вы должны найти запись, например следующую:

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

Эта ошибка возникает, когда инструмент запускает новую сессию трассировки системных событий, но превышен максимальный лимит числа сессий, которые Windows может создать на уровне системы. Если превышено ограничение по умолчанию (64), вы получите ошибку ERROR_NO_SYSTEM_RESOURCES, что приводит к сбою драйвера.

Решение состоит в том, чтобы остановить некоторые из существующих сеансов трассировки событий, выполнив следующие действия.

1. Откройте меню "Пуск" и найдите Монитор производительности.
2. Щелкните его правой кнопкой мыши и выберите команду "Дополнительно" —> запуск от имени администратора.
3. В меню "Дерево" выберите наборы сборщиков данных —> сеансы трассировки событий.
4. Щелкните правой кнопкой мыши некоторые существующие сеансы в списке и нажмите кнопку "Остановить".

Теперь вы можете повторить преобразование с помощью средства упаковки MSIX.

Минимальная версия

Существует несколько функций, которые автоматически изменяют поддержку минимальной версии в вашем пакете MSIX.

Применение требований к версионированию в Майкрософт Store

Если вы преобразуете существующий установщик с помощью версии средства упаковки MSIX ниже 1.2019.701.0, средство имело включенные требования управления версиями Microsoft Store или использовало другое средство для создания пакета, которое не установило минимальную версию 10.0.16299.0 (Windows 10, версии 1709). Это приведет к возникновению сообщения об ошибке при развертывании приложения в Windows 10 версии 1709 или более поздней версии.

Чтобы устранить эту проблему, откройте средство упаковки MSIX и измените приложение с помощью редактора пакетов. Откройте манифест и установите атрибут MinVersion элемента TargetDeviceFamily на значение "10.0.16299.0".

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

MSIX с службами

В версии 1.2019.1220.0 средства упаковки MSIX мы добавили поддержку создания пакета MSIX с помощью служб. Из-за ограничений ОС на поддержку служб средство упаковки MSIX автоматически изменяет минимальную версию, поддерживаемую в пакете MSIX с услугами, до версии 10.0.19025.0 включительно. Это означает, что вы не можете установить MSIX со службами в ОС ниже Windows 10 версии 2004, но вы можете создать эту MSIX с помощью средства упаковки MSIX до Windows 10 1809. Если необходимо установить это приложение на более низкой ОС, обновите минимальную версию соответствующим образом, но обратите внимание, что поддержка служб не будет работать.

Платформы и драйверы

Если приложению требуется платформа, убедитесь, что платформа установлена на этапе мониторинга преобразования. Просмотрите журналы, чтобы убедиться, что это происходит. Если приложению требуется установить драйвер, необходимо оценить, требуется ли это для правильного выполнения приложения. В настоящее время MSIX не поддерживает установку драйверов.

Удаленный компьютер

Если возникают проблемы с использованием удаленной виртуальной машины для преобразований, см. инструкции по настройке для преобразования удаленных компьютеров.

Проблемы во время преобразования

• Некоторые установщики могут не преобразоваться с кодом выхода 259. Это означает, что установщик запустил поток и не дождался его завершения. Другими словами, основной поток закончил установку, но он завершился с ошибкой 259, так как он породил поток, который по-прежнему запущен. Рекомендуется использовать соответствующий параметр установки для setup.exe.

Проблемы при подписи

Недопустимый сертификат PE (0x800700C1)

Эта проблема возникает, когда пакет содержит двоичный файл с поврежденным сертификатом. Чтобы устранить эту проблему, используйте команду dumpbin.exe /headers, чтобы сбросить заголовки файлов и проверить наличие ошибочных элементов. Перепишите заголовки вручную, чтобы устранить проблему. Как правило, средство упаковки MSIX автоматически обнаруживает плохие заголовки. Если эта проблема сохраняется, отправьте отзыв. Дополнительные сведения см. здесь.

Подпись для Device Guard

Обязательно выполните действия и назначьте соответствующие роли в Microsoft Store для бизнеса.

Истек срок действия сертификата

• Используйте метку времени при подписи пакета.
• Вы можете уйти в отставку с действительным знаком или сертификатом метки времени.

Вы можете отказаться от приложения с помощью скрипта пакетного преобразования в MSIX Toolkit — Scripts.

Устранение неполадок

Файлы журналов

Независимо от того, успешно ли выполнено преобразование, файлы журналов создаются для каждого преобразования. Их можно найти здесь:

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

Коды сбоев записываются и указывают любую точку сбоя во время процесса преобразования. Коды ошибок должны быть понятными для пользователей.

Файлы журнала с удаленных устройств или виртуальных машин

Если преобразование выполняется на удаленном устройстве или виртуальной машине, рекомендуется скопировать файлы журналов с этого устройства и присоединить их как часть элемента обратной связи. Это поможет нам более эффективно диагностировать и устранять проблемы.

Здесь вы найдете логи удалённых конверсий: %localappdata%\packages\Майкрософт.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

Это еще более полезно, если вы можете предоставить общий доступ ко всей папке журналов, которая будет включать операции, выполняемые на локальном клиенте, а также удаленный сервер.

Распространенные проблемы

Ошибки перевода makePri/Manifest

Эта ошибка возникает при возникновении проблемы с манифестом пакета. Чтобы определить проблему, перейдите в редактор пакетов и откройте манифест. При открытии манифеста можно определить проблему и указать правильное исправление.

Файл не найден

Файл может быть открыт или не существует. Чтобы устранить эту проблему, добавьте соответствующий файл или закройте используемый в данный момент файл. Обратите внимание, что ошибка File not Found не появится, если она открыта. Вместо этого вы получите ошибку Access Denied или File in Use.

Сопоставления типов файлов

Проблемы, связанные с сопоставлениями типов файлов (FTA), зависят от пакета к пакету. Средство упаковки MSIX поддерживает сопоставления файлов для установки с помощью двойного щелчка. Например, если в приложении есть контекстное меню, оно не добавляется автоматически, поэтому его необходимо добавить вручную в манифест. Пример см. в элементе манифеста desktop4:FileExplorerContextMenus .

Сочетания клавиш с аргументами

Средство упаковки MSIX будет записывать все сочетания клавиш на уровне пользователя вместе с аргументами. Если эти сочетания клавиш не обнаружены должным образом, его можно добавить вручную в манифест. См. desktop7:Ярлык для получения дополнительных сведений.

Установка каталога

Это чаще всего для тех, кто использует дополнительный диск для преобразования приложений. Если вы решите изменить место установки, это изменит основной путь, куда попадают все файлы. Это означает, что средство упаковки MSIX должно знать, куда помещаются все эти файлы и будут фиксироваться во время преобразования.

Это можно исправить с помощью платформы поддержки пакетов для установки исправления каталога. Мы добавили это как возможность по умолчанию в средстве MSIX, что позволяет сократить до 1809. Если приложение не работает в 1709 году и находится в 1809 году, это, вероятно, проблема.

Отправка отзывов

Лучший способ отправки отзывов — через Центр отзывов.

1. Откройте Feedback Hub или введите Windows + F.
2. Укажите заголовок и необходимые шаги для воспроизведения проблемы.
3. В разделе "Категория" выберите "Приложения" и выберите средство упаковки MSIX.
4. Вложите все файлы журнала , связанные с преобразованием. Журналы можно найти в папке, указанной выше.
5. Подключите преобразованный пакет MSIX (если это возможно).
6. Нажмите кнопку "Отправить".

Вы также можете отправить нам отзыв непосредственно из средства упаковки MSIX, перейдя на вкладку "Отзывы" в разделе "Параметры".