Pgina 1 de 84

Lio 1: Desenvolvimento para AndroidA plataforma Android baseada em sistema operacional Linux, adaptada para funcionamento em dispositivos mveis, como: smart phones, PDAs e Tablets. Para o desenvolvimento de aplicativos, foi disponibilizada uma mquina virtual, especialmente otimizada para uso em dispositivos mveis, alm de um ambiente de programao completo, com componentes visuais, de acesso a dados e redes. Interessante notar que a mquina virtual Dalvik um projeto Open Source (http://code.google.com/p/dalvik/), e NO UMA MQUINA VIRTUAL JAVA ! Isso mesmo: DALVIK NO JAVA! Existe uma aplicao, chamada dx, que pode converter o bytecode compilado a partir da mquina virtual Java (especificao da Oracle), no bytecode da Dalvik. A Google disponibilizou um ambiente de programao baseado em Java , que permite o desenvolvimento de aplicaes para a plataforma Android. Ele possui emuladores de dispositivos Android e conversores de bytecode. Segundo pesquisa da empresa Canalys , no quatro trimestre de 2010, quase 33 milhes de smartphones equipados com o sistema Android foram entregues, comparado com 31 milhes equipados com o sistema Symbian, da Nokia. Arquitetura do ambiente Android

A arquitetura do ambiente de desenvolvimento Android dividida em camadas. Sua aplicao roda na camada superior, por exemplo: contatos, telefone, jogos, calendrio, seu programa etc. Abaixo desta camada, vem um framework de componentes, que formam uma API de gerenciamento e servios para uso das aplicaes. Abaixo da camada de framework, temos as bibliotecas de servios, como OpenGL e SQLite, e as bibliotecas principais do ambiente, alm da prpria mquina virtual Dalvik. Finalmente, abaixo de tudo, temos o Kernel Linux. Embora seja possvel, devido a grande diversidade de dispositivos, no recomendado programar aplicaes em C/C++. O ambiente de programao Android fornece tudo o que voc necessita para criar aplicaes sinistras! Voc no precisa programar em C/C++ ou usar chamadas ao Kernel. Tudo o que necessita para criar aplicaes Android, do SDK e de um ambiente de programao Java. Cada aplicao Android executada por uma instncla da mquina virtual Dalvik, rodando em um processo separado dentro do sistema operacional.

Pgina 2 de 84

Componentes Uma aplicao Android um conjunto de componentes, que podem ser: Activities atividades ou telas; Services servios em background; Content Providers disponibilizam dados; Broadcast Receivers respondem a avisos gerais do sistema;

Uma aplicao Android orientada a eventos. Um evento um sinal, que pode ter sido originado pelo usurio (um toque) ou no (o timer, o bloqueio de tela etc). Logo, uma aplicao dividida em diversos tipos de componentes (activities, services etc), que compartilham um nome de pacote (sim, muito importante) e de aplicao comum, por exemplo: br.com.thecodebakers.hpp.Hppfree Os tipos de componentes so declarados e implementados na camada framework, e voc os estende para criar seus componentes especficos. View e ViewGroups

Uma View um elemento de interface. Comparando com uma pgina HTML, seriam os elementos de formulrio, como: botes, caixa de texto, radio buttons etc. As Views podem gerar e receber Eventos, que podem ser interceptados no cdigo-fonte. As Views podem ser agrupadas em ViewGroups, que fornecem o layout de arrumao na tela. Existem Views fornecidas pelo framework, que j agregam a parte visual e algum tipo de comportamento. So chamadas de Widgets. Se a sua aplicao possuir algum tipo de interface visual, o que o caso para a maioria delas, ento conter algumas Telas (activities), com Layouts (ViewGroups) e Views arrumadas nelas. atravs das Views que voc e o usurio se comunicam.

Pgina 3 de 84Activity

Uma Activity uma tela onde o usurio pode fazer algo. Note que o relacionamento entre Activity e caso de uso no 1 para 1. Um caso de uso pode envolver vrias activities. Para criar uma Activity necessrio criar um arquivo de layout, que contm um ViewGroup e um ou mais ViewGroups ou Views internos, todos arrumados de acordo com a usabilidade da sua aplicao. Depois, necessrio criar a subclasse de Activity, que ser invocada quando o usurio solicitar. A parte de cdigo quem comanda o espetculo, usando a parte de layout. Todos os eventos gerados pelas Views do Layout, e pelos controles do aparelho (boto de menu, menu de contexto e boto back) podero ser tratados no cdigo de sua activity. Uma activity pode iniciar outros componentes de sua aplicao, como: outras Activities, Services etc; Service http://developer.android.com/guide/topics/fundamentals/services.html Um componente que executa operaes de longo prazo e em background; Podemos iniciar um service em outro componente. Ele continuar a executar mesmo que o usurio mude de aplicao. Outros componentes podem se conectar com o nosso service. Exemplos: I/O, servios de rede, de GPS, de alerta etc. Imagine uma aplicao de vendas. Os vendedores recebem atualizaes de Clientes e as acessam atravs da sua aplicao, O Download automtico de atualizaes poderia ser feito por um Service de sua aplicao. Um service, uma instncia de: android.app.Service, fica rodando em Background e pode executar tarefas longas, repetitivas ou a intervalos determinados. E tambm pode ser acessado por outras aplicaes. Um Media Player, por exemplo, utiliza um Service, que fica tocando a msica mesmo que a interface do media player seja fechada. Sua aplicao pode criar seus prprios Services ou usar Services fornecidos por outros. A criao de Services est fora do escopo deste curso, mas abordada em cursos mais avanados.

Pgina 4 de 84Content Provider http://developer.android.com/guide/topics/providers/content-providers.html Amazenam e recuperam dados, disponibilizando-os para outras aplicaes. Exemplos: Contacts, Agenda etc. Voc tambm pode criar Content Providers para outras aplicaes; O Android vem com vrios Content Providers, como por exemplo as informaes de contato. Voc pode obter a lista de contatos do usurio (desde que autorizado por ele), acrescentar, remover etc. Voc no precisa criar um Content Provider para lidar com os dados de sua aplicao, mas, se quiser compartilh-los, ento ter que pensar nisto. Como as aplicaes Android so muito relacionadas com MashUps, bom pensar em compartilhar os dados de suas aplicaes, tornando-as mais populares. O desenvolvimento de content providers est fora do escopo deste curso. Broadcast Receiver http://developer.android.com/reference/android/content/BroadcastReceiver.html Classe que recebe alertas gerais do sistema. Podem ser gerados pelas activities ou no. Exemplo: SCREEN_OFF gerado pelo sistema quando a tela bloqueada. Voc pode tomar atitudes de acordo com o tipo de alerta recebido. Um Broadcast Receiver (derivado de: android.content.BroadcastReceiver) segue o padro GoF Observer. Ele se registra e fica observando se determinado evento geral acontece. diferente da classe de uma Activity, que somente observa eventos gerados pelas suas Views. Este tipo de componente pode receber eventos gerados pelo cdigo de sua aplicao, de outras aplicaes ou mesmo do sistema Android. Quando a tela desligada, por exemplo, possvel tomar alguamas atitudes. Nosso projeto: Hercules Password Protector (http://code.google.com/p/hercules-password-protector) usa um Broadcast Receiver para fechar o cofre caso a tela tenha sido desligada. A criao de Broadcast Receivers est fora do escopo deste curso.

Lio 2: Ambiente de desenvolvimentoAndroid APK Para ser executada e distribuda, sua aplicao Android tem que ser empacotada dentro de um arquivo com formato e extenso apk (Android Package). Algumas coisas so muito importantes neste arquivo: O hashcode de todas as pastas calculado e colocado dentro do MANIFEST.MF, que fica dentro do META-INF; A pasta res contm todos os recursos no compilveis da aplicao, como: arquivos XML, Layouts, menus, imagens etc; Arquivo dex. Este contm todo o bytecode da sua aplicao, traduzido para bytecode Dalvik; Arquivo arsc. Este contm os strings e uma tabela com todas as entradas do diretrio res, em formato binrio;

Antes de instalar um APK, voc deve assin-lo digitalmente. Isto pode ser feito com um certificado de assinatura de cdigo ou com uma chave auto-assinada. O processo de montagem manual de um APK bastante complexo e est fora do escopo deste curso. Veremos como criar APKs utilizando a IDE "eclipse".

Pgina 5 de 84A APP dentro do Device Tudo acontece dentro do diretrio /data, em seu dispositivo Android. A figura mostra um shell de comandos conectado a um emulador Android. Veremos como administrar dispositivos mais adiante.

Dentro da pasta /data/dalvik-cache, temos os arquivos .dex acessados, e dentro da pasta /data/app, temos os arquivos apk de cada aplicao que instalamos.

Android Market Toda infra-estrutura para voc distribuir sua aplicao para o grande pblico. Pode ser gratuita ou paga. http://market.android.com. De acordo com pesquisas da loja de aplicativos GetJar, o mercado de aplicativos para dispositivos mveis, ou apps, deve crescer de 7 bilhes de downloads para cerca de 50 bilhes at 2012, tornando-se um mercado mais lucrativo que o de CD's. O crescimento da plataforma Android, cujo nmero de novos aparelhos superou a Symbian no terceiro trimestre de 2010, tornando-se a mais utilizada no mundo, apontado (juntamente com o iPad) como o fator impulsionador do mercado apps. Na plataforma Android, temos o site Android Market, que pode ser facilmente acessado pelos dispositivos mveis. Neste site possvel encontrar inmeros aplicativos, tanto gratuitos como pagos. E voc pode facilmente publicar suas aplicaes nele. Ns, The Code Bakers, temos algumas aplicaes publicadas no Android Market. Voc pode publicar suas aplicaes no Android Market. As nicas exigncias so: 1. Sua aplicao tem que estar assinada com uma chave criptogrfica privada, cuja validade termine depois de 22 de Outubro de 2033; 2. Sua aplicao tem que definir os atributos: android:versionCode e android:versionName no elemento , de seu arquivo AndroidManifest.xml; 3. Sua aplicao tem que definir os atributos: android:icon e android:label no elemento do arquivo AndroidManifest.xml; 4. Voc tem que fornecer um cone de alta resoluo (512 x 512 pixels) independentemente do cone de lanamento da aplicao; 5. Voc tem que fornecer o apk da sua aplicao; 6. Voc tem que fornecer pelo menos dois screen shots, de 320 x 480 pixels; 7. Voc tem que ter uma conta no Android Market, pagando US$ 25,00 pelo registro (uma nica vez);

Pgina 6 de 84Todo o processo de publicao feito pela Internet e no h nenhum tempo de aprovao, ou seja, publicou, valeu! Sua aplicao pode ser gratuita ou paga. Se for paga, ento h necessidades posteriores (fora do escopo deste curso). Ambiente de desenvolvimento Para desenvolver aplicaes Android, podemos utilizar a IDE "eclipse", acrescentando um "plug-in" chamado ADT, e o framework do Android (Android SDK). O desenvolvimento feito em Java e, quando compilado, transformado em bytecode Dalvik. No necessrio possuir um dispositivo Android! Voc pode desenvolver e executar em um "emulador", que permite emular vrios tamanhos de tela e caractersticas de dispositivos mveis.

Configurao do ambiente Baixar o eclipse (ltima verso), s com Java; Baixar o Android SDK: o Windows: http://dl.google.com/android/android-sdk_r10-windows.zip o Mac: http://dl.google.com/android/android-sdk_r10-mac_x86.zip o Linux: http://dl.google.com/android/android-sdk_r10-linux_x86.tgz Baixar o plug-in ADT: configurar eclipse update site: "https://dl-ssl.google.com/android/eclipse/";

O SDK que voc est baixando apenas para configurar a instalao. Na segunda etapa, baixaremos atravs do eclipse as APIs necessrias. Descompacte-o em qualquer diretrio e anote este como a raiz do SDK. Baixe o eclipse e, dentro dele, configure o site de download indicado. Isto feito em Help / Install New Software / Add Site. Selecione todos os arquivos e baixe. Selecione o menu: Window / Preferences e selecione Android, para indicar ao eclipse onde est instalado o SDK. Indique o diretrio clicando no boto Browse. Baixando as plataformas especficas O ambiente composto por vrios outros componentes: Plataformas, exemplos, APIs e documentao. Para desenvolver, voc precisa uma plataforma, de modo a poder criar um AVD (Android Virtual Device), ou seja, um emulador. O mnimo necessrio : O SDK (voc j baixou e instalou); Platform (voc pode baixar pelo Android SDK and AVD Manager - menu: Window / SDK and AVD Manager do eclipse); Platform-tools;

Pgina 7 de 84

Podemos instalar vrias plataformas e APIs, dependendo da verso do Android e da API que desejamos.

Ns sempre instalamos a API level 7, pois corresponde verso do Android dos nossos celulares. Voc no precisa instalar todos os SDKs. Veja quais so as verses de Android e os API levels:

Pgina 8 de 84Laboratrio 1 Baixe e instale todo o seu ambiente de desenvolvimento.

Lio 3: Obtendo e analisando um projeto prontoEclipse Neste curso, temos que assumir que voc j possua alguns conhecimentos bsicos: Java e eclipse. Por que eclipse? Por que no o NetBeans? Por que no fazer "na mo"? Bem, ns achamos que "eclipse" a IDE mais utilizada pelos desenvolvedores. um chute, mas baseado na nossa experincia como professores e como membros de vrias comunidades Open Source. Em segundo lugar, o plugin ADT foi desenvolvido para "eclipse". Voc pode fazer tudo "na mo", sem IDE alguma, mas vai ser muito mais difcil. Se voc no conhece "eclipse", existe farto material na Internet, inclusive este curso gratuito: https://www.buzzero.com/Feedib/curso-online-JAVA-ECLIPSE.html

ANDROID VERSION x API LEVEL Existem muitas verses do Android, assim como de sua API de programao. Isto muito importante! Voc deve baixar a plataforma (via SDK and AVD Manager) correspondente ao pblico-alvo que voc quer atingir. Atualmente, a maioria dos aparelhos que temos visto usa Android 2.2 (e 2.3 em segundo lugar). Voc pode estabelecer os requisitos para sua aplicao atravs de trs atributos de seu arquivo AndroidManifest.xml: android:minSdkVersion: Qual o menor nvel de API que sua aplicao suporta. O default 1; Se sua aplicao exige um determinado nvel de API, voc deve informar isto; android:targetSdkVersion: Qual o nvel de API que sua aplicao prefere executar. E,m alguns casos, permite que sejam usados elementos do nvel desejado, ao invs do nvel mnimo; android:maxSdkVersion: Qual o nvel mximo de SDK que sua aplicao suporta;

E voc deve desenvolver em uma plataforma (AVD) compatvel com o nvel de API que voc espera. Veja as verses do Android e o nvel de API de cada uma, at agora:

Code name (no code name) (no code name) Cupcake Donut Eclair Eclair Eclair Froyo Gingerbread Gingerbread Honeycomb Honeycomb

Version 1.0 1.1 1.5 1.6 2.0 2.0.1 2.2.x 2.3 - 2.3.2 2.3.3 - 2.3.4 3.0 3.1

API level API level 1 API level 2 API level 3, NDK 1 API level 4, NDK 2 API level 5 API level 6 API level 8, NDK 4 API level 9, NDK 5 API level 10 API level 11 API level 12

2.1 (incl. 2.1-update 1) API level 7, NDK 3

Pgina 9 de 84Segundo nossas estatsticas, at agora (Junho 2011), as verses "Eclair" (2.1) e "Froyo" (2.2), so as mais utilizadas pelas pessoas que baixaram nossas aplicaes do Android Market.

Google Code e Subversion Ns mantemos todo o nosso cdigo-fonte dentro do "Google Code", que um repositrio de projetos Open Source. Ele fornece acesso a servidores de controle de verso (CVS, Subversion e Mercurial), que permitem aos usurios baixar e subir atualizaes. Ns optamos por utilizar sempre o Subversion, logo, para obter os projetos, necessrio que voc instale um novo plugin no "eclipse", chamado: "Subeclipse". A URL do update site : http://subclipse.tigris.org/update_1.6.x. Para instalar o plugin: 1. 2. 3. 4. 5. Clique no menu "Help / Install New Software..."; Clique no boto "Add..." para adicionar o update site; Informe a URL: "http://subclipse.tigris.org/update_1.6.x" e adicione; Feche a Janela e selecione o site recm-adicionado; Aps carregar, marque todos. Pode demorar um pouco. Certifique-se de aceitar a licena de uso;

Agora, voc pode fazer "checkout" de projetos armazenados no Servidor SVN (subversion). Para isto, veja qual a URL do servidor do projeto: 1. No site do Google Code do projeto, por exemplo, o BioMago, selecione a aba "Source"; 2. No conjunto de abas logo abaixo, deixe "Checkout" selecioando. Voc ver uma caixa com o ttulo: "Use this command to anonymously check out the latest project source code:", logo, anote a URL que est logo aps as palavras "svn checkout". No caso do BioMago, a URL : "http://biomago.googlecode.com/svn/trunk/"; Desta forma, voc ter a URL que deve ser informada ao configurar o "repositrio SVN" dentro do "eclipse". Se quiser saber mais sobre Controle de Verses e Subversion, recomendamos o site da Wikipedia: http://pt.wikipedia.org/wiki/Subversion.

Um projeto no eclipse Agora, sente-se em posio de ltus, respire fundo e murmure: "Ohmmmmmm", ou seja, relaxe e entre em meditao profunda, de modo a prestar ateno no que vamos dizer neste momento. Sabemos que voc est com pressa. Ns, tcnicos, sempre temos pressa em fazer tudo e no temos pacincia para ler manuais. Existe at um ditado famoso: "Quanto tudo mais falhar, leia o Manual!" Antes de voc fazer um projeto seu no Android, colocar no Celular e mostrar para a Me, o Pai, o Av, a Namorada ou o Namorado, melhor conhecer um projeto j existente. Voc tem que ver como estruturado, quais so as pastas, quais so os principais arquivos etc. Assim, quando chegar o momento de fazer seu prprio programa, evitar diversos problemas (e xingamentos). Tenha pacincia e v com calma. O laboratrio desta lio voc conseguir baixar um projeto, analisar o cdigo-fonte e executar no emulador. Agora, pode sar da posio de ltus! Vamos usar o Subversion para importar um projeto para a nossa workspace; Crie um repositrio: http://biomago.googlecode.com/svn/trunk:

Pgina 10 de 84 Selecione Window / Show View / SVN Repositories e clique com o boto direito, selecionando: New / Repository location. Depois, informe a URL acima;

Agora, vamos baixar o projeto para nossa Workspace: Selecione File / Import / SVN / Checkout projects from SVN, selecione o repositrio que voc acabou de criar, aceite os defaults, e importe o projeto;

A estrutura bem simples. Na pasta src temos todo o cdigo-fonte Java desenvolvido. Na pasta gen, temos uma classe muito importante: R.java! Nunca altere este arquivo! Ele contm identificadores para imagens, layouts, menus e strings da aplicao. Ele auto-gerado a cada novo recurso que adicionamos ao projeto. A pasta res contm os recursos em si: imagens (drawables), layouts (de activities), menus, estilos e strings. O arquivo AndroidManifest.xml a declarao da aplicao. Ele contm todas as configuraes necessrias para empacotar, distribuir e executar a aplicao. O arquivo default.properties contm as propriedades do projeto. A mais importante qual Plataforma est sendo usada para executar o projeto. Para mudar isto: selecione o projeto e, com o boto direito, selecione: Properties. Abra a parte Android e selecione a plataforma desejada. Ateno: Para executar esta aplicao, voc deve ter baixado a plataforma: Google Inc.:Google APIs:7. Porm, se voc baixou apenas o Android SDK 7, ento deve mudar a plataforma, conforme ensinado anteriormente. Executando a aplicao Sua aplicao ser executada DENTRO de um programa emulador de ambiente Android. Voc precisa criar um "AVD" (Android Virtual Device) para isto. claro que pode executar diretamente no seu Celular, o que contra-producente.

Criando um Android Virtual Device - AVD (Emulador) Para criar um AVD: 1. Clique no menu "Window" e selecione SDK and AVD Manager; 2. Clique em new; 3. Informe os dados desejados: o name: o nome do seu dispositivo virtual; o target: a verso de Android e o nvel de API que ele vai suportar; o SD-card (size): o tamanho em megabytes do SD Card; o Skin: a tela. Selecione "builtin". Recomendamos usar HVGA; 4. Clique em Create AVD e v tomar um caf... Demora MUUUUUUIIIIITO!

Pgina 11 de 84Voc s precisar criar AVDs uma nica vez, ou ento, sempre que desejar testar em um dispositivo diferente. Voc pode criar AVDs que simulem o seu Celular ou Tablet, ou ento o que voc espera encontrar no mercado. Porm, o Google sempre se refere a uma configurao chamada de "Baseline": Tela: HVGA (320x480) Se voc usar esta configurao, ser fcil adaptar seu programa para utilizar outras formas e tamanhos de tela. Guarde o nome do AVD que voc criou. Ele pode ser econtrado na pasta: Linux: ( uma pasta oculta): ~/.android/avd/[nome do avd]; Windows: DOCUMENTS_AND_SETTINGS/android/avd/[nome do avd];

Executando a aplicao Selecione seu projeto, na Janela "Project Explorer", e faa o seguinte: 1. Selecione: Run / Run Configurations; 2. Abra a aba target, e indique qual AVD o preferencial; 3. Depois, selecione apply e run;

Nas prximas vezes, s clicar no projeto e selecionar "Run as / Android Application"

Emulador

O emulador como se fosse um dispositivo mvel mesmo! Ele possui todas as teclas de um aparelho tpico, inclusive um teclado de hardware. Ele tem as teclas home, menu, back e magnify. A tecla menu desbloqueia o aparelho. Se quiser, pode at alternar entre em p (portrait) e deitado (landscape) usando CONTROL ESQUERDO + F11. Voc conhece o Android? No? Ento aproveite! Acione a tecla back, saia do aplicativo e veja o que o Android oferece a voc, Talvez voc esteja se perguntando: eu preciso ter um dispositivo Android para desenvolver? A resposta NO! Porm, ajuda bastante. Ns temos alguns smartphones Sony Xperia (um X10 e um X10 mini), alm de um Samsung S. Ah! E para depurar a mesma coisa, s que voc tem que acionar Debug e colocar breakpoints no cdigofonte.

Pgina 12 de 84Problemas de publicao do Blogger O Blogger, servio do Google que utilizamos para manter nossa comunidade, est apresentando problemas intermitentes de publicao. Logo, tivemos que dividir algumas lies, incluindo esta, em duas partes, de modo a diminuir o tamanho e o nmero de imagens. Laboratrio O laboratrio desta lio voc conseguir instalar o plugin subeclipse, conectar ao servidor SVN, baixar o projeto BioMago (http://code.google.com/p/biomago/), analisar o cdigo-fonte e conseguir executar o aplicativo.

Lio 4: Criando sua primeira aplicao AndroidEst na hora de criar um "Hello world" O aprendizado de toda linguagem de programao comea com um famoso programa, do tipo: "Hello World". Vamos fazer a mesma coisa! Siga as instrues a seguir, de modo a criar uma aplicao simples no "eclipse". 1) Para comear, vamos criar uma nova Workspace: Depois de cri-la, configure o Android SDK. Abra o menu: "window" / "preferences", selecione "Android" e aponte para a localizao do SDK. Se voc j tem uma workspace criada (a do projeto anterior), ento pode utiliz-la. Lembre-se de fechar o projeto "BioMago", para no confundir (selecione o projeto e, no menu de contexto, clique em "Close Project"). 2) Com a Workspace criada, hora de criar um projeto: Selecione o menu: "File / New / Android Project". Pode ser que a opo "Android Project" no aparea, neste caso, selecione: "Project...", escolhendo "Android" na tela seguinte. Preencha os campos conforme a lista abaixo: Informe o campo: "Project Name" com o nome do futuro projeto (no use espaos nem caracteres especiais); Deixe selecionados os campos: "Create new project in workspace" e "Use default location"; Marque o campo "Build target". Ns s temos dispositivos Android 2.1. Se quiser uma verso posterior, tem que baixar a plataforma. Role a tela para cima; Preencha o campo: "Application Name" com o nome que voc quer que as pessoas conheam o seu projeto; Preencha o campo: "Package Name" com o nome do pacote Java. Em Android este nome muito importante. Normalmente, usamos o nome de domnio ao contrrio, acrescido do nome do projeto; Marque o campo "Create Activity" e informe o nome da classe da Activity principal, que o assistente criar para ns (este um class name!); Informe o campo "Min SDK version" com a verso de SDK mnima necessria para que sua aplicao seja executada. Se estiver usando Android 2.1, ento use "7";

Pgina 13 de 84

Ao clicar "Next", note que oferecida a opo de criar um projeto de teste. Neste momento, deixe desmarcada e clique "finish"; Aps algum tempo, seu projeto estar criado. Selecione seu projeto, abra suas propriedades e selecione "Android". Voc ver que a API desejada estar marcada. 3) Configure o AVD e execute o projeto no emulador: Para executar o projeto, voc deve ter criado um AVD (Android Virtual Device). No curso, h instrues sobre como fazer isto. Selecione seu projeto, escolha "Run Configurations". Marque "Android Application", e clique no boto "new" da caixa de dilogo. Selecione o AVD "target", aponte o nome do projeto, depois pressione: "Apply" e "Run". Da prxima vez, no ter que fazer isto.

Ao aparecer o Emulator com a "cara de um celular" na tela, pressione o boto "menu" para desbloque-lo (se aparecer um dilogo de espera, selecione o boto "Wait"). Examinando o cdigo-fonte gerado Pera... Ns no escrevemos nada! Como pode haver cdigo-fonte? O plug-in "ADT" gera uma aplicao "Hello World" automaticamente, logo, todo o cdigo-fonte e configuraes necessrios j esto prontos.

Pgina 14 de 84Vamos examinar a aplicao. Para comear, ela j possui uma activity com um layout criado, alm de recursos, como strings e cones: Classe da Activity "Principal.java", dentro de "src" e dentro do pacote Java que voc informou. Layout "main.xml" (os layouts e todos os arquivos XML do Android devem ter nomes em minsculas), dentro de "res/layout". cone "icon.png", dentro de cada uma das trs pastas "drawable", dentro de "res". Dois strings "hello" e "app_name", criados dentro de um arquivo "strings.xml", dentro da pasta: "res/values". Uma classe "R.java", criada automaticamente dentro da pasta: 'src/gen". Um arquivo "AndroidManifest.xml", criado na raiz do projeto. Um arquivo "default.properties", contendo as propriedades do projeto. Um arquivo "proguard.cfg", criado na raiz do projeto - ProGuard um ofuscador de cdigo, que "embaralha" o byte code da aplicao, dificultando a engenharia reversa. Este um arquivo que configura esta ferramenta. Vamos examinar o cdigo-fonte da nossa Activity:1. package br.com.thecodebakers.primeiro; 2. 3. import android.app.Activity; 4. import android.os.Bundle; 5. 6. public class Principal extends Activity { 7. /** Called when the activity is first created. */ 8. @Override 9. public void onCreate(Bundle savedInstanceState) { 10. super.onCreate(savedInstanceState); 11. setContentView(R.layout.main); 12. } 13. }

O mtodo "onCreate" invocado quando a Activity criada (no existe na pilha). A chamada do mtodo "setContentView()" indica qual o layout que deve ser exibido na tela que a Activity vai exibir.

Ciclo de vida de activities

Quando uma activity est em estado "running", est visvel, com todo seu estado preservado e pode receber eventos, seja do sistema ou de suas Views.

Pgina 15 de 84Se outra atividade ou dilogo receber o foco, a activity passa para o estado "Paused". Ela continua "visvel" e retm seu estado. Ela pode ser destruda pelo sistema, caso haja extrema necessidade de memria e recursos. Neste estado, ideal que as animaes sejam pausadas e o estado seja salvo. Outra atividade recebeu o foco e o controle, ocultando totalmente a primeira, que passa a estar em estado "Stopped". Ela poder ser desativada pelo sistema, caso haja necessidade de memria. Ela continuar a reter seu estado. H uma nuance de diferena entre o estado "Paused" e o "Stopped", pois ambos partem do pressuposto que a activity foi "oculta". A nuance a visibilidade. Uma activity em estado "Paused" no est totalmente oculta, um exemplo disto quando uma caixa de dilogo aberta (ou uma janela de notificao). J uma activity em estado "Stopped" foi completamente ocultada por outra Activity, por exemplo, neste comando:1. public void clicouLinear(View view) { 2. Intent i = new Intent (this.getApplicationContext(), LinearDemo.class); 3. this.startActivity(i); 4. }

Ao executar a linha com a chamada: "startActivity()", a atividade a qual este cdigo-fonte pertence passar a ficar em estado "Stopped", pois acaba de iniciar outra Activity. O Estado "Killed", na verdade no existe. A Activity fica nesse estado somente por uns poucos momentos, enquanto seu mtodo "onDestroy()" est sendo executado. A no ser em casos extremamente especficos, ns no encerramos manualmente as activities, deixando esta tarefa a cargo do sistema. Para cada transio de estado, um mtodo "callback" da classe Activity invocado. Voc pode ou no sobrescrev-los, dependendo da sua necessidade. Normalmente, sobrescrevemos apenas o mtodo "onCreate()", mas existem os mtodos: onCreate quando a actitivy est para se tornar "Running". onStart a activity est para se tornar visvel. onRestart a activity estava "Stopped" e foi ativada novamente. onResume a activity vai comear a interagir com o usurio, recebendo input e eventos. onPause a activity est parcialmente oculta. Neste mtodo, voc pode fazer "commit" de alteraes ou parar animaes, de modo a poupar recursos do sistema. onStop a activity est totalmente oculta por outra activity e esta funo chamada. onDestroy a activity est para ser eliminada da memria. Existem outros "callbacks" importantes, como: "onBackPressed()", invocado quando a tecla "back" do dispositivo acionada.

Arquivo "AndroidManifest.xml" Abra o arquivo "AndroidManifest.xml", dentro da raiz do projeto. Note que ele possui diversas informaes sobre seu projeto. Para comear, dentro do TAG , ele possui alguns atributos interessantes: package: muito importante! Sua aplicao conhecida pelo nome do pacote;

Pgina 16 de 84 android:versionCode e android:versionName: nmero da verso da aplicao. Primeiro em forma numrica e depois em forma String;

Dentro do tag temos atributos importantes: android:icon: identificao do cone da aplicao, de acordo com os nomes de imagens dentro da classe "R"; android:label: ttulo da aplicao. Todas as activities que no especificarem este atributo, herdaro o valor deste;

Ainda dentro do tag , ns inserimos os tags de nossas activities. O Assistente do ADT faz isto para ns, porm, se inserirmos mais classes de activities, temos que inserir tags manualmente: android:name: o nome da classe (ser concatenado ao string especificado no atributo "package", do tag ); Se a activity for utilizada para lanar a aplicao, ento temos que colocar um tag com dois subtags. Veja a activity principal ("main") para ver como se faz;

Existe muito mais para se saber sobre o arquivo "AndroidManifest.xml". Sugerimos que voc leia os manifestos dos nossos projetos ou ento entre no site do Android (http://developer.android.com/guide/topics/manifest/manifest-intro.html).

Lio 5: Layout e interface com usurioCriao de layout Um Layout um arquivo XML que define quais ViewGroups existem e quais Views elas contm. Pontos importantes: Toda activity deve possuir pelo menos uma View para interagir com o usurio; Normalmente, usamos um arquivo de layout, contendo um ViewGroup e algumas Views; Todos os elementos de layout so referenciados na classe R.java; Baixe o projeto http://layout-exercise.googlecode.com/svn/trunk/: 1. No eclipse, abra a view: SVN repositories; 2. Adicione o repositrio acima; 3. Expanda o repositrio; 4. Selecione a pasta Layouts e faa Checkout; Examine o arquivo res/layout/main.xml:1. 6. 13. 20. 27. 34. 41. 48. 55.

Todo layout um arquivo ANDROID XML, cujo nome deve comear com letras minsculas, e deve residir na pasta: res/layout. Ele deve possuir um e somente um ViewGroup principal, que, neste caso, o LinearLayout. O LinearLayout coloca tudo em sequncia. Execute a aplicao e selecione LinearLayout:

Pgina 18 de 84

Todas as views filhas so organizadas em sequncia, enquando couberem na mesma linha. Voltando ao arquivo main.xml, note que temos 7 Views dentro do nosso ViewGroup principal e todas so do tipo TextView, Uma TextView serve para exibir textos. Agora, abra o seu primeiro projeto, cujo layout mais simples, e veja o arquivo res/main.xml:1. 2. 7. 12.

Temos uma nica TextView, com trs propriedades informadas: android:layout_width Qual a largura que a View prefere ter, dentro de seu parent, que, neste caso o ViewGroup LinearLayout. android:layout_height Qual a altura que a View prefere ter dentro de seu parent. android:text Qual o texto que ser exibido dentro da View. As propriedades android:layout_width e android:layout_height so muito importantes e so obrigatrias. Ns podemos especificar trs valores: FILL_PARENT A view quer ser to grande naquela dimenso (altura ou largura) como o seu parent. Ela encher o ViewGroup; WRAP_CONTENT A view quer ser grande o suficiente para conter o texto (ou imagem) atribudo; Unidades Podem ser dp - density independent values, sp - scale independent, pt - 1/72 de polegada ou px -pixels; No nosso caso, estamos estabelecento que a TextView ser da largura de seu parent e ter a altura suficiente para conter o texto que atribumos (este o padro para TextView). Na propriedade android:text especificamos um string resource. Nossa aplicao pode ter vrios tipos de recursos (resources): layouts, estilos, strings, imagens etc; os nomes dos recursos ficam compilados em uma tabela binria, chamada de .arsc. Para identificar o recurso, usamos um nmero inteiro, que o seu ndice na tabela. Sempre que criamos alguma coisa na pasta res, o ADT altera a classe R.java, dentro da pasta gen. Ele cria uma constante dentro da inner class apropriada. Eis o R.java do nosso primeiro projeto:1. package br.com.thecodebakers.primeiro; 2. 3. public final class R { 4. public static final class attr { 5. } 6. public static final class drawable { 7. public static final int icon=0x7f020000; 8. } 9. public static final class layout {

Pgina 19 de 8410. 11. 12. 13. 14. 15. 16. } public static final int main=0x7f030000; } public static final class string { public static final int app_name=0x7f040001; public static final int hello=0x7f040000; }

Temos trs inner classes que so constantes dentro desta classe: attr, que representa atributos (no estamos usando), drawable, que representa imagens, layout, que representa layouts de views, e string, que representa recursos de strings. Outro muito importante o id, que representa os identificadores que criamos dentro de nossos layouts (veja a classe R.java do projeto Layouts). No layout de nossa activity (primeiro projeto), dissemos o seguinte: android:text="@string/hello" Logo, o texto que ser exibido o que est contido dentro do recurso de strings chamado hello. E onde fica ele? Dentro de um arquivo XML, que fica na pasta res:1. 2. 3. Hello World, Principal! 4. Primeiro Projeto 5.

Por que isto? para facilitar a localizao (L10N) de nossa aplicao. Finalmente, temos tambm os ids. Abra o projeto BioMago, que importamos na primeira aula. Execute o programa e cadastre um registro. Note que, ao cadastrar, o BioMago tem que pegar o nome e a data de nascimento. A atividade que faz o cadastramento a Edicao.java e seu layout R.layout.edicao, ou o arquivo: edicao.xml. Vamos primeiramente ver o arquivo de layout:1. 5. 6. 14. 21. 22.

Pgina 20 de 8430. 31. 39. 40. 50. 60.

Neste projeto, usamos outro tipo de ViewGroup, que o RelativeLayout. Note a View EditText, que est em negrito:1.

O que isso? A propriedade id permite que nos referenciamos a uma View dentro do cdigo-fonte Java, podendo obter o valor que o usurio digitou, por exemplo. O que informamos dentro da propriedade foi @+id/txtNome, que significa: se no existir o id txtNome, crie-o. Uma entrada foi criada dentro de R.java:view plaincopy to clipboardprint?

1. public final class R { 2. public static final class attr { 3. ... 4. } 5. public static final class drawable { 6. ... 7. } 8. public static final class id { 9. ... 10. public static final int txtNome=0x7f07000a; 11. ... 12. } 13. public static final class layout { 14. ... 15. }

Pgina 21 de 8416. 17. 18. 19. 20. 21. 22. 23. 24. 25. } public static final class menu { ... } public static final class string { ... } public static final class style { ... }

Ou seja, criamos um novo identificador de View dentro de nosso projeto, e podemos us-lo para nos referenciar EditText que criamos. Para obter o nome do usurio, o cdigo da Activity tem que declarar uma varivel do tipo: android.widget.EditText:1. public class Edicao extends Activity { 2. ... 3. private EditText txtNome; 4. 5. public void salvar (View view) { 6. txtNome = (EditText) this.findViewById(R.id.txtNome); 7. Elemento elemento = new Elemento(); 8. elemento.setNome(txtNome.getText().toString()); 9.

Assim, podemos acessar a View e pegar o nome que o usurio informou. A EditText possui alguns atributos e propriedades muito interessantes, por exemplo, o atributo XML android:inputType nos permite determinar qual tipo de dado o usurio pode digitar, e o atributo: android:password substitui o valor digitado por um crculo, como se fosse um campo de senha. Podemos pegar o contedo de uma EditText com o mtodo getText(), mas note que ele somente devolve um Editable. Se quisermos pegar o string, temos que usar o mtodo: getText().toString(). E, se quisermos converter em um nmero: Long.valueOf(txt.getText().toString()); Se informarmos numberSigned no atributo XML android:inputType, nossa EditText somente aceitar a digitaco de algarismos, com ou sem sinal. Para concluir esta parte, precisamos ter uma maneira de reagir aos eventos provocados pelo usurio, como o clique de um boto, por exemplo. Todo elemento Clicvel possui o atributo XML: android:onClick, que nos permite nomear um mtodo de callback dentro da classe da Activity. Por exemplo, abra o layout main,xml e a Activity Principal.java, do projeto Layouts:1.

1. public void clicouLinear(View view) { 2. Intent i = new Intent (this.getApplicationContext(), LinearDemo.class); 3. this.startActivity(i); 4. }

Repare que no layout, a TextView est apontando o android:onClick para clicouLinear, e que na classe da Activity, temos um mtodo com a assinatura: public void clicouLinear (View view). O nome do mtodo tem que ser o mesmo informado no atributo, e a assinatura tem que ter void como retorno, e uma instncia de

Pgina 22 de 84View como argumento. Este mtodo ser invocado quando aquela TextView for clicada pelo usurio. E o que o mtodo faz? Ele invoca outra Activity! Ele cria uma instncia de android.content.Intent, que serve para determinar o que ser executado. Pode ser uma Actrivity do projeto ou um aplicativo externo, como uma pgina Web. Neste caso, estamos criando um Intent que chama a classe da atividade LinearDemo. O mtodo startActivity() inicia a outra atividade. Tambm poderamos mostrar uma caixa de dilogo, uma mensagem, tipo JOptionPane, s que usamos outra classe para isto:1. 2. 3. 4. 5. 6. 7. 8. Resources res = this.getResources(); new AlertDialog.Builder(this) .setMessage(res.getString(R.string.erro_data_posterior)) .setNeutralButton(res.getString(R.string.lblOK), new DialogInterface.OnClickList ener() { public void onClick(DialogInterface dialog, int which) { } }) .show();

Para comear, apontamos para os recursos da aplicao usando a classe android.content.res.Resources. Ela serve para obtermos recursos, por exemplo strings, dentro do cdigo-fonte Java. Nos arquivos XML usamos apenas @string/, mas no cdigo Java precisamos usar: .getString(identificador). Lembrando que todo resource string est possui seu identificador dentro da classe R.java. Depois, criamos uma instncia de android.app.AlertDialog.Builder e outra de AlertDialog; Poderamos reescrever este cdigo-fonte assim:1. AlertDialog.Builder construtor = new AlertDialog.Builder(this); 2. construtor.setMessage(res.getString(R.string.erro_data_posterior)) 3. .setPositiveButton("Ok", new DialogInterface.OnClickListener() { 4. public void onClick(DialogInterface dialog, int id) { 5. // comandos... 6. } 7. }); 8. AlertDialog alert = construtor.create(); 9. alert.show();

Dois pontos importantes: 1 Todos os dilogos so MODELESS; 2 Use sempre string resources e evite literais; Agora, voc tem todos os elementos para fazer o laboratrio 2.

Laboratrio 2 Vamos criar uma aplicao que interage com o usurio. Ela receber um nmero e far sua fatorao (decomposio em nmeros primos), exibindo um dilogo que mostrar o resultado. 1 Crie um novo projeto Android, conforme fizemos no Laboratrio 1; 2

Pgina 23 de 84Edite o layout main.xml e acrescente:a Uma TextView contendo o rtulo: Nmero (dever estar dentro de um string resource); b Uma EditView que receba o nmero digitado (deve apenas receber nmeros e deve ter id); c Um boto Button, que invoque o callback para fazer e mostrar a fatorao;

3 O callback dever decompor o nmero informado em fatores primos, e usar um dilogo para mostrar o resultado; O crivo de Eratstenes Para decompor em fatores primos, necessrio, primeiramente, obter uma lista de nmeros primos! Segundo a Wikipedia: O Crivo de Eratstenes um algoritmo e um mtodo simples e prtico para encontrar nmeros primos at um certo valor limite. Segundo a tradio, foi criado pelo matemtico grego Eratstenes (c. 285-194 a.C.), o terceiro bibliotecrio-chefe da Biblioteca de Alexandria. Felizmente, para voc, estvamos de bom humor e providenciamos uma implementao do Crivo, que pode ser encontrada ao final da lio. O resultado de sua aplicao deve ser como a figura:

Implementao do Crivo1. package br.nom.sampaio.cleuton.factorwiz; 2. import java.util.ArrayList; 3. import java.util.Iterator; 4. import java.util.List; 5. import android.view.View; 6. 7. public class FatoracaoBO { 8. private static List primos; 9. private static long sinalUltimo = 1; 10. public static String fatorar (long numero) { 11. String resultado = null; 12. 13. if (numero == 0) { 14. resultado = "0"; 15. } 16. else { 17. if (numero > 0 && numero < 3) { 18. resultado = Long.toString(numero); 19. } 20. else {

Pgina 24 de 8421. 22. 23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 34. 35. 36. 37. 38. 39. 40. 41. 42. 43. 44. 45. 46. 47. 48. 49. 50. 51. 52. 53. 54. 55. 56. 57. 58. 59. 60. 61. 62. 63. 64. 65. 66. 67. 68. 69. 70. 71. 72. 73. 74. 75. 76. 77. 78. 79. 80. 81. 82. 83. 84. 85. 86. Long valor = numero; if (numero < 0) { sinalUltimo = -1; valor = numero * (-1); } primos = crivo(valor); resultado = calcular(valor); } } return resultado; } private static String calcular(Long numero) { String resultado = ""; Long valor = numero; Iterator it = primos.iterator(); Long primo = it.next(); while (valor > 1) { long resto = valor % primo; if (resto > 0) { primo = it.next(); } else { if (resultado.length() > 0) { resultado += "x"; } valor = valor / primo; if (valor == 1) { primo = primo * sinalUltimo; } resultado += Long.toString(primo); } } return resultado; } private static List crivo (long n) { List lprimos = new ArrayList(); for (long x = 2; x CREATE TABLE aluno (nome VARCHAR(100), email VARCHAR(100)); Para verificar se a tabela foi criada, execute o seguinte comando: sqlite> .tables Nas prximas lies, abordaremos o SQLite no Android com exemplos e exerccios.

Pgina 50 de 84

Lio 2: Conhecendo a API SQLite para AndroidComo j dito na lio 1, o Android j tem suporte nativo ao banco de dados SQLite. Nesta lio pretendemos detalhar a API com exemplos prticos e didticos. Na primeira lio, criamos o banco de dados via shell ou usando a ferramenta SqliteStudio, o caminho poderia ser especificado no momento da criao do database. No ambiente Android, o banco fica armazenado num path especifico, conforme o nome do pacote da sua aplicao, conforme a seguinte estrutura de diretrios: /data/data/pacote.sua.app.android/databases. Isso significa que o banco de dados visvel apenas para a sua aplicao. Existe uma forma de acessar os bancos criados por outras aplicaes, atravs da API Content Providers, ela permite o compartilhamento dos dados de outras aplicaes. No abordaremos o acesso via ContentProviders nesse curso. Mas como eu crio o banco de dados no meu device, Tio? Muita calma nessa hora jovem mancebo! Na primeira lio, aprendemos como criar o banco de dados SQLite de formal manual (shell ou outra ferramenta), j imaginou toda vez que voc criar um banco de dados para a sua app Android ter que copiar o arquivo .db manualmente para a estrutura de diretrios citada acima. Imagina atualizar o banco em milhares de dispositivos, tarefa rdua n. Vimos ento que podemos criar o banco de dados no Android de duas maneiras: manualmente, copiando o .db gerado para o diretrio data/data/pacote.sua.app.android/databases, ou via programao. Nessa lio pretendemos abordar a criao de banco via programao, atravs das classes disponibilizadas na API do Android. Criando o banco de dados via programao Para criar o banco via programao necessrio o entendimento da API do Android, que disponiliza um conjunto de classes para acessar o SQLite. Inicialmente devemos criar uma classe que estenda a classe SQLiteOpenHelper, essa classe responsvel por gerenciar a criao e atualizao do banco de dados no Android. Abaixo vamos demonstrar um exemplo prtico baseado na aplicao HPP (Hercules Password Protector), onde criamos uma classe chamada DBHelper, que estende a classe SQLiteOpenHelper, consequentemente herda os seus mtodos: onCreate (cria o banco no momento de sua instalao) e onUpgrade (atualiza o banco). Segue a implementao completa da classe citada acima:1. public 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. ; 14. 15. 16. 17. 18. 19. 20. 21. 22. class DBHelper extends SQLiteOpenHelper { private static final String DATABASE_NAME = "hppfree.db"; public static final int DATABASE_VERSION = 1; private static final String TABLE_NAME = "elemento"; public DBHelper(Context context) { super(context, DATABASE_NAME, null, DATABASE_VERSION); } @Override public void onCreate(SQLiteDatabase db) { db.execSQL("CREATE TABLE " + TABLE_NAME + "(uid TEXT, textoSecreto BLOB)") } @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { if ((newVersion - oldVersion) > 2) { db.execSQL("DROP TABLE IF EXISTS " + TABLE_NAME); onCreate(db); } }

Pgina 51 de 8423. 24. }

Bem, j mostramos a classe que vai gerenciar o banco, agora voc precisa entender como usar esse banco nas suas classes DAO . Primeiramente, na sua classe que far papel de DAO, ou algo parecido, voc deve criar uma instancia da classe DBHelper (criada anteriormente), e uma instancia da classe SQLiteDatabase. Essa classe disponibiliza mtodos para gerenciar um banco de dados SQLite. Ela possui mtodos para incluir, alterar, e executar outros comandos SQL. Repare no exemplo retirado do aplicativo HPP, criamos a classe DAO e nessa classe instanciamos a classe SQLiteDatabase, como tambm a classe DBHelper.1. public class DBAdapter implements IDBAdapter { 2. 3. private SQLiteDatabase db = null; 4. private DBHelper dbHelper= null; 5. 6. public DBAdapter(Context context) { 7. dbHelper = new DBHelper(context); 8. } 9. 10. public long insert(String uuid, byte[] lob) throws SQLException{ 11. this.db = dbHelper.getWritableDatabase(); 12. ContentValues cv = new ContentValues(); 13. cv.put("uid", uuid); 14. cv.put("textoSecreto", lob); 15. long retorno = db.insert("elemento", null, cv); 16. db.close(); 17. return retorno; 18. } 19.

Ainda falando do trecho de cdigo acima, repare que no construtor do DAO criamos uma instancia do DBHelper e passamos como parmetro para a classe Helper (SQLiteOpenHelper) o contexto da aplicao:1. public DBAdapter(Context context) { 2. dbHelper = new DBHelper(context); 3. }

Acredito que vendo uma implementao pronta muitas dvidas iniciais sero sanadas rapidamente. Mas como ficou o acesso e o insert dos dados? Para manipulao dos dados, leitura ou gravao, necessrio entender que existem dois mtodos da classe SQLiteOpenHelper, so eles: - getReadableDatabase() : cria ou abre um banco para leitura. - getWritableDatabase(): cria ou abre um banco para leitura e gravao Como vamos gravar uma informao na base dados, utilizamos o mtodo getWritableDatabase.1. public long insert(String uuid, byte[] lob) throws SQLException{ 2. this.db = dbHelper.getWritableDatabase(); 3. ContentValues cv = new ContentValues(); 4. cv.put("uid", uuid); 5. cv.put("textoSecreto", lob); 6. long retorno = db.insert("elemento", null, cv); 7. db.close(); 8. return retorno; 9. }

Pgina 52 de 84

Repare que nesse caso necessrio usar a classe ContentValues, que representa um conjunto de valores dos comandos SQL. Outro ponto importante do mtodo insert chamada db.insert, que recebe o nome da tabela e o ContentValues como parmetro, e insere na base de dados. A diferena do mtodo update para o insert que ele recebe como parmetro uma string contendo o campo que representa a clusula Where, e os argumentos representados pelo sinal ?, conforme a seguir:1. db.update("elemento", cv, "uid = ?", new String[]{ uid });

Todas as consultas retornam um tipo de objeto chamado Cursor, conforme o seguinte exemplo:1. Cursor cursor = db.query("elemento", columns,null, null, null, null, null);

Onde os parmetros da query so: nome da tabela, array com os nomes das colunas, clusula Where, argumentos do where e as clusulas groupby, having e order by. O mtodo para listar os dados ficou assim:1. ... 2. Cursor cursor = db.query("elemento", columns,null, null, null, null, null); 3. cursor.moveToFirst(); 4. 5. while(!cursor.isAfterLast()){ 6. Elemento elemento = new Elemento(); 7. elemento.setUUID(cursor.getString(0)); 8. elemento.setLob(cursor.getBlob(1)); 9. 10. lista.add(elemento); 11. cursor.moveToNext(); 12. } 13. ...

Nas prximas lies iniciaremos um exerccio prtico com o SQLite.

Lio 3 - Criando um CRUD no SQLiteNas duas primeiras lies explicamos como funciona o SQLite como funciona a API do Android. Nesta lio vamos fazer um exerccio para fixar o contedo dado at o momento. Para agilizar um pouco o processo de criao de aplicao, vamos utilizar como fonte de consulta o cdigo do projeto HPP (Hercules Password Protector) disponvel no Google Code. No exerccio criaremos uma app que far o cadastro de um curso, e mostrar o resultado de uma busca na tela. Para facilitar o entendimento do exerccio criamos uma tela com dois campos: nome e descrio do curso, e depois botes: salvar e pesquisar, conforme abaixo:

Pgina 53 de 84

Em seguida, criaremos a Activity para suportar os mtodos da tela acima:1. public class CursoSQLite extends Activity { 2. 3. private ICursoAdapter cursoAdappter ; 4. private String id; 5. 6. private EditText nome; 7. private EditText descricao; 8. private Elemento elemento; 9. 10. @Override 11. public void onCreate(Bundle savedInstanceState) { 12. super.onCreate(savedInstanceState); 13. setContentView(R.layout.main); 14. cursoAdappter = new CursoAdapter(this); 15. } 16. 17. public void salvar(View view) { 18. 19. nome = (EditText) findViewById(R.id.txtNome); 20. descricao = (EditText) findViewById(R.id.txtDescricao); 21. elemento = buscarPorNome(); 22. 23. elemento.setNome(nome.getText().toString()); 24. elemento.setDescricao(descricao.getText().toString()); 25. 26. //verfica se ja existe o valor 27. if (elemento == null) 28. { 29. cursoAdappter.incluir(elemento); 30. }else{ 31. cursoAdappter.alterar(elemento); 32. } 33. 34. } 35. 36. public void pesquisar (View view) { 37. nome = (EditText) findViewById(R.id.txtNome); 38. descricao = (EditText) findViewById(R.id.txtDescricao); 39. Elemento el = buscarPorNome();

Pgina 54 de 8440. 41. 42. 43. 44. 45. 46. 47. 48. 49. 50. 51. } nome.setText(el.getNome()); descricao.setText(el.getDescricao()); this.id = el.getId().toString(); } public Elemento buscarPorNome() { elemento = cursoAdappter.buscarPorNome(nome.getText().toString()); return elemento; }

Os passos citados acima foram abordados com mais detalhes no nosso curso de programao ANDROID . Agora vamos para a parte que importa, que desenvolver um Adapter para acessar o banco de dados e executar as operaes de CRUD. Conforme dito nas lies anteriores! Precisamos criar uma classe Helper que herda de SQLiteOpenHelper. Lembre-se que essa classe responsvel pela criao(mtodo onCreate) e atualizao(mtodo onUpgrade) do banco. Voc pode copiar a classe desenvolvida para o projeto HPP, chamada DBHelper, ela estende a classe SQLiteOpenHelper. Segue a classe criada para o projeto curso SQLite:1. public class CursoDBHelper extends SQLiteOpenHelper { 2. 3. private static final String DATABASE_NAME = "curso.db"; 4. public static final int DATABASE_VERSION = 1; 5. private static final String TABLE_NAME = "elemento"; 6. 7. public CursoDBHelper(Context context) { 8. super(context, DATABASE_NAME, null, DATABASE_VERSION); 9. } 10. 11. @Override 12. public void onCreate(SQLiteDatabase db) { 13. db.execSQL("CREATE TABLE " + TABLE_NAME + "(nome TEXT, descricao TEXT)"); 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. } } @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { if ((newVersion - oldVersion) > 2) { db.execSQL("DROP TABLE IF EXISTS " + TABLE_NAME); onCreate(db); } }

Repare que o nome do banco foi definido na varivel DATABASE_NAME (curso.db) , a verso na DATABASE_VERSION e o nome da tabela em TABLE_NAME. Agora vamos criar a classe de acesso aos dados (famoso DAO) e as variveis para acesso s classes CursoHelper e SQLiteDatabase, conforme a seguir:1. public class CursoAdapter { 2. private SQLiteDatabase db = null; 3. private CursoDBHelper cursoDBHelper= null;

Pgina 55 de 844. 5. 6. 7. } public CursoAdapter(Context context) { dbHelper = new CursoDBHelper(context); }

Note que no construtor da classe CursoAdapter recebe como parmetro o Context, que deve ser repassado para a classe CursoDBHelper. Em seguida, vamos criar os mtodos para incluso, alterao, excluso:1. public long incluir(Elemento elemento) throws SQLException{ 2. this.db = cursoDBHelper.getWritableDatabase(); 3. ContentValues cv = new ContentValues(); 4. cv.put("nome", elemento.getNome()); 5. cv.put("descricao", elemento.getDescricao()); 6. long retorno = db.insert("elemento", null, cv); 7. db.close(); 8. Log.i(TAG, "Registro criado com sucesso."); 9. return retorno; 10. 11. } 12. 13. public int alterar (Elemento elemento) throws SQLException{ 14. this.db = cursoDBHelper.getWritableDatabase(); 15. ContentValues cv = new ContentValues(); 16. cv.put("id", elemento.getId()); 17. cv.put("nome", elemento.getNome()); 18. cv.put("descricao", elemento.getDescricao()); 19. int retorno = db.update("elemento", cv, "id = ?", new String[]{ elemento.ge tId().toString() }); 20. db.close(); 21. Log.i(TAG, "Registro atualizado com sucesso."); 22. return retorno; 23. 24. } 25. 26. 27. public int excluir(String id)throws SQLException{ 28. Log.i(TAG, "Esse voce deve implementar..."); 29. }

Na lio 2 j explicamos o que significa o ContentValues e o mtodo getWritableDatabase. Ao executar o mtodo query de SQLiteDatabase, a consulta retorna um objeto chamado Cursor, esse objeto responsvel pelo acesso ao resultado da consulta.1. Cursor c = db.query("elemento", columns,"nome = ?", args, null, null, "nome");

Repare que o mtodo query recebe algumas informaes como parmetros, so eles: String nome tabela String[] colunas tabela String clausula where String[] parametros Where String clausula groupBy String clasusula having String orderBy (na consulta acima estamos ordenando o resultado pelo nome do curso).

Segue a listagem completa da consulta pelo nome do curso:

Pgina 56 de 841. public Elemento buscarPorNome(String id){ 2. Elemento curso; 3. String[] columns = new String[]{"id", "nome", "descricao"}; 4. String[] args = new String[]{id}; 5. Cursor c = db.query("elemento", columns,"nome = ?", args, null, null, "nome" ); 6. 7. c.moveToFirst(); 8. curso = new Elemento(); 9. curso.setId((int)c.getLong(0)); 10. curso.setNome(c.getString(1)); 11. curso.setDescricao(c.getString(2)); 12. return curso; 13. }

O cdigo fonte desse projeto foi disponibilizado para download no google code. Se voc quiser pode baixar pelo QR Code:

O exerccio dessa lio criar o boto excluir com o cdigo necessrio para excluir o registro da base de dados.

Gerenciando o SQLite atravs do ADB (Android Debug Bridge)Mas o que diabos o ADB? uma ferramenta muita importante para quem quer trabalhar com desenvolvimento Android, que vem junto com o SDK Android. Com a ferramenta ADB voc consegue executar diversas operaes (instalar apps, montar o carto de memria, e at gerenciar os bancos de dados das aplicaes), via linha de comando no emulador. Para trabalhar com o SQLite no ADB, siga os seguintes passos: Antes de qualquer coisa, no seu dispositivo, ative a "Depurao via USB". Abra uma janela de terminal(Linux) ou cmd (no caso do Windows); V para o diretrio onde est instalado o seu SDK do Android, exemplo: cd /caminho_diretorio_do_sdk/platform-tools/ Altere o path caminho_diretorio_do_sdk para o caminho do SDK do Android da sua mquina. Agora s executar o ADB, conforme abaixo: ./adb shell Iniciei mas recebi um erro no terminal:

Pgina 57 de 84> ~/android-sdk-linux_x86/platform-tools$ ./adb shell * daemon not running. starting it now on port 5037 * * daemon started successfully * error: device not found Isso normal!!! Voc tem um dispositivo acoplado na USB da sua mquina ou emulador est executando nesse momento? Seno, execute o emulador e rode o comando novamente. Mas tio eu no sei criar um emulador, ento leia o seguinte artigo e aprenda como fazer . Sugerimos tambm a leitura do artigo Desenvolvendo diretamente no seu aparelho, ele vai abrir um pouco mais a sua mente, vai por mim. Ainda no conseguiu criar uma instancia do emulador (AVD) no Eclipse, ento faz na mo vai. Entra numa janela de terminal, v para o diretrio caminho_diretorio_do_sdk/tools e execute seguinte comando shell: ./android create avd -n curso_sqlite2.1 -t 2 Aps executar o comando acima o seu AVD foi criado, conforme a seguir: Android 2.1-update1 is a basic Android platform. Do you wish to create a custom hardware profile [no] Created AVD 'curso_sqlite2.1' based on Android 2.1-update1, with the following hardware config: hw.lcd.density=240 vm.heapSize=24 Para saber qual target usar, voc pode listar todas as targets instaladas na sua mquina e escolher uma opo, no meu caso, eu escolhi a verso 2.1 do Android. Para listar as targets execute o seguinte comando: android list targets

Agora vamos acessar o seu banco de dados atravs do ADB: ./adb shell Lembre-se que o ADB fica no diretrio PATH_SEU_ANDROID_SDK/platform-tools, e execute o seguinte comando:

Pgina 58 de 84

./adb -s emulator-5554 shell Para maiores informaes acessar a documentao do ADB x SQLite Uma vez conectado ao emulador, digite o comando sqlite3. Ao invocar esse comando, possvel especificar o caminho do banco de dados que se deseja explorar. Aps se conectar no emulador, acesse o SQLite especificando o pacote do banco do curso: # sqlite3 /data/data/br.com.thecodebakers.cursosqlite/databases/curso SQLite version 3.5.9 Enter ".help" for instructions sqlite> Voc acabou de acessar o banco SQLite via ADB! Agora possvel criar suas tabelas e executar suas operaes de CRUD no seu banco de dados. Segue alguns comandos que podem te ajuda no dia a dia: sqlite> .tables Lista todas as tabelas do seu banco sqlite>.schema Lista o esquema do seu banco, ou voc pode listar apenas o esquema de uma tabela, usando o comando a seguir: sqlite>.schema curso Seguem abaixo alguns exemplos comandos SQL: Para criar uma tabela: sqlite> CREATE TABLE curso (id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT, nome TEXT NOT NULL,data DATE); Para inserir um registro na tabela criada: sqlite> INSERT INTO curso (nome, data) VALUES ('curso sqlite no android', '2011-08-22');

Se voc seguiu toda a lio, voc j fez todo o laboratrio baseado no ADB. A ideia desse minicurso foi mostrar rapidamente como foi funciona o SQLite no Android, no se prendendo aos detalhes do banco, mas ao ambiente de desenvolvimento Android Espero que esse curso agregue valor para o seu conhecimento e sua evoluo profissional.

Gostou do curso de SQLite, ento clique no boto abaixo e ajude a The Code Bakers a continuar a publicar artigos, cursos e projetos.

Pgina 59 de 84

PhoneGapLio 1: Praparando o terrenoPhoneGap um framework open source para facilitar a criao de aplicaes mveis. Ele distribudo nos termos da licena MIT (http://www.phonegap.com/about/license), e pode ser utilizado para criar apps pagas ou gratuitas. Ele utiliza HTML 5, JavaScript (com uma API de extenso), e CSS, e fornece um meio-de-campo para integrar sua app com as plataformas suportadas: Android; iOS (iPhone, iPad, iPod); BlackBerry; WebOS (HP Palm); Symbian;

Mas ento, por que eu simplesmente no fao a pgina HTML sem usar o PhoneGap? No seria mais simples? A resposta sim, porm, no seria uma aplicao mvel. Voc teria problemas para distribu-la nas lojas especializadas (iTunes, Android Market etc). Alm disto, voc no teria acesso API PhoneGap, que permite fazer interface com os dispositivos. Por exemplo, como voc faria sua aplicao usar a cmera? E o GPS? Voc acabaria tendo que desenvolver uma camada nativa para cada tipo de aparelho, e adivinha s: exatamente o que o PhoneGap faz! Neste curso, vamos iniciar pela plataforma Android. Depois, vamos mostrar a parte especfica sobre iOS. Para os que quiserem outras plataformas, mostraremos tutoriais separados. Como funciona o processo de criao? Simples: 1. Crie um projeto, com pelo menos uma pgina chamada index.html. Seu projeto pode conter JavaScript (interno ou externo pgina), outras pginas, CSS, imagens etc. Ele deve ficar dentro de uma pasta www. Se quiser, pode usar o Git para criar e gerenciar seu projeto; 2. Use o mecanismo nativo (SDK) de cada plataforma, e crie um projeto. Infelizmente, cada uma tem suas caractersticas. Copie a pasta www para o local correto (depende da plataforma); 3. Compile e distribua!

O passo 1 muito importante, pois voc procurar separar seu projeto dos cdigos especficos de cada plataforma. Voc pode at escolher uma delas para usar seu ambiente, mas procure manter o mdulo www bem separado. Eu no sou programador! Preciso conhecer Java e Objective-C? Boa pergunta! Se voc conhece HTML 5 e arranha em JavaScript, j d para desenvolver uma app. Agora, infelizmente, necessrio fazer alguns ajustes, dependendo da plataforma. Algumas plataformas exigem maior trabalho de integrao, outras exigem menos, mas, infelizmente, alguma coisa voc vai ter que fazer. Outra coisa que pode fazer usar o PhoneGap Build! Assim, voc s se preocupa com o HTML 5 e JavaScript, deixando todo o trabalho de integrao cargo do servio, e recebe um pacote prontinho para rodar! Voc pode continuar a fazer o curso, se concentrando mais na parte de API e tcnicas de programao.

Pgina 60 de 84Arrumando a casa Nesta primeira lio, vamos mostrar como instalar a plataforma (Android) e comear a criar uma aplicao. Se voc s pretende usar o PhoneGap Build, recomendamos que leia o tutorial: Como criar uma app em 5 minutos com o PhoneGap Build. Como dissemos anteriormente, vamos comear pela plataforma Android. Se voc quiser conhecer mais profundamente esta plataforma, lembro que temos um curso especfico sobre Android, o qual vamos utilizar para ensinar a baixar e instalar tudo. Aplicaes Android so desenvolvidas usando a linguagem Java, da Oracle. Logo, voc teve ter o Java Software Development Kit (Java SDK) instalado em sua mquina. Existe o Java Runtime Environment, que apenas executa aplicaes Java, mas voc precisa do compilador, logo, deve baixar e instalar o Java JDK. Depois, voc vai precisar de uma IDE (Integrated Development Environment), e ns vamos usar o eclipse. Finalmente, voc vai precisar do Kit de Desenvolvimento do PhoneGap. Para baixar e instalar o eclipse, o plug-in para Android (ADT) e o Android SDK, leia a lio 2 do curso bsico de Android: Lio 2: Ambiente de desenvolvimento. Ento voc deve ter o ambiente pronto para desenvolvimento. Agora, s falta baixar o Kit do PhoneGap, que pode ser obtido diretamente na pgina do PhoneGap, ou ento clicando nesse link diretamente: http://phonegap.googlecode.com/files/phonegap-0.9.6.zip. Ele multiplataforma, e tem duas pastas: __MACOSX e phonegap-0.9.6. Ns vamos usar esta ltima. Descompacte em um local do seu HD (pode extrair apenas a ltima pasta) e guarde esta localizao. Ns vamos nos referenciar a ela como $PHONEGAP_HOME mais tarde, porm, pode deixar o nome padro da pasta. O primeiro programa a gente nunca esquece! Quem diria que voc viraria um garoto (ou garota) de programa, heim? U? Por que o espanto? Estamos falando de programa de computador! Pensou que fosse o qu? Ns j amaciamos e partimos o bifinho para voc. Temos uma aplicao tima para servir de Hello World: http://gerador-de-desculpas-furadas.googlecode.com/files/ProjectExcuse.zip. s baixar e descompactar este arquivo ZIP, que contm uma pgina index.html. Normalmente, voc desenvolveria o seu prprio aplicativo, mas achamos que, para um primeiro contato, melhor ter algo pronto. Eu j tenho um jogo legal em flash! Ser que posso usar o PhoneGap para coloc-lo no iTunes e ganhar uma grana? Bem, temos boas e ms notcias. A boa que a comunidade PhoneGap est criando plugins para permitir o uso de Flash e tem algumas aplicaes tentando fazer isso em Android. A m notcia que a Apple no suporta Flash, logo, no sei se voc poder colocar sua aplicao no iTunes! Estude HTML 5, que tem muitos recursos que o Flash tinha. Se voc usar bem a combinao HTML 5 + JavaScript + CSS, vai poder fazer tudo o que faria com Flash. Bem, vamos criar logo nosso primeiro projeto PhoneGap, para rodar em plataforma Android. Lembrando que ns j temos um tutorial sobre o assunto: http://www.thecodebakers.org/2011/04/javasscript-noambiente-android.html. Primeiro passo: crie um projeto Android no eclipse. Abra o eclipse, crie uma nova workspace (se que j no fez isso quando instalou), e prepare-a para receber um projeto. Crie um novo projeto Android.

Pgina 61 de 84

A lio 4, do curso bsico, explica como fazer isto: Lio 4: Criando sua primeira aplicao Android. Segundo passo: adaptando seu projeto Android para receber o PhoneGap. P, eu no conheo eclipse! Calma, ns damos um jeito! Tem vrios tutoriais na Internet. Veja este: http://www.cin.ufpe.br/~phmb/ip/MaterialDeEnsino/IntroducaoAoEclipse/IntroducaoAoEclipse.htm. Voc conseguiu criar um projeto? timo! Ento, temos que fazer algumas alteraes para poder embutir nossa aplicao PhoneGap dentro do projeto. Para comear, crie duas pastas dentro do projeto: libs e assets/www (uma pasta www dentro de uma pasta assets). Para criar pastas em um projeto eclipse s selecion-lo com o boto direito, escolher new e folder. Seu projeto deve ficar como a figura:

Ficou assim? timo! Agora, abra a pasta $PHONEGAP_HOME/phonegap-x.x.x/Android (o x.x.x o nmero da verso. No nosso caso 0.9.6) e copie os arquivos: phonegap.x.x.x.jar (x.x.x o nmero da verso) para a pasta libs do seu projeto; phonegap.x.x.x.js (x.x.x o nmero da verso) para a subpasta www, dentro da pasta assets do seu projeto;

Agora, temos que adicionar as bibliotecas do PhoneGap ao projeto. Selecione o arquivo phonegap.x.x.x.jar (que est dentro de libs) e escolha: Build path... e Add to Build path. Existem outras formas de se fazer isto, mas esta a mais simples.

Bem, agora, sente-se em posio de ltus, endireite a coluna, repouse as mos sobre as pernas, respire fundo e murmure: OOOHMMMMMM! Faa isso por 10 minutos! necessrio porque voc vai mexer no

Pgina 62 de 84cdigo-fonte Java do seu projeto! Ao criar o projeto, voc criou tambm uma classe Java, que a activity principal dele. No sabe o que activity? P, ns pedimos para voc ler as lies 2 e 4 do curso bsico... Voc no leu tudo? Ento volte e leia: Lio 2: Ambiente de desenvolvimento Lio 4: Criando sua primeira aplicao Android

Ela fica dentro da pasta src do projeto. Ao criar o projeto, voc criou um nome de pacote, normalmente, usamos o nome de domnio da empresa invertido, mais o nome do projeto. Em nosso caso, eu criei: org.thecodebakers.phonegap1. Dentro deste pacote est o arquivo-fonte em Java. Lembre-se que, ao criar o projeto, voc deu um nome para a activity principal. Veja a figura:

Ao dar um duplo-clique sobre o arquivo Java, abre-se uma janela de edio do lado direito, com o texto do arquivo. Localize a linha que diz: import e, logo abaixo dela, digite uma nova linha contendo: import com.phonegap.*;. Depois, localize a linha que diz: public class xxxxx extends Activity (o xxxx no importa!) e mude a palavra em negrito para: DroidGap. Finalmente, localize a linha que diz: setContentView(...); e a substitua por: super.loadUrl("file:///android_asset/www/index.html"); Seu cdigo deve ficar como este:1. package org.thecodebakers.phonegap1; 2. 3. import android.app.Activity; 4. import android.os.Bundle; 5. import com.phonegap.*; 6. 7. public class Principal extends DroidGap { 8. /** Called when the activity is first created. */ 9. @Override 10. public void onCreate(Bundle savedInstanceState) { 11. super.onCreate(savedInstanceState); 12. super.loadUrl("file:///android_asset/www/index.html"); 13. } 14. }

Terceiro passo: copie seu aplicativo PhoneGap para dentro do projeto. Seu aplicativo PhoneGap pode ser totalmente desenvolvido fora do projeto Android. Neste caso, copie todos os arquivos para dentro da subpasta www, dentro da pasta assets, que voc criou na raiz do projeto. Em nosso exemplo, baixe a aplicao http://gerador-de-desculpasfuradas.googlecode.com/files/ProjectExcuse.zip, extraia o arquivo index.html e copie-o para dentro da subpasta assets/www.

Pgina 63 de 84

Quarto passo: rode e mostre para a Mame! Se voc leu tudo direitinho, ento j sabe o que um AVD, um emulador, no? Ento selecione seu projeto com o boto direito e escolha Run as... e Android Application e aguarde alguns porrilnios. Dependendo da sua mquina, vai demorar muito, a boa notcia que voc no precisa fechar o emulador para rodar novamente. Basta mant-lo aberto! Voc deve ver algo como isto:

o emulador com a sua aplicao PhoneGap executando! Agora s mostrar para todo mundo! O que falta? Certamente, faltam algumas coisas, entre elas: Colocar para rodar no seu celular ou tablet; Distribuir no Android Market; Converter para iPhone;

Mas vamos fazer como Jack, o estripador: por partes!

Lio 2: Entendendo o funcionamento do PhoneGapNesta lio, ainda estamos utilizando o PhoneGap para Android, embora a maioria dos conceitos seja para ambiente multi-plataforma. Em breve, teremos uma parte sobre as caractersticas especficas do iOS (iPad, iPhone etc). Vamos aprender como utilizar a API PhoneGap. O PhoneGap um framework que permite a voc desenvolver aplicaes em HTML 5 + JavaScript, com acesso aos recursos dos dispositivos mveis, utilizando uma API padronizada. Eis o que o PhoneGap expe para a camada JavaScript: Acelermetro (Accelerometer) - Usar o sensor de movimento do dispositivo; Cmera (Camera) - Capturar uma foto utilizando a cmera; Captura (Capture) - Capturar arquivos de mdia utilizando aplicaes de captura, por exemplo: gravador de udio; Bssola (Compass) - Obter a direo para onde o dispositivo est apontando; Conexo (Connection) - Verificar o estado da Rede e do celular; Contatos (Contacts) - Trabalhar com o arquivo de contatos do dispositivo; Dispositivo (Device) - Obter informaes especficas do dispositivo; Eventos (Events) - Observar e capturar eventos nativos atravs do JavaScript;

Pgina 64 de 84 Arquivo (File) - Lidar com o sistema de arquivos nativos atravs do JavaScript; Geolocalizao (Geolocation) - Tornar sua aplicao consciente de sua localizao; Media (Media) - Gravar e reproduzir arquivos de udio; Notificao (Notification) - Notificaes visuais, audveis e tcteis (vibrao) do dispositivo; Armazenamento (Storage) - Lidar com as opes de armazenamento nativas;

Logo, voc no precisa se preocupar em aprender a lidar com as caractersticas de cada equipamento individualmente. Porm, ser que d para desenvolver tudo assim? Caso voc queira fazer um processamento em segundo plano (ou background), ou ento queira usar uma caracterstica para a qual no existe o componente JavaScript do PhoneGap, como fazer? nesse momento que entra a arquitetura de plug-ins do PhoneGap.

Este diagrama vem do site de documentao do PhoneGap. Para desenvolver um plug-in, voc precisa criar duas camadas: um componente em cdigo nativo de cada dispositivo, e um componente JavaScript que expe sua funcionalidade para as aplicaes HTML 5. Plug-ins prontos Se voc quiser, pode baixar plug-ins prontos para suas necessidades, o repositrio de plug-ins do PhoneGap tem muita coisa, todos separados por plataforma. Um pequeno exemplo usando a API PhoneGap Vamos comear criando uma aplicao tpica PhoneGap. Embora voc possa utililizar qualquer HTML com JavaScript, existem alguns pr-requisitos para utilizar a API em toda sua plenitude. Crie um projeto Android no eclipse, como ensinamos na lio anterior. Dentro da pasta assets/www, crie um arquivo index.html. Eis o esqueleto geral de uma aplicao bsica:1. 2. 3. Integrando com a API PhoneGap 4. 5. 6. 7. Informaes 8. 9. Inicializando o PhoneGap... 10. 11. 12.

Pgina 65 de 84Note que estamos carregando o JavaScript do PhoneGap logo no incio. Agora, precisamos esperar o ambiente PhoneGap inicializar e depois carregamos as informaes dentro da div que criamos. Antes de mais nada, como vamos realmente utilizar a API PhoneGap neste programa, voc deve acrescentar as seguintes permisses no seu arquivo AndroidManifest.xml, que fica no raiz do projeto:1. 2.

Elas indicaro ao usurio que o seu programa tenta acessar a INTERNET do dispositivo, e tambm o estado da rede de comunicaes. Estas permisses devem ficar dentro do tag :1. 2. 6. 7. 8. 9. 10. 12. 13. 14. 15. 16. 17. 18.

Depois, interceptamos o evento deviceready, criado pelo PhoneGap, e colocamos nossa funo. Eis o cdigo-fonte (adaptado do existente na API do PhoneGap):1. 2. 3. Integrando com a API PhoneGap 4. 5. 6. document.addEventListener("deviceready", exibirInfo, false); 7. function exibirInfo() { 8. var saida = document.getElementById("saida"); 9. saida.innerHTML = 'Device Name: ' + device.name + ' 10. ' + 11. 'Device PhoneGap: ' + device.phonegap + ' 12. ' + 13. 'Device Platform: ' + device.platform + ' 14. ' + 15. 'Device UUID: ' + device.uuid + ' 16. ' + 17. 'Device Version: ' + device.version + ' 18. '; 19. } 20. 21. 22. 23. Informaes 24. 25. Inicializando o PhoneGap... 26. 27. 28.

Se voc conhece JavaScript e HTML, ser fcil entender o que esta pgina faz. Quando o PhoneGap termina de inicializar (ele carregado pelo primeiro tag da pgina, o evento deviceready ser levantado.

Pgina 66 de 84E ento, nossa funo ser chamada. Logo, ela carregar o contedo da div saida. Para que este programa funcione, faltam duas coisinhas: primeiro, temos que alterar a classe Java da Activity, que foi criada automaticamente para o nosso projeto, de modo que ela invoque a nossa pgina HTML. E, em segundo lugar, temos que executar o programa em um AVD. Ah, voc no tem a menor ideia do que eu estou falando? Ento volte lio anterior e leia atentamente. Eis o cdigo-fonte da minha activity:1. package org.thecodebakers.phonegap.teste; 2. 3. import com.phonegap.DroidGap; 4. 5. import android.app.Activity; 6. import android.os.Bundle; 7. 8. public class Principal extends DroidGap { 9. /** Called when the activity is first created. */ 10. @Override 11. public void onCreate(Bundle savedInstanceState) { 12. super.onCreate(savedInstanceState); 13. super.loadUrl("file:///android_asset/www/index.html"); 14. } 15. }

E, finalmente, eis o resultado da execuo do programa:

O nosso cdigo-fonte solicita API de Dispositivo as seguintes propriedades: device.name : o nome do produto (ou dispositivo); device.phonegap : verso do PhoneGap que est rodando; device.platform : qual o sistema operacional do dispositivo; device.uuid : o identificador universal do aparelho; device.version : verso do sistema operacional do dispositivo;

S isso? P, eu queria fazer mais! Ah, t bom. Ento vamos colocar um boto para dar uma vibrada no Celular, ok? Eu sei que pouco, mas temos que ir devagar. Eis o novo cdigo-fonte em HTML:1. 2. 3. Integrando com a API PhoneGap 4. 5. 6. document.addEventListener("deviceready", exibirInfo, false); 7. function exibirInfo() { 8. var saida = document.getElementById("saida"); 9. saida.innerHTML = 'Device Name: ' + device.name + ' 10. ' +

Pgina 67 de 8411. 'Device PhoneGap: ' + device.phonegap + ' 12. ' + 13. 'Device Platform: ' + device.platform + ' 14. ' + 15. 'Device UUID: ' + device.uuid + ' 16. ' + 17. 'Device Version: ' + device.version + ' 18. '; 19. } 20. function vibrar() { 21. navigator.notification.alert("Vibrando", 22. "Funcionou?", 23. "OK"); 24. 25. navigator.notification.vibrate(2000); 26. } 27. 28. 29. 30. Informaes 31. 32. Inicializando o PhoneGap... 33. 34. 35. 36.

Estamos utilizando a API notificaes, para mostar um alerta e fazer o dispositivo vibrar. Voc s vai sentir isso se colocar a aplicao rodando em seu Celular. Colocando para rodar em um Celular Android Ainda no vamos usar o Android Market! Para comear, gere um APK com certificado auto-assinado. Leia a partir do item Instalao de aplicaes no seu dispositivo mvel, da liao 10, do curso de Android bsico. Este o laboratrio desta lio. O projeto pode ser encontrado no Google Code: http://code.google.com/p/gerador-de-desculpas-furadas/downloads/list.

Usando plugins

O PhoneGap possui uma API padro bem completa, mas falta sempre alguma coisa... Por exemplo, Como compartilhar coisas no Facebook? Como enviar um e-mail? Essas funes so especficas de cada plataforma, logo, necessrio utilizar um plugin. Felizmente, para ns, o PhoneGap j possui uma boa biblioteca de plugins, que pode ser acessada no endereo: https://github.com/phonegap/phonegap-plugins. Eis os plugins que existiam no repositrio at a data de hoje (7 de Agosto de 2011): Analytics: Enviar estatsticas de visualizao de pginas no seu aplicativo para o Google Analytics

Pgina 68 de 84 BarcodeScanner: Como o prprio nome j diz, permite digitalizar cdigos de barra Bluetooth: Permite comunicao via bluetooth ChildBrowser: Cria um navegador "popup" com pginas externas, dentro da sua aplicao ClipboardManager: Integrao com a "Clipboard" nativa ContactView: Permite integrar com o Intent visualizador de contatos nativo do Android, ao invs de lidar com a Contacts API FileUploader: Para enviar arquivos do dispositivo a um servidor FtpClient: Como o prprio nome diz, um cliente para FTP PayPalPlugin: Este muito importante! Serve para voc enviar pagamentos, ou seja, implementar "inapp buy" PowerManagement: Permite acesso s funes de "power management" nativas Share: Cria um "Intent" ACTION_SEND, para compartilhar informaes SoftKeyboard: Mostra ou oculta o teclado StatusBarNotification: Permite escrever mensagens na barra de notificaes do Android TTS: Permite usar as caractersticas de "Text-to-speach". Podemos passar um texto para ser "falado" WebIntent: Permite invocar qualquer "Intent" do Android

Mas, como se desenvolve um plugin? Tenho certeza que est muito cedo para isto, mas, se insiste... Primeiramente, voc TEM que conhecer Java e TEM que saber programar em Android. Se j fez nosso Curso Bsico de Programao Android, ento d para comear. Primeiramente, voc tem que criar uma classe Java. que estenda com.phonegap.api.Plugin. Nesta classe, voc implementa o mtodo execute, desta forma:1. public class MeuPlugIn extends Plugin { 2. public PluginResult execute(String 3. acao, JSONArray args, String callbackId) { 4. if (action.equals("acao")) { 5. // ... 6. // ... 7. } 8. } 9. }

Entre os argumentos que ele recebe, est o nome da ao que deve ser executada. Depois, precisamos fazer a ponte entre o JavaScript e a nossa classe. Temos que criar um objeto e um mtodo. Depois, para que o PhoneGap saiba que seu plugin existe, necessrio registrar nosso plugin com ele. Para isto, usamos um mtodo addConstructor que nos permite adicionar nosso plugin. Isto feito em um arquivo JavaScript:1. var MeuPlugIn = function () {}; 2. MeuPlugIn.prototype.acao = function (params, success, fail) { 3. return PhoneGap.exec(success, fail, 'MeuPlugIn', 'acao', [params]); 4. }; 5. 6. PhoneGap.addConstructor(function () { 7. // Cria uma instncia do nosso plugin 8. PhoneGap.addPlugin('meuplugin', new MeuPlugIn()); 9. // Associa classe que executa o servio 10. PluginManager.addService('MeuPlugIn', 'org.thecodebakers.meuplugin'); 11. });

Para invocar um plugin, bastam duas coisas: 1 - Instanciar o PhoneGap e o plugin:

Pgina 69 de 842 No momento certo, invocar o plugin: window.plugins.meuplugin.acao({ arg1: 'val1', arg2: 'val2', // etc }); No vamos entrar em mais detalhes aqui porque no o momento. Melhorando o Gerador de Desculpas Furadas Lembra do programa que fizemos na primeira lio? Bem, vamos adicionar um boto para compartilhar a Desculpa Furada que ele criou. Para comear, crie um projeto Android (falamos sobre isso na primeira lio deste curso), com o cdigo do Gerador (http://gerador-de-desculpasfuradas.googlecode.com/files/ProjectExcuse.zip). Se voc fez a primeira lio deste curso, deve ter uma Workspace com o projeto j criado nela. Se no leu, ento leia a primeira lio. Como vamos compartilhar a desculpa gerada? Bem, para comear, vamos olhar a documentao da API do PhoneGap (http://docs.phonegap.com/). Se no acharmos nada que sirva, ento olhamos o repositrio de plugins (https://github.com/phonegap/phonegap-plugins/tree/master/Android). Achamos dois! Os plugins Share e WebIntent atendem ao nosso propsito. Porm, o plugin WebIntent mais completo e permite chamar qualquer Intent, incluindo aplicaes que tenhamos desenvolvido. Isto bem interessante, pois abre uma janela infinita de probabilidades. Vamos usar o WebIntent. Como se usa um plugin? Normalmente, o prprio autor d instrues, porm, resumindo: Copie o arquivo java para a pasta src do seu projeto, tomando cuidado de criar a subpasta de pacote que ele pede (neste caso: "src/com/borismus/webintent"); Copie o arquivo js para a pasta assets/www; Leia as instrues para saber como chamar a funo desejada;

O WebIntent foi criado por Boris Smus (http://smus.com/about), e ele possui um Blog no qual expe seus projetos: http://smus.com/android-phonegap-plugins. Vamos acessar o GitHub do projeto WebIntent, e baixar os dois arquivos (https://github.com/phonegap/phonegap-plugins/tree/master/Android/WebIntent ): WebIntent.java e webintent.js. O arquivo WebIntent.java possui uma declarao de pacote, logo, devemos criar os diretrios corretos dentro da pasta src (pode criar como Java Package) e copi-lo para l. O arquivo webintent.js deve ser copiado para a pasta assets/www. Alteraes no arquivo index.html Temos que adicionar o boot do plugin, logo abaixo da carga inicial do PhoneGap:1. 2. 3. 4. 5. Gerador de desculpas furadas

E precisamos colocar um boto, que pegue o texto da div onde o gerador colocou a desculpa, e envie como EXTRA_TEXT no Intent. Voc no sabe o que o EXTRA_TEXT? Ento leia nosso tutorial Compartilhando imagens, videos e outros. Inclumos mais uma funo no nosso bloco de scripts:1. function compartilhar() { 2. var extras = {}; 3. extras[WebIntent.EXTRA_SUBJECT] = "Querido(a) chefe!"; 4. extras[WebIntent.EXTRA_TEXT] = document.getElementById("output").innerHTML; 5. window.plugins.webintent.startActivity({ 6. action: WebIntent.ACTION_SEND, 7. type: 'text/plain', 8. extras: extras

Pgina 70 de 849. 10. 11. 12. 13. 14. 15. } }, function() {}, function() { alert('Erro ao compartilhar'); } );

Note que estamos criando uma coleo de argumentos, contento o EXTRA_SUBJECT (assunto da mensagem) e o EXTRA_TEXT (texto). Depois, passamos duas outras funes: uma para o evento de trmino da ao e outra para o caso de erro. No queremos ser avisados quando ele terminar, ento passamos uma funo vazia. Agora, s criar um boto:1. &

Pronto! Eis a sada:

Se voc clicar no boto Compartilhar, o Intent ACTION_SEND ser invocado e mostrar as telas para voc escolher o canal e enviar, conforme j falamos no tutorial Compartilhando imagens, videos eoutros. Jogou a toalha? Que isso?! Assim voc me entristece... Tudo bem, ns j temos um projeto no Google Code com a resposta pronta. S que acrescentamos o AdMob tambm. Ento, voc mata o coelho com duas cassetadas: http://code.google.com/p/gerador-de-desculpas-furadas/source/checkout.

Lidando com arquivosO PhoneGap possui uma API bem interessante, que te permite lidar com elementos do dispositivo sem se preocupar com detalhes de cada sistema operacional. Uma das interfaces desta API a "File", que permite lidar com arquivos. Nesta lio, vamos ver como lidar com esta interface, lendo e gravando arquivos no "sdcard". JSON - Ser o de "Sexta-feira 13"?

Pgina 71 de 84Para entender legal a programao PhoneGap, necessrio entender um pouco de JavaScript, o que , digamos, meio "estressante". O JSON uma das causas deste "stress"... Segundo o meu site preferido, a Wikipedia: "JSON (com a pronncia ['dejzn]), um acrnimo para "JavaScript Object Notation", um formato leve para intercmbio de dados computacionais. JSON um subconjunto da notao de objeto de JavaScript, mas seu uso no requer Javascript exclusivamente." Para entender bem a programao PhoneGap necessrio saber criar expresses JSON. Outro site muito interessante o http://www.json.org/, que ensina tudo o que voc precisa saber sobre esta tcnica. Veja um exemplo:

{ "Aluno" : { "nome": "Joo", "notas": [ 8, 9, 7 ] } }

Ns podemos criar e passar objetos utilizando a sintaxe JSON. Ponteiros de funo

Em JavaScript muito comum passarmos ponteiros de funo como argumentos. Podemos fazer isto de duas maneiras: explcita e implcita. Da maneira explcita:1. 2. 3. 4. 5. 6. 7. 8. window.resolveLocalFileSystemURI("file:///sdcard", ok, function () { alert('Erro ao tentar acessar o sdcard'); }); } function ok(diretorio) { ... }

Note que a funo "ok" foi passada como argumento, logo, o mtodo "resolveLocalFileSystemURI" pode invoc-la. Isto chamado de "callback", e um dos princpios da programao assncrona, caracterstica do PhoneGap. A maneira implcita declarar a funo dentro da chamada de outra:1. window.resolveLocalFileSystemURI("file:///sdcard", ok, 2. function () { 3. alert('Erro ao tentar acessar o sdcard'); 4. } 5. );

o mesmo exemplo anterior, s que passamos outro ponteiro de funo. Esta funo implcita (nem tem nome) e d um alerta. Um projeto de exemplo Criamos um projeto de exemplo para esta lio, cujo zip pode ser baixado desta URL: http://code.google.com/p/gerador-de-desculpas-furadas/downloads/detail?name=FileProject.zip, ou ento clicando no QR code abaixo:

Pgina 72 de 84

Notas sobre desenvolvimento JavaScript

Desenvolver em JavaScript , no mnimo "nojento" =( ... Sem um plugin para JavaScript, voc no tem sintax hi-light, nem code completion no "eclipse". E o pior de tudo: no d para depurar cdigo JavaScript de maneira fcil no Android. Mas vamos mostrar como melhorar isso depois. Montando um projeto Se baixou o nosso projeto, voc pode utiliz-lo sem problemas. Mas, se quiser criar outro projeto do zero, recomendamos ver a primeira lio do curso, mas vamos repetir aqui as principais tarefas para preparar um projeto: 1. Criar uma pasta "www" dentro da pasta "assets". Copiar para ela o "phonegap.xxx.js" e a sua pgina "index.html", alm de qualquer javascript de plugin que voc use; 2. Criar uma pasta "libs" na raiz do projeto, e copiar para ela o arquivo "phonegap.xxx.jar"; 3. Adicionar o jar que voc acabou de copiar ao Build path do projeto; 4. Adicionar as permisses necessrias ao arquivo "AndroidManifest.xml"; 5. Modificar sua "activity" para exibir sua pgina "index.html"; As permisses bsicas devem ser acrescentadas ao tag "" do arquivo "AndroidManifest.xml":1. 2.

Porm, existe uma permisso adicional, caso deseje gravar arquivos no "sdcard":1.

Finalmente, modifique sua classe de "activity":1. package org.thecodebakers.phonegap.filesample; 2. 3. import android.os.Bundle; 4. import com.phonegap.DroidGap; 5. 6. public class Principal extends DroidGap { 7. /** Called when the activity is first created. */ 8. @Override 9. public void onCreate(Bundle savedInstanceState) { 10. super.onCreate(savedInstanceState); 11. super.loadUrl("file:///android_asset/www/index.html"); 12. } 13. }

Pgina 73 de 84Listando diretrio A API "File" possui alguns objetos interessantes, entre eles o DirectoryEntry, que representa uma entrada no diretrio do File System. Toda a API "File" do PhoneGap baseada na proposta de "File API", do W3C, uma proposta livre de protocolo e API de acesso a arquivos e diretrios em pginas Web. Vamos mostrar como obter a entrada de diretrio do "sdcard":1. function gerar() { 2. window.requestFileSystem(LocalFileSystem.PERSISTENT, 3. 0, 4. function() {}, 5. function() { 6. alert('Erro ao tentar acessar o file system'); 7. } 8. ); 9. window.resolveLocalFileSystemURI("file:///sdcard", 10. ok, 11. function () { 12. alert('Erro ao tentar acessar o sdcard'); 13. } 14. ); 15. } 16. 17. function ok(diretorio) { 18. var txtListagem = diretorio.fullPath; 19. var leitor = diretorio.createReader(); 20. leitor.readEntries( 21. function(entries) { 22. var i; 23. for (i=0; i 0) { local.innerHTML += "

"; for (var iy = 0; iy < lista[ix].emails.length; iy++) { local.innerHTML += "

" + lista[ix].emails[iy].v