Apache Cordova - Android - Introdução
Autor: Evaldo Wolkers | Publicado: 2012-05-17T18:45:00-07:00







Introdução ao Android

Este guia descreve como configurar seu ambiente de desenvolvimento para Cordova e executar um aplicativo de exmplo.&nbsp;Note que Cordova era chamado de PhoneGap, então alguns dos sites ainda usam o nome PhoneGap.





1.&nbsp;Requisitos&nbsp;

Eclipse 3.4 +






2.&nbsp;Instale SDK + Cordova

Baixe e instale o&nbsp;Eclipse Classic
Baixe e instale o&nbsp;Android SDK
Baixe e instale o&nbsp;plugin ADT
Baixe a última cópia de&nbsp;Cordova&nbsp;e extraia seu conteúdo.&nbsp;Nós estaremos trabalhando com o diretório Android.






3.&nbsp;Criando o Projeto


Abra o Eclipse e selecione o item do menu File /&nbsp;New &gt;&nbsp;Android&nbsp;Project.&nbsp;Preencha os três painéis da janela&nbsp;New Android Project como mostrado abaixo.




















No diretório raiz do seu projeto, crie dois novos diretórios:

/libs
assets/www


Copie o arquivo&nbsp;cordova-1.7.0.js&nbsp;do Cordova (phonegap-phonegap-475bfd2/lib/android) para&nbsp;assets/www
Copie o arquivo&nbsp;cordova-1.7.0.jar&nbsp;do Cordova para&nbsp;/libs

Copie a pasta&nbsp;xml&nbsp;do Cordova para&nbsp;/res


Verifique se&nbsp;cordova-1.7.0.jar&nbsp;está listado no Build Path de seu projeto.&nbsp;Botão direito do mouse na pasta libs / e vá para Build Path&nbsp;/&gt; Configure Build Path...&nbsp;.&nbsp;Em seguida, na guia Libraries, adicione&nbsp;cordova-1.7.0.jar&nbsp;ao projeto.&nbsp;Se Eclipse está sendo "temperamental", talvez você precise atualizar (F5) o projeto mais uma vez.






Edite o arquivo&nbsp;principal&nbsp;do seu projeto Java encontrado na pasta&nbsp;src&nbsp;do Eclipse:

Adicione o&nbsp;import org.apache.cordova *.;
Altere a classe estendida de&nbsp;Activity&nbsp;para&nbsp;DroidGap;
Substitua a linha&nbsp;setContentView(R.layout.main)&nbsp;por&nbsp;super.loadUrl("file:///android_asset/www/index.html");


Veja como ficou:








Clique com o botão direito do mouse sobre AndroidManifest.xml e selecione&nbsp;Open With &gt; XML Editor


Cole as seguintes permissões entre as tags&nbsp;&lt;uses-sdk.../&gt;&nbsp;e&nbsp;&lt;application.../&gt;.


&lt;supports-screens 
&nbsp; &nbsp; android:largeScreens="true" 
&nbsp; &nbsp; android:normalScreens="true" 
&nbsp; &nbsp; android:smallScreens="true" 
&nbsp; &nbsp; android:resizeable="true" 
&nbsp; &nbsp; android:anyDensity="true" /&gt;
&lt;uses-permission android:name="android.permission.CAMERA" /&gt;
&lt;uses-permission android:name="android.permission.VIBRATE" /&gt;
&lt;uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /&gt;
&lt;uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /&gt;
&lt;uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" /&gt;
&lt;uses-permission android:name="android.permission.READ_PHONE_STATE" /&gt;
&lt;uses-permission android:name="android.permission.INTERNET" /&gt;
&lt;uses-permission android:name="android.permission.RECEIVE_SMS" /&gt;
&lt;uses-permission android:name="android.permission.RECORD_AUDIO" /&gt;
&lt;uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" /&gt;
&lt;uses-permission android:name="android.permission.READ_CONTACTS" /&gt;
&lt;uses-permission android:name="android.permission.WRITE_CONTACTS" /&gt;
&lt;uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /&gt;
&lt;uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /&gt; &lt;uses-permission android:name="android.permission.GET_ACCOUNTS" /&gt;
&lt;uses-permission android:name="android.permission.BROADCAST_STICKY" /&gt;



Adicione a linha abaixo&nbsp;dentro da tag "activity".


android:configChanges="orientation|keyboardHidden"



O seu arquivo AndroidManifest.xml deve ser semelhante a este:















4. Hello World


Criar um arquivo chamado&nbsp;index.html&nbsp;em&nbsp;assets/www.&nbsp;Cole o seguinte código:
&lt;!DOCTYPE HTML&gt;
&lt;html&gt;
&lt;head&gt;
&lt;title&gt;Cordova&lt;/title&gt;
&lt;script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"&gt;&lt;/script&gt;
&lt;/head&gt;
&lt;body&gt;
&lt;h1&gt;Hello World&lt;/h1&gt;
&lt;/body&gt;
&lt;/html&gt;








5A. Realizar Deploy para o Simulador

Clique com o botão direito do mouse no projeto e selecione Run As&nbsp;&gt; Android Application
O Eclipse vai pedir para você selecionar um AVD apropriado.&nbsp;Se não houver um, então você terá que criá-lo.




Veja a execução no simulador:









5B.&nbsp;Realizar Deploy para um Dispositivo:

Certifique-se de que a depuração USB está habilitada em seu dispositivo e conecte-o ao sistema.&nbsp;(&nbsp;Settings &gt; Applications &gt; Development&nbsp;)
Clique com o botão direito do mouse no projeto e selecione&nbsp;Run As &gt; Android Application






Pronto!



Publicado em:&nbsp;http://docs.phonegap.com/en/1.7.0/guide_getting-started_android_index.md.html#Getting%20Started%20with%20Android



Evaldo Wolkers.