Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 PC com Windows 10 para qualquer dispositivo Windows 10. Você pode usar essa ferramenta para implantar um pacote de aplicativo 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 sem empacotar primeiro em um PC remoto ou Xbox One. Este artigo descreve como instalar aplicativos UWP usando essa ferramenta.
Você só precisa do SDK do Windows 10 instalado para executar a ferramenta WinAppDeployCmd a partir de um prompt de comando ou um arquivo de script. Quando o utilizador instala uma aplicação com WinAppDeployCmd.exe, é utilizado o ficheiro .appx/.msix ou o AppxManifest (para ficheiros soltos) para transferir paralelamente a sua aplicação para um dispositivo Windows 10. Este 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, você deve primeiro criar um pacote. Para obter mais informações, consulte aqui.
A ferramenta WinAppDeployCmd.exe está localizada aqui no seu PC com Windows 10: C:\Program Files (x86)\Windows Kits\10\bin\<SDK Version>\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 dentro de pastas específicas da versão. SDKs anteriores (anteriores e incluindo 14393) são gravados diretamente na pasta pai.
Primeiro, conecte seu dispositivo Windows 10 à mesma sub-rede ou conecte-o diretamente à sua máquina Windows 10 com uma conexão USB. Em seguida, use a sintaxe a seguir e exemplos desse comando mais adiante neste artigo para implantar seu aplicativo UWP:
Sintaxe e opções de 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>
Pode instalar ou desinstalar uma aplicação no dispositivo de destino ou pode atualizar uma aplicação que já esteja instalada. Para manter os dados ou as configurações salvas por um aplicativo que já está 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á esteja instalado no dispositivo de destino. |
| lista | Mostrar a lista de aplicativos UWP instalados no dispositivo de destino especificado. |
| desinstalar | Desinstale o pacote do aplicativo especificado do dispositivo de destino. |
| arquivos de implementaçã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 de destino ao executar um aplicativo de um compartilhamento de rede. |
| deletecreds | Exclua as credenciais de rede que o destino usa quando executa 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, opções e argumentos. |
| -IP | Endereço IP do dispositivo alvo. |
| -g (-guid) | Identificador exclusivo do dispositivo alvo. |
| -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 o pacote do aplicativo a ser instalado, atualizado ou desinstalado. |
| -p (-package) | O nome completo do pacote do aplicativo a ser desinstalado. (Você pode usar o comando list para encontrar 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 serem utilizadas pelo alvo. |
| -credusername | O nome de usuário das credenciais de rede para uso pelo destino. |
| -credpassword | A senha das credenciais de rede para uso pelo alvo. |
| -tempo limite de ligação | O tempo limite em segundos usado ao se conectar ao dispositivo. |
| -remotedeploydir | Caminho/nome relativo do diretório para copiar arquivos no dispositivo remoto; Esta 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 de espera em segundos. (O padrão é 10) |
| <endereço> | Endereço IP ou identificador exclusivo do dispositivo alvo. |
| <um><b> ... | Caminho de dependência para cada uma das dependências do pacote do aplicativo. |
| <p> | Um pino 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 que será desinstalado. |
| <servidor> | Servidor na rede de arquivos. |
| <nome de utilizador> | Utilizador das credenciais com acesso ao servidor na rede de ficheiros. |
| <palavra-passe> | Palavra-passe para as credenciais com acesso ao servidor na rede de ficheiros. |
| < > remotedeploydir | Diretório no dispositivo relativo ao local de implantação |
WinAppDeployCmd.exe exemplos
Aqui estão alguns exemplos de como implantar a partir da linha de comando usando a sintaxe para WinAppDeployCmd.exe.
Mostra os dispositivos que estão disponíveis para implantação. O comando expira em 3 segundos.
WinAppDeployCmd devices 3
Instala a aplicação a partir do pacote MyApp.appx que se encontra na pasta Transferências do seu PC para um dispositivo Windows 10, com endereço IP 192.168.0.1 e PIN A1B2C3, para criar uma ligaçã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 de 192.168.0.1. Você pode usar o comando list 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 PC ou Xbox com um endereço IP 192.168.0.1 na mesma pasta que o AppxManifest no diretório app1_F5 sob o 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 WinAppDeployCmd para configurar a implantação Run from PC no Xbox One
Executar a partir do PC permite implantar 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, precisa do modo de desenvolvedor desbloqueado na Xbox One e um aplicativo UWP de arquivo independente numa unidade de rede que a Xbox possa aceder.
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