Compartilhar via

Implantar aplicativos do Windows Phone 8.1 com a ferramenta Implantação do Aplicativo

  • Artigo

 

Applies to Windows Phone only

Você pode implantar aplicativos do Windows Phone no emulador ou em um telefone do Visual Studio. Você também pode implantar aplicativos usando a ferramenta Implantação do Aplicativo. Essa ferramenta é instalada quando você instala as ferramentas de desenvolvimento do Windows Phone.

A ferramenta de implantação de aplicativo tem uma versão autônoma (appdeploy.exe) e uma versão de linha de comando (appdeploy.cmd). A ferramenta de linha de comando permite que você implante um aplicativo por meio de um script ou de um aplicativo personalizado.

Neste tópico

  • Implantando um aplicativo com a ferramenta Implantação do Aplicativo

    • Para implantar um aplicativo com a ferramenta Implantação do Aplicativo

  • Implantando um aplicativo a partir do prompt de comando

    • Para implantar um aplicativo a partir do prompt de comando

    • Sintaxe e opções de implantação da linha de comando

    • Exemplos de implantação da linha de comando

Implantando um aplicativo com a ferramenta Implantação do Aplicativo

Para implantar um aplicativo com a ferramenta autônoma, use a ferramenta Implantação do Aplicativo (appdeploy.exe). Essa ferramenta é instalada quando você instala as ferramentas de desenvolvimento do Windows Phone.

Para implantar um aplicativo com a ferramenta Implantação do Aplicativo

  1. Compile e empacote seu aplicativo.

  2. Se você estiver implantando seu aplicativo em um dispositivo, verifique se o dispositivo está registrado e conectado.

  3. Na tela de início do seu computador, localize a ferramenta de implantação do aplicativo.

    Você também pode executar a ferramenta do seguinte local:

    C:\Program Files (x86)\Microsoft SDKs\Windows Phone\v8.1\Tools\AppDeploy\AppDeploy.exe

  4. Execute a ferramenta.

    A ferramenta inicia, conforme ilustrado na captura de tela a seguir.

    App Deployment Tool for Windows Phone apps

  5. Na caixa de listagem suspensa Destino, selecione Dispositivo ou uma das opções de emuladores.

  6. No campo Aplicativo, clique em Procurar e localize o arquivo de pacote que você deseja implantar.

  7. Clique em Implantar.

Se a implantação for bem-sucedida, o campo Status exibirá Implantação de Aplicativo Concluída.

Implantando um aplicativo a partir do prompt de comando

Use a versão de linha de comando da ferramenta Implantação do Aplicativo (appdeploycmd.exe) para implantar um aplicativo por meio do prompt de comando. A ferramenta de linha de comando permite que você implante um aplicativo por meio de um script ou de um aplicativo personalizado.

Para implantar um aplicativo a partir do prompt de comando

  1. Compile e empacote seu aplicativo.

  2. Se você estiver implantando seu aplicativo em um dispositivo, verifique se o dispositivo está registrado e conectado.

  3. Abra uma janela do Prompt de Comando.

  4. Se sua variável de ambiente PATH não contiver o caminho para AppDeployCmd.exe, navegue para a pasta a seguir.

    C:\Program Files (x86)\Microsoft SDKs\Windows Phone\v8.1\Tools\AppDeploy

  5. Execute AppDeployCmd.exe com as opções descritas na tabela a seguir.

Sintaxe e opções de implantação da linha de comando

AppDeployCmd.exe tem a seguinte sintaxe:

AppDeployCmd.exe <cmd[:param]> <product-id/app filename> <targetdevice[:param]>

A tabela a seguir descreve as opções de linha de comando AppDeployCmd.exe.

Você pode instalar ou reinstalar um aplicativo no dispositivo de destino ou atualizar um aplicativo que já esteja instalado. Para manter os dados ou configurações salvos por um aplicativo já instalado, use as opções update em vez das opções install.

Opção

Descrição

<cmd[:param]>

Especifica o comando a ser executado. Essa opção tem um dos seguintes valores:

Opção

Descrição

/install

Instala o aplicativo no destino. Essa opção requer o argumento app filename.

/installlaunch

Instala e executa o aplicativo no destino. Essa opção requer o argumento app filename.

/update

Atualiza o aplicativo já instalado no destino. Essa opção requer o argumento app filename.

/updatelaunch

Atualiza e executa o aplicativo já instalado no destino. Essa opção requer o argumento app filename.

/launch

Executa o aplicativo já instalado no destino. Essa opção requer o argumento product-id.

/uninstall

Desinstala o aplicativo do destino. Essa opção requer o argumento product-id.

/EnumerateDevices

Lista os destinos de dispositivo válidos e o índice numérico de cada dispositivo.

<product-id>

Especifica o GUID que identifica o aplicativo. O valor é encontrado no arquivo de manifesto do aplicativo para o projeto.

  • Para um pacote APPX, a GUID é o valor do atributo Id do elemento Application.

  • Para um pacote XAP, o GUID é o valor do atributo ProductID do elemento App.

<app filename>

Especifica o caminho completo do pacote a ser instalado ou atualizado.

<targetdevice[:param]>

Especifica o dispositivo de destino. Essa opção tem um dos seguintes valores:

Valor

Descrição

xd

Almeja o emulador padrão.

de

Destinos do Windows Phone conectado ao computador de desenvolvimento.

n

Almeja o dispositivo no índice n na lista de dispositivos. Para obter a lista de dispositivos, execute AppDeployCmd.exe /EnumerateDevices.

<force[:INTERNAL|SCARD]>

Força a instalação do aplicativo em um dispositivo de armazenamento específico. Você pode usar essa opção somente com as opções /install e /installlaunch .

Essa opção tem um dos seguintes valores:

Valor

Descrição

INTERNAL

Instala o aplicativo no dispositivo de armazenamento interno no destino.

SDCARD

Instala o aplicativo no dispositivo de armazenamento removível no destino.

Exemplos de implantação da linha de comando

Veja alguns exemplos de implantação da linha de comando. Os exemplos a seguir presumem que product-id seja f8ce6878-0aeb-497f-bcf4-65be961d4bba e app filename seja D:\PhoneApp2.appx.

  • Instala o aplicativo no emulador padrão.
    AppDeployCmd.exe /install D:\PhoneApp2.appx /targetdevice:xd

  • Instala o aplicativo no emulador padrão e o executa.
    AppDeployCmd.exe /installlaunch D:\PhoneApp2.appx /targetdevice:xd

  • Executa o aplicativo instalado com a ID de produto especificada no dispositivo conectado.
    AppDeployCmd.exe /launch f8ce6878-0aeb-497f-bcf4-65be961d4bba /targetdevice:de

  • Atualiza o aplicativo já instalado no dispositivo especificado pelo índice de dispositivo 2. Para obter a lista de dispositivos válidos, use a opção /EnumerateDevices.
    AppDeployCmd.exe /update D:\PhoneApp2.appx /targetdevice:2

  • Atualiza o aplicativo já instalado no dispositivo conectado e o executa.
    AppDeployCmd.exe /updatelaunch D:\PhoneApp2.appx /targetdevice:de

  • Desinstala o aplicativo com a ID de produto especificada do emulador padrão.
    AppDeployCmd.exe /uninstall f8ce6878-0aeb-497f-bcf4-65be961d4bba /targetdevice:xd

  • Enumera a lista de destinos de dispositivo válidos e o índice numérico de cada dispositivo.
    AppDeployCmd.exe /EnumerateDevices