Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A Implantação de Aplicativos do Windows (WinAppDeployCmd.exe) é uma ferramenta de linha de comando que pode ser usada para implantar um aplicativo da Plataforma Universal do Windows (UWP) de um computador Windows 10 em qualquer dispositivo Windows 10. Você pode usar essa ferramenta para implantar um pacote de aplicativos quando o dispositivo Windows 10 estiver conectado por USB ou disponível na mesma sub-rede sem precisar do Microsoft Visual Studio ou da solução para esse aplicativo. Você também pode implantar o aplicativo em um computador remoto ou Xbox One sem empacotá-lo primeiro. Este artigo descreve como instalar aplicativos UWP usando essa ferramenta.
Você só precisa do SDK do Windows 10 instalado para executar a ferramenta WinAppDeployCmd de um prompt de comando ou de um arquivo de script. Quando você instala um aplicativo com WinAppDeployCmd.exe, ele usa o arquivo .appx/.msix ou AppxManifest(para arquivos soltos) para carregar seu aplicativo em um dispositivo Windows 10. Esse comando não instala o certificado necessário para seu aplicativo. Para executar o aplicativo, o dispositivo Windows 10 deve estar no modo de desenvolvedor ou já ter o certificado instalado.
Para implantar em dispositivos móveis, primeiro você deve criar um pacote. Para obter mais informações, consulte aqui.
A ferramenta WinAppDeployCmd.exe está localizada aqui no computador Windows 10: C:\Arquivos de Programas (x86)\Kits do Windows\10\bin\<versão do SDK>\x86\WinAppDeployCmd.exe (com base no caminho de instalação do SDK).
Observação
Na versão 15063 e posterior do SDK, o SDK é instalado lado a lado em pastas específicas da versão. Os SDKs anteriores (antes e incluindo 14393) são gravados diretamente na pasta pai.
Primeiro, conecte seu dispositivo Windows 10 à mesma sub-rede ou conecte-o diretamente ao computador Windows 10 com uma conexão USB. Em seguida, use a seguinte sintaxe e exemplos deste comando mais adiante neste artigo para implantar seu aplicativo UWP:
Sintaxe e opções do WinAppDeployCmd
Esta é a sintaxe geral usada para WinAppDeployCmd.exe:
WinAppDeployCmd command -option <argument>
Aqui estão alguns exemplos de sintaxe adicionais para usar vários comandos:
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>
Você pode instalar ou desinstalar um aplicativo no dispositivo de destino ou atualizar um aplicativo já instalado. Para manter dados ou configurações salvos por um aplicativo já instalado, use as opções de atualização em vez das opções de instalação .
A tabela a seguir descreve os comandos para WinAppDeployCmd.exe.
| Comando | Descrição |
|---|---|
| Dispositivos | Mostrar a lista de dispositivos de rede disponíveis. |
| instalar | Instale um pacote de aplicativo UWP no dispositivo de destino. |
| atualização | Atualize um aplicativo UWP que já está instalado no dispositivo de destino. |
| lista | Mostrar a lista de aplicativos UWP instalados no dispositivo de destino especificado. |
| desinstalar | Desinstale o pacote de aplicativo especificado do dispositivo de destino. |
| arquivos de implantação | Copie o aplicativo de arquivo solto no caminho de destino para o caminho relativo remoto no dispositivo. |
| arquivos de registro | Registre o aplicativo de arquivo solto no diretório de implantação remota. |
| addcreds | Adicione credenciais a um Xbox para permitir que ele acesse um local de rede para registro de aplicativo. |
| getcreds | Obtenha credenciais de rede para os usos pretendidos ao executar um aplicativo a partir de um compartilhamento de rede. |
| deletecreds | Exclua as credenciais de rede que o destino utiliza ao executar um aplicativo a partir de um compartilhamento de rede. |
A tabela a seguir descreve as opções para WinAppDeployCmd.exe.
| Comando | Descrição |
|---|---|
| -h (-help) | Mostrar os comandos, as opções e os argumentos. |
| -IP | Endereço IP do dispositivo de destino. |
| -g (-guid) | Identificador exclusivo do dispositivo de destino. |
| -d (-dependency) | (Opcional) Especifica o caminho de dependência para cada uma das dependências do pacote. Se nenhum caminho for especificado, a ferramenta procurará dependências no diretório raiz para o pacote do aplicativo e os diretórios do SDK. |
| -f (-file) | Caminho do arquivo para instalar, atualizar ou desinstalar o pacote do aplicativo. |
| -p (-package) | O nome completo do pacote do aplicativo a ser desinstalado. (Você pode usar o comando de lista para localizar os nomes completos dos pacotes já instalados no dispositivo) |
| -alfinete | Um pino se for necessário estabelecer uma conexão com o dispositivo de destino. (Você será solicitado a tentar novamente com a opção -pin se a autenticação for necessária) |
| -credserver | O nome do servidor das credenciais de rede para uso pelo destino. |
| -credusername | O nome de usuário das credenciais de rede para uso pelo destino. |
| -credpassword | A senha das credenciais de rede para uso pelo destinatário. |
| -connecttimeout | O tempo limite em segundos usado ao se conectar ao dispositivo. |
| -remotedeploydir | Caminho/nome do diretório relativo para onde copiar arquivos no dispositivo remoto; essa será uma pasta de implantação remota, bem conhecida e determinada automaticamente. |
| -deleteextrafile | Alterne para indicar se os arquivos existentes no diretório remoto devem ser limpos para corresponder ao diretório de origem. |
A tabela a seguir descreve as opções para WinAppDeployCmd.exe.
| Argumento | Descrição |
|---|---|
| <x> | Tempo limite em segundos. (O padrão é 10) |
| <endereço> | Endereço IP ou identificador exclusivo do dispositivo de destino. |
| <a><b>... | Caminho de dependência para cada uma das dependências do pacote do aplicativo. |
| <p> | Um pin alfanumérico mostrado nas configurações do dispositivo para estabelecer uma conexão. |
| <caminho> | Caminho do sistema de arquivos. |
| <nome> | Nome completo do pacote do aplicativo a ser desinstalado. |
| <servidor> | Servidor na rede de arquivos. |
| <nome de usuário> | Usuário associado às credenciais com acesso ao servidor na rede de arquivos. |
| <senha> | Senha para as credenciais com acesso ao servidor na rede de arquivos. |
| < > remotedeploydir | Diretório no dispositivo relativo ao local da implantação |
WinAppDeployCmd.exe exemplos
Aqui estão alguns exemplos de como fazer o deploy pela linha de comando usando a sintaxe para WinAppDeployCmd.exe.
Mostra os dispositivos disponíveis para implantação. O comando expira em 3 segundos.
WinAppDeployCmd devices 3
Instala o aplicativo do pacote MyApp.appx localizado no diretório Downloads do computador em um dispositivo Windows 10 com o endereço IP 192.168.0.1 e PIN A1B2C3 para estabelecer uma conexão com o dispositivo.
WinAppDeployCmd install -file "Downloads\MyApp.appx" -ip 192.168.0.1 -pin A1B2C3
Desinstala o pacote especificado (com base em seu nome completo) de um dispositivo Windows com um endereço IP 192.168.0.1. Você pode usar o comando de lista para ver os nomes completos de todos os pacotes instalados em um dispositivo.
WinAppDeployCmd uninstall -package Company.MyApp_1.0.0.1_x64__qwertyuiop -ip 192.168.0.1
Atualiza o aplicativo que já está instalado no dispositivo Windows 10 com um endereço IP de 192.168.0.1 usando o pacote de aplicativo especificado.
WinAppDeployCmd update -file "Downloads\MyApp.appx" -ip 192.168.0.1
Implanta os arquivos de um aplicativo em um computador ou Xbox com um endereço IP de 192.168.0.1 na mesma pasta que o AppxManifest, no diretório app1_F5 dentro do caminho de implantação do dispositivo.
WinAppDeployCmd deployfiles -file "C:\apps\App1\AppxManifest.xml" -remotedeploydir app1_F5 -ip 192.168.0.1
Registra o aplicativo no diretório app1_F5 sob o caminho de implantação do PC ou Xbox em 192.168.0.1.
WinAppDeployCmd registerfiles -remotedeploydir app1_F5 -ip 192.168.0.1
Usando o WinAppDeployCmd para configurar a implantação do modo Executar a partir do PC no Xbox One
A execução do computador permite que você implante um aplicativo UWP em um Xbox One sem copiar os binários, em vez disso, os binários são hospedados em um compartilhamento de rede na mesma rede que o Xbox. Para fazer isso, você precisa de um Xbox One desbloqueado para desenvolvedores e um aplicativo UWP em formato de arquivo solto em uma unidade de rede que o Xbox possa acessar.
Execute isso para registrar o aplicativo:
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