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

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

Предварительные требования

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

Windows 10:

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

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

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

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

Версия Windows

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

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

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

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

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

MSIX signed with missing or untrusted Cert

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

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

Важно!

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

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

Find the local Computer Certificates tool via the Start Menu

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

MSIX signed with a trusted Cert

Зависимости, которые не устанавливаются

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

Важно!

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

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

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

  • .appinstaller файл, доступный в виде application/xml
  • .appx и .appxbundle файлы, доступные как application/vns.ms-appx

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

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

Изоляция проблем установщика приложений

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

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

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

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

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

Инфраструктура развертывания приложений создает журналы, которые часто полезны для отладки проблем с установкой через средство просмотра событий Windows: Application and Services Logs -> Microsoft -> Windows -> AppxDeployment-Server