Executar seu aplicativo Apache Cordova no Android

  • Artigo

No Visual Studio 2013, as ferramentas do Cordova são lançadas como uma versão de visualização (CTP). As ferramentas do Cordova serão lançadas como parte do Visual Studio 2015 e recomendamos usar o Visual Studio 2015 RTM para desenvolver aplicativos usando o Visual Studio Tools for Apache Cordova. Você pode baixar o Visual Studio no Centro de Download da Microsoft.

Há muitas opções para executar seus aplicativos criados usando o Visual Studio Tools para o Apache Cordova no Android. Do Visual Studio, você pode executar e depurar aplicativos Android nos seguintes emuladores e dispositivos:

  • Apache ondulação simulador(discutido em outro artigo)

  • Emulador do Visual Studio para Android

  • Emulador do Android

  • Emulador Genymotion

  • Umdispositivo Androidconectado ao computador

Se você encontrar erros criando para o Android, consulte essesdicas e soluções alternativas.

Emulador do Visual Studio para Android (Hyper-V)

Para executar seu aplicativo noVisual Studio emulador Android. Para requisitos de sistema, consulteRequisitos do sistema para o emulador do Visual Studio para Android.

Importante

O Visual Studio emulador Android só está disponível no Visual Studio de 2015.

Para executar o aplicativo no emulador

  1. Certifique-se de que o Hyper-V está habilitada no computador. Seu computador deve atender arequisitos de sistemapara o Visual Studio emulador Android.

    Importante

    Não há suporte para o emulador em um ambiente virtualizado.

  2. Com o aplicativo aberto no Visual Studio, escolha Android na lista Plataformas de Solução. Se você não vir essa lista, escolha Plataformas de Solução na lista Adicionar ou remover botões para exibi-lo.

  3. Escolha um dos emuladores, comoemulador VS 5" KitKat (4,4) XHDPI telefone.

  4. Pressione F5 para iniciar o aplicativo.

    O Visual Studio inicia o emulador e executa o aplicativo.

Configurar um emulador de alto desempenho (sem Hyper-V)

Se você tiver um computador com processador Intel, poderá melhorar o desempenho dos emuladores Android e Genymotion. Para configurar um emulador de alto desempenho:

  1. Desabilite o Hyper-V. Você pode fazer isso no Painel de Controle ou de uma linha de comando, de conforme descrito nos procedimentos a seguir.

    Aviso

    Desabilitar Hyper-V impedirá você de usar o emulador do Visual Studio para Android e o emulador do Windows Phone.No entanto, você ainda poderá implantar em um dispositivo Windows Phone enquanto o Hyper-V estiver desabilitado.

  2. (Apenas emulador Android) Instale o driver Intel Hardware Accelerated Execution Manager (HAXM) de alto desempenho, se ainda não estiver instalado. (Mais informações sobre o driver HAXM)

  3. Configure o emulador do Android para usar a aceleração de hardware.

Para desabilitar o Hyper-V no Painel de Controle

  1. No Painel de Controle, escolha Programas e Recursos e escolha Ativar ou desativar recursos do Windows.

  2. Desmarque a caixa de seleção para o Hyper-V.

    Disabling Hyper-V

  3. Reinicie o computador.

    Agora você poderá instalar o driver HAXM.

Como alternativa, você pode configurar o Windows para iniciar com o Hyper-V automaticamente habilitado ou desabilitado usando a linha de comando.

Para desabilitar o Hyper-V usando a linha de comando

  1. Abra um prompt de comando com privilégios elevados (com credenciais administrativas) e digite:

    bcdedit /set hypervisorlaunchtype off

    Aviso

    Os comandos bcdedit podem impedir que o sistema inicialize se não forem executados corretamente; tenha cuidado ao usar esses comandos.

    Se você está adicionando este comando a um script shell, use o seguinte:

    bcdedit /set hypervisorlaunchtype off
shutdown /r

  2. Reinicie o computador.

    Se você quiser reabilitar o Hyper-V posteriormente, use o seguinte comando e, em seguida, reinicialize o computador:

    bcdedit /set hypervisorlaunchtype auto

Se você estiver usando o emulador de Genymotion, você pode ignorar este procedimento. Para obter mais informações, consulteemulador Genymotion.

Para instalar o driver HAXM de alto desempenho (apenas emulador do Android)

  1. Depois de desabilitar o Hyper-V e reiniciar, abra o Gerenciador do SDK do Android. Para fazer isso em uma linha de comando, vá para o local do SDK e digiteandroid.

    No Windows, o Android Manager.exe SDK está instalado no seguinte local: \Android\android-sdk C:\Program Files (x86).

  2. No Gerenciador do SDK do Android, procure em Extras pelo Intel x86 Emulator Accelerator (instalador do HAXM). Se a coluna de status mostrar que ele não está instalado, marque a caixa de seleção e escolha Instalar pacotes.

    Installing the HAXM driver

  3. Instale o driver acessando sdk-path\extras\intel\Hardware_Accelerated_Execution_Manager e execute o intelhaxm.exe.

    Dica

    Se a parte "intel" do caminho não estiver presente, o driver não foi instalado.

    Agora você poderá configurar um emulador para usar o driver. Ao criar ou editar um emulador, você deve usar uma CPU Intel e selecionar a opção Usar GPU do host. Para obter mais informações, consulte a próxima seção.

Emulador do Android

Antes de executar o aplicativo no emulador do Android no Visual Studio, use o Gerenciador de Dispositivos Virtuais do Android (AVD) para criar uma configuração do emulador e inicie o emulador a partir do Gerenciador de AVD. As etapas a seguir mostram como fazer isso. Para obter mais informações, consulte a Documentação do Gerenciador de AVD.

Para criar uma instância do emulador

  1. Abra o Gerenciador de AVD. Para fazer isso em uma linha de comando, acesse o local do SDK e digiteandroid avd.

    No Windows, o Manager.exe AVD é instalado no seguinte local: \Android\android-sdk C:\Program Files (x86).

  2. No Gerenciador do AVD, escolhacriar.

  3. Configure as propriedades para o novo emulador.

    As propriedades necessárias são Nome do AVD, Dispositivo, Destino, CPU/ABI e Capa. Destino representa uma versão instalada da versão do SDK do Android (conjunto de APIs). Defina essa propriedade como API nível 19.

    Dica

    Se você deseja emular outras versões do dispositivo Android, você pode instalar as imagens usando o Gerenciador de SDK do Android.

    Creating an Android emulator

  4. Se você instalou o driver do HAXM de alto desempenho noseção anteriore escolher uma CPU Intel, selecione ouso Host GPUcaixa de seleçãoOpções de emulação.

    Importante

    Para usar o emulador de alto desempenho, você também deve escolher um processador Intel a seção CPU/ABI da caixa de diálogo do AVD.

  5. Escolha OK para fechar a caixa de diálogo de configuração e escolha OK novamente na caixa de diálogo que mostra todas as configurações de emulador.

  6. No Gerenciador de AVD, selecione o novo emulador e escolha Iniciar.

Para executar o aplicativo no emulador

  1. Com o aplicativo aberto no Visual Studio, escolha Android na lista Plataformas de Solução. (Se você não vir essa opção, primeiro escolhaplataformas de soluçãodoAdicionar ou remover botõeslista.)

  2. Na lista de dispositivos, escolha Emulador do Android.

    Deploying to the Android emulator

  3. Pressione F5 para iniciar o aplicativo ou Shift+F5 para iniciar o aplicativo sem depuração.

    O Android 4.4 é necessário para anexar o depurador. Caso contrário, o aplicativo será executado sem depuração.

    Dica

    • Se você receber um erro indicando que você precisa instalar uma nova versão do SDK do Android, use o Gerenciador do SDK do Android para instalá-lo.No Windows, você pode abrir o Gerenciador de SDK, digitando o seguinte comando na linha de comando:android sdk.

    • O Visual Studio implanta o aplicativo no emulador do Android que está sendo executado.Se nenhum emulador estiver em execução, o Visual Studio inicia o último emulador criado usando o Gerenciador de AVD e, em seguida, implanta o aplicativo.

    • Se você quiser depurar seu aplicativo em relação a versões Android 4.1.2-4.3, consulte as informações sobre o plug-in jsHybugger no artigodepurar seu aplicativo compilado com o Visual Studio Tools for Apache Cordova.

Emulador Genymotion

O emulador Genymotion é uma alternativa popular ao emulador do Android fornecido com o SDK do Android. Veja a seguir algumas dicas para começar a usar o emulador:

  • Se você tiver problemas para iniciar o emulador de uma conexão remota, tente iniciá-lo localmente e reconecte remotamente, se necessário. O emulador exige OpenGL para renderização, e isso pode resultar em um conflito ao iniciar o emulador.

  • Você precisa de uma placa de vídeo e drivers de placa de vídeo com suporte a OpenGL. Você pode receber mensagens indicando isso. (Se você se conectar remotamente ao computador, você também poderá ver essa mensagem. Tente novamente após conectar localmente.)

  • Você receberá uma mensagem para verificar a configuração da rede VirtualBox quando você tentar iniciar o emulador. Siga o link e instruções para modificar ou remover o "Adaptador de rede somente do host" do VirtualBox. (O VirtualBox é incluído com a instalação do emulador).

  • Para a emulação de alto desempenho usando Genymotion, desabilitar o Hyper-V antes de iniciar o emulador, conforme descrito anteriormente emConfigurar um emulador de alto desempenho.

As ferramentas de desenvolvimento do Android veem o Genymotion como um dispositivo físico. Quando você usar o Visual Studio para executar o aplicativo, instrua-o a implantar um dispositivo Android.

Para executar o aplicativo no emulador Genymotion

  1. Inicie o emulador Genymotion.

  2. Com o aplicativo aberto no Visual Studio, escolha Android na lista Plataformas de Solução. Se você não vir essa opção, escolha Plataformas de Solução na lista Adicionar ou remover botões.

  3. Na lista de dispositivos, escolha Dispositivo.

    Deploying to an Android device

  4. Pressione F5 para iniciar o aplicativo ou Shift+F5 para iniciar o aplicativo sem depuração.

Dispositivos Android

Antes de usar o Visual Studio para executar seu aplicativo em um dispositivo Android conectado, você deve instalar o driver necessário:

Você também deve garantir que seu dispositivo está no modo de desenvolvedor. Para obter instruções, consulte "Habilitando opções do desenvolvedor no dispositivo" e "Configurando um dispositivo para desenvolvimento" na página Usando dispositivos de hardware no site da Android.

Para implantar uma configuração de Versão ou Distribuição do aplicativo, você deve assiná-lo pela primeira vez. Para obter mais informações, consulteempacotar o aplicativo.

Para executar seu aplicativo em um dispositivo Android

  1. Certifique-se de que você instalou o driver necessário do Google USB ou OEM.

  2. Certifique-se de que o dispositivo Android está no modo de desenvolvedor (consulte Usando dispositivos de Hardware no site da Android).

  3. Certifique-se de que adb (ponte de depuração do Android) de ver o dispositivo usando adb.exe.

    1. Abra um prompt de desenvolvedor VisualStudio no modo de administrador.

    2. Digite o seguinte comando:

      "%ADT_HOME%\platform-tools\adb.exe" devices

      Você deve ver seu dispositivo na lista, como mostrado aqui.

      Viewing your device using the Android Debug Bridge

  4. Com o aplicativo aberto no Visual Studio, escolha Android na lista Plataformas de Solução. (Se você não vir essa opção, escolhaplataformas de soluçãodoAdicionar ou remover botõeslista.)

  5. Na lista de dispositivos, escolha Dispositivo.

    Deploying to an Android device

  6. Pressione F5 para iniciar o aplicativo ou Shift+F5 para iniciar o aplicativo sem depuração.

  7. Quando solicitado, escolha Permitir a depuração de USB.

Download the tools Obter o Visual Studio Tools para o Apache Cordovaoumais

Consulte também

Conceitos

Instalar o Visual Studio Tools for Apache Cordova

Depurar seu aplicativo compilado com o Visual Studio Tools for Apache Cordova

Empacotar seu aplicativo compilado com o Visual Studio Tools for Apache Cordova

Outros recursos

FAQ