Установка приложений с помощью средства WinAppDeployCmd.exe
Windows Application Deployment (WinAppDeployCmd.exe) — это программа командной строки, которая используется для развертывания приложения универсальной платформы Windows (UWP) с компьютера с Windows 10 на любом устройстве Windows 10. Этот инструмент можно использовать для развертывания пакета приложения, если устройство Windows 10 подключено через USB или доступно в той же подсети. При этом Microsoft Visual Studio или отдельное решение для этого приложения не требуется. Кроме того, вы можете развернуть приложение без упаковки на удаленный компьютер или Xbox One. В этой статье описывается установка приложений UWP с помощью этого средства.
Чтобы запустить инструмент WinAppDeployCmd из командной строки или файла сценария, нужен лишь установленный пакет SDK для Windows 10. При установке приложения с помощью WinAppDeployCmd.exe для загрузки неопубликованного приложения на устройство Windows 10 используется файл .appx или .msix (для свободных файлов). Эта команда не устанавливает сертификат, необходимый для приложения. Для запуска приложения устройство Windows 10 должно находиться в режиме разработчика или на нем уже должен быть установлен сертификат.
Чтобы развернуть на мобильных устройствах, сначала необходимо создать пакет. Для получения дополнительных сведений см. здесь.
Средство WinAppDeployCmd.exe находится на компьютере под управлением Windows 10 здесь: C:\Program Files (x86)\Windows Kits\10\bin\<SDK Version>\x86\WinAppDeployCmd.exe (зависит от пути установки SDK).
Примечание.
Пакет SDK версии 15063 и более поздних версий устанавливается рядом с папками для соответствующей версии. Предыдущие пакеты SDK (включая 14393 и более ранние) записываются непосредственно в родительскую папку.
Сначала подключите устройство Windows 10 к той же подсети или непосредственно к компьютеру с Windows 10 через USB. Затем используйте следующий синтаксис и примеры этой команды далее в этой статье для развертывания приложения UWP:
Синтаксис и параметры WinAppDeployCmd
Вот общий синтаксис, используемый для WinAppDeployCmd.exe:
WinAppDeployCmd command -option <argument>
Ниже приведено несколько дополнительных примеров синтаксиса для использования различных команд.
WinAppDeployCmd devices
WinAppDeployCmd devices <x>
WinAppDeployCmd install -file <path> -ip <address>
WinAppDeployCmd install -file <path> -guid <address> -pin <p>
WinAppDeployCmd install -file <path> -ip <address> -dependency <a> <b>
WinAppDeployCmd install -file <path> -guid <address> -dependency <a> <b>
WinAppDeployCmd uninstall -file <path>
WinAppDeployCmd uninstall -package <name>
WinAppDeployCmd update -file <path>
WinAppDeployCmd list -ip <address>
WinAppDeployCmd list -guid <address>
WinAppDeployCmd deployfiles -file <path> -remotedeploydir <remoterelativepath> -ip <address>
WinAppDeployCmd registerfiles -remotedeploydir <remoterelativepath> -ip <address>
WinAppDeployCmd addcreds -credserver <server> -credusername <username> -credpassword <password> -ip <address>
WinAppDeployCmd getcreds -credserver <server> -ip <address>
WinAppDeployCmd deletecreds -credserver <server> -ip <address>
Вы можете установить или удалить приложение на целевом устройстве или обновить уже установленное приложение. Чтобы сохранить данные или параметры, сохраненные приложением, которое уже установлено, используйте параметры обновления вместо параметров установки .
В следующей таблице описаны команды для WinAppDeployCmd.exe.
| Command | Description |
|---|---|
| IoT-устройства | Отображение списка доступных сетевых устройств. |
| Установить | Установите пакет приложения UWP на целевое устройство. |
| обновить | Обновите приложение UWP, которое уже установлено на целевом устройстве. |
| список | Отображение списка приложений UWP, установленных на указанном целевом устройстве. |
| Удалить | Удалите указанный пакет приложения с целевого устройства. |
| deployfiles | Скопируйте свободное приложение файла в целевой путь к удаленному относительному пути на устройстве. |
| registerfiles | Зарегистрируйте свободное приложение для файлов в удаленном каталоге развертывания. |
| addcreds | Добавьте учетные данные в Xbox, чтобы разрешить ему доступ к сетевому расположению для регистрации приложения. |
| getcreds | Получение сетевых учетных данных для целевого объекта, который используется при запуске приложения из сетевой папки. |
| deletecreds | Удалите учетные данные сети, которые целевой объект использует при запуске приложения из сетевого ресурса. |
В следующей таблице описаны параметры WinAppDeployCmd.exe.
| Command | Description |
|---|---|
| -h (-help) | Отображение команд, параметров и аргументов. |
| -ip | IP-адрес целевого устройства. |
| -g (-guid) | Уникальный идентификатор целевого устройства. |
| -d (-dependency) | (Необязательно) Указывает путь зависимостей для каждого из зависимостей пакета. Если путь не указан, средство выполняет поиск зависимостей в корневом каталоге для пакета приложения и каталогов ПАКЕТА SDK. |
| -f (-file) | Путь к файлу пакета приложения для установки, обновления или удаления. |
| -p (-package) | Полное имя пакета для удаления пакета приложения. (Можно использовать команду list, чтобы найти полные имена пакетов, уже установленных на устройстве). |
| -булавка | Пин-код, если требуется установить соединение с целевым устройством. (Вам будет предложено повторить попытку с параметром -pin, если требуется аутентификация.) |
| -credserver | Имя сервера сетевых учетных данных для использования целевым объектом. |
| -credusername | Имя пользователя сетевых учетных данных для использования целевым объектом. |
| -credpassword | Пароль сетевых учетных данных для использования целевым объектом. |
| -connecttimeout | Время ожидания в секундах, используемое при подключении к устройству. |
| -remotedeploydir | Относительный путь и имя каталога для копирования файлов на удаленном устройстве. Это должна быть хорошо известная, автоматически определяемая папка для удаленного развертывания. |
| -deleteextrafile | Переключитесь, чтобы указать, следует ли очистить существующие файлы в удаленном каталоге, чтобы он соответствовал исходному каталогу. |
В следующей таблице описаны параметры WinAppDeployCmd.exe.
| Argument | Description |
|---|---|
| <x> | Время ожидания в секундах. (Значение по умолчанию — 10) |
| <address> | IP-адрес или уникальный идентификатор целевого устройства. |
| <a><b>… | Путь зависимостей для каждого из зависимостей пакета приложения. |
| <p> | Буквенно-цифровой пин-код, показанный в параметрах устройства для установления подключения. |
| <path> | Путь к файловой системе. |
| <name> | Полное имя пакета для удаления пакета приложения. |
| <server> | Сервер в файловой сети. |
| <username> | Пользователь для учетных данных с доступом к серверу в файловой сети. |
| <пароль> | Пароль для учетных данных с доступом к серверу в сети файлов. |
| <remotedeploydir> | Каталог на устройстве относительно расположения развертывания |
примеры WinAppDeployCmd.exe
Здесь приведено несколько примеров развертывания с помощью командной строки с использованием синтаксиса для WinAppDeployCmd.exe.
Показывает устройства, доступные для развертывания. Время ожидания команды в течение 3 секунд.
WinAppDeployCmd devices 3
Устанавливает приложение из пакета MyApp.appx, который находится в папке компьютера "Загрузки", на устройство Windows 10 с IP-адресом 192.168.0.1 и PIN-кодом A1B2C3 для установки соединения с устройством.
WinAppDeployCmd install -file "Downloads\MyApp.appx" -ip 192.168.0.1 -pin A1B2C3
Удаляет указанный пакет (в зависимости от его полного имени) из устройства Windows с IP-адресом 192.168.0.1. Команду списка можно использовать для просмотра полных имен всех пакетов, установленных на устройстве.
WinAppDeployCmd uninstall -package Company.MyApp_1.0.0.1_x64__qwertyuiop -ip 192.168.0.1
Обновляет приложение, которое уже установлено на устройстве Windows 10 с IP-адресом 192.168.0.1, с использованием указанного пакета приложения.
WinAppDeployCmd update -file "Downloads\MyApp.appx" -ip 192.168.0.1
Развертывает файлы приложения на компьютере или Xbox с IP-адресом 192.168.0.1 в той же папке, что и AppxManifest, в каталог app1_F5 в пути развертывания устройства.
WinAppDeployCmd deployfiles -file "C:\apps\App1\AppxManifest.xml" -remotedeploydir app1_F5 -ip 192.168.0.1
Регистрирует приложение в каталоге app1_F5 в пути развертывания компьютера или Xbox в версии 192.168.0.1.
WinAppDeployCmd registerfiles -remotedeploydir app1_F5 -ip 192.168.0.1
Использование WinAppDeployCmd для настройки запуска из развертывания пк на Xbox One
Запуск с компьютера позволяет развернуть приложение UWP в Xbox One без копирования двоичных файлов, а двоичные файлы размещаются в сетевой папке в той же сети, что и Xbox. Для этого необходимо разблокировать Xbox One разработчика и свободное приложение UWP на сетевом диске, к которому может получить доступ Xbox.
Выполните следующую команду, чтобы зарегистрировать приложение:
WinAppDeployCmd registerfiles -ip <Xbox One IP> -remotedeploydir <location of app> -username <user for network> -password <password for user>
ex. WinAppDeployCmd register files -ip 192.168.0.1 -remotedeploydir \\driveA\myAppLocation -username admin -password A1B2C3