Partilhar via


Executar seu aplicativo Apache Cordova no emulador Apache Ripple

Este artigo se refere ao Visual Studio Tools for Apache Cordova, que é um software de pré-lançamento. Os recursos descritos estão em pré-lançamento e sujeitos a alterações. Você pode baixar a visualização do Microsoft Download Center.

O emulador Apache Ripple é executado como um aplicativo da web dentro de um navegador (Google Chrome). No Cordova, ele pode ser usado para simular seu aplicativo em diversos dispositivos e plataformas e oferece suporte básico aos principais plug-ins do Cordova como Localização Geográfica e a Orientação do Dispositivo.

O emulador Ripple fornece uma primeira etapa rápida e fácil na criação e validação do seu aplicativo para Android e iOS, porque ambas as plataformas usam um navegador com uma base de código semelhante. O emulador Ripple é especialmente útil para validação de layout e código CSS. Para emulação de alta fidelidade específica a uma plataforma, use os emuladores de Android ou iOS ou um dispositivo real.

Aviso

O Ripple não fornece uma emulação completa das APIs do Cordova ou dos recursos do dispositivo nativo, nem emula versões específicas do navegador usado pelo seu aplicativo em uma plataforma de dispositivo específica.

Aqui estão algumas coisas que deve ter em mente ao testar o layout de cascata.

  • Se você direcionar 4.4 Android ou posterior (Chromium com base em navegador), suporte para os padrões atuais de CSS e outras tecnologias da web é melhor. Consulte caniuse.com para obter informações específicas sobre os recursos com suporte.

  • Se você direcionar iOS ou Android versões antes 4.4, o navegador é baseado em WebKit. (O emulador ondulação, que usa a versão instalada do Chrome, se comporta como Android 4.4.) Alguns comportamentos de navegador WebKit é diferente. Por exemplo, WebKit navegadores não fornecem suporte consistente para unidades vw e vh.

Executar seu aplicativo no emulador Apache Ripple

O procedimento a seguir mostra como executar o aplicativo no emulador e anexar o depurador.

Para executar o aplicativo no emulador Ripple

  1. Escolha Android ou iOS na lista Plataformas de Solução.

    Selecione Android como o destino da implantação

    Dica

    Se você não vir essa lista, escolha Plataformas de Solução na lista Adicionar ou remover botões para exibi-lo.

  2. Na lista de dispositivos de destino, escolha um dos emuladores Ripple.

    Selecionar o emulador em cascata

  3. Pressione F5 para iniciar a depuração ou Shift+F5 para iniciar o aplicativo 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, o SDK Manager.exe é instalado no seguinte local: %localappdata%\Android\android-sdk (por exemplo, C:\Users\user\AppData\Local\Android\android-sdk).

Alterar o proxy para o emulador

O Ripple evita limitações entre domínios no navegador usando um proxy. Dois proxies estão disponíveis: um proxy remoto e um local. O proxy remoto é hospedado na nuvem.

Observação de segurançaObservação de segurança

Se seu aplicativo estiver transferindo dados confidenciais (por exemplo, tokens de autenticação do Active Directory), é altamente recomendável usar o proxy local em vez do proxy remoto.

Para alterar o proxy

  1. No Chrome, enquanto o aplicativo é executado, escolha o botão de seta à direita e escolha a seção Configurações.

  2. Escolha o botão Proxy entre domínios e, em seguida, escolha um proxy.

    Selecionando um proxy no emulador ondulação

Alterar o dispositivo durante a execução do aplicativo

Você pode alterar o dispositivo de destino sem interrupções enquanto o aplicativo é executado no Chrome. Ao fazer isso, você pode evitar reiniciar o aplicativo no Visual Studio.

Para alterar o dispositivo

  1. Enquanto o aplicativo é executado no Chrome, escolha o botão de seta à direita e escolha a seção Dispositivos.

  2. Escolha o botão que especifica o nome do dispositivo atual e, em seguida, escolha um dispositivo diferente.

    A alteração do dispositivo no Chrome

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