Устранение неполадок с установкой файла установщика приложений

2025-04-30

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

Предпосылки

Чтобы иметь возможность устанавливать приложения вне магазина в Windows 10, устройство пользователя должно удовлетворять следующим требованиям:

Windows 10:

Сертификат, используемый для подписи пакета, должен быть доверенным для устройства. Дополнительные сведения см. в разделе " Доверенные сертификаты " ниже.
Версия Windows 10 должна поддерживать .appinstaller схему файлов и протокол распространения.

Windows 10 1909 и более ранних версий:

Устройство должно быть настроено на использование режима разработчика или установку приложений из внешних источников. Подробнее см. в статье «Включение устройства для разработки».

Общие проблемы

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

Версия Windows

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

Версия	Заметки о загрузке неопубликованных данных
Сборка 17134 (обновление за апрель 2018 г., версия 1803)	Доступ `.appinstaller` к файлу можно получить по папкам UNC/Share. Также доступны настраиваемые проверки обновлений.
Выпуск 16299 (Осеннее обновление для создателей, версия 1709)	Представлен файл `.appinstaller` для обеспечения автоматических обновлений вашему приложению. Эта версия поддерживает только конечные точки HTTP. Проверки обновлений не настраиваются и выполняются каждые 24 часа.
Сборка 15063 (Обновление для создателей, версия 1703)	Приложение Установщик приложений может загрузить зависимости приложений из Microsoft Store (только в режиме релиза).
Сборка 14393 (юбилейное обновление, версия 1607)	Представлено приложение App Installer для установки файлов .appx и .appxbundle, файлы .appinstaller не поддерживаются.
Сборка 10586 (ноябрьское обновление, версия 1511)	Загрузка пакета вне магазина доступна только через PowerShell, с использованием команды Add-AppxPackage.
Сборка 10240 — Windows 10, версии 1507	Сторонняя загрузка доступна только через PowerShell с командой Add-AppxPackage.

Доверенные сертификаты

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

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

MSIX, подписанный с недостающим или ненадежным сертификатом

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

Локальный компьютер: доверенные люди
Локальный компьютер: доверенные корневые центры (не рекомендуется)

Это важно

Не импортируйте сертификаты подписывания пакета в хранилище сертификатов пользователя. Установщик приложений не выполняет поиск сертификатов пользователей при проверке удостоверения пакета.

Средство управления сертификатами компьютера можно легко найти, выполнив поиск в меню "Пуск".

Найдите средство сертификатов локального компьютера через меню

После успешного импорта сертификата подписи повторное выполнение установщика приложения покажет, что пакет является доверенным и может быть установлен:

MSIX, подписанный доверенным сертификатом

Зависимости не установлены

Приложения Windows 10 могут иметь зависимости от платформы приложения в зависимости от используемой платформы для создания приложения. Если вы используете C# или VB, приложению потребуется пакет среды выполнения .NET и платформы .NET. Для приложений C++ требуются VCLibs.

Это важно

Если пакет приложения построен в конфигурации режима выпуска, зависимости платформы будут получены из Microsoft Store. Однако, если приложение построено в режиме отладки, зависимости будут получены из расположения, указанного в файле .appinstaller.

Файлы недоступны

При установке из конечной точки HTTP важно убедиться, что все необходимые файлы доступны. Самый простой метод проверки заключается в том, чтобы выполнить ссылки, предоставленные на HTML-странице, созданной Visual Studio. Эти файлы необходимо проверить:

файл, найденный .appinstaller на Additional Links > App Installer File созданной странице Visual Studio
файл .appx, .appxbundle, .misx или msixbundle, найденный на Additional Links > Package Bundle созданной странице Visual Studio

Замечание

В зависимости от конфигурации может быть несколько файлов .appx, .appxbundle, .misx или msixbundle, участвующих в развертывании. Убедитесь, что все они доступны.

Файлы, обслуживаемых неправильным типом MIME

При установке из конечной точки HTTP все файлы должны передаваться с правильным типом MIME в заголовке Content-Type веб-сервера.

Файлы, передаваемые без заголовка Content-Length

При установке из конечной точки HTTP все ответы должны включать правильный Content-Length заголовок. Это включает в себя GET , HEAD а также запросы. Убедитесь в том, что все они правильно уточняют свой Content-Length. Несоблюдение этого может привести к ошибкам, таким как App installation failed with error message: Appinstaller operation failed with error code 0x80072F76. Detail: Unknown error (0x80072f76) или другим.

Сбой установки приложения с сообщением об ошибке: неправильный параметр

Поскольку в данный момент кастомные URL-ы не поддерживаются при использовании протокола ms-appinstaller, исходный параметр ДОЛЖЕН заканчиваться на .appinstaller. Это не имеет значения, если вы перенаправляете в файл, заканчивающийся .appinstaller. Это также провалится таким же образом. Единственный способ исправить это — убедиться, что исходный URL-адрес заканчивается .appinstaller.

Устранение проблем с приложением App Installer

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

Проверка установки файла пакета приложения

Скачайте файл пакета приложения в локальную папку и попробуйте установить его с помощью команды Add-AppxPackage PowerShell.
.appinstaller Скачайте файл в локальную папку и попытайтесь установить его с помощью Add-AppxPackage -Appinstaller команды PowerShell.

Журналы событий установщика приложений

Инфраструктура развертывания приложений выдает журналы, которые часто полезны для отладки проблем с установкой с помощью средства просмотра событий Windows: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server В этой папке создаются дополнительные файлы журнала: %LocalAppData%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\LocalState\DiagOutputDir