Skip to content
Robson Vinicius edited this page Jun 8, 2018 · 6 revisions

Ambiente de desenvolvimento com Cordova

Vamos preparar o ambiente para desenvolvimento com Cordova, independente da plataforma. Essencialmente, vamos instalar:

  • Node.js
  • Cordova
  • Google Chrome



Precisamos do Node para usar o Cordova. Entre no site do Node, e clique no grande botão Install. Ele vai baixar o pacote e você pode simplesmente executá-lo. Faça a instalação padrão com Next, Next, Finish, e deixando as opções padrões marcadas.

Ao fim, para saber se a instalação foi bem sucedida, abra o terminal e digite:

node -v





O Cordova é um pacote do Node.js que vamos instalar com sua ferramenta de pacotes, chamada npm.

No Windows, feche e abra novamente o terminal, e digite:

npm -g install cordova



No Mac e no Linux, precisamos do sudo para instalar globalmente, então faça:

sudo npm -g install cordova



Deve demorar um pouco para fazer a instalação completa para nós.



Projeto com plataforma browser


Neste ponto, temos como criar um novo projeto Cordova para rodar nos navegadores. Depois vamos ver o ambiente para Android e iOS.

Abra um terminal e entre na pasta onde quer criar o novo projeto. E aí digite em um só comando:

cordova create nomepasta com.seudominio.garconapp "Título único de seu app"


Ele deve gerar a pasta garconapp cheio de arquivos dentro. É só um HelloWorld* simples.

Abra um terminal e entre na pasta do projeto. Então, adicione a plataforma browser com:


cd nomepasta cordova platform add browser


Assim, podemos executar o projeto, que tem aquele HTML simples de HelloWorld, na plataforma browser. É bem simples:


cordova run browser


Ele vai abrir uma nova instância do Google Chrome com algumas configurações de segurança alteradas, e mostrará a App padrão do Cordova.




Ambiente Android

Vamos preparar o ambiente para suportar o desenvolvimento Android. Precisamos:

  • Java JDK
  • Android SDK
  • VirtualBox
  • Emuladores Genymotion



Precisamos do Java para usar o Android SDK. Se você não tem certeza se possui o Java instalado, abra um terminal e rode o comando:

java -version


Precisamos do Java na versão 1.8.x ou superior. Para instalá-lo, acesse o site da Oracle.

Localize o pacote Java Platform JDK na versão 8 ou superior (não precisa baixar a versão Netbeans). Baixe e siga a instalação padrão com Next, Next, Finish.

Ao final, abra um novo terminal e teste novamente: java -version.




Apesar de ser um projeto híbrido, o Cordova exige as ferramentas nativas instaladas para montar a App final e testá-la. Por isso, vamos precisar do Android SDK que funciona no Windows, Mac e Linux.

Entre no site do Android e baixe o SDK para sua plataforma (está no finalzinho da página, depois do Studio, chamado de Ferramentas de Linha de Comando):


No Windows

Siga a instalação padrão com Next, Next e Finish. No final, tem a opção Start SDK Manager, deixe-a marcada. Deverá abrir o SDK Manager do Android. Senão, vá no menu Iniciar e ache o SDK Manager.


No Mac ou Linux

O pacote para Mac e Linux nada mais é que um ZIP que você pode descompactar onde quiser, como a home do seu usuário ou alguma outra pasta. Faça essa descompactação e anote o caminho completo onde colocou.

Você vai precisar adicionar o caminho no PATH. Para isso, abra o arquivo ~/.bashrc e adicione a seguinte linha, colocando o caminho correto na sua máquina:


export PATH=$PATH:<caminho_android_sdk>/tools:<caminho_android_sdk>/platform-tools:<caminho_android_sdk>/build-tools


E no terminal recarregue essas novas configurações com:


source ~/.bashrc


Por fim, você precisa abrir o SDK Manager rodando no terminal:


android sdk




Configuração do Android SDK


Instalado o Android SDK, precisamos então adicionar certos componentes a ele. Abra o Android SDK Manager como no passo anterior. Vamos instalar:

  • SDK Platform
  • Android SDK Platform-tools
  • Android SDK Build-tools

Marque as últimas versões do Build-tools, Platform-tools e do SDK Platform. Clique em Install. Ele baixará bastante coisa e é bem demorado para instalar.




Instalação do Genymotion


O último passo é instalar um emulador de Android. O SDK traz emuladores oficiais, mas eles são muito lentos. Uma ferramenta que cresceu bastante no mercado é o Genymotion, que permite rodar o Android direto virtualizado no VirtualBox. E ele é muito mais rápido.

O Genymotion é gratuito para uso pessoal, mas o site tenta vender a versão paga a todo custo. Você vai precisar criar uma conta, mas é rápido. Acesse Genymotion e crie sua conta. Então faça o download para seu sistema operacional.

Na versão Windows, você tem a opção de baixar o Genymotion já com VirtualBox embutido (ou só Genymotion caso já tenha o VirtualBox instalado). Baixe e siga a instalação padrão.

No Mac e Linux, é necessário instalar o VirtualBox separadamente. Entre em http://virtualbox.org, baixe o arquivo e siga a instalação padrão. Você talvez precise reiniciar a máquina após a instalação do VirtualBox para que o Genymotion o encontre.

Baixando emulador no Genymotion

Instalado o Genymotion e o VirtualBox, precisamos baixar emuladores de versões específicas do Android que nos interessam.

Abra o Genymotion. Ele pedirá seu usuário e senha, que você criou no Site. Depois, você pode adicionar novos emuladores. Teste instalar um tablet com Android 5, por exemplo, ou outra versão.

Para testar, clique em Start e veja se o emulador abre e funciona.

Você pode instalar outros emuladores também, em mais versões e tamanhos de tela.



Plataforma Android

Se o ambiente estiver propriamente configurado para Android, executar nesta plataforma é tão simples quanto no browser. Primeiro, adicionamos a plataforma:


cordova platform add android


E, para rodar:


cordova run android


Isso provavelmente deu um erro para você. Ele reclama que não há dispositivo Android nenhum. Logo, precisamos de um dispositivo Android para rodar, seja real ou emulado. Vamos usar os emuladores Genymotion que instalamos antes.

Abra o Genymotion e inicie algum emulador. Depois de iniciado, tente novamente:


cordova run android


Pronto, agora a App deve executar no emulador.