Android Cookbook

Android Cookbook
Ian F. Darwin
Novatec
Authorized Portuguese translation of the English edition of titled Android Cookbook, First Edition ISBN
9781449388416 2012 OReilly Media Inc. This translation is published and sold by permission of O'Reilly
Media, Inc., the owner of all rights to publish and sell the same.
Traduo em portugus autorizada da edio em ingls da obra Android Cookbook, First Edition ISBN
9781449388416 2012 OReilly Media Inc. Esta traduo publicada e vendida com a permisso da O'Reilly
Media, Inc., detentora de todos os direitos para publicao e venda desta obra.
Novatec Editora Ltda. 2012.
Todos os direitos reservados e protegidos pela Lei 9.610 de 19/02/1998.
proibida a reproduo desta obra, mesmo parcial, por qualquer processo, sem prvia autorizao, por escrito,
do autor e da Editora.
Editor: Rubens Prates
Traduo: Rafael Zanolli
Reviso tcnica: Edgard Damiani
Reviso gramatical: Giacomo Leone Neto
Editorao eletrnica: Carolina Kuwabata
ISBN: 978-85-7522-323-9
Histrico de impresses:
Setembro/2012
Primeira edio
Novatec Editora Ltda.

Rua Lus Antnio dos Santos 110
02460-000 So Paulo, SP Brasil
Tel.: +55 11 2959-6529
Fax: +55 11 2950-8869
Email: novatec@novatec.com.br
Site: www.novatec.com.br
Twitter: twitter.com/novateceditora
Facebook: facebook.com/novatec
LinkedIn: linkedin.com/in/novatec
Dados
Internacionais de Catalogao na Publicao

(Cmara Brasileira do Livro, SP, Brasil)
Darwin, Ian F.
Android cookbook / Ian F. Darwin. -- So Paulo :
Novatec Editora ; Sebastopol, CA : O`Reilly, 2012.
ISBN 978-85-7522-323-9
1. Android (Programa de computador)
2. Aplicao de programa - Desenvolvimento
3. Computao mvel 4. Google 5. Internet sem fio
6. Telefones celulares I. Ttulo.
12-11335
CDD-005.26
ndices para catlogo sistemtico:
1. Android : Plataforma de desenvolvimento para
aplicativos mveis : Programa de computador
005.26
OG20120918
(CIP)
captulo 1
Primeiros passos
1.1 Introduo: primeiros passos

Ian Darwin
Discusso
O famoso padro Ol, mundo (Hello, world) surgiu quando Kernighan e Plaugher
quiseram escrever uma receita sobre como comear a utilizar qualquer nova linguagem e ambiente de programao. Este captulo carinhosamente dedicado a
esses nobres senhores, e a todos que j lutaram para dar seus primeiros passos em
qualquer novo paradigma de programao.
1.2 Aprendendo a linguagem Java

Ian Darwin
Problema
Aplicativos Android so escritos na linguagem de programao Java antes de serem
convertidos no formato de arquivo de classe prprio do Android, DEX. Se voc no
sabe como programar em Java, vai ter dificuldade em escrever aplicativos Android.
Soluo
Muitos recursos esto disponveis para aprender Java. A maioria deles ensinar o que
voc precisa, mas tambm mencionar algumas classes de API (Application Programming Interface) que no esto disponveis para o desenvolvimento Android. Evite
quaisquer sees em qualquer recurso que fale sobre os tpicos listados na coluna
esquerda da tabela 1.1.
Tabela 1.1 Componentes da API Java a ignorar
API Java
Swing, applets
Equivalente Android
GUI do Android; veja o captulo 7
23
24
Android Cookbook
API Java
Equivalente Android
Ponto de entrada de aplicativo main() Veja a receita 1.6

J2ME/Java ME
A maior parte do android.* substitui a API Java ME
Servlets/JSP, J2EE/Java EE
Projetados para uso no lado do servidor
Discusso
Aqui esto livros e recursos sobre programao Java:
Java in a Nutshell (lanado no Brasil pela editora Bookman, com o ttulo Java: o
guia essencial) de David Flanagan (OReilly) uma boa introduo para programadores, especialmente queles que esto vindo de C/C++. Esse livro cresceu
muito em tamanho para acompanhar o crescimento do Java SE ao longo de
seu tempo de vida.
Head First Java (lanado no Brasil pela editora Starlin Alta, com o ttulo Use
a cabea! Java) de Kathy Sierra e Bert Bates (OReilly). Esse livro fornece uma
tima apresentao orientada ao aprendizado visual para essa linguagem.
Thinking in Java (em uma traduo livre, Pensando em Java) de Bruce Eckel
(Prentice-Hall).
Learning Java (lanado no Brasil pela editora Campus, com o ttulo Aprendendo
Java) de Patrick Niemeyer e Jonathan Knudsen (OReilly).
Great Java: Level 1 (em uma traduo livre, Java excelente: nvel 1), um vdeo
feito por Brett McLaughlin (OReilly). Esse vdeo fornece uma apresentao
visual para a linguagem.
Java: The Good Parts (lanado no Brasil pela editora Campus, com o ttulo O
melhor do Java) de Jim Waldo (OReilly).
Java Cookbook, o qual eu escrevi e a OReilly publicou. Esse livro tido como
um bom segundo livro para desenvolvedores Java. Ele tem captulos completos
sobre strings, expresses regulares, nmeros, data e hora, estruturas de dados,
E/S e diretrios, internacionalizao, threads, e redes, todo temas que se aplicam
ao Android. Ele tambm tem vrios captulos especficos para Swing e algumas
tecnologias com base em EE.
Entenda, por favor, que essa lista provavelmente nunca vai estar totalmente atualizada. Voc tambm deve consultar o Android Development Bibliography, da OReilly,
disponvel gratuitamente para download (mediante registro), uma compilao de
todos os livros de vrias editoras cujos livros esto no servio online Safari. Esse livro
tambm distribudo sem custos em conferncias relevantes nas quais a OReilly
tem um estande.
Captulo 1 Primeiros passos
25
Veja tambm
O autor principal deste livro mantm uma lista online de recursos Java em http://
www.darwinsys.com/java/.
A OReilly tem alguns dos melhores livros Java do mercado; veja uma lista completa
em http://oreilly.com/pub/topic/java.
1.3 Criao de um aplicativo Ol, mundo a partir da linha de comando

Ian Darwin
Problema
Voc deseja criar um novo projeto Android sem utilizar o plugin ADT do Eclipse.
Soluo
Utilize a ferramenta android do kit de desenvolvimento do Android (Android Development Kit, ou ADK) com o argumento create project e alguns argumentos adicionais
para configurar seu projeto.
Discusso
Alm de ser o nome da plataforma, android tambm o nome de uma ferramenta de
linha de comando para criao, atualizao e gerenciamento de projetos. Voc pode
navegar at o diretrio android-sdk-xxx, ou definir sua varivel PATH para incluir seu
subdiretrio tools.
Depois, para criar um novo projeto, utilize o comando android create project com alguns
argumentos. O exemplo 1.1 um exemplo executado em MS-DOS.
Exemplo 1.1 Criao de um novo projeto

C:> PATH=%PATH%;"C:\Documents and Settings\Ian\My Documents\android-sdk-windows\tools"; \
"C:\Documents and Settings\Ian\My Documents\android-sdk-windows\platform-tools"
C:> android create project --target android-7 --package com.example.foo
--name Foo --activity FooActivity --path .\MyAndroid
Created project directory: C:\Documents and Settings\Ian\My Documents\MyAndroid
Created directory C:\Documents and Settings\Ian\My Documents\MyAndroid\src\com\example\foo
Added file C:\Documents and Settings\Ian\My
Documents\MyAndroid\src\com\example\foo\FooActivity.java
Created directory C:\Documents and Settings\Ian\My Documents\MyAndroid\res
Created directory C:\Documents and Settings\Ian\My Documents\MyAndroid\bin
Created directory C:\Documents and Settings\Ian\My Documents\MyAndroid\libs
Created directory C:\Documents and Settings\Ian\My Documents\MyAndroid\res\values
26
Android Cookbook
Added file C:\Documents and Settings\Ian\My Documents\MyAndroid\res\values\strings.xml
Created directory C:\Documents and Settings\Ian\My Documents\MyAndroid\res\layout
Added file C:\Documents and Settings\Ian\My Documents\MyAndroid\res\layout\main.xml
Added file C:\Documents and Settings\Ian\My Documents\MyAndroid\AndroidManifest.xml
Added file C:\Documents and Settings\Ian\My Documents\MyAndroid\build.xml
C:>
A tabela 1.2 lista os argumentos para o cdigo create project.

Tabela 1.2 Lista de argumentos de create project
Nome
Significado
Exemplo
--activity
Nome de sua classe principal e nome-padro para o arquivo

--activity HelloActivity
.apk gerado
--name
Nome do projeto e do arquivo .apk gerado
--name MyProject
--package
Nome do pacote Java para suas classes
--package com.example.hello
--path
--target
Path (caminho) no qual o projeto ser criado (no cria um

subdiretrio dentro dele, por isso no utilize /home/you/
workspace, mas, em vez disso, /home/you/workspace/
NewProjectName)
Nvel de API almejado da plataforma Android; utilize
android list targets para ver a lista de alvos. Um
nmero um "ID", e no um nvel de API; para tanto, utilize
android- com o nvel de API que voc deseja
--path /home/ian/workspace/MyProject
(veja o exemplo anterior para Windows)
--target android-10
Se ele no puder completar a operao solicitada, o comando android apresentar uma

extensa mensagem de uso do comando, listando todas as operaes que ele pode
realizar, e os argumentos para elas. Se tiver sucesso, o comando android create project
criar os arquivos e diretrios listados na tabela 1.3.
Tabela 1.3 Artefatos criados por create project
Nome
Significado
AndroidManifest.xml
Arquivo de configurao do projeto, com informaes essenciais

sobre o projeto para o Android
bin
Binrios gerados (arquivos de classe compilados)
build.properties
Arquivo de propriedades editvel
build.xml
Arquivo de controle de compilao Ant padro
default.properties ou project.properties Armazena a verso do SDK e as bibliotecas utilizadas; mantido

(dependendo da verso das ferramentas)
por plugin
gen
Elementos gerados
libs
Bibliotecas, claro
res
Arquivos de recursos importantes (strings.xml, layouts etc.)
src
Cdigo-fonte de seu aplicativo
27

Nome
Significado
src/packagename/ActivityName.java
Fonte da atividade de incio equivalente a main
test
Cpias da maioria dos anteriores
uma prtica normal e recomendada no Android criar sua interface de usurio em

XML utilizando o arquivo de layout criado em res/layout, mas certamente possvel
escrever todo o cdigo em Java. Para manter este exemplo autocontido, faremos do
jeito errado por enquanto. Utilize seu editor de texto favorito para substituir o
contedo do arquivo HelloWorld.java com o contedo do exemplo 1.2.
Exemplo 1.2 HelloWorld.java

import android.app.Activity;
import android.widget.*;
public class Hello extends Activity {
/**
* Este mtodo invocado quando a atividade instanciada em resposta,
* por exemplo, a um clique seu no cone do aplicativo na tela inicial
*/
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// Cria uma TextView para a atividade atual
TextView view = new TextView(this);
// Faz ele dizer algo
view.setText("Hello World");
// Coloca essa viso recm-criada dentro da atividade,
// mais ou menos como JFrame.getContentPane().add(view)
setContentView(view);
}
}
Supondo que voc tenha a ferramenta Ant Build Tool da Apache Software Foundation
instalada (e ela est includa em verses recentes do SDK do Android), voc pode
(em uma janela de linha de comando) ir at o diretrio do projeto (...MyDocuments\
MyAndroid no exemplo 1.1) e utilizar o comando:
ant debug
Isso vai criar um arquivo chamado, por exemplo, MyAndroid.apk (com apk representando Android Package) no diretrio bin.
Se esta sua primeira vez aqui, voc pode ter de criar um dispositivo virtual Android
(Android Virtual Device, ou AVD), que simplesmente uma configurao nomeada
28
Android Cookbook
para o emulador Android especificando a resoluo-alvo, o nvel de API e assim por

diante. Voc pode criar um emulador utilizando:
android create avd -n my_droid -t 7
Para mais detalhes sobre a criao de um AVD (veja a receita 3.3).

Voc pode ento iniciar o servidor do ADB (Android Debug Bridge) e o emulador:
adb start-server
emulator -avd my_droid -t 5
Presumindo que agora voc tenha o emulador sendo executado ou seu dispositivo
conectado e reconhecido via USB, voc pode fazer:
adb -e install -r bin/MyAndroid.apk
A flag -e para o emulador; utilize -d para um dispositivo real.

Se voc tiver prtica com scripts shell ou arquivos em lote, poder criar um arquivo
chamado, digamos, download, para evitar ter de digitar a invocao adb a cada ciclo
de compilao.
Finalmente voc pode iniciar seu aplicativo! Voc pode utilizar a lista Application: toque
no pequeno cone que se parece com uma linha 55 de pontos, encontre seu aplicativo
pelo nome e toque em seu cone.
Voc provavelmente vai considerar conveniente criar um cone para seu aplicativo na
tela inicial do dispositivo ou emulador; esse cone sobreviver a vrios ciclos install
-r, portanto, essa a forma mais fcil de testar a execuo de seu aplicativo.
Veja tambm
Receita 1.4. O blog a little madness tem uma formulao mais detalhada. O site
oficial de referncia do Android tem uma pgina sobre desenvolvimento sem Eclipse.
1.4 Criao de um aplicativo Ol, mundo no Eclipse

Ian Darwin
Problema
Voc quer utilizar o Eclipse para desenvolver seu aplicativo Android.
Soluo
Instale o Eclipse, o SDK (Software Development Kit) do Android e o plugin ADT
(Android Development Tools). Crie seu projeto e comece a escrever seu aplicativo.
Compile e teste esse aplicativo no emulador, dentro do Eclipse.
29
Discusso
Assim que tiver estes itens instalados, voc estar pronto para iniciar:
O IDE Eclipse
O SDK do Android
O plugin ADT
Se voc quiser uma explicao mais detalhada da instalao desses trs itens, por
favor, consulte a receita 1.5.
Para iniciar, crie um novo projeto a partir do menu File -> New (veja a figura 1.1).
Figura 1.1 Comeando a criar um projeto Eclipse.
Clique em Next. D um nome ao seu novo projeto e clique em Next (veja a figura 1.2).
Selecione uma verso de SDK como alvo. A verso 2.1 oferece para voc praticamente
todos os dispositivos atualmente em uso; as verses 3.x ou 4.x oferecem os ltimos
recursos (veja a figura 1.3). Voc decide.
A figura 1.4 mostra a estrutura do projeto expandida no painel Project direita. Ela
tambm mostra a que ponto voc pode chegar na utilizao do recurso de preenchimento automtico do Eclipse dentro do Android eu inclu o atributo gravity para o
rtulo, e o Eclipse est oferecendo uma lista completa de valores de atributos possveis. Eu escolhi center-horizontal, por isso o rtulo dever estar centralizado quando
colocarmos o aplicativo para funcionar.
30
Android Cookbook
Figura 1.2 Configurao de parmetros para um novo projeto Eclipse.
Figura 1.3 Definio do SDK alvo para um novo projeto Eclipse.
31
Figura 1.4 Uso do editor do Eclipse para definir gravity em um TextView.
Na realidade, se voc definir gravity como center_vertical no LinearLayout e defini-lo

como center_horizontal na TextView, o texto estar centralizado tanto vertical quanto
horizontalmente. O exemplo 1.3 o arquivo de layout main.xml (localizado em res/
layout) que realiza isso.
Exemplo 1.3 Layout do XML

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:gravity="center_vertical"
>
<TextView
android:layout_height="wrap_content"
android:text="@string/hello"
android:gravity="center_horizontal"
/>
</LinearLayout>
32
Android Cookbook
Como sempre, o Eclipse gera uma verso compilada sempre que voc salva um arquivo-fonte. Alm disso, em um projeto Android, ele tambm executa uma compilao
Ant para criar o APK compilado e empacotado que estar pronto para ser executado.
Por isso voc precisa apenas execut-lo. Clique com o boto direito no projeto em si
e selecione Run As -> Android Project (veja a figura 1.5.).
Figura 1.5 Executando um projeto Android Eclipse.
Isso iniciar o emulador do Android se ele ainda no estiver sendo executado. O

emulador comear com a palavra Android em texto simples, depois trocar para
a fonte Android mais elaborada, com um detalhe em branco se movendo sobre as
letras em azul lembra da inicializao do Microsoft Windows 95 (veja a figura 1.6).
Depois de um pouco mais de tempo, seu aplicativo dever inicializar. A figura 1.7
mostra apenas uma tela do aplicativo em si, j que o restante da viso do emulador
redundante.
Veja tambm
Receita 1.3.
33
Figura 1.6 O projeto Android sendo inicializado no emulador.
Figura 1.7 Projeto Eclipse sendo executado no emulador.
1.5 Configurando um IDE no Windows para desenvolvimento Android

Daniel Fowler
Problema
Voc deseja desenvolver seus aplicativos Android utilizando um PC Windows, por
isso um guia conciso da configurao de um IDE para essa plataforma seria til.
34
Android Cookbook
Soluo
O uso do IDE Eclipse recomendado no desenvolvimento de aplicativos Android.
Configurar o Eclipse no Windows no uma instalao com um nico passo; vrios
estgios precisam ser completados. Esta receita fornece detalhes sobre esses estgios.
Discusso
No desenvolvimento de aplicativos para Android, o IDE (Integrated Development
Environment) Eclipse para Java recomendado. O plugin ADT (Android Development
Tools) est disponvel para aprimorar o Eclipse, o qual utiliza o SDK do Android,
fornecendo programas essenciais para desenvolvimento de software para o Android.
Para configurar um ambiente de desenvolvimento, voc precisa efetuar o download
e a instalao destes componentes:
Java Standard Edition Development Kit
Eclipse para desenvolvimento Java
SDK do Android
plugin ADT (dentro do Eclipse)
Nas subsees a seguir abordaremos esses estgios detalhadamente para um PC
Windows (testado em XP, Vista e Windows 7).
Instalao do JDK (Java Development Kit)

V at a pgina de downloads do Java, em http://www.oracle.com/technetwork/java/
javase/downloads/index.html.
Selecione o cone do Java para acessar os downloads do JDK:
A lista de downloads do JDK ser mostrada. Clique no boto de opo Accept License
Agreement; do contrrio, voc no poder continuar. Faa o download e execute o JDK
mais recente presente; quando da elaborao deste texto, eles eram o jdk-7u2-windows-i586.exe (ou o jdk-7u2-windows-x64.exe para o Windows 64 bits). Voc pode precisar
selecionar a localizao do site de download. Aceite quaisquer avisos de segurana
que apaream, mas apenas se voc estiver efetuando o download na pgina oficial
de downloads do Java.
35
Quando o download tiver terminado e for executado, voc ter de percorrer as telas
de instalao, clicando Next at que o instalador do JDK tenha concludo. Voc no
deve ter de alterar nenhuma das opes apresentadas. Quando o instalador do JDK
tiver concludo, clique no boto Finish. Pode ser que uma pgina de registro de produto
seja carregada; voc pode fech-la ou escolher registrar sua instalao.
Instalao do Eclipse para desenvolvimento Java

A pgina de download do Eclipse est em http://www.eclipse.org/downloads/.
O Windows precisa ser selecionado na lista suspensa Packages; selecione o link relevante
de download do IDE Eclipse para desenvolvedores Java (veja a figura 1.8).
Figura 1.8 Escolha de um download do Eclipse.
Faa o download e abra o arquivo ZIP. No arquivo haver um diretrio eclipse contendo vrios arquivos e subdiretrios. Copie o diretrio eclipse e todo o seu contedo
como fornecido (Figura 1.9). O local habitual para o qual copiar os arquivos na raiz
do drive C ou dentro de C:\Arquivos de Programas. Voc pode ter de selecionar Continuar
quando o Windows pedir permisso para a cpia.
Crie um atalho de desktop para eclipse.exe.
Figura 1.9 Contedo da pasta do Eclipse.
36
Android Cookbook
Execute o Eclipse para que ele configure um workspace (espao de trabalho); fazer
isso tambm verificar que tanto o Java quanto o Eclipse foram instalados corretamente. Quando voc executar o Eclipse, pode ser que um aviso de segurana seja
mostrado; selecione Run para continuar. Aceite a localizao padro do workspace ou
utilize um diretrio diferente.
Instalao do SDK do Android

V at a pgina de download do SDK do Android em http://developer.android.com/
sdk/index.html.
Escolha o pacote EXE mais recente para Windows (no momento em que escrevo
isso, installer_r16-windows.exe) e selecione Run. Aceite o aviso de segurana apenas se
voc estiver efetuando o download na pgina oficial do site do SDK do Android. O
instalador Android SDK Tools mostrar algumas telas. Selecione o boto Next em cada
uma delas; voc no deve ter de alterar nenhuma opo. Uma vez que C:\Arquivos de
Programas um diretrio protegido, voc pode ou obter permisso para instalar nele,
ou, como fazem alguns desenvolvedores, instalar em sua pasta de usurio ou outro
diretrio por exemplo, C:\Android\android-sdk.
Quando o boto Install for clicado, uma tela de progresso aparecer brevemente enquanto os arquivos do Android so copiados. Clique no ltimo boto Next e no boto
Finish ao final da instalao. Se voc deixou a caixa Start SDK Manager selecionada, o SDK
Manager ser executado. Do contrrio, selecione o SDK Manager a partir do grupo
de programas Android SDK Tools (Iniciar->Todos os Programas->Android SDK Tools->SDK Manager).
Quando o SDK Manager iniciar, os pacotes Android disponveis para download sero
verificados. Ento, uma lista de pacotes disponveis ser mostrada com alguns deles
pr-selecionados para download. Uma coluna de Status mostrar se um pacote est
instalado ou no. Na figura 1.10 voc pode ver que as Android SDK Tools acabaram
de ser instaladas e isso est refletido na coluna Status.
Marque cada pacote que precisa ser instalado. Vrios pacotes esto disponveis. Estes
incluem pacotes da plataforma SDK para cada nvel de API, exemplos de aplicativos
para a maioria dos nveis de API, APIs do Google Maps, APIs de fabricantes especficos,
documentao, cdigo-fonte e os pacotes extras a seguir para o Google:
37
Android Support
Utilizado para oferecer suporte a APIs Android mais recentes em dispositivos
mais antigos.
AdMob Ads SDK

Para incorporao de publicidade em aplicativos.
Analytics SDK
Para oferecer suporte anlise das compras de clientes.
Market Billing
Acrescenta suporte para compras dentro do aplicativo.
Market Licensing
Ajuda a proteger aplicativos de serem ilegalmente copiados.
USB Driver
Para depurao em dispositivos fsicos (ou utilizando um driver do fabricante).
Webdriver
Ajuda a testar a compatibilidade de um site com o navegador Android.
Figura 1.10 Android SDK Manager, mostrando componentes instalados e disponveis para download.
38
Android Cookbook
recomendado que voc efetue o download de vrias plataformas de SDK para

permitir testes de aplicativos em vrias configuraes de dispositivo. Vale notar que
computadores mais antigos tero dificuldade em executar os emuladores de dispositivos virtuais para as APIs mais recentes do Android; portanto, nesses computadores,
desenvolva utilizando as plataformas SDK mais antigas. Se estiver em dvida quanto a
qual download efetuar, aceite as escolhas iniciais e execute novamente o SDK Manager
para obter outros pacotes como e quando necessrio; ou marque todos os pacotes
para efetuar o download de tudo (o download pode demorar um pouco). Clique no
boto Install packages.
Os pacotes selecionados sero mostrados em uma lista; se um pacote tiver termos
de licena que requerem aceitao, ele ser mostrado com um ponto de interrogao. Destaque cada pacote que tem um ponto de interrogao para ler os termos de
licena. Voc pode aceitar ou rejeitar o pacote utilizando os botes de opo. Pacotes
rejeitados so marcados com um vermelho. Alternativamente, clique em Accept All
para aceitar tudo que est disponvel Clique no boto Install e uma barra de progresso
mostrar os pacotes sendo instalados, bem como quaisquer erros que ocorram. No
Windows, um erro comum ocorre quando o SDK Manager incapaz de acessar ou
de renomear diretrios. Execute novamente o SDK Manager como administrador
e verifique se o diretrio no tem nenhuma flag ou nenhum arquivo apenas para
leitura; veja a receita 1.12 para mais detalhes. Quando tiver concludo, feche o SDK
Manager clicando no boto no canto superior da janela.
Instalao do plugin ADT

A instalao do plugin ADT feita via Eclipse, mas para isso voc precisa executar o
Eclipse a partir da conta de administrador. Utilize o atalho criado antes ou o eclipse.
exe na pasta eclipse. Em qualquer um dos casos, abra o menu de contexto (geralmente
por meio de um clique com o boto direito), selecione Executar como administrador
e aceite quaisquer avisos de segurana. Quando o Eclipse tiver carregado, abra o item
de menu Help e selecione Install New Software.
Na tela de instalao, digite este endereo na caixa Work with:
https://dl-ssl.google.com/android/eclipse/
Clique no boto Add. Uma tela Add Repository aparecer; na caixa Name digite algo significativo, como ADT plug-in (o endereo web mencionado antes ser mostrado na
caixa Location); veja a figura 1.11.
Clique no boto OK. A tela ser atualizada depois de brevemente mostrar Pending
na coluna Name da tabela.
Marque a caixa ao lado de Developer Tools. Ento, selecione o boto Next na parte inferior
da tela (veja figura 1.12).
39
Figura 1.11 Incluso do repositrio ADT plug-in.
Uma lista de itens a serem instalados ser mostrada. Se voc receber uma mensagem
de erro, verifique se o Eclipse foi executado na conta do administrador. Selecione Next
novamente. Uma tela mostrar as licenas; certifique-se de que cada licena tenha
sido aceita (selecione o boto de opo I accept the terms of the license agreements).
Ento clique no boto Finish. Um aviso de segurana ter de ser aceito para concluir
a instalao; selecione OK para esse aviso (o endereo digitado antes um endereo
seguro). O Eclipse pedir uma reinicializao. Selecione o boto Restart Now e o Eclipse
vai fechar e recarregar. Uma caixa de dilogo Welcome to Android Development
vai aparecer. Defina a localizao do SDK na caixa Existing Location (uma vez que o SDK
Manager j foi executado), v at a pasta do SDK do Android (por padro, C:\Arquivos
de Programas\Android\android-sdk), e clique em Next (veja a figura 1.13).
Uma pergunta de monitoramento de uso do Google Android SDK vai aparecer; modifique a opo se necessrio e clique em Finish. O Eclipse estar agora configurado
para compilar e depurar aplicativos Android. Veja a receita 3.3 para configurar um
emulador Android; depois experimente a receita 1.4 como um teste de sanidade. Conecte um dispositivo fsico no computador e utilize suas configuraes para ativar o
USB Debugging (em Development, dentro de Applications).
Veja tambm
Receita 1.4; Receita 1.12; Receita 3.3; http://developer.android.com/sdk/installing.html, http://
www.eclipse.org/; http://www.oracle.com/technetwork/java/javase/downloads/index.html.
40
Android Cookbook
Figura 1.12 Escolhendo o que instalar.
Figura 1.13 Conexo do recm-instalado SDK ao recm-instalado plugin ADT.
41
1.6 Entendendo o ciclo de vida do Android

Ian Darwin
Problema
Aplicativos Android no tm um mtodo main; voc precisa aprender como eles
comeam e como param ou so parados.
Soluo
A classe android.Activity fornece vrios mtodos de ciclo de vida bem definidos que
so chamados quando um aplicativo iniciado, suspenso, reiniciado e assim por
diante, assim como um mtodo que voc pode chamar para marcar uma atividade
como concluda.
Discusso
Seu aplicativo Android executa seu prprio processo Unix, por isso, em geral, ele no
pode afetar diretamente nenhum outro aplicativo em execuo. A VM Dalvik faz a
interface com o sistema operacional para chamar voc quando seu aplicativo inicia,
quando o usurio muda para outro aplicativo e assim por diante. H um ciclo de
vida bem definido para aplicativos Android.
Um aplicativo Android tem trs estados em que pode estar:
Ativo, no qual o aplicativo est visvel para o usurio e em execuo.
Pausado, no qual o aplicativo est parcialmente obscurecido e perdeu o foco
de entrada.
Parado, no qual o aplicativo est completamente oculto da viso.
Seu aplicativo percorrer esses estados quando o Android chamar os mtodos a seguir
na atividade atual, no momento apropriado:
void
void
void
void
void
void
void
onCreate(Bundle savedInstanceState)
onStart()
onResume()
onRestart()
onPause()
onStop()
onDestroy()
Voc pode ver o diagrama de estado desse ciclo de vida na figura 1.14.
No caso da primeira atividade de um aplicativo, onCreate() a forma como voc sabe
que o aplicativo foi iniciado. aqui que voc normalmente realiza trabalhos de tipo
42
Android Cookbook
construtor, como definir a janela principal com setContentView(), incluir ouvintes

(listeners) para botes que realizem trabalhos (inclusive iniciar atividades adicionais) e assim por diante. Esse o nico mtodo que at mesmo o mais simples dos
aplicativos Android precisa.
(new)
onStart()
Running
onPause()
onResume()
Paused
onStop()
onResume()
onStop()
onDestroy()
Stopped
onDestroy()
(no process)
Figura 1.14 Estados de ciclo de vida do Android.
Voc pode ver os efeitos dos vrios mtodos de ciclo de vida criando um projeto de
teste no Eclipse e sobrescrevendo todos os mtodos utilizando instrues de log para
fins de depurao.
1.7 Instalao de arquivos .apk em um emulador por meio do ADB

Rachee Singh
Problema
Voc tem um arquivo .apk de um aplicativo, e deseja instal-lo no emulador para conferir esse aplicativo, ou porque um aplicativo que voc est desenvolvendo o requer.
Soluo
Utilize a ferramenta de linha de comando ADB para instalar o arquivo .apk no emulador em execuo; voc tambm pode utilizar essa ferramenta para instalar um
arquivo .apk em um dispositivo Android conectado.
43
Discusso
Para instalar o arquivo .apk, siga estes passos:
1. Encontre o local em sua mquina onde voc instalou o SDK do Android. No
diretrio do SDK do Android, v at o diretrio tools.
2. Procure um executvel chamado adb no diretrio tools. Se ele estiver presente,
essa a localizao do arquivo adb; do contrrio, deve haver um arquivo .txt
chamado adb has moved. O contedo desse arquivo meramente direciona
voc para a localizao do binrio do adb; o arquivo afirma que o adb est
presente no diretrio platform-tools em vez de estar no diretrio tools.
3. Assim que voc tiver localizado o programa adb, use o comando cd para chegar
a essa localizao em um terminal (Linux) ou prompt de comando (Windows).
4. Utilize o comando adb install localizao do .apk que voc deseja instalar. Se voc
receber command not found no Linux, tente utilizar ./adb em vez de apenas
adb.
Isso deve iniciar a instalao no dispositivo que est atualmente sendo executado
(seja um emulador em execuo em seu desktop, ou um dispositivo fsico Android
conectado).
Depois de a instalao terminar, no menu do dispositivo/emulador Android, voc
deve ver o cone do aplicativo que acabou de instalar (veja a figura 1.15).
Figura 1.15 Comando da instalao.
44
Android Cookbook
1.8 Instalao de aplicativos em um emulador via SlideME

David Dawes
Problema
As app stores (em uma traduo livre, lojas de aplicativos) so uma enorme parte
da atrao dos smartphones modernos. O Android Market1 do Google a app store
oficial, mas voc tambm pode querer utilizar outras.
Soluo
A SlideMe LLC oferece uma app store alternativa. A app store SlideME permite que
voc instale outros aplicativos (talvez voc queira integrar com outros aplicativos),
bem como que voc teste a experincia de publicar e efetuar o download de seus
prprios aplicativos em seu dispositivo emulado Android. A SlideME tambm alcana
muitos usurios Android que esto fora do Android Market, incluindo pessoas com
dispositivos no suportados e aqueles que no vivem em um pas onde h suporte
do Android Market.
Discusso
Uma alternativa ao Android Market oficial a SlideME, uma app store alternativa. A
SlideME pode no ter tantos aplicativos quanto o Android Market do Google, mas
tem algumas vantagens, incluindo o fato de que funciona facilmente em um dispositivo Android emulado.
V at o site da SlideME utilizando seu dispositivo Android emulado, navegue ou
busque aplicativos e clique em um aplicativo gratuito. Depois de uma pausa para
download do aplicativo, abra o download (a pequena seta no canto superior esquerdo),
revise a licena e inicie o arquivo .apk do qual voc efetuou o download para instalar
o aplicativo. Durante a instalao, ser pedido que voc revise e aceite a licena para
o software.
Assim que o aplicativo da SlideME tiver sido instalado, voc poder percorrer o
catlogo e instalar mais aplicativos sem utilizar o navegador. Isso muito mais fcil
do que utilizar um navegador web para efetuar o download dos aplicativos, j que
a apresentao projetada para o dispositivo Android; simplesmente escolha uma
categoria, navegue dentro dela, e escolha um aplicativo para instalar. Eu tive alguns
problemas de estabilidade utilizando o aplicativo em meu emulador ele congelou
em alguns casos , mas fui capaz de instalar alguns aplicativos bsicos gratuitos,
como o Grocery List.
1 N.T.: Android Market era o nome anterior da loja de aplicativos do Google, que hoje, unificada
s lojas de msica, filmes e livros, chamada de Google Play (fonte: Wikipdia).
45
Percebi, no frum de discusso Android Invasion no Linkedin.com, que alguns usurios

do Android ficaram desapontados ao perceber que muitos provedores de telefones
celulares no incluem o Android Market oficial em suas ofertas de telefones celulares
Android, e, a no ser que voc se sinta vontade em fazer o root2 e atualizar seu telefone Android, no h como acess-lo. A maioria dos clientes no se sente confortvel
em fazer o root e atualizar seus telefones, e, para eles, a SlideME oferece um modo
alternativo de encontrar aplicativos gratuitos e baratos para seus telefones.
Veja tambm
A SlideME tambm permite que voc publique seus aplicativos em sua app store; veja
a pgina Applications no site da SlideME.
Para informaes sobre o desenvolvimento de aplicativos para a SlideME, consulte
http://slideme.org/developers.
1.9 Compartilhando classes Java de outro projeto Eclipse

Ian Darwin
Problema
Voc deseja utilizar uma classe de outro projeto, mas no quer copiar e colar.
Soluo
Inclua o projeto como um projeto referenciado, e o Eclipse (e o DEX) cuidaro do
trabalho.
Discusso
Voc muitas vezes precisa reutilizar classes de outro projeto. Em meu programa de
monitoramento GPS, o JPSTrack, a verso do Android empresta classes como o mdulo de I/O de arquivos da verso Java SE. Voc certamente no deseja copiar e colar
classes inalteradas de um projeto para outro, pois isso torna a manuteno improvvel.
No caso mais simples, quando o projeto de biblioteca contm o cdigo-fonte das
classes que voc deseja importar, tudo que voc tem de fazer declarar o projeto que
contm as classes necessrias (a verso Java SE neste caso) como um projeto referenciado no path de compilao. Selecione Project->Properties->Java Build Path, selecione Projects,
e clique em Add. Na figura 1.16, eu estou incluindo o projeto SE jpstrack como uma
dependncia no projeto Android jpstrack.android.
2 N.T.: O rooting um processo que permite a usurios de smartphones, tablets, e outros dispositivos que executam o sistema operacional Android, obter controle privilegiado (conhecido como
acesso raiz) dentro do subsistema do Android (fonte: Wikipdia).
46
Android Cookbook
Figura 1.16 Tornando um projeto dependente de outro utilizando Eclipse padro.
Desenvolvedores mveis que tambm criam aplicativos para outras plataformas devem notar que essa tcnica no funciona se voc tem o plugin BlackBerry Java atual
(do final de 2011) instalado em sua instalao Eclipse. Esse um bug no plugin BlackBerry Java; ele sinaliza incorretamente at mesmo projetos no BlackBerry como
dependentes de projetos de biblioteca no BlackBerry, e marca o projeto como tendo
um erro, o que impede a gerao e execuo correta do cdigo. Remova o plugin
defeituoso ou coloque-o em uma instalao separada do Eclipse.
Como alternativa, crie um arquivo JAR utilizando o Ant ou o assistente do Eclipse.
Faa com que o outro projeto referencie esse arquivo como um JAR externo nas
configuraes do classpath. Ou copie fisicamente este arquivo para o diretrio libs e
faa referncia a ele a partir desse local.
Um mtodo mais novo que frequentemente mais confivel, e agora oficialmente
recomendado, mas til apenas se ambos os projetos forem projetos Android, declarar o projeto de biblioteca como tal na guia Project->Properties->Android->Library (marque
o boto Is Library), e utilizar o boto Add no outro projeto, na mesma tela, para listar o
projeto de biblioteca como uma dependncia do projeto principal (veja a figura 1.17).
Para fs da linha de comando, o primeiro mtodo envolve a edio do arquivo .classpath, enquanto o segundo simplesmente cria entradas no arquivo project.properties,
por exemplo:
47
# Projeto alvo
target=android-7
android.library=false
android.library.reference.1=../wheel
Figura 1.17 Tornando um projeto dependente de outro utilizando ADT.
Como voc provavelmente est mantendo ambos os projetos em controle de verso

(e se forem programas que em algum momento voc pretende lanar, voc deve!),
lembre-se de marcar ambos os projetos quando lanar o projeto Android um
dos pontos a favor do controle de verso que voc capaz de recriar exatamente o
que entregou.
Veja tambm
Consulte a documentao oficial sobre projetos de biblioteca.
1.10 Referenciando bibliotecas para implementar funcionalidades externas

Rachee Singh
Problema
Voc precisa referenciar uma biblioteca externa em seu cdigo-fonte.
48
Android Cookbook
Soluo
Obtenha o arquivo JAR da biblioteca requerida e inclua-o em seu projeto.
Discusso
Como exemplo, voc pode ter de utilizar o AndroidPlot, uma biblioteca para representao de diagramas e grficos em seu aplicativo, ou o OpenStreetMap, um projeto
wiki que cria e fornece dados e mapeamento geogrficos gratuitos. Se afirmativo, seu
aplicativo precisa referenciar essas bibliotecas. Voc pode fazer isso no Eclipse em
poucos passos simples:
1. Efetue o download do arquivo JAR correspondente biblioteca que voc deseja
utilizar.
2. Depois de criar seu projeto Android no Eclipse, clique com o boto direito
sobre o nome do projeto e selecione Properties no menu (Figura 1.18).
3. Na lista do lado esquerdo, selecione Java Build Path e clique na guia Libraries.
4. Clique no boto Add External JARs.
5. Fornea o local onde voc efetuou o download do arquivo JAR da biblioteca
que voc deseja utilizar.
Figura 1.18 Seleo de propriedades do projeto.
49
Nesse ponto, voc ver um diretrio Referenced Libraries em seu projeto. Os JARs que
voc incluiu vo aparecer (veja a figura 1.19).
Uma abordagem alternativa criar uma pasta lib em seu projeto, copiar fisicamente os
arquivos JAR para ela e inclu-los individualmente como voc fez antes, mas, em vez
disso, clicando no boto Add JARs. Isso mantm tudo em um lugar s (especialmente
se seu projeto for compartilhado por meio de um sistema de controle de verso com
outros que podem utilizar um sistema operacional diferente e incapaz de utilizar os
JARs externos no mesmo local). No entanto, isso eleva o fardo de responsabilidade para
questes de licenciamento referentes aos arquivos JAR includos (veja a figura 1.20).
Figura 1.19 Incluso de bibliotecas.
Em qualquer um dos casos, se voc tambm compilar com Ant, certifique-se de

atualizar seu arquivo build.xml.
Qualquer que seja o modo escolhido bastante fcil incluir bibliotecas em seu projeto.
50
Android Cookbook
Figura 1.20 Incluso do arquivo JAR externo.
1.11 Uso de exemplos do SDK para ajudar a evitar situaes de dvida

Daniel Fowler
Problema
s vezes difcil codificar determinada funcionalidade, especialmente quando a
documentao imprecisa ou no fornece nenhum exemplo.
Soluo
Analisar cdigos funcionais j existentes vai ajudar. O SDK do Android tem programas
de exemplo que voc pode destrinchar para ver como funcionam.
Discusso
O SDK do Android vem com vrios aplicativos de exemplo que podem ser teis
quando voc estiver tentando codificar alguma funcionalidade. Analisar o cdigo do
exemplo pode ser esclarecedor. Assim que voc tiver instalado o SDK do Android,
vrios exemplos se tornaro disponveis:
51
Accelerometer Play
Accessibility Service
API Demos
Backup and Restore
Bluetooth Chat
Business Card
Contact Manager
Cube Live Wallpaper
Home
Honeycomb Gallery
JetBoy
Lunar Lander
Multiple Resolutions
Near Field Communication
Note Pad
RenderScript
Sample Sync Adapter
Searchable Dictionary
Session Initiation Protocol
Snake
Soft Keyboard
Spinner
SpinnerTest
StackView Widget
TicTacToeLib
TicTacToeMain
USB
Wiktionary
Wiktionary (Simplified)
Weather List Widget
XML Adapters
Para abrir um projeto de exemplo a partir do Eclipse, abra o menu File e ento selecione Android Project (veja a figura 1.21).
52
Android Cookbook
Figura 1.21 Iniciando um novo projeto Android.
No dilogo New Android Project, selecione a opo Create project from existing sample. Clique em
Next e selecione o alvo de compilao. Uma lista de exemplos disponveis para o alvo
selecionado ser mostrada. Se o exemplo necessrio no for mostrado, volte e selecione
outro alvo de compilao. (O exemplo pode no estar instalado; o SDK Manager pode
ser utilizado para instalar exemplos adicionais se eles estiverem faltando durante o
setup do SDK.) Escolha o exemplo a ser carregado, clique em Finish, e o exemplo ser
copiado para o Workspace e compilado (com o progresso mostrado na barra de status).
Depois de pouco tempo o exemplo estar pronto para ser executado e voc ser capaz
de explorar o cdigo-fonte para ver como tudo feito.
Se os exemplos foram movidos do diretrio samples do SDK, utilize a opo Create
project from existing source no dilogo New Android Project para abrir o exemplo.
Quando o exemplo for executado pela primeira vez, selecione Android Application no
dilogo Run As que deve aparecer. Tambm pode ser necessrio configurar um AVD
apropriado para executar o exemplo (veja a receita 3.3). Veja a figura 1.22.
Figura 1.22 Demonstraes da API em ao.
53
Veja tambm
O site Android Developers em http://developer.android.com/index.html; este cookbook,
claro.
Voc tambm pode pesquisar a Web em busca de programas ou exemplos adicionais.
Se voc ainda no conseguiu encontrar o que precisa, pode buscar ajuda no Stack
Overflow (http://www.stackoverflow.com; utilize android como tag) ou no canal IRC
(Internet Relay Chat) #androiddev no freenode.
1.12 Mantendo o SDK do Android atualizado

Daniel Fowler
Problema
O SDK deve ser mantido atualizado para permitir que desenvolvedores de aplicativos
trabalhem com as APIs mais recentes na plataforma Android que est sempre em
evoluo.
Soluo
Utilize o programa Android SDK Manager para atualizar os pacotes SDK instalados
existentes e instalar novos pacotes SDK. Isso inclui pacotes de terceiros para funcionalidades de dispositivos especficos.
Discusso
O sistema operacional (SO) Android est evoluindo constantemente, e, portanto, o
mesmo vale para o SDK do Android. O desenvolvimento constante do Android
motivado por estes fatores:
A pesquisa e desenvolvimento do Google.
Fabricantes de telefones estarem sempre desenvolvendo dispositivos novos e
melhorados.
A resoluo de problemas de segurana e possveis exploits3.
A necessidade do suporte a novos dispositivos (por exemplo, o suporte a dispositivos tablet foi includo com a verso 3.0).
O suporte a novas interfaces de hardware (por exemplo, o suporte a comunicao de campo prximo foi includo na verso 2.3).
A correo de bugs.
3 N.T.: Um exploit, em segurana da informao, um programa de computador, ou uma sequncia
de comandos que aproveita das vulnerabilidades de um sistema computacional (fonte: Wikipdia).
54
Android Cookbook
Melhorias de funcionalidades (por exemplo, um novo engine JavaScript).

Alteraes no kernel Linux subjacente.
A substituio de interfaces de programao redundantes.
Novos usos (por exemplo, o Google TV).
A comunidade de desenvolvimento Android como um todo.
Abordamos a instalao do SDK do Android em outro local (veja a Receita 1.5 ou
http://developer.android.com/sdk/installing.html). Depois de o SDK ter sido instalado
na mquina de desenvolvimento e de o ambiente de programao estar sendo executado sem problemas, desenvolvedores tero, de vez em quando, de verificar se h
atualizaes para o SDK.
Voc pode manter o SDK atualizado executando o programa SDK Manager. (Em uma
mquina Windows, execute o SDK Manager.exe na pasta C:\Arquivos de Programas\
Android\androidsdk, ou utilize o menu Iniciar, e ento selecione Todos os Programas->Android
SDK Tools, e clique em SDK Manager). Voc tambm pode execut-lo dentro do Eclipse
(utilizando o menu Window e selecionando Android SDK Manager); veja a figura 1.23. O SDK
do Android dividido em vrios pacotes. O SDK Manager procura automaticamente
por atualizaes para pacotes existentes e vai listar novos pacotes e aqueles fornecidos
por fabricantes de dispositivos.
Figura 1.23 SDK Manager do Android.
Atualizaes disponveis sero mostradas em uma lista (assim como pacotes opcionais
disponveis). Se uma atualizao ou um pacote tiver termos de licena que requerem
aceitao eles sero mostrados com um ponto de interrogao. Destaque cada pacote
que tem um ponto de interrogao para ler os termos de licena. Voc pode aceitar
ou rejeitar o pacote utilizando os botes de opo. Pacotes rejeitados sero marcados
com um vermelho (veja a figura 1.24).
55
Figura 1.24 Escolha de pacotes do SDK.
Como alternativa, clique em Accept All para aceitar tudo que estiver disponvel. Todos
os pacotes e atualizaes que estiverem disponveis para download e instalao sero
mostrados com um sinal de visto verde.
Clique no boto Install para comear o download e a instalao; quando concludo,
clique no boto Close (veja a figura 1.25).
Figura 1.25 Janela de log do SDK Manager.
Se o prprio programa SDK Manager tiver sido atualizado, voc ver uma mensagem
pedindo que reinicie o programa (veja a figura 1.26).
O SDK Manager tambm utilizado para download de pacotes adicionais que no
so parte da plataforma padro. Esse mecanismo utilizado por fabricantes de dispositivos para fornecer suporte a seus prprios hardwares. Por exemplo, a LG Electronics
fornece um dispositivo 3D e, para oferecer suporte capacidade 3D em aplicativos,
um pacote adicional fornecido. Ele tambm utilizado pelo Google para permitir
o download de APIs opcionais.
56
Android Cookbook
Figura 1.26 Notificao de atualizao do SDK Manager.
Na caixa de dilogo do SDK Manager, expanda e marque os pacotes necessrios na

lista da esquerda e ento clique no boto Install (veja a figura 1.27). Se um pacote de
terceiros no estiver listado, o URL para um arquivo respository.xml, fornecido pelo
publicador do pacote, ter de ser digitado por meio do menu Tools.
Figura 1.27 Lista de componentes instalados e instalveis.
Possveis erros de atualizao no Windows

Em um sistema to complexo, h muitas coisas que podem dar errado. Esta seo
discute algumas dessas coisas e suas solues.
Execute o SDK Manager como administrador. Em uma mquina Windows, a localizao

padro para o SDK o diretrio C:\Arquivos de Programas\Android\android-sdk. Esse
um diretrio restrito e isso pode fazer com que a instalao do SDK fracasse. Um
dilogo de mensagem com o ttulo SDK Manager: failed to install pode aparecer
(veja a figura 1.28).
57
Figura 1.28 SDK Manager: falha ao instalar.
Para resolver esse erro h algumas coisas a verificar:

Desconecte quaisquer dispositivos Android (isso pode impedir o adb.exe de
fechar).
V at C:\Arquivos de Programas\Android\Android-sdk e abra as propriedades
para a pasta de ferramentas (selecione o menu de contexto e ento Propriedades).
Certifique-se de que a caixa seletora Somente leitura (arquivos da pasta) no
est clicada (veja figura 1.29).
Figura 1.29 Definio do atributo de leitura e escrita no Microsoft Windows.
Voc pode ter de dar permisso para alterar os atributos (veja a figura 1.30).
58
Android Cookbook
Figura 1.30 Confirmao de permisso necessria.
Uma caixa de dilogo de confirmao das modificaes de atributos vai aparecer;

certifique-se de que a opo Aplicar as alteraes a esta pasta, subpasta e arquivos
est selecionada e clique em OK. Ento, faa o seguinte:
Reinicie o computador.
Certifique-se de que todos os outros programas esto fechados, especialmente
qualquer cpia do Gerenciador de Arquivos.
Execute o SDK Manager.exe na conta de administrador. Abra o menu de contexto
e selecione Executar como administrador (veja a figura 1.31).
Figura 1.31 Executar como administrador.
Feche o ADB antes de atualizar. Uma mensagem pedindo que voc reinicie o ADB (o Android Debugger) pode aparecer (Figura 1.32).
Figura 1.32 Confirmao para reiniciar o ADB.
Idealmente, melhor executar o SDK Manager sem que o ADB esteja sendo executado,
e ele no deve estar sendo executado se o Windows tiver acabado de iniciar. Como
alternativa voc pode utilizar o Gerenciador de Tarefas do Windows para interromper o adb.exe. Se o ADB no estava sendo executado, responda No a esse prompt; do
contrrio, responda Yes.
59
O SDK Manager no pode se atualizar. Durante a instalao da atualizao do SDK pode

haver um erro relacionado ao programa SDK Manager (veja a figura 1.33).
Figura 1.33 Janela de log do SDK Manager do Android.
Para solucionar esse erro, certifique-se de que todos os programas esto fechados
(inclusive o adb.exe). Depois copie o SDK Manager.exe de C:\Arquivos de Programas\
Android\android-sdk\tools\lib para C:\Arquivos de Programas\Android\android-sdk (ou
onde quer que o SDK esteja instalado). Ento execute novamente o SDK Manager
(veja a figura 1.32).
Atualizao do Eclipse. Depois que voc atualizar o SDK e abrir o Eclipse, uma mensagem
de erro pode aparecer (veja a figura 1.34).
Figura 1.34 Verso incorreta do SDK do Android.
No Eclipse, selecione Help e ento Check for Updates. Espere at que o dilogo de progresso
termine e as atualizaes do Android Eclipse sejam mostradas. Clique em Next duas
vezes, e aceite os termos de licena. Ento, clique em Finish para comear o processo
de download e atualizao. Uma mensagem de aviso sobre contedo no assinado
pode aparecer. Clique em OK para aceitar o aviso (faa isso apenas se voc estiver
atualizando via Eclipse). Reinicie o Eclipse assim que a atualizao estiver concluda
(uma mensagem para isso vai aparecer).
Mais informaes sobre a resoluo de problemas do SDK Manager e do plugin do
Eclipse para Android esto disponveis no site Android Developers.
60
Android Cookbook
Veja tambm
Receita 1.5; Instalao do SDK; Incluso de componentes SDK; Plugin ADT para
Eclipse
1.13 Captura de tela do emulador/dispositivo Android

Rachee Singh
Problema
Voc deseja obter uma captura de tela de um aplicativo executado em um dispositivo
Android.
Soluo
Utilize a funcionalidade Device Screen Capture da viso DDMS (Dalvik Debug
Monitor Server) no Eclipse.
Discusso
Para utilizar a funcionalidade Device Screen Capture siga estes passos:
1. Execute o aplicativo no Eclipse e v at a viso DDMS (Window menu->Open Perspective->Other->DDMS) ou Window menu->Show View->Other->Android->Devices; a primeira
mostrada na figura 1.36). Note que a linha que diz Resourcedoes not exist
aparece na figura 1.35 apenas porque outro projeto Eclipse foi fechado, e no
afeta os passos listados aqui.
Figura 1.35 Iniciando a viso DDMS.
61
2. Na viso DDMS, selecione o dispositivo ou emulador cuja tela voc deseja

capturar.
3. Na viso DDMS, clique no cone Screen Capture (veja a figura 1-36).
Figura 1.36 Captura de tela do dispositivo.
4. Uma janela mostrando a tela atual do emulador/dispositivo Android ser

mostrada. Ela deve se parecer com a figura 1.37. Voc pode at salvar a captura
de tela e utiliz-la para descrever o aplicativo!
Figura 1.37 A captura de tela.
62
Android Cookbook
Veja tambm
Algumas distribuies fornecem modos alternativos de se obter capturas de tela.
O CyanogenMod 7.x fornece uma captura de tela no menu que surge quando voc
segura pressionado o boto de ligar/desligar. Alguns tablets HTC com suporte a
caneta oferecem capturas de tela no menu Pen. O Ice Cream Sandwich (Android 4.0)
fornece um mecanismo integrado para captura de tela em dispositivos reais: basta
pressionar o controle de diminuio de volume ao mesmo tempo em que o boto
de ligar/desligar e a imagem sero salvos em seu dispositivo e poder ser visualizada
no aplicativo de galeria.
1.14 Programa: um simples exemplo de CountDownTimer

Wagied Davids
Problema
Voc deseja um simples timer regressivo, um programa que far uma contagem regressiva a partir de um determinado nmero de segundos at atingir zero.
Soluo
O Android vem com uma classe integrada para construo de CountDownTimers. Ela
fcil de utilizar, eficiente e funciona (isso nem precisa dizer!).
Discusso
Os passos para fornecer um timer regressivo so estes:
1. Crie uma subclasse de CountDownTimer. O construtor dessa classe recebe dois
argumentos, CountDownTimer(long millisInFuture, long countDownInterval). O primeiro o nmero de milissegundos, contados a partir de agora, determinando
quando o intervalo deve estar concludo; nesse ponto o mtodo onFinish()
da subclasse ser chamado. O segundo a frequncia em milissegundos da
regularidade em que voc deseja ser notificado de que o timer ainda est em
execuo, normalmente para atualizar um monitor de progresso ou comunicar
o usurio de outra forma. O mtodo onTick() de sua subclasse ser chamado a
cada passagem desse nmero de milissegundos.
2. Substitua os mtodos onTick() e onFinish().
3. Instancie uma nova instncia em sua atividade Android.
4. Chame o mtodo start() na nova instncia criada!
63
O programa de exemplo de timer regressivo consiste em um layout XML (que pode

ser visto no exemplo 1.4) e um pouco de cdigo Java (exemplo 1.5). Quando executado, ele deve se parecer mais ou menos com a figura 1.38, ainda que os tempos sejam
provavelmente diferentes.
Exemplo 1.4 main.xml

<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_height="fill_parent">
<Button
android:id="@+id/button"
android:text="Start"
android:layout_height="wrap_content" />
<TableLayout
android:padding="10dip"
android:layout_gravity="center"
android:layout_height="wrap_content">
<TableRow>
<TextView
android:id="@+id/timer"
android:text="Time: "
android:paddingRight="10dip"
android:layout_width="wrap_content"
<TextView
android:id="@+id/timeElapsed"
android:text="Time elapsed: "
android:paddingRight="10dip"
</TableRow>
</TableLayout>
</LinearLayout>
Exemplo 1.5 Main.java

package com.examples;
import android.os.Bundle;
64
Android Cookbook
import
import
import
import
import
android.os.CountDownTimer;
android.view.View;
android.view.View.OnClickListener;
android.widget.Button;
android.widget.TextView;
public
{

class Main extends Activity implements OnClickListener

private
private
private
private
private
private
private
private
MalibuCountDownTimer countDownTimer;
long timeElapsed;
boolean timerHasStarted = false;
Button startB;
TextView text;
TextView timeElapsedView;
final long startTime = 50 * 1000;
final long interval = 1 * 1000;
/** Chamado quando a atividade criada pela primeira vez */

@Override
public void onCreate(Bundle savedInstanceState)
{
setContentView(R.layout.main);
startB = (Button) this.findViewById(R.id.button);
startB.setOnClickListener(this);
text = (TextView) this.findViewById(R.id.timer);
timeElapsedView = (TextView) this.findViewById(R.id.timeElapsed);
countDownTimer = new MalibuCountDownTimer(startTime, interval);
text.setText(text.getText() + String.valueOf(startTime));
}
@Override
public void onClick(View v)
{
if (!timerHasStarted)
{
countDownTimer.start();
timerHasStarted = true;
startB.setText("Start");
}
else
{
countDownTimer.cancel();
timerHasStarted = false;
startB.setText("RESET");
}
}
65

// Classe CountDownTimer
public class MalibuCountDownTimer extends CountDownTimer
{
public MalibuCountDownTimer(long startTime, long interval)
{
super(startTime, interval);
}
@Override
public void onFinish()
{
text.setText("Time's up!");
timeElapsedView.setText("Time Elapsed: " +
String.valueOf(startTime));
}
@Override
public void onTick(long millisUntilFinished)
{
text.setText("Time remain:" + millisUntilFinished);
timeElapsed = startTime - millisUntilFinished;
timeElapsedView.setText("Time Elapsed: " +
String.valueOf(timeElapsed));
}
}
}
Figura 1.38 Reset do timer.
66
Android Cookbook
URL de download do cdigo-fonte

O cdigo-fonte para esse exemplo est no repositrio do Android Cookbook,
em http://github.com/AndroidCook/Android-Cookbook-Examples, no subdiretrio
CountDownTimerExample (veja Obteno e uso de exemplos de cdigo na pgina 20).
1.15 Programa: Tipster, um calculador de gorjetas para o Android OS

Sunit Katkar
Problema
Quando voc vai com amigos a um restaurante e deseja dividir a conta e a gorjeta,
pode se envolver em muitos clculos manuais e controvrsias. Em vez disso, voc
deseja utilizar um aplicativo que permita que voc simplesmente some o percentual
da gorjeta ao total e divida o valor pelo nmero de presentes. O Tipster uma implementao disso no Android, para mostrar um aplicativo completo.
Soluo
Este um exerccio simples que utiliza os elementos bsicos da GUI (graphical user
interface, ou interface grfica de usurio), combinando-os a alguns clculos simples
e a um cdigo de UI (user interface, ou interface de usurio) orientada a eventos para
reunir todos os elementos. Ns utilizaremos os seguintes componentes de GUI:
TableLayout
Fornece controle adequado sobre o layout da tela. Esse layout permite que voc
utilize o paradigma da tag HTML Table para posicionar os widgets.
TableRow
Define uma linha no TableLayout. como as tags HTML TR e TD combinadas.

TextView
Essa View fornece um rtulo para apresentao de texto esttico na tela.

EditText
Essa View fornece um campo de texto para entrada de valores.

RadioGroup
Agrupa botes de opo.

RadioButton
Fornece um boto de opo.
67
Button
Esse o boto normal.

View
Ns utilizaremos uma View para criar um separador visual com certos atributos
de altura e cor.
Discusso
O Android utiliza arquivos XML para o layout de widgets. Em nosso projeto de
exemplo, o plugin do Android para Eclipse gera um arquivo main.xml para o layout.
Esse arquivo tem as definies XML dos vrios widgets e de seus contineres.
H um arquivo strings.xml que tem todos os recursos de strings utilizados no aplicativo.
Um arquivo icon.png padro fornecido para o cone do aplicativo.
E h tambm o arquivo R.java que gerado automaticamente (e atualizado quando
quaisquer alteraes so feitas ao main.xml). Esse arquivo tem as constantes definidas
para cada layout e widget. No edite esse arquivo manualmente; o plugin far isso
para voc ao efetuar qualquer modificao em seus arquivos XML.
Em nosso exemplo temos Tipster.java como o arquivo Java principal para a Activity.
A receita 1.4, assim como diversos tutoriais do Google, mostra como utilizar o plugin.
Utilizando o plugin do Eclipse, crie um projeto Android chamado Tipster. O resultado
final ser um layout de projeto que se parecer com o da figura 1.39.
Criao do layout e posicionamento dos widgets

O objetivo final criar um layout semelhante quele mostrado na figura 1.39.
Para o layout dessa tela voc vai utilizar estes layouts e widgets:
TableLayout
Fornece controle adequado sobre o layout da tela. Esse layout permite que voc
utilize o paradigma da tag HTML Table para posicionar os widgets.
TableRow
Define uma linha no TableLayout. como as tags HTML TR e TD combinadas.

TextView
Essa View fornece um rtulo para apresentao de texto esttico na tela.

EditText
Essa View fornece um campo de texto para entrada de valores.
68
Android Cookbook
RadioGroup
Agrupa botes de opo.

RadioButton
Fornece um boto de opo.

Button
Esse o boto normal.

View
Ns utilizaremos uma View para criar um separador visual com certos atributos
de altura e cor.
Familiarize-se com esses widgets j que voc vai utiliz-los bastante nos aplicativos que
construir. Ao verificar os Javadocs relacionados a layouts e widgets, d uma olhada
nos atributos XML. Isso vai ajud-lo a correlacionar o uso no arquivo de layout main.
xml e o cdigo Java (Tipster.java e R.java) onde eles so acessados.
Tambm est disponvel um editor visual de layout no ADT do Eclipse, bem como
uma ferramenta independente de UI chamada DroidDraw, ambas as quais permitem
que voc crie um layout arrastando e soltando widgets a partir de uma paleta, como
qualquer ferramenta de design de formulrios. No entanto, recomendo que voc crie o
layout mo em XML, pelo menos nos estgios iniciais de seu aprendizado Android.
Futuramente, medida que aprender todas as nuances da API de layout XML, voc
poder delegar essa tarefa a tais ferramentas.
O arquivo de layout, main.xml, tem as informaes de layout (veja o exemplo 1.6). Um
widget TableRow cria uma nica linha dentro do TableLayout. Por isso voc utiliza tantas
TableRows quanto for o nmero de linhas que deseja. Neste tutorial, vamos utilizar oito
TableRows cinco para os widgets at o separador visual abaixo dos botes, e trs para
a rea de resultados abaixo dos botes e do separador.
Exemplo 1.6 /res/layout/main.xml


<TableLayout
android:id="@+id/TableLayout01"
android:layout_height="fill_parent"
android:stretchColumns="1"
xmlns:android="http://schemas.android.com/apk/res/android">

<TableRow>
<TextView
android:id="@+id/txtLbl1"
android:layout_column="0"
android:text="@string/textLbl1"/>
<EditText
android:id="@+id/txtAmount"
android:numeric="decimal"
android:layout_span="2"
/>
</TableRow>

<TableRow>
<TextView
<EditText
android:id="@+id/txtPeople"
android:numeric="integer"
android:layout_span="3"/>
</TableRow>

<TableRow>
<TextView
</TableRow>

<TableRow>
<RadioGroup
android:id="@+id/RadioGroupTips"
android:orientation="horizontal"
android:layout_span="3"
android:checkedButton="@+id/radioFifteen">
<RadioButton android:id="@+id/radioFifteen"
android:text="@string/rdoTxt15"
android:textSize="15sp" />
<RadioButton android:id="@+id/radioTwenty"
android:text="@string/rdoTxt20"
<RadioButton android:id="@+id/radioOther"
android:text="@string/rdoTxtOther"
</RadioGroup>
<EditText
android:id="@+id/txtTipOther"
android:numeric="decimal"/>
</TableRow>

<TableRow>
<Button
android:id="@+id/btnReset"
android:text="@string/btnReset"/>
<Button
android:id="@+id/btnCalculate"

android:text="@string/btnCalculate"/>
</TableRow>

<View
android:layout_height="2px"
android:background="#DDFFDD"
android:layout_marginTop="5dip"
android:layout_marginBottom="5dip"/>

<TableRow android:paddingBottom="10dip" android:paddingTop="5dip">
<TextView
<TextView
android:id="@+id/txtTipAmount"
</TableRow>
<TextView
<TextView
android:id="@+id/txtTotalToPay"
</TableRow>
<TextView
71
72
Android Cookbook
<TextView
android:id="@+id/txtTipPerPerson"
</TableRow>

</TableLayout>
TableLayout e TableRow
Depois de analisar main.xml, voc pode perceber que TableLayout e TableRow so simples
de usar. Voc cria o TableLayout uma vez, e ento insere uma TableRow. Agora voc est
livre para inserir quaisquer outros widgets, como TextView, EditView e assim por diante,
dentro dessa TableRow.
No deixe de dar uma olhada nos atributos, especialmente em android:stretchColumns,
android:layout_column e android:layout_span, os quais permitem que voc posicione widgets
da mesma forma que voc faria com uma tabela HTML comum. Recomendo que voc
siga os links para esses atributos e aprenda como eles funcionam em um TableLayout.
Controle de valores de entrada

D uma olhada no widget EditText, marcado no arquivo main.xml como . Esse o
primeiro campo de texto para entrada do Valor total da conta. Queremos apenas
nmeros aqui. Podemos aceitar nmeros decimais porque contas de restaurantes
reais tambm podem ter valores em centavos, e no apenas nmeros inteiros. Por isso
utilizamos o atributo android:numeric com um valor de decimal. Isso permitir valores
de nmeros inteiros, como 10, e valores decimais, como 10.12, mas impedir qualquer
outro tipo de entrada.
Essa uma forma simples e concisa de controlar valores de entrada, economizando-nos
o trabalho de escrever cdigo de validao no arquivo Tipster.java, e garantindo que
o usurio no digite valores errados. Essa funcionalidade do Android de limitao
com base em XML bastante poderosa e til. Voc deve explorar todos os atributos
possveis que acompanham um widget especfico para extrair o mximo de benefcios desse modo XML abreviado de definir restries. Em um lanamento futuro, a
no ser que eu no tenha visto isso nesta verso, eu espero que o Android permita a
entrada de intervalos para o atributo android:numeric, de modo que voc possa definir
qual intervalo de nmeros deseja aceitar.
73
Como (at onde eu sei) intervalos atualmente no esto disponveis, voc ver futuramente que temos realmente de verificar a presena de certos valores, como zero ou
valores vazios, para garantir que as contas de nosso calculador de gorjeta no falhem.
Anlise do Tipster.java
Agora vamos analisar o arquivo Tipster.java que controla nosso aplicativo. Essa a
classe principal que cuida do layout, do tratamento de eventos e da lgica do aplicativo.
O plugin do Eclipse para Android cria o arquivo Tipster.java em nosso projeto com
o cdigo padro que pode ser visto no exemplo 1.7.
Exemplo 1.7 Trecho de cdigo 1 de /src/com/examples/tipcalc/Tipster.java

package com.examples.tipcalc;
public class Tipster extends Activity {
@Override
}
}
A classe Tipster estende a classe android.app.Activity. Uma atividade uma nica ao

concentrada que o usurio pode realizar. A classe Activity cuida de criar a janela e
depois de apresentar a UI. Voc tem de chamar o mtodo setContentView(View view) para
colocar sua UI na Activity. Por isso, pense em Activity como uma moldura externa
que est vazia, e que voc preenche com sua UI.
Agora verifique o trecho da classe Tipster.java que pode ser visto no exemplo 1.8. Primeiro, definimos os widgets como membros de classe. Verifique, mais especificamente,
de a para referncia.
Ento, utilizamos o mtodo findViewById(int id) para localizar os widgets. O ID de cada
widget, definido em seu arquivo main.xml, automaticamente definido no arquivo
R.java quando voc limpa e compila o projeto no Eclipse. (Se voc configurou o Eclipse
para compilar automaticamente, o arquivo R.java ser atualizado instantaneamente
quando voc atualizar main.xml.)
Cada widget derivado da classe View, e fornece funcionalidades GUI especiais. Assim,
uma TextView fornece uma forma de colocar rtulos na UI, enquanto que o EditText
fornece um campo de texto. Verifique de a no exemplo 1.8. Voc pode ver como
findViewById() utilizado para localizar os widgets.
74
Android Cookbook

public class Tipster extends Activity {
// Widgets do aplicativo
private EditText txtAmount;
private EditText txtPeople;
private EditText txtTipOther;
private RadioGroup rdoGroupTips;
private Button btnCalculate;
private Button btnReset;

private TextView txtTipAmount;

private TextView txtTotalToPay;
private TextView txtTipPerPerson;
// Para o id do boto de opo selecionado

private int radioCheckedId = -1;

@Override
// Acessa os vrios widgets por id em R.java
txtAmount = (EditText) findViewById(R.id.txtAmount);
// No carregamento do aplicativo, o cursor deve estar no campo Amount
txtAmount.requestFocus();

txtPeople = (EditText) findViewById(R.id.txtPeople);

txtTipOther = (EditText) findViewById(R.id.txtTipOther);
rdoGroupTips = (RadioGroup) findViewById(R.id.RadioGroupTips);
btnCalculate = (Button) findViewById(R.id.btnCalculate);

// No carregamento do aplicativo, o boto Calculate est desabilitado
btnCalculate.setEnabled(false);

btnReset = (Button) findViewById(R.id.btnReset);
txtTipAmount = (TextView) findViewById(R.id.txtTipAmount);

txtTotalToPay = (TextView) findViewById(R.id.txtTotalToPay);
txtTipPerPerson = (TextView) findViewById(R.id.txtTipPerPerson);
// No carregamento do aplicativo, desabilite o campo de texto Other Tip Percentage

txtTipOther.setEnabled(false);
Lidando com consideraes de facilidade de uso ou usabilidade

Nosso aplicativo deve tentar ser to utilizvel quanto qualquer outro aplicativo ou
pgina web consolidado. Em resumo, incluir recursos de usabilidade resultar em
uma boa experincia de usurio. Para lidar com essas consideraes, d uma olhada
no exemplo 1.8 novamente.
75
Veja , onde utilizamos o mtodo requestFocus() da classe View. Como o widget EditText
derivado da classe View, esse mtodo aplicvel a ele. Isso feito para que, quando
nosso aplicativo carregar, o campo de texto Total Amount receba foco e o cursor seja posicionado nele. Isso semelhante tela de login de aplicativos web populares onde
o cursor est presente no campo de texto do nome do usurio.
Agora verifique
onde o boto Calculate desabilitado chamando o mtodo
setEnabled(boolean enabled) no widget Button. Isso feito para que o usurio no possa
clicar nele antes de digitar valores nos campos obrigatrios. Se permitssemos que
o usurio clicasse em Calculate sem digitar valores nos campos Total Amount e No. of People,
teramos de escrever um cdigo de validao para capturar essas condies. Isso significaria mostrar um alerta em popup avisando o usurio dos valores vazios. Algo desse
tipo adicionaria cdigo e interao de usurio desnecessrios. Quando o usurio v
o boto Calculate desabilitado, fica bastante bvio que, a no ser que todos os valores
sejam digitados, a gorjeta no poder ser calculada.
Verifique no exemplo 1.8. Aqui o campo de texto Other Tip Percentage est desabilitado.
Isso feito porque o boto de opo 15% tip selecionado por padro quando o
aplicativo carrega. Essa seleo padro no carregamento do aplicativo feita por meio
do arquivo main.xml. D uma olhada na linha de main.xml onde a instruo a seguir
seleciona o boto de opo 15% tip:
android:checkedButton="@+id/radioFifteen"
O atributo android:checkedButton de RadioGroup permite que voc selecione um dos widgets

RadioButton no grupo por padro.
A maioria dos usurios que j utilizou aplicativos populares no desktop ou na web
est familiarizada com o paradigma widgets desabilitados que so habilitados em
certas condies. Incluir essas pequenas convenincias sempre torna um aplicativo
mais utilizvel e a experincia do usurio mais rica.
Processamento de eventos da UI
Semelhante aos populares frameworks de UI do Windows, Java Swing, Flex e outros, o
Android tambm fornece um modelo de eventos que permite a voc escutar determinados eventos na UI provocados pela interao do usurio. Vejamos como podemos
utilizar o modelo de eventos do Android em nosso aplicativo.
Primeiro, vamos nos concentrar nos botes de opo da UI. Queremos saber qual
boto de opo o usurio selecionou, uma vez que isso nos permitir determinar o
percentual de gorjeta em nossos clculos. Para escutar botes de opo, utilizamos
a interface esttica OnCheckedChangeListener(). Isso vai nos notificar quando o estado de
seleo de um boto de opo mudar.
76
Android Cookbook
Em nosso aplicativo, queremos habilitar o campo de texto Other Tip Percentage apenas
quando o boto de opo Other estiver selecionado. Quando os botes 15% tip e
20% tip estiverem selecionados, ns queremos desabilitar esse campo de texto. Alm
disso, queremos incluir um pouco mais de lgica em nome da usabilidade. Como
discutimos antes, no devemos habilitar o boto Calculate at que todos os campos
obrigatrios tenham valores vlidos. Em termos dos trs botes de opo, queremos
garantir que o boto Calculate esteja habilitado para as duas condies a seguir:
O boto de opo Other est selecionado e o campo de texto Other Tip Percentage
tem valores vlidos.
Os botes de opo 15% tip ou 20% tip esto selecionados e os campos de
texto Total Amount e No. of People tm valores vlidos.
Veja o exemplo 1.9, o qual lida com os botes de opo. Os comentrios do cdigo-fonte so bastante autoexplicativos.

/*
* Anexa um OnCheckedChangeListener ao grupo de opo
* para monitorar botes de opo selecionados pelo usurio
*/
rdoGroupTips.setOnCheckedChangeListener(new OnCheckedChangeListener() {
@Override
public void onCheckedChanged(RadioGroup group, int checkedId) {
// Habilita/desabilita o campo Other Tip Percentage
if (checkedId == R.id.radioFifteen || checkedId == R.id.radioTwenty) {
txtTipOther.setEnabled(false);
/*
* Habilita o boto Calculate se os campos Total
* Amount e No. of People tiverem valores vlidos
*/
btnCalculate.setEnabled(txtAmount.getText().length() > 0
&& txtPeople.getText().length() > 0);
}
if (checkedId == R.id.radioOther) {
// Habilita o campo Other Tip Percentage
txtTipOther.setEnabled(true);
// define o foco para este campo
txtTipOther.requestFocus();
/*
* Habilita o boto Calculate se os campos Total Amount e No. of People tiverem
* valores vlidos. Tambm assegura que o usurio digitou um valor em Other Tip
* Percentage antes de habilitar o boto Calculate
*/
77
&& txtPeople.getText().length() > 0
&& txtTipOther.getText().length() > 0);
}
// Para determinar a escolha do percentual de gorjeta feita pelo usurio
radioCheckedId = checkedId;
}
});
Monitorando atividade de teclas em campos de texto

Como mencionei antes, o boto Calculate no deve ser habilitado a no ser que os
campos de texto tenham valores vlidos. Ento temos de garantir que o boto Calculate
seja habilitado apenas se os campos de texto Total Amount, No. of People e Other Tip Percentage
tiverem valores vlidos. O campo de texto Other Tip Percentage ser habilitado apenas se
o boto de opo Other Tip Percentage for selecionado.
No temos de nos preocupar com o tipo dos valores, ou seja, se o usurio digitou
ou no nmeros negativos ou letras, pois o atributo android:numeric foi definido para
os campos de texto, limitando, dessa forma, os tipos de valores que o usurio pode
digitar. Temos apenas de garantir que os valores estejam presentes.
Ento utilizamos a interface esttica OnKeyListener(). Ela vai nos notificar quando uma
tecla for pressionada. A notificao chegar at ns antes de a tecla pressionada em si
ser enviada para o widget EditText.
Verifique o cdigo nos exemplos 1.10 e 1.11, que lidam com eventos de teclas em
campos de texto. Assim como no exemplo 1.9, os comentrios do cdigo-fonte so
bastante autoexplicativos.

/*
* Anexa um KeyListener aos campos de texto Tip Amount, No. of People
* e Other Tip Percentage
*/
txtAmount.setOnKeyListener(mKeyListener);
txtPeople.setOnKeyListener(mKeyListener);
txtTipOther.setOnKeyListener(mKeyListener);
Note que criamos apenas um ouvinte, em vez de criar ouvintes annimos/internos

para cada campo de texto. No tenho certeza se meu estilo melhor ou recomendado,
mas sempre escrevo dessa forma se os ouvintes vo realizar aes habituais. Aqui, a
preocupao comum a todos os campos de texto que eles no devem estar vazios,
e apenas quando tiverem valores que o boto Calculate deve ser habilitado.
78
Android Cookbook
Exemplo 1.11 Trecho de cdigo 5 de KeyListener.java

/*
* KeyListener para os campos de texto Total Amount, No of People e Other Tip
* Percentage. Precisamos aplicar esse ouvinte de teclas para verificar estas condies:
*
* 1) Se o usurio selecionar Other Tip Percentage, o campo de texto Other Tip Percentage
* deve ter um percentual de gorjeta vlido inserido pelo usurio. Habilite o
* boto Calculate apenas quando o usurio digitar um valor vlido.
*
* 2) Se o usurio no digitar valores nos campos Total Amount e No. of People,
* no poderemos realizar os clculos. Assim, habilitaremos o boto Calculate
* apenas quando o usurio digitar valores vlidos.
*/
private OnKeyListener mKeyListener = new OnKeyListener() {
@Override
public boolean onKey(View v, int keyCode, KeyEvent event) {
switch (v.getId()) {
case R.id.txtAmount:
case R.id.txtPeople:
&& txtPeople.getText().length() > 0);
break;
case R.id.txtTipOther:
&& txtPeople.getText().length() > 0
&& txtTipOther.getText().length() > 0);
break;
}
return false;
}
};
Em no exemplo 1.11, analisamos o ID da View. Lembre-se de que cada widget tem

um ID nico definido no arquivo main.xml. Esses valores so, ento, definidos na
classe R.java gerada.
Em e , se o evento-chave ocorreu nos campos Total Amount ou No. of People, verificamos
o valor digitado no campo. Estamos garantindo que o usurio no tenha deixado
ambos os campos em branco.
Em , verificamos se o usurio selecionou o boto de opo Other, e ento garantimos
que o campo de texto Other no esteja vazio. Tambm verificamos mais uma vez se os
campos Total Amount e No. of People esto vazios.
Assim, o propsito de nosso KeyListener agora est claro: garantir que todos os campos
de texto no estejam vazios, e apenas ento habilitar o boto Calculate.
79
Escutando cliques em botes

Agora vamos verificar os botes Calculate e Reset. Quando o usurio clicar nesses botes, utilizaremos a interface esttica OnClickListener() que nos informar quando um
boto for clicado.
Como fizemos com os campos de texto, criamos apenas um ouvinte e, dentro dele,
detectamos qual boto foi clicado. Dependendo do boto que foi clicado, o mtodo
calculate() ou reset() ser chamado.
O exemplo 1.12 mostra como o ouvinte de cliques adicionado aos botes.

/* Anexa um ouvinte aos botes Calculate e Reset */
btnCalculate.setOnClickListener(mClickListener);
btnReset.setOnClickListener(mClickListener);
O exemplo 1.13 mostra como detectar qual boto foi clicado verificando o ID da View
que recebe o evento de clique.

/**
* ClickListener para os botes Calculate e Reset.
* Dependendo do boto clicado, o mtodo correspondente ser chamado.
*/
private OnClickListener mClickListener = new OnClickListener() {
@Override
public void onClick(View v) {
if (v.getId() == R.id.btnCalculate) {
calculate();
} else {
reset();
}
}
};
Reset do aplicativo
Quando o usurio clicar no boto Reset, os campos de texto devero ser limpos, o
boto de opo-padro 15% tip dever ser selecionado, e quaisquer resultados
calculados devero ser limpos.
O exemplo 1.14 mostra o mtodo reset().
80
Android Cookbook

/**
* Faz o reset das vises de texto dos resultados na parte inferior da tela,
* assim como dos campos de texto e dos botes de opo.
*/
private void reset() {
txtTipAmount.setText("");
txtTotalToPay.setText("");
txtTipPerPerson.setText("");
txtAmount.setText("");
txtPeople.setText("");
txtTipOther.setText("");
rdoGroupTips.clearCheck();
rdoGroupTips.check(R.id.radioFifteen);
// define o foco no primeiro campo
txtAmount.requestFocus();
}
Validao da entrada para calcular a gorjeta

Como eu disse antes, estamos limitando o tipo de valor que o usurio pode digitar
nos campos de texto. No entanto, o usurio ainda pode digitar um valor de zero nos
campos de texto Total Amount, No. of People e Other Tip Percentage, provocando, dessa forma,
condies de erro, como diviso por zero, em nossos clculos de gorjetas.
Se o usurio digitar zero, devemos mostrar um popup de alerta pedindo que digite
um valor diferente de zero. Lidaremos com isso utilizando um mtodo chamado
showErrorAlert(String errorMessage, final int fieldId), mas discutiremos isso mais detalhadamente no futuro.
Primeiro, verifique o exemplo 1.15, o qual mostra o mtodo calculate(). Note como os
valores digitados pelo usurio so processados como valores do tipo Double.
Agora perceba e , onde verificamos a presena de valores iguais a zero. Se o usurio
digitar zero, mostraremos um popup de alerta para avis-lo. Depois, verifique , onde
o campo de texto Other Tip Percentage habilitado porque o usurio selecionou o boto
de opo Other. Aqui tambm devemos verificar se o percentual de gorjeta no zero.
Quando o aplicativo carregar, o boto de opo 15% tip ser selecionado por padro.
Se o usurio modificar a seleo, atribuiremos o ID do boto de opo selecionado
varivel membro radioCheckedId, como vimos no exemplo 1.9, em OnCheckedChangeListener.
Mas se o usurio aceitar a seleo padro, o radioCheckedId ter o valor padro de 1.
Em resumo, nunca saberemos qual boto de opo foi selecionado. Ns sabemos,
claro, qual est selecionado por padro, e poderamos ter codificado a lgica de modo
81
levemente diferente, para presumir 15% se radioCheckedId tiver o valor de 1. Mas se

voc consultar a API, ver que podemos chamar o mtodo getCheckedRadioButtonId() no
RadioGroup e no em botes individuais de opo. Isso ocorre porque OnCheckedChangeListener
nos fornece prontamente o ID do boto de opo selecionado.
Apresentao dos resultados

Calcular a gorjeta simples. Se no houver nenhum erro de validao, a flag booleana isError ser false. Verifique de a no exemplo 1.15 para observar os clculos
simples da gorjeta. Na sequncia, os valores calculados sero definidos nos widgets
TextView de a .

/**
* Calcule a gorjeta de acordo com os dados digitados pelo usurio
*/
private void calculate() {
Double billAmount = Double.parseDouble(txtAmount.getText().toString());
Double totalPeople = Double.parseDouble(txtPeople.getText().toString());
Double percentage = null;
boolean isError = false;
if (billAmount < 1.0) {
showErrorAlert("Enter a valid Total Amount.", txtAmount.getId());
isError = true;
}
if (totalPeople < 1.0) {
showErrorAlert("Enter a valid value for No. of People.", txtPeople.getId());
isError = true;
}
/*
* Se o usurio nunca modificar sua seleo de opo,
* significa que a seleo padro de 15% est em efeito. Mas mais seguro verificar
*/
if (radioCheckedId == -1) {
radioCheckedId = rdoGroupTips.getCheckedRadioButtonId();
}
if (radioCheckedId == R.id.radioFifteen) {
percentage = 15.00;
} else if (radioCheckedId == R.id.radioTwenty) {
percentage = 20.00;
} else if (radioCheckedId == R.id.radioOther) {
percentage = Double.parseDouble(
txtTipOther.getText().toString());
if (percentage < 1.0) {
82
Android Cookbook
showErrorAlert("Enter a valid Tip percentage", txtTipOther.getId());
isError = true;
}
}
/*
* Se todos os campos estiverem preenchidos com valores vlidos, prossiga
* para o clculo das gorjetas
*/
if (!isError) {
Double tipAmount = ((billAmount * percentage) / 100);
Double totalToPay = billAmount + tipAmount;
Double perPersonPays = totalToPay / totalPeople;
txtTipAmount.setText(tipAmount.toString());
txtTotalToPay.setText(totalToPay.toString());
txtTipPerPerson.setText(perPersonPays.toString());
}
}
Apresentao dos alertas

O Android fornece a classe AlertDialog para mostrar popups de alerta. Isso nos permite
mostrar uma caixa de dilogo com at trs botes e uma mensagem.
O exemplo 1.16 mostra o mtodo showErrorAlert, o qual utiliza esse AlertDialog para mostrar
as mensagens de erro. Perceba que informamos dois argumentos a esse mtodo: String
error Message e int fieldId. O primeiro argumento a mensagem de erro que queremos
mostrar ao usurio. O fieldId o ID do campo que causou a condio de erro. Depois
que o usurio dispensar o dilogo de alerta, esse fieldId nos permitir solicitar o foco
para esse campo, de modo que o usurio saiba qual campo contm o erro.

/**
* Mostra a mensagem de erro no dilogo de alerta
*
* @param errorMessage
* String a ser mostrada pela mensagem de erro
* @param fieldId
* o Id do campo que provocou o erro. Isso necessrio para que o foco possa ser definido
* nesse campo assim que o dilogo for dispensado.
*/
private void showErrorAlert(String errorMessage,
final int fieldId) {
new AlertDialog.Builder(this).setTitle("Error")
.setMessage(errorMessage).setNeutralButton("Close",
new DialogInterface.OnClickListener() {
83

@Override
public void onClick(DialogInterface dialog,
int which) {
findViewById(fieldId).requestFocus();
}
}).show();
}
Quando reunimos tudo isso, o resultado deve ficar como a figura 1.39.
Figura 1.39 Tipster em ao.
Concluso
O desenvolvimento para o OS Android no to diferente do desenvolvimento para
qualquer kit de ferramentas de UI, incluindo Microsoft Windows, X Windows, Java
Swing ou Adobe Flex. O Android tem, claro, suas diferenas e, em geral, um design
muito bom. O paradigma de layout em XML muito interessante e til para criao
de UIs complexas utilizando XML simples. Alm disso, o modelo de tratamento de
eventos simples, rico em funcionalidades e intuitivo de se utilizar no cdigo.
URL de download do cdigo-fonte

Voc pode efetuar o download do cdigo-fonte para esse exemplo em http://www.
vidyut.com/sunit/android/tipster.zip.
URL de download do binrio

Voc pode efetuar o download do cdigo executvel para esse exemplo em http://www.
vidyut.com/sunit/android/tipster.zip.

Android Cookbook

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Android Cookbook

Uploaded by

Copyright:

Available Formats

Android Cookbook

Novatec Editora Ltda.

Internacionais de Catalogao na Publicao

1.1 Introduo: primeiros passos

1.2 Aprendendo a linguagem Java

Ponto de entrada de aplicativo main() Veja a receita 1.6

A maior parte do android.* substitui a API Java ME

Projetados para uso no lado do servidor

Captulo 1 Primeiros passos

1.3 Criao de um aplicativo Ol, mundo a partir da linha de comando

Exemplo 1.1 Criao de um novo projeto

A tabela 1.2 lista os argumentos para o cdigo create project.

Nome de sua classe principal e nome-padro para o arquivo

Nome do projeto e do arquivo .apk gerado

Nome do pacote Java para suas classes

Path (caminho) no qual o projeto ser criado (no cria um

(veja o exemplo anterior para Windows)

Se ele no puder completar a operao solicitada, o comando android apresentar uma

Arquivo de configurao do projeto, com informaes essenciais

Binrios gerados (arquivos de classe compilados)

Arquivo de propriedades editvel

Arquivo de controle de compilao Ant padro

default.properties ou project.properties Armazena a verso do SDK e as bibliotecas utilizadas; mantido

Arquivos de recursos importantes (strings.xml, layouts etc.)

Cdigo-fonte de seu aplicativo

Captulo 1 Primeiros passos

Fonte da atividade de incio equivalente a main

Cpias da maioria dos anteriores

uma prtica normal e recomendada no Android criar sua interface de usurio em

Exemplo 1.2 HelloWorld.java

para o emulador Android especificando a resoluo-alvo, o nvel de API e assim por

Para mais detalhes sobre a criao de um AVD (veja a receita 3.3).

A flag -e para o emulador; utilize -d para um dispositivo real.

1.4 Criao de um aplicativo Ol, mundo no Eclipse

Captulo 1 Primeiros passos

Figura 1.1 Comeando a criar um projeto Eclipse.

Figura 1.2 Configurao de parmetros para um novo projeto Eclipse.

Figura 1.3 Definio do SDK alvo para um novo projeto Eclipse.

Captulo 1 Primeiros passos

Figura 1.4 Uso do editor do Eclipse para definir gravity em um TextView.

Na realidade, se voc definir gravity como center_vertical no LinearLayout e defini-lo

Exemplo 1.3 Layout do XML

Figura 1.5 Executando um projeto Android Eclipse.

Isso iniciar o emulador do Android se ele ainda no estiver sendo executado. O

Captulo 1 Primeiros passos

Figura 1.6 O projeto Android sendo inicializado no emulador.

Figura 1.7 Projeto Eclipse sendo executado no emulador.

1.5 Configurando um IDE no Windows para desenvolvimento Android

Instalao do JDK (Java Development Kit)

Captulo 1 Primeiros passos

Instalao do Eclipse para desenvolvimento Java

Figura 1.8 Escolha de um download do Eclipse.

Figura 1.9 Contedo da pasta do Eclipse.

Instalao do SDK do Android

Captulo 1 Primeiros passos

AdMob Ads SDK

recomendado que voc efetue o download de vrias plataformas de SDK para

Instalao do plugin ADT

Captulo 1 Primeiros passos

Figura 1.11 Incluso do repositrio ADT plug-in.

Figura 1.12 Escolhendo o que instalar.

Figura 1.13 Conexo do recm-instalado SDK ao recm-instalado plugin ADT.

Captulo 1 Primeiros passos

1.6 Entendendo o ciclo de vida do Android