Você está na página 1de 162

TREINAMENTOS

Desenvolvimento Mobile
com Android

Android

8 de outubro de 2012

Sumrio

Sobre a K19

Seguro Treinamento

Termo de Uso

Cursos

Introduo plataforma Android


1.1 O que o Android? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2 O que eu preciso para desenvolver para o Android? . . . . . . . . . . . . . . . . . . . . .
1.3 Exerccios de Fixao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1
1
1
1

Viso Geral de uma aplicao Android


2.1 Criando o famoso Hello World . . . . . .
2.2 Exerccios de Fixao . . . . . . . . . . .
2.3 Entendendo a estrutura do projeto . . .
2.4 Principais componentes do Framework

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

11
11
11
15
17

Layouts e Widgets
3.1 Activities . . . . . . .
3.2 Layouts em XML . . .
3.3 Exerccios de Fixao
3.4 Exerccios de Fixao

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

19
19
19
21
26

.
.
.
.
.
.
.

29
29
29
29
31
32
34
35

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

Usando Intents
4.1 O que um Intent . . . . . . . . . .
4.2 Usando o Intent com Activities . .
4.3 Exerccios de Fixao . . . . . . . .
4.4 Usando Intents para passar dados .
4.5 Exerccios de Fixao . . . . . . . .
4.6 Abrindo outros aplicativos . . . . .
4.7 Exerccios de Fixao . . . . . . . .
www.k19.com.br

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

S UMRIO

ii

Persistncia de dados
5.1 Persistindo informao . . .
5.2 Usando o SharedPreferences
5.3 Exerccios de Fixao . . . .
5.4 Usando o SQLite . . . . . . .
5.5 Exerccios de Fixao . . . .

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

37
37
37
38
41
41

HTTP e JSON
47
6.1 HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
6.2 JSON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
6.3 Exerccios de Fixao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Threads e AsyncTasks
7.1 Threads e Handlers .
7.2 Exerccios de Fixao
7.3 AsyncTasks . . . . . .
7.4 Exerccios de Fixao

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

53
53
53
56
56

Services e BroadCastReceivers
8.1 Servios . . . . . . . . . . .
8.2 Exerccios de Fixao . . .
8.3 BroadCast Receivers . . . .
8.4 Exerccios de Fixao . . .

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

59
59
62
65
65

Notificaes
9.1 Dialogs . . . . . . . .
9.2 Exerccios de Fixao
9.3 Notifications . . . . .
9.4 Exerccios de Fixao

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

69
69
69
72
72

10 Mapas e GPS
10.1 Utilizando o GPS . . .
10.2 Exerccios de Fixao
10.3 Usando o MapView .
10.4 Exerccios de Fixao

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

75
75
75
78
79

.
.
.
.
.
.
.

83
83
83
89
91
94
98
107

.
.
.
.
.

111
111
111
111
112
112

11 Apndice - Multimedia
11.1 Introduo . . . . . .
11.2 Reproduo de Mdia
11.3 Exerccios de Fixao
11.4 Captura de udio . .
11.5 Exerccios de Fixao
11.6 Captura de Vdeo . .
11.7 Exerccios de Fixao

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

12 Apndice - AppWidgets
12.1 Introduo . . . . . . . . . . . . . . . . .
12.2 Principais classes . . . . . . . . . . . . .
12.3 Manifest . . . . . . . . . . . . . . . . . . .
12.4 Configurando o AppWidgetProviderInfo
12.5 Definindo o Layout . . . . . . . . . . . .
ii

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

www.k19.com.br

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.

iii

S UMRIO

12.6 Exerccios de Fixao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113


13 Apndice - Publicando no Google Play
117
13.1 Como gerar um aplicativo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
13.2 Exerccios de Fixao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
14 Apndice - Sensores
14.1 O Bsico . . . . . . . . . .
14.2 Sensores de Movimento
14.3 Sensores de Posio . . .
14.4 Sensores de Ambiente . .
14.5 Exerccios de Fixao . .

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

123
123
125
128
129
130

15 Apndice - Web Apps com WebView


15.1 Introduo . . . . . . . . . . . . . . . . . . . . . .
15.2 Manifest . . . . . . . . . . . . . . . . . . . . . . . .
15.3 Layout . . . . . . . . . . . . . . . . . . . . . . . . .
15.4 Carregando uma pgina . . . . . . . . . . . . . .
15.5 Controlando a Navegao . . . . . . . . . . . . .
15.6 Associando cdigo JavaScript a cdigo Android
15.7 Exerccios de Fixao . . . . . . . . . . . . . . . .

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

133
133
133
133
133
134
135
136

16 Apndice - Bluetooth
16.1 Classes utilizadas . . . . . . . .
16.2 Permisses . . . . . . . . . . . .
16.3 Usando o Bluetooth . . . . . . .
16.4 Listando dispositivos pareados
16.5 Descobrindo dispositivos . . .
16.6 Usando conexes . . . . . . . .

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

139
139
139
139
140
140
140

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

17 Apndice - Animaes
145
17.1 Exerccios de Fixao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
18 Apndice - Monetizando com Ads
18.1 Introduo . . . . . . . . . . .
18.2 Conta de Veculo . . . . . . . .
18.3 SDK do servio de Ad . . . . .
18.4 Manifest . . . . . . . . . . . . .
18.5 Layout . . . . . . . . . . . . . .
18.6 Inicializando o Ad . . . . . . .

www.k19.com.br

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

149
149
149
149
150
151
151

iii

S UMRIO

iv

iv

www.k19.com.br

S UMRIO

Sobre a K19
A K19 uma empresa especializada na capacitao de desenvolvedores de software. Sua equipe
composta por profissionais formados em Cincia da Computao pela Universidade de So Paulo
(USP) e que possuem vasta experincia em treinamento de profissionais para rea de TI.
O principal objetivo da K19 oferecer treinamentos de mxima qualidade que relacionados s
principais tecnologias utilizadas pelas empresas. Atravs desses treinamentos, seus alunos se tornam
capacitados para atuar no mercado de trabalho.
Visando a mxima qualidade, a K19 mantm as suas apostilas em constante renovao e melhoria, oferece instalaes fsicas apropriadas para o ensino e seus instrutores esto sempre atualizados
didtica e tecnicamente.

www.k19.com.br

S UMRIO

Seguro Treinamento
Na K19 o aluno faz o curso quantas vezes quiser!
Comprometida com o aprendizado e com a satisfao dos seus alunos, a K19 a nica que possui o Seguro Treinamento. Ao contratar um curso, o aluno poder refaz-lo quantas vezes desejar
mediante a disponibilidade de vagas e pagamento da franquia do Seguro Treinamento.
As vagas no preenchidas at um dia antes do incio de uma turma da K19 sero destinadas ao
alunos que desejam utilizar o Seguro Treinamento. O valor da franquia para utilizar o Seguro Treinamento 10% do valor total do curso.

www.k19.com.br

S UMRIO

Termo de Uso
Termo de Uso
Todo o contedo desta apostila propriedade da K19 Treinamentos. A apostila pode ser utilizada
livremente para estudo pessoal . Alm disso, este material didtico pode ser utilizado como material
de apoio em cursos de ensino superior desde que a instituio correspondente seja reconhecida pelo
MEC (Ministrio da Educao) e que a K19 seja citada explicitamente como proprietria do material.
proibida qualquer utilizao desse material que no se enquadre nas condies acima sem
o prvio consentimento formal, por escrito, da K19 Treinamentos. O uso indevido est sujeito s
medidas legais cabveis.

www.k19.com.br

S UMRIO

S
TO
EN
AM
EIN
TREINAMENTOS
TR
EIN
AM
EN
TO
S

TR

Conhea os nossos cursos


K01- Lgica de Programao

K11 - Orientao a Objetos em Java

K12 - Desenvolvimento Web com JSF2 e JPA2

K21 - Persistncia com JPA2 e Hibernate

K22 - Desenvolvimento Web Avanado com JFS2, EJB3.1 e CDI

K23 - Integrao de Sistemas com Webservices, JMS e EJB

K31 - C# e Orientao a Objetos

K32 - Desenvolvimento Web com ASP.NET MVC

www.k19.com.br/cursos

www.k19.com.br

CAPTULO

I NTRODUO PLATAFORMA
A NDROID

O que o Android?
O Android uma plataforma de software que permite criar aplicativos para dispositivos mveis,
como smartphones e tablets.
O Android foi desenvolvido pela Google, e posteriormente pela OHA (Open Handset Alliance),
uma organizao que une vrias empresas com o objetivo de criar padres abertos para dispositivos
mveis.

O que eu preciso para desenvolver para o Android?


Uma das vantagens de desenvolver para o Android que as ferramentas e programas necessrios
so todos gratuitos e disponveis para todos os sistemas operacionais (OS X, Windows e Linux).
Para comear a programar para o Android necessrio conhecer (ou aprender) a linguagem Java,
pois foi a linguagem escolhida pela Google.
Entre as ferramentas que voc precisa instalar esto:
JDK - como o Android faz uso da tecnologia Java, necessrio ter o Java Development Kit instalado.
Android SDK - que inclui as bibliotecas e vrias ferramentas, como o emulador, por exemplo.
Eclipse e ADT Plugin - a IDE que ser utilizada e o plugin para facilitar o desenvolvimento para o
Android. O uso do eclipse e do plugin no obrigatrio, mas altamente recomendado, por
diminuir as tarefas repetitivas.
Voc no obrigado a ter um aparelho com Android. O SDK inclui um emulador que permite
rodar as aplicaes desenvolvidas. Porm, altamente recomendado que se rode a aplicao em um
aparelho de verdade, antes de liberar o aplicativo no Google Play, a loja de aplicativos do Android.

Mais Sobre
Um aplicativo Android um arquivo com extenso .apk, que basicamente um pacote
que contm o cdigo compilado e os demais recursos, como XMLs e imagens.

Exerccios de Fixao
www.k19.com.br

I NTRODUO PLATAFORMA A NDROID

Os exerccios deste captulo so para preparar o ambiente de desenvolvimento. Caso voc no


tenha o JDK instalado no seu computador, ento voc deve instal-lo primeiramente. Para fazer isso,
consulte o artigo da K19 de instalao do JDK no endereo a seguir:
1

http://www.k19.com.br/artigos/instalando-o-jdk-java-development-kit/
Caso voc j tenha o Java instalado, pode passar para o prximo exerccio.

Importante
De acordo com a documentao do Android, apenas o JDK 6 suportado. Porm, h relatos de desenvolvedores utilizando o JDK 7 sem problemas, mas sem os novos recursos
do Java 7.

2
Para instalar o Android SDK, voc deve visitar a pgina http://developer.android.com/sdk/
index.html e escolher o pacote apropriado para o seu sistema operacional e arquitetura (32 ou 64

bits). No caso do OS X e do Linux a instalao simplesmente descompactar o arquivo baixado. No


caso do Windows existe um instalador, e basta seguir os passos.
3

Caso voc no tenha o Eclipse instalado, tambm ter que instalar. Voc pode baix-lo em

http://www.eclipse.org/downloads/. O Eclipse Classic recomendado, mas se voc tambm desenvolve para web (ou pretende) o Eclipse IDE for Java EE Developers uma melhor alternativa. Em
geral a instalao do Eclipse tambm se resume a descompactar o pacote baixado.
4
A seguir voc precisa instalar o ADT Plugin no Eclipse. Abra normalmente o Eclipse e selecione
Help -> Install new software. Ir aparecer uma nova janela, clique no boto add. Ir aparecer outra
janela, preencha como no exemplo abaixo:

Figura 1.1: Repositrio do ADT Plugin.

Depois disso, o Eclipse iniciar o download das informaes do repositrio. Quando o processo
for concludo, marque para ser instalado como no exemplo abaixo:
2

www.k19.com.br

I NTRODUO PLATAFORMA A NDROID

Figura 1.2: Marcando o plugin para instalao.

Aps isso basta confirmar a instalao e concordar com a licensa. O download do plugin ser
iniciado logo em seguida. Caso voc receba a seguinte aviso, pode clicar em Ok sem problemas:

Figura 1.3: Aviso de segurana durante a instalao.

Quanto tudo terminar, necessrio reiniciar o Eclipse para que as alteraes sejam feitas.
Ao ser aberto novamente, o Eclipse ir exibir um wizard para configurar o SDK do Android. Marque o segundo checkbox e informe corretamente onde est a pasta do SDK que foi baixado no exercwww.k19.com.br

I NTRODUO PLATAFORMA A NDROID

cio 2 (Caso voc ainda no tenha baixado o SDK, pode deixar marcado a primeira opo que o Eclipse
ir baixar). Veja a figura abaixo:

Figura 1.4: Wizard de configurao do Android SDK.

Aps isso o Eclipse deve mostrar o seguinte aviso:

Figura 1.5: Ainda esto faltando componentes.

Isto porque ainda esto faltando alguns componentes para comear a desenvolver. Voc pode
clicar em Open SDK Manager, que uma nova janela ir aparecer. Esta a tela do Gerenciador do
SDK, nele voc pode baixar diferentes targets da API e outras bibliotecas e ferramentas para auxiliar
no desenvolvimento do Android. Precisamos de pelo menos um target, por isso marque as opes
4

www.k19.com.br

I NTRODUO PLATAFORMA A NDROID

como na figura abaixo. O target 4.1 o mais recente, mas se houver um mais novo, recomendado
que voc instale o mais novo. Tambm recomendado instalar mais targets caso voc queira testar
com diferentes APIs e garantir que sua aplicao funciona corretamente.

Figura 1.6: Ainda esto faltando componentes.

Na tela seguinte, basta marcar Accept all e clicar em Install.

Figura 1.7: Finalizando a instalao do SDK.

Aps baixar os novos componentes, ser mostrado a tela inicial do Gerenciador. Agora voc pode
www.k19.com.br

I NTRODUO PLATAFORMA A NDROID

fech-lo.
Para testar a instalao do SDK, vamos tentar rodar o emulador. Voc precisa criar um AVD (Android Virtual Device), que basicamente uma imagem que roda no emulador. A partir do Eclipse,
voc deve clicar no segundo cone da imagem abaixo (O primeiro cone abre novamente o SDK Manager), que fica na barra de tarefas:
5

Figura 1.8: cones do Android.

Ir aparecer a janela abaixo. Voc deve clicar em New para criar um novo AVD:

Figura 1.9: Gereciador dos AVDs.

Configure a nova tela conforme a figura abaixo:


6

www.k19.com.br

I NTRODUO PLATAFORMA A NDROID

Figura 1.10: Criando um AVD.

Quando o Eclipse terminar de criar, ele volta a mesma tela de antes. Agora voc deve selecionar
com o mouse o AVD recm-criado, e clicar em Start para que ele seja iniciado. Quando surgir a tela
abaixo, basta clicar em Launch
www.k19.com.br

I NTRODUO PLATAFORMA A NDROID

Figura 1.11: Iniciando o AVD.

Aps isso, deve surgir uma nova janela igual abaixo. Na primeira vez, comum demorar mais
que o normal para que o AVD inicie.
8

www.k19.com.br

I NTRODUO PLATAFORMA A NDROID

Figura 1.12: AVD iniciando...

Se o processo der certo, voc deve visualizar o Android OS rodando dentro do emulador, como
na figura abaixo:
www.k19.com.br

I NTRODUO PLATAFORMA A NDROID

10

Figura 1.13: AVD rodando com sucesso.

10

www.k19.com.br

CAPTULO

V ISO G ERAL DE UMA APLICAO


A NDROID

Criando o famoso Hello World


Vamos testar o ambiente de instalao criando um projeto simples, que apenas mostra uma mensagem na tela.

Exerccios de Fixao
Crie um novo projeto, clicando em File -> New -> Project. Na janela que ir aparecer, selecione
Android Project, como na figura abaixo:
1

Figura 2.1: Criando um projeto Android.

Agora voc deve selecionar o nome do projeto. Siga o exemplo da figura abaixo, e depois clique
www.k19.com.br

11

V ISO G ERAL DE UMA APLICAO A NDROID

12

em Next:

Figura 2.2: Wizard para criar projetos.

Os primeiro campo indica o nome da aplicao. o nome que ir aparecer no launcher do Android, ou seja, o nome que os usurios vo ver. O segundo campo o nome do projeto que ser
utilizado no Eclipse. O terceiro campo o nome do pacote raiz da aplicao.
Em seguida voc deve selecionar o target do projeto. O campo Build SDK indica o target para o
qual a aplicao ser compilada. indicado utilizar a API mais recente para fazer build. O campo
emphMinimum required SDK indica a menor API suportada pelo seu aplicativo. APIs abaixo desse
nmero no sero capazes de rodar o aplicativo.
12

www.k19.com.br

13

V ISO G ERAL DE UMA APLICAO A NDROID

Figura 2.3: Criar activity.

Nesta tela voc pode escolher se quer uma activity por padro ou no. Se deixar desmarcado a
opo de criar a activity, ser criado um projeto em branco, sem nenhum cdigo no src. Caso voc
opte por criar uma activity, surgir uma nova tela pedindo o nome da Activity e do Layout que ser
usado. Por enquanto pode selecionar para criar uma Activity, conforme a figura acima. Configure o
nome da Activity e do Layout conforme a figura abaixo e depois clique em Finish.
www.k19.com.br

13

V ISO G ERAL DE UMA APLICAO A NDROID

14

Figura 2.4: Criar activity.

Altere o arquivo strings.xml que fica na pasta res/values, e deixe o contedo igual ao abaixo:

1
2
3
4
5
6
7

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< resources >
< string name = " hello " > Ol mundo ! </ string >
< string name = " app_name " > OlaMundo </ string >
</ resources >
Cdigo XML 2.1: strings.xml

Agora rode o projeto clicando com o boto direito do mouse no projeto, e selecionando Run as
-> Android Application. Por padro, o Eclipse ir iniciar o AVD que configuramos antes, e ir rodar a
aplicao dentro do emulador. Depois de algum tempo, voc deve ver a imagem abaixo:
3

14

www.k19.com.br

15

V ISO G ERAL DE UMA APLICAO A NDROID

Figura 2.5: Aplicativo rodando no emulador.

Entendendo a estrutura do projeto


Agora vamos entender tudo que foi gerado no nosso primeiro projeto Android. Voc deve ter
reparado que a estrutura do projeto a seguinte:
www.k19.com.br

15

V ISO G ERAL DE UMA APLICAO A NDROID

16

Figura 2.6: Estrutura de um projeto Android.

src - pasta onde fica o cdigo fonte java da nossa aplicao. No projeto recm-criado, existe apenas
um arquivo, que se chama OlaMundoActivity.
gen - pasta onde ficam arquivos gerados automaticamente pelo Eclipse. Voc no deve fazer alteraes manualmente nesta pasta ou nos arquivos dentro dela.
assets - pasta onde ficam arquivos de mdia que so usados na aplicao. Podem ser quaisquer tipos
como vdeos, sons, imagens, etc.
bin - pasta onde ficam os arquivos compilados pelo Eclipse. Em geral, voc tambm no deve mexer
nesta pasta.
res - abreviao de resources, esta pasta subdividida em vrias pastas, com propsitos diferentes.
As pastas que comeam com o sufixo drawable so destinadas a armazenar imagens que so
usadas na aplicao, como cones, por exemplo. A pasta layout se destina a armazenar os arquivos XML que representam o layout das telas da aplicao. Por enquanto, temos apenas um
arquivo, o main.xml. A pasta values tambm se destina a armazenar XMLs que sero usados
na aplicao. Inicialmente s existe um arquivo nesta pasta, o strings.xml. Ao longo do curso
iremos ver diferentes tipos de arquivo que so colocacos na pasta res.
16

www.k19.com.br

17

V ISO G ERAL DE UMA APLICAO A NDROID

AndroidManifest.xml , o arquivo que guarda a configurao de um aplicativo Android. Iremos ver


mais a fundo quais so as opes de configurao no decorrer do curso.

Principais componentes do Framework


O framework do Android possui vrios componentes. Os principais so:

Activities - o componente que representa a tela, na qual o usurio interage com a aplicao.
Services - o componente responsvel por rodar tarefas em background. Em geral so tarefas mais
longas, rodadas em background para no prejudicar a responsividade da aplicao.
Intents - o componente que inicia os demais (activities, services e receivers). Para criar uma nova
activity ou service, voc faz atravs dos intents.
Broadcast receivers - um componente responsvel por responder a eventos do sistema. Os eventos podem ser de variados tipos, por exemplo, uma localizao foi encontrada pelo GPS, ou
que a bateria est acabando, etc.
Content providers - componente responsvel por gerenciar dados da aplicao. Caso voc queira
compartilhar os dados da sua aplicao com outras, voc s consegue faz-lo atravs de um
content provider. Porm, mesmo quando a informao usada somente na sua aplicao e no
compartilhada com as demais, possvel usar um content provider para organizar a forma
como os dados so consultados.

www.k19.com.br

17

V ISO G ERAL DE UMA APLICAO A NDROID

18

18

www.k19.com.br

CAPTULO

L AYOUTS E W IDGETS

Activities
Uma activity o componente responsvel por mostrar uma tela ao usurio. Sempre que voc
quiser criar uma nova tela na aplicao, dever criar uma classe que herda de Activity. Entre os
principais mtodos da activity esto os que so responsveis pelo seu ciclo de vida. O ciclo de vida
de uma activity se refere a ordem em que os mtodos so chamados desde a sua criao, at o seu
final, quando a activity destruda. Estes mtodos so:

OnCreate - chamado quando a activity criada.


onStart - chamado aps o onCreate, e antes da activity se tornar visvel para o usurio.
onResume - chamado aps o onStart, quando a activity se torna visvel para o usurio.
onPause - chamado aps o onResume, quando a activity est para perder a visibilidade para outra
activity.
onStop - a activity no est mais visvel para o usurio.
onDestroy - a activity est prestes a ser destruda.

Layouts em XML
As interfaces da aplicao so definidas em arquivos XML que ficam na pasta res/layout. Todos
os arquivos de layout devem ficar nesta pasta, voc no pode agrup-los em outra pasta.

Mais Sobre
At possvel criar interfaces usando apenas cdigo Java, sem criar os layouts em XML,
porm o cdigo fica muito extenso e complicado de entender, conforme a interface vai
ficando maior e mais complexa.

A ligao entre a interface em XML e seus elementos com o cdigo Java da activity feita atravs
de um arquivo especial, com o nome apenas de R.java que fica na pasta gen. Esse arquivo gerado
automaticamente, e voc no deve fazer nunca alteraes manuais nele. O nome R como uma
abreviao para resources.
www.k19.com.br

19

L AYOUTS E W IDGETS
1
2
3
4
5

20

@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
}
Cdigo Java 3.1: ExemploActivity.java

No exemplo acima, o mtodo setContentView serve para definir qual ser o contedo da activity.
Ao passar como parmetro R.layout.main estamos dizendo que o contedo da activity est definido
no arquivo main.xml da pasta res/layout.
Existem dois tipos de elementos no XML de um layout, os containers e os widgets. Um container um elemento que agrega vrios outros elementos, sejam eles outros containers ou widgets.
Widgets so os elementos isolados como textos, botes, caixas de texto, etc. Uma coisa em comum
entre todos os elementos XML que eles precisam obrigatoriamente dos atributos layout_width e
layout_height para indicar a largura e altura do elemento, respectivamente. Em vez de valores absolutos (em pixels) comum ver os valores match_parent para indicar que deve ter a mesma largura do
elemento que o contm, ou wrap_content para indicar que deve ter a mesma largura do contedo
do elemento.
Entre os containers temos os seguintes tipos:

LinearLayout - possui um atributo orientation que pode receber o valor vertical ou horizontal que
indica que os elementos filhos devem ser agrupados na vertical ou horizontal.
RelativeLayout - um layout que permite posicionar os elementos filhos de maneira relativa, um
em relao ao outro.
FrameLayout - um tipo de layout bem simples, que permite adicionar apenas um elemento. Se
adicionar mais elementos, eles iro ser desenhados sobre os outros, parcialmente ou totalmente.
TableLayout - como o nome sugere, serve para criar tabelas. Voc deve adicionar elementos do tipo
TableRow, e nestes elementos adicionar as clulas que deseja mostrar.
Entre os diversos widgets temos:
TextView - usado para mostrar textos na tela.
EditText - usado para que o usurio digite alguma entrada.
Button - usado para que o usurio execute aes atravs de cliques.
CheckBox - usado para que o usurio marque opes.
RadioButton - o mesmo que acima, mas permite marcar apenas uma opo.
Spinner - usado para que o usurio selecione uma opo (combo box).
ImageView - usado para mostrar imagens na tela.

De acordo com o widget, existem diferentes tipos de atributos que cada um pode receber, alguns
sero vistos nos exerccios.
20

www.k19.com.br

21

L AYOUTS E W IDGETS

Exerccios de Fixao
Crie um novo projeto Android, da mesma forma que foi criado no captulo anterior. Use como
nome para o projeto Layouts. O nome do pacote deve ser br.com.k19.android.cap03, e o nome da
activity deve ser MainActivity.
1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

Na pasta res/layouts crie um arquivo chamado linear.xml. Ele deve conter o seguinte contedo:
<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< TextView
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:text = " Nome: " / >
< EditText
android:layout_width = " match_parent "
android:layout_height = " wrap_content " / >
< Button
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:text = " Ver mensagem " / >
</ LinearLayout >

Cdigo XML 3.1: linear.xml

A seguir edite o arquivo MainActivity.java para que ele fique com o seguinte contedo:
1
2
3
4
5
6
7
8
9
10
11
12

package br . com . k19 . android . cap03 ;


import android . app . Activity ;
import android . os . Bundle ;
public class MainActivity extends Activity {
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . linear ) ;
}
}

Cdigo Java 3.2: MainActivity.java

Aps isso, rode a aplicao e veja o resultado. Ele deve ficar semelhante figura abaixo:
www.k19.com.br

21

L AYOUTS E W IDGETS

22

Figura 3.1: Resultado da tela.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

Edite o arquivo linear.xml, deixando igual ao exemplo abaixo:


<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< TextView
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:text = " @string / name_label " / >
< EditText
android:layout_width = " match_parent "
android:layout_height = " wrap_content " / >
< Button
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:text = " @string / see_message " / >
</ LinearLayout >
Cdigo XML 3.2: linear.xml

22

www.k19.com.br

23

L AYOUTS E W IDGETS

Em seguida edite o arquivo strings.xml presente em res/values para que fique igual ao abaixo:
1
2
3
4
5
6
7
8

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< resources >
< string name = " app_name " > Layouts </ string >
< string name = " name_label " > Nome: </ string >
< string name = " see_message " > Ver mensagem </ string >
</ resources >
Cdigo XML 3.3: strings.xml

Rode novamente a aplicao e veja se est igual ao que era antes.


4
Agora crie um novo arquivo de layout chamado relative.xml. Ele deve conter o seguinte contedo:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< RelativeLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent " >
< TextView
android:id = " @ + id / name_label_text "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_alignParentLeft = " true "
android:layout_alignParentTop = " true "
android:textSize = " 24 dp "
android:text = " @string / name_label " / >
< EditText
android:id = " @ + id / name_edit_text "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:inputType = " text "
android:layout_toRightOf = " @id / name_label_text " / >
< Button
android:id = " @ + id / see_message_button "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_alignParentRight = " true "
android:layout_below = " @id / name_edit_text "
android:text = " @string / see_message " / >
</ RelativeLayout >
Cdigo XML 3.4: relative.xml

Agora edite novamente o arquivo MainActivity.java para que fique igual ao exemplo abaixo:
1
2
3
4
5
6
7
8
9
10
11
12
13

package br . com . k19 . android . cap03 ;


import android . app . Activity ;
import android . os . Bundle ;
public class MainActivity extends Activity {
@Override
protected void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . relative ) ;
}
}

www.k19.com.br

23

L AYOUTS E W IDGETS

24

Cdigo Java 3.3: MainActivity.java

Agora rode a aplicao e veja o resultado.


Agora copie o logo da K19 (no site http://k19.com.br) e salve na pasta res/drawable-hdpi com
o nome k19_logo.png.
5

Crie um novo arquivo de layout chamado frame.xml. Adicione o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< FrameLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent " >
< ImageView
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:src = " @drawable / k19_logo "
android:layout_gravity = " center " / >
< TextView
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_gravity = " top | center_horizontal "
android:text = " @string / k19_label "
android:textStyle = " bold "
android:textSize = " 30 dp " / >
</ FrameLayout >
Cdigo XML 3.5: frame.xml

Edite novamente o arquivo MainActivity.java para que fique igual ao exemplo abaixo:
1
2
3
4
5
6
7
8
9
10
11
12
13

package br . com . k19 . android . cap03 ;


import android . app . Activity ;
import android . os . Bundle ;
public class MainActivity extends Activity {
@Override
protected void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . frame ) ;
}
}
Cdigo Java 3.4: MainActivity.java

1
2
3
4
5
6
7
8
9
10
11

24

Crie um novo layout chamado table.xml com o seguinte contedo:


<? xml version = " 1.0 " encoding = " utf -8 " ? >
< TableLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:stretchColumns = " true " >
< TableRow >
< TextView
android:layout_column = " 1 "
android:text = " Nome "
android:padding = " 3 dip "

www.k19.com.br

25
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

L AYOUTS E W IDGETS
android:textStyle = " bold " / >
< TextView
android:text = " Sobrenome "
android:padding = " 3 dip "
android:textStyle = " bold " / >
</ TableRow >
< TableRow >
< TextView
android:layout_column = " 1 "
android:text = " Alexandre "
android:padding = " 3 dip " / >
< TextView
android:text = " Macedo "
android:padding = " 3 dip " / >
</ TableRow >
< TableRow >
< TextView
android:layout_column = " 1 "
android:text = " Rafael "
android:padding = " 3 dip " / >
< TextView
android:text = " Cosentino "
android:padding = " 3 dip " / >
</ TableRow >
</ TableLayout >
Cdigo XML 3.6: table.xml

Edite o arquivo MainActivity.java e altere para usar o layout recm-criado (altere o parmetro do
mtodo setContentView para R.layout.table).
Rode novamente a aplicao e veja o resultado.

Listeners de eventos
Nos vimos como podemos mostrar a tela para o usurio, mas no vimos ainda como o usurio
pode interagir com a tela, clicando e digitando em widgets. Isso feito atravs de listeners de eventos.
Primeiramente, para utilizar um widget que foi definido no layout, devemos "busc-lo"e fazer
referncia no nosso cdigo java. Para isso, utilizado o mtodo findViewById.
1
2

Button button = ( Button ) findViewById ( R . id . see_message_button ) ;


TextView label = ( TextView ) findViewById ( R . id . name_label_text ) ;
Cdigo Java 3.5: Exemplo

Veja que devemos fazer um cast para o elemento que queremos, porque o findViewById sempre
retorna um objeto do tipo View. O parmetro que o mtodo recebe, se refere ao id que foi dado ao
elemento no XML. Lembre-se que o arquivo R.java fazia a ligao entre XML e cdigo java. Ele
quem guarda a referncia de todos os layouts e elementos presentes no XML.
Aps termos o objeto, podemos adicionar listeners, como no exemplo abaixo:
1
2
3

Button button = ( Button ) findViewById ( R . id . see_message_button ) ;


button . setOnClickListener ( new OnClickListener () {
@Override

www.k19.com.br

25

L AYOUTS E W IDGETS
4
5
6
7

26

public void onClick ( View arg0 ) {


// faz alguma coisa
}
}) ;
Cdigo Java 3.6: Exemplo

Dessa maneira, sempre que o boto for clicado, o mtodo onClick ser chamado. Existem vrios
outros tipos de listeners, todos sempre comeam com o sufixo on indicando depois qual tipo de
evento eles esto "escutando". No decorrer do curso iremos ver mais tipos de listeners.

Exerccios de Fixao
7

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

Edite novamente o linear.xml para que fique igual ao exemplo abaixo:


<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< TextView
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:text = " @string / name_label " / >
< EditText
android:id = " @ + id / name_edit_text "
android:layout_width = " match_parent "
android:layout_height = " wrap_content " / >
< Button
android:id = " @ + id / see_message_button "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:text = " @string / see_message " / >
< TextView
android:id = " @ + id / show_message_text "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:layout_gravity = " center "
android:layout_marginTop = " 20 dp "
android:text = " @string / hello_message "
android:textSize = " 24 dp "
android:textStyle = " bold "
android:visibility = " invisible " / >
</ LinearLayout >
Cdigo XML 3.7: linear.xml

Edite o arquivo strings.xml e inclua a seguinte entrada:

< string name = " hello_message " >Ol , %1$ s ! </ string >
Cdigo XML 3.8: strings.xml

26

Edite novamente o arquivo MainActivity.java, e deixe semelhante ao exemplo abaixo:

www.k19.com.br

27
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

L AYOUTS E W IDGETS
package br . com . k19 . android . cap03 ;
import android . app . Activity ;
import android . os . Bundle ;
public class MainActivity extends Activity {
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . linear ) ;
final EditText nameEditText = ( EditText ) findViewById ( R . id . name_edit_text )
seeMessageButton = ( Button ) findViewById ( R . id . see_message_button )
final TextView showMessageText = ( TextView ) findViewByUd ( R . id . show_message_text )
seeMessageButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View view ) {
String name = nameEditText . getEditableText () . toString () ;
showMessageText . setText ( getString ( R . string . hello_message , name ) ) ;
showMessageText . setVisibility ( View . VISIBLE ) ;
}
}) ;
}
}
Cdigo Java 3.7: MainActivity.java

Rode a aplicao novamente e veja o resultado no emulador.

www.k19.com.br

27

L AYOUTS E W IDGETS

28

28

www.k19.com.br

CAPTULO

U SANDO I NTENTS

O que um Intent
Intents so objetos responsveis por passar informaes, como se fossem mensagens, para os
principais componentes da API do Android, como as Activities, Services e BroadCast Receivers.
Para que um destes componentes seja instanciado, necessrio que seja criado um Intent, mesmo
quando no temos nenhuma informao para passar para o componente criado.
Quando usado em conjunto com Intent Filters podemos at iniciar uma Activity de outros aplicativo, ou o inverso, deixar que um outro aplicativo inicie uma das nossas Activities.

Usando o Intent com Activities


Para iniciar uma nova Activity necessrio usar o mtodo startActivity() presente no objeto Context, ou na Activity.
1
2

Intent intent = new Intent ( this , NewActivity . class ) ;


startActivity ( intent ) ;
Cdigo Java 4.1: Exemplo.java

No exemplo acima, estamos iniciando uma Activity cujo nome NewActivity. O primeiro parmetro que passamos para o construtor do Intent o contexto, no caso this se refere prpria Activity
atual, que est chamando a prxima.

Exerccios de Fixao
Crie um novo projeto Android, da mesma forma que foi criado no captulo anterior. Use como
nome para o projeto Intents. O nome do pacote deve ser br.com.k19.android.cap04, e o nome da
activity deve ser MainActivity.
1

Na pasta res/layouts crie um arquivo chamado main.xml. Ele deve conter o seguinte contedo:

1
2
3
4
5
6
7
8

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< Button
android:id = " @ + id / main_button "

www.k19.com.br

29

U SANDO I NTENTS
9
10
11
12
13

30

android:layout_width = " match_parent "


android:layout_height = " wrap_content "
android:text = " @string / next_screen " / >
</ LinearLayout >
Cdigo XML 4.1: main.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2
3
4
5

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< resources >
< string name = " app_name " > Intents < string / >
< string name = " next_screen " > Prxima tela < string / >
</ resources >
Cdigo XML 4.2: strings.xml

A seguir edite o arquivo MainActivity.java para que ele fique com o seguinte contedo:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

package br . com . k19 . android . cap04 ;


import
import
import
import
import
import

android . app . Activity ;


android . content . Intent ;
android . os . Bundle ;
android . view . View ;
android . view . View . OnClickListener ;
android . widget . Button ;

public class MainActivity extends Activity {


@Override
protected void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
Button button = ( Button ) findViewById ( R . id . main_button ) ;
button . setOnClickListener ( new OnClickListener () {
public void onClick ( View v ) {
Intent intent = new Intent ( MainActivity . this , SecondActivity . class );
startActivity ( intent ) ;
}
}) ;
}
}
Cdigo Java 4.2: MainActivity.java

1
2
3
4
5
6
7
8
9
10
11
12

Crie um novo arquivo XML na pasta de layouts chamado second.xml com o contedo abaixo:
<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< TextView
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:text = " @string / second_screen " / >
</ LinearLayout >
Cdigo XML 4.3: second.xml

30

www.k19.com.br

31

U SANDO I NTENTS

Adicione uma nova entrada no arquivo strings.xml:


1

< string name = " second_screen " > Nova tela < string / >
Cdigo XML 4.4: strings.xml

Crie uma nova classe chamada SecondActivity que herda Activity e possui o contedo abaixo:
1
2
3
4
5
6
7
8
9
10
11
12
13
14

package br . com . k19 . android . cap04 ;


import android . app . Activity ;
import android . os . Bundle ;
import android . widget . EditText ;
public class SecondActivity extends Activity {
@Override
protected void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . second ) ;
}
}
Cdigo Java 4.3: SecondActivity.java

Se lembre de adicionar os nomes das activities no AndroidManifest.xml. Para fazer isso basta
adicionar a seguinte tag dentro da tag application:
1

< activity android:name = " . SecondActivity " / >


Cdigo XML 4.5: AndroidManifest.xml

Aps isso, rode a aplicao e veja o resultado. Voc deve ter um boto que abre uma nova tela, e
apertando back voc volta a tela anterior.

Usando Intents para passar dados


No exerccio anterior, foi instanciada uma nova Activity, mas no foi passada nenhuma informao para ela. Isso pode ser feito utilizando o mtodo putExtra do Intent.
1
2
3
4

Intent intent = new Intent ( this , NewActivity . class ) ;


intent . putExtra ( " curso " , " Android " ) ;
intent . putExtra ( " sigla " , " k41 " ) ;
intent . putExtra ( " total " , 25) ;
Cdigo Java 4.4: Exemplo

Este mtodo tem overloading, logo podemos passar diferentes tipos. Podemos passar tipos primitivos e Strings. O primeiro parmetro indica qual a chave que estamos usando para a informao.
O segundo o valor da informao que estamos passando.
Do outro lado, na Activity que est sendo criada, podemos obter os valores atravs do Bundle que
pode ser obtido a partir do mtodo getExtras presente no Intent:
1
2

protected void onCreate ( Bundle savedInstanceState ) {


super . onCreate ( savedInstanceState ) ;

www.k19.com.br

31

U SANDO I NTENTS
3
4
5
6
7
8
9
10
11

32

setContentView ( R . layout . some_layout ) ;


Bundle extras = getIntent () . getExtras () ;
String curso = extras . getString ( " curso " ) ;
String sigla = extras . getString ( " sigla " ) ;
int total = extras . getInt ( " total " ) ;
...
}
Cdigo Java 4.5: Exemplo

Exerccios de Fixao
4

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

Edite o contedo do arquivo second.xml, para o exemplo abaixo:


<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< TextView
android:id = " @ + id / name_label "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:text = " @string / name " / >
< EditText
android:id = " @ + id / name_edit_text "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:inputType = " textCapWords " / >
< TextView
android:id = " @ + id / age_label "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:text = " @string / age " / >
< EditText
android:id = " @ + id / age_edit_text "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:inputType = " number " / >
< Button
android:id = " @ + id / next_button "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:text = " @string / next_screen " / >
</ LinearLayout >
Cdigo XML 4.6: second.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2
3
4
5

32

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< resources >
< string name = " app_name " > Intents </ string >
< string name = " next_screen " > Prxima tela </ string >
< string name = " name " > Nome </ string >

www.k19.com.br

33
6
7
8
9

U SANDO I NTENTS
< string name = " age " > Idade </ string >
< string name = " user_name " > Nome: %1 s </ string >
< string name = " user_age " > Idade: %1 s </ string >
</ resources >
Cdigo XML 4.7: strings.xml

A seguir edite o arquivo SecondActivity.java para que ele fique com o seguinte contedo:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

package br . com . k19 . android . cap04 ;


import
import
import
import
import
import
import

android . app . Activity ;


android . content . Intent ;
android . os . Bundle ;
android . view . View ;
android . view . View . OnClickListener ;
android . widget . Button ;
android . widget . EditText ;

public class SecondActivity extends Activity {


@Override
protected void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . second ) ;
final EditText nameEditText = ( EditText ) findViewById ( R . id . name_edit_text ) ;
final EditText ageEditText = ( EditText ) findViewById ( R . id . age_edit_text ) ;
Button button = ( Button ) findViewById ( R . id . next_button ) ;
button . setOnClickListener ( new OnClickListener () {
public void onClick ( View v ) {
String name = nameEditText . getEditableText () . toString () ;
String age = ageEditText . getEditableText () . toString () ;
Intent intent = new Intent ( SecondActivity . this , ThirdActivity . class ) ;
intent . putExtra ( " name " , name ) ;
intent . putExtra ( " age " , age ) ;
startActivity ( intent ) ;
}
}) ;

}
}
Cdigo Java 4.6: SecondActivity.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

Crie um novo arquivo XML na pasta de layouts chamado third.xml com o contedo abaixo:
<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >

< TextView
android:id = " @ + id / name "
android:layout_width = " match_parent "
android:layout_height = " wrap_content " / >
< TextView
android:id = " @ + id / age "
android:layout_width = " match_parent "
android:layout_height = " wrap_content " / >

www.k19.com.br

33

U SANDO I NTENTS
17
18

34

</ LinearLayout >


Cdigo XML 4.8: third.xml

Adicione uma nova entrada no arquivo strings.xml:


1

< string name = " second_screen " > Nova tela < string / >
Cdigo XML 4.9: strings.xml

Crie uma nova classe chamada ThirdActivity que herda Activity e possui o contedo abaixo:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

package br . com . k19 . android . cap04 ;


import android . app . Activity ;
import android . os . Bundle ;
import android . widget . TextView ;
public class ThirdActivity extends Activity {
@Override
protected void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . third ) ;
Bundle extras = getIntent () . getExtras () ;
String name = extras . getString ( " name " ) ;
String age = extras . getString ( " age " ) ;
TextView nameTextView = ( TextView ) findViewById ( R . id . name ) ;
TextView ageTextView = ( TextView ) findViewById ( R . id . age ) ;
nameTextView . setText ( getString ( R . string . user_name , name ) ) ;
ageTextView . setText ( getString ( R . string . user_age , age ) ) ;
}
}
Cdigo Java 4.7: ThirdActivity.java

Adicione a nova Activity ao AndroidManifest.xml.


1

< activity android:name = " . ThirdActivity " / >


Cdigo XML 4.10: AndroidManifest.xml

Aps isso, rode a aplicao e veja o resultado. Faa alguns testes, clique nos botes, digite nome
e idade, e veja se est funcionando como o esperado.

Abrindo outros aplicativos


possvel abrir outros aplicativos utilizando intents. Para isso, necessrio passar uma flag que
chamamos de action. Dependendo do tipo de action que passarmos, um novo aplicativo ser aberto
para executar a ao. Este tipo de intent chamado de implcito, porque no especificado qual a
activity que ser aberta. Apenas passamos uma ao, e o sistema ir decidir qual activity dever ser
utilizada nesse caso.
34

www.k19.com.br

35

U SANDO I NTENTS

Exerccios de Fixao
Crie um novo projeto Android, da mesma forma que foi criado no captulo anterior. Use como
nome para o projeto IntentActions. O nome do pacote deve ser br.com.k19.android.cap04_02, e o
nome da activity deve ser MainActivity.
6

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

Edite o contedo do arquivo main.xml, para o exemplo abaixo:


< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
xmlns:tools = " http: // schemas . android . com / tools "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< Button
android:id = " @ + id / view_site_button "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:text = " @string / view_site_label " / >
< Button
android:id = " @ + id / send_email_button "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:text = " @string / send_email_label " / >
< Button
android:id = " @ + id / make_call_button "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:text = " @string / make_call_label " / >
</ LinearLayout >
Cdigo XML 4.11: second.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11

< resources >


< string
< string
< string
< string
< string
< string
< string

name = " app_name " > IntentActions </ string >


name = " hello_world " > Hello world ! </ string >
name = " menu_settings " > Settings </ string >
name = " title_activity_main " > MainActivity </ string >
name = " view_site_label " > Ver site da K19 </ string >
name = " send_email_label " > Enviar email de contato </ string >
name = " make_call_label " > Fazer ligao </ string >

</ resources >


Cdigo XML 4.12: strings.xml

A seguir edite o arquivo MainActivity.java para que ele fique com o seguinte contedo:
1
2
3
4
5
6
7
8

package br . com . k19 . android . cap04 ;


import
import
import
import
import
import

android . app . Activity ;


android . content . Intent ;
android . net . Uri ;
android . os . Bundle ;
android . view . View ;
android . view . View . OnClickListener ;

www.k19.com.br

35

U SANDO I NTENTS
9
10
11
12
13
14
15
16
17
18
19
20
21
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

36

import android . widget . Button ;


public class MainActivity extends Activity {
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
Button viewSiteButton = ( Button ) findViewById ( R . id . view_site_button ) ;
Button sendEmailButton = ( Button ) findViewById ( R . id . send_email_button ) ;
Button makeCallButton = ( Button ) findViewById ( R . id . make_call_button ) ;
viewSiteButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View v ) {
Intent intent = new Intent ( Intent . ACTION_VIEW , Uri
. parse ( " http :// k19 . com . br " ) ) ;
startActivity ( intent ) ;
}
}) ;
sendEmailButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View v ) {
Intent intent = new Intent ( Intent . ACTION_SEND ) ;
intent . setType ( " plain / text " ) ;
intent . putExtra ( Intent . EXTRA_EMAIL ,
new String [] { " contato@k19 . com . br " }) ;
startActivity ( Intent . createChooser ( intent , " Enviar email " ) ) ;
}
}) ;
makeCallButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View v ) {
Intent intent = new Intent ( Intent . ACTION_DIAL , Uri
. parse ( " tel :2387 -3791 " ) ) ;
startActivity ( intent ) ;
}
}) ;
}
}
Cdigo Java 4.8: MainActivity.java

Aps isso, adicione a permisso para fazer ligaes no AndroidManifest.xml:


1

< uses - permission android:name = " android . permission . CALL_PHONE " / >
Cdigo XML 4.13: AndroidManifest.xml

A tag deve ser adicionada dentro da tag <manifest> e fora da tag <application>.

36

www.k19.com.br

CAPTULO

P ERSISTNCIA DE DADOS

Persistindo informao
A API do Android oferece diferentes opes quando se trata de salvar dados para serem usados
posteriormente. Qual a opo mais apropriada depende do tipo de informao que ser salva e da
disponibilidade que queremos que ela tenha.
Existem 4 tipos de armazenamento possveis:

Shared Preferences - um tipo de armazenamento que utiliza chave/valor indicado principalmente


para configuraes e dados isolados.
SQLite - banco de dados privado que pode ser utilizado pelo seu aplicativo. o mais indicado
quando temos vrias informaes com a mesma estrutura, que podem ser organizadas em
tabelas e serem consultadas.
Internal Storage - armazena na memria interna do aparelho, os dados aqui armazenados so privados da sua aplicao e no podem ser acessados por outros aplicativos ou pelo usurio.
External Storage - armazena em um SD, que pode ser externo ou interno do aparelho. Os arquivos
armazenados no SD so visveis para todos, e o usurio pode alter-los quando conecta o USB
a um computador.

Neste captulo, iremos ver os dois primeiros tipos de armazenamento. O internal e external sero
vistos em captulos mais a frente.

Usando o SharedPreferences
Abaixo est um exemplo de como utilizar o SharedPreferences para ler informaes:
1
2
3

SharedPreferences prefs = getSharedPreferences ( nome , modo ) ;


String someString = prefs . getString ( chave , null ) ;
int someInt = prefs . getInt ( outraChave , 0) ;
Cdigo Java 5.1: Exemplo.java

Voc obtm o SharedPreferences chamando o mtodo getSharedPreferences, passando para ele


uma string, que ser a chave para indicar o SharedPreferences. Voc pode utilizar vrios SharedPreferences por aplicao se achar necessrio. O modo indica a permisso do SharedPreferences. Se passar
0, indica modo privado.
www.k19.com.br

37

P ERSISTNCIA DE DADOS

38

Para ler os dados, s chamar o mtodo get correspondente ao tipo de informao que voc
quer. Lembre-se que no SharedPreferences voc s pode armazenar informaes de tipo primitivo e
Strings. O segundo parmetro indica um valor padro caso a chave no seja encontrada.
Para salvar os dados no SharedPreferences necessrio usar um editor. Veja o exemplo abaixo:
1
2
3
4

SharedPreferences prefs = getSharedPreferences ( nome , modo ) ;


Editor editor = prefs . edit () ;
editor . putString ( " curso " , " k41 " ) ;
editor . commit () ;
Cdigo Java 5.2: Exemplo.java

Obtemos o editor chamando o mtodo edit(). Adicionamos informaes chamando o mtodo


put() correspondente ao tipo que estamos armazenando. necessrio chamar o mtodo commit()
no final, seno as alteraes no sero salvas.

Exerccios de Fixao
1
Crie um novo projeto Android. Use como nome para o projeto SharedPrefs. O nome do pacote
deve ser br.com.k19.android.cap05, e o nome da activity deve ser MainActivity.
2

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

Na pasta res/layouts crie um arquivo chamado main.xml. Ele deve conter o seguinte contedo:
< RelativeLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
xmlns:tools = " http: // schemas . android . com / tools "
android:layout_width = " match_parent "
android:layout_height = " match_parent " >
< TextView
android:id = " @ + id / welcome_message "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_centerHorizontal = " true "
android:layout_centerVertical = " true " / >
< Button
android:id = " @ + id / add_name_button "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_below = " @id / welcome_message "
android:layout_centerHorizontal = " true " / >
</ RelativeLayout >
Cdigo XML 5.1: main.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10

38

< resources >


< string
< string
< string
< string
< string
< string

name = " app_name " > SharedPrefs </ string >


name = " hello_world " > Hello world ! </ string >
name = " menu_settings " > Settings </ string >
name = " title_activity_main " > MainActivity </ string >
name = " type_your_name " > Digite seu nome </ string >
name = " save " > Salvar </ string >

</ resources >

www.k19.com.br

39

P ERSISTNCIA DE DADOS

Cdigo XML 5.2: strings.xml

A seguir edite o arquivo MainActivity.java para que ele fique com o seguinte contedo:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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

package br . com . k19 . android . cap05 ;


import
import
import
import
import
import
import
import

android . app . Activity ;


android . content . Intent ;
android . content . SharedPreferences ;
android . os . Bundle ;
android . view . View ;
android . view . View . OnClickListener ;
android . widget . Button ;
android . widget . TextView ;

public class MainActivity extends Activity {


final static String APP_PREFS = " app_prefs " ;
final static String USERNAME_KEY = " username " ;
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
}
@Override
protected void onResume () {
super . onResume () ;
SharedPreferences prefs = getSharedPreferences ( APP_PREFS , MODE_PRIVATE ) ;
String username = prefs . getString ( USERNAME_KEY , null ) ;
TextView message = ( TextView ) findViewById ( R . id . welcome_message ) ;
Button addNameButton = ( Button ) findViewById ( R . id . add_name_button ) ;
if ( username != null ) {
message . setText ( " Bem vindo , " + username + " ! " ) ;
addNameButton . setText ( " Trocar de nome " ) ;
} else {
message . setText ( " Voc no cadastrou seu nome ... " ) ;
addNameButton . setText ( " Adicionar nome " ) ;
}
addNameButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View v ) {
Intent intent = new Intent ( MainActivity . this ,
AddNameActivity . class ) ;
startActivity ( intent ) ;
}
}) ;
}
}
Cdigo Java 5.3: MainActivity.java

Crie um novo arquivo XML na pasta de layouts chamado add_name.xml com o contedo abaixo:

1
2
3
4
5
6

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< RelativeLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent " >

www.k19.com.br

39

P ERSISTNCIA DE DADOS
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

40

< EditText
android:id = " @ + id / name_edit_text "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:inputType = " textCapWords "
android:hint = " @string / type_your_name "
android:layout_centerHorizontal = " true "
android:layout_marginTop = " 20 dp " / >
< Button
android:id = " @ + id / add_name_button "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_below = " @id / name_edit_text "
android:layout_centerHorizontal = " true "
android:layout_marginTop = " 20 dp "
android:text = " @string / save " / >
</ RelativeLayout >
Cdigo XML 5.3: add_name.xml

Crie uma nova classe chamada AddNameActivity que herda Activity e possui o contedo abaixo:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

package br . com . k19 . android . cap05 ;


import
import
import
import
import
import
import
import

android . app . Activity ;


android . content . SharedPreferences ;
android . content . SharedPreferences . Editor ;
android . os . Bundle ;
android . view . View ;
android . view . View . OnClickListener ;
android . widget . Button ;
android . widget . EditText ;

public class AddNameActivity extends Activity {


private SharedPreferences prefs ;
@Override
protected void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . add_name ) ;
prefs = getSharedPreferences ( MainActivity . APP_PREFS , MODE_PRIVATE ) ;
final EditText name = ( EditText ) findViewById ( R . id . name_edit_text ) ;
Button saveButton = ( Button ) findViewById ( R . id . add_name_button ) ;
saveButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View v ) {
String username = name . getEditableText () . toString () ;
Editor editor = prefs . edit () ;
editor . putString ( MainActivity . USERNAME_KEY , username ) ;
editor . commit () ;
finish () ;
}
}) ;
}
}
Cdigo Java 5.4: Main.java

Se lembre de adicionar os nomes das activities no AndroidManifest.xml. Aps isso, rode a aplicao e veja o resultado. Feche a aplicao e abra novamente, para ver se o nome est salva.
40

www.k19.com.br

41

P ERSISTNCIA DE DADOS

Usando o SQLite
O SQLite um banco de dados bem simples que consome poucos recursos, bastante usado em
dispositivos embarcados. Para utilizar o SQLite, necessrio que voc crie uma subclasse de SQLiteOpenHelper. Em seguida necessrio sobrescrever os mtodos OnCreate() e OnUpgrade(). O
primeiro chamado quando ainda no existe um banco de dados, nele voc deve incluir os comandos para criar tabelas e inicializar qualquer tipo de dados, se preciso. O segundo chamado quando
a verso da base de dados alterada, e nele voc deve incluir quaisquer comandos relacionados
alterao do esquema, como alteraes em tabelas e colunas.
O SQLiteOpenHelper oferece dois mtodos que sero muito usados, o getWritableDatabase()
e getReadableDatabase(). Como o nome indica, estes mtodos servem para obter uma instncia
da base de dados. Estes mtodos retornam uma instncia de SQLiteDatabase, que utilizada para
fazer consultas aos dados. Os mtodos que so usados com esse propsito so o insert(), update() e
delete(). Tambm so usados os mtodos query() e rawQuery(). O primeiro oferece uma interface
para criar consultas, enquanto o segundo permite utilizar SQL diretamente.
O resultado de uma consulta um objeto do tipo Cursor, que permite iterar sobre os dados.

Exerccios de Fixao
Crie um novo projeto Android. Use como nome para o projeto SQLite. O nome do pacote deve
ser br.com.k19.android.cap05_02, e o nome da activity deve ser MainActivity.
4

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

Na pasta res/layouts crie um arquivo chamado main.xml. Ele deve conter o seguinte contedo:
<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< ListView
android:id = " @android:id / list "
android:layout_width = " match_parent "
android:layout_height = " wrap_content " / >
< TextView
android:id = " @android:id / empty "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:text = " @string / no_notes " / >
</ LinearLayout >
Cdigo XML 5.4: main.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2
3
4
5

< resources >


< string name = " app_name " > SQLite </ string >
< string name = " title_activity_main " > MainActivity </ string >
< string name = " add " > Adicionar </ string >

www.k19.com.br

41

P ERSISTNCIA DE DADOS
6
7
8
9
10

42

< string name = " no_notes " > Nenhuma anotao </ string >
< string name = " write_a_note " > Escreva uma anotao </ string >
< string name = " save " > Salvar </ string >
</ resources >
Cdigo XML 5.5: strings.xml

Crie um novo arquivo java chamado CustomSQLiteOpenHelper com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

package br . com . k19 . android . cap05_02 ;


import android . content . Context ;
import android . database . sqlite . SQLiteDatabase ;
import android . database . sqlite . SQLiteOpenHelper ;
public class CustomSQLiteOpenHelper extends SQLiteOpenHelper {
public static final String TABLE_NOTES = " notes " ;
public static final String COLUMN_ID = " _id " ;
public static final String COLUMN_NOTES = " note " ;
private static final String DATABASE_NAME = " notes . db " ;
private static final int DATABASE_VERSION = 1;
// Database creation sql statement
private static final String DATABASE_CREATE = " create table "
+ TABLE_NOTES + " ( " + COLUMN_ID
+ " integer primary key autoincrement , " + COLUMN_NOTES
+ " text not null ) ; " ;
public CustomSQLiteOpenHelper ( Context context ) {
super ( context , DATABASE_NAME , null , DATABASE_VERSION ) ;
}
@Override
public void onCreate ( SQLiteDatabase database ) {
database . execSQL ( DATABASE_CREATE ) ;
}
@Override
public void onUpgrade ( SQLiteDatabase db , int oldVersion , int newVersion ) {
db . execSQL ( " DROP TABLE IF EXISTS " + TABLE_NOTES ) ;
onCreate ( db ) ;
}
}
Cdigo Java 5.5: CustomSQLiteOpenHelper.java

Crie um arquivo java chamado Note, com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

42

package br . com . k19 . android . cap05_02 ;


public class Note {
private long id ;
private String note ;
@Override
public String toString () {
return note ;
}
public long getId () {
return id ;
}

www.k19.com.br

43
16
17
18
19
20
21
22
23
24
25
26
27
28

P ERSISTNCIA DE DADOS

public void setId ( long id ) {


this . id = id ;
}
public String getNote () {
return note ;
}
public void setNote ( String note ) {
this . note = note ;
}
}
Cdigo Java 5.6: Note.java

Crie um arquivo chamado NotesDao, com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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

package br . com . k19 . android . cap05_02 ;


import java . util . ArrayList ;
import java . util . List ;
import
import
import
import
import

android . content . ContentValues ;


android . content . Context ;
android . database . Cursor ;
android . database . SQLException ;
android . database . sqlite . SQLiteDatabase ;

public class NotesDao {


private SQLiteDatabase database ;
private String [] columns = { CustomSQLiteOpenHelper . COLUMN_ID ,
CustomSQLiteOpenHelper . COLUMN_NOTES };
private CustomSQLiteOpenHelper sqliteOpenHelper ;
public NotesDao ( Context context ) {
sqliteOpenHelper = new CustomSQLiteOpenHelper ( context ) ;
}
public void open () throws SQLException {
database = sqliteOpenHelper . getWritableDatabase () ;
}
public void close () {
sqliteOpenHelper . close () ;
}
public Note create ( String note ) {
ContentValues values = new ContentValues () ;
values . put ( CustomSQLiteOpenHelper . COLUMN_NOTES , note ) ;
long insertId = database . insert ( CustomSQLiteOpenHelper . TABLE_NOTES , null ,
values ) ;
Cursor cursor = database . query ( CustomSQLiteOpenHelper . TABLE_NOTES ,
columns , CustomSQLiteOpenHelper . COLUMN_ID + " = " + insertId , null ,
null , null , null ) ;
cursor . moveToFirst () ;
Note newNote = new Note () ;
newNote . setId ( cursor . getLong (0) ) ;
newNote . setNote ( cursor . getString (1) ) ;
cursor . close () ;
return newNote ;
}
public void delete ( Note note ) {
long id = note . getId () ;
database . delete ( CustomSQLiteOpenHelper . TABLE_NOTES , CustomSQLiteOpenHelper . COLUMN_ID
+ " = " + id , null ) ;

www.k19.com.br

43

P ERSISTNCIA DE DADOS
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

44

}
public List < Note > getAll () {
List < Note > notes = new ArrayList < Note >() ;
Cursor cursor = database . query ( CustomSQLiteOpenHelper . TABLE_NOTES ,
columns , null , null , null , null , null ) ;
cursor . moveToFirst () ;
while (! cursor . isAfterLast () ) {
Note note = new Note () ;
note . setId ( cursor . getLong (0) ) ;
note . setNote ( cursor . getString (1) ) ;
notes . add ( note ) ;
cursor . moveToNext () ;
}
cursor . close () ;
return notes ;
}
}
Cdigo Java 5.7: NotesDao.java

Edite o arquivo res/menu/main.xml (se o arquivo no existir, voc deve cri-lo). Deixe-o com o
seguinte contedo:
1
2
3
4
5
6
7

< menu xmlns:android = " http: // schemas . android . com / apk / res / android " >
< item android:id = " @ + id / add_note "
android:title = " @string / add "
android:showAsAction = " ifRoom " / >
</ menu >
Cdigo XML 5.6: main.xml

A seguir edite o arquivo MainActivity.java para que ele fique com o seguinte contedo:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

44

package br . com . k19 . android . cap05_02 ;


import java . util . List ;
import
import
import
import
import
import

android . app . ListActivity ;


android . content . Intent ;
android . os . Bundle ;
android . view . Menu ;
android . view . MenuItem ;
android . widget . ArrayAdapter ;

public class MainActivity extends ListActivity {


private NotesDao dao ;
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
dao = new NotesDao ( this ) ;
dao . open () ;
}
@Override
protected void onResume () {
dao . open () ;
super . onResume () ;

www.k19.com.br

45
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

P ERSISTNCIA DE DADOS
List < Note > notes = dao . getAll () ;
ArrayAdapter < Note > adapter = new ArrayAdapter < Note >( this ,
android . R . layout . simple_list_item_1 , notes ) ;
setListAdapter ( adapter ) ;
}
@Override
protected void onPause () {
dao . close () ;
super . onPause () ;
}
@Override
public boolean onCreateOptionsMenu ( Menu menu ) {
getMenuInflater () . inflate ( R . menu . main , menu ) ;
return true ;
}
@Override
public boolean onOptionsItemSelected ( MenuItem item ) {
if ( item . getItemId () == R . id . add_note ) {
Intent intent = new Intent ( this , AddNoteActivity . class ) ;
startActivity ( intent ) ;
}
return super . onOptionsItemSelected ( item ) ;
}
}
Cdigo Java 5.8: MainActivity.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

Crie um novo arquivo XML na pasta de layouts chamado add_note.xml com o contedo abaixo:
<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< EditText
android:id = " @ + id / note_text "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:inputType = " textMultiLine "
android:hint = " @string / write_a_note " / >
< Button
android:id = " @ + id / save_note_button "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:hint = " @string / save " / >
</ LinearLayout >
Cdigo XML 5.7: add_name.xml

Crie uma nova classe chamada AddNoteActivity que herda Activity e possui o contedo abaixo:
1
2
3
4
5
6
7
8
9

package br . com . k19 . android . cap05_02 ;


import
import
import
import
import
import

android . app . Activity ;


android . os . Bundle ;
android . view . View ;
android . view . View . OnClickListener ;
android . widget . Button ;
android . widget . EditText ;

www.k19.com.br

45

P ERSISTNCIA DE DADOS
10
11
12
13
14
15
16
17
18
19
20
21
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

46

public class AddNoteActivity extends Activity {


private NotesDao dao ;
@Override
protected void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . add_note ) ;
dao = new NotesDao ( this ) ;
dao . open () ;
Button saveButton = ( Button ) findViewById ( R . id . save_note_button ) ;
final EditText noteText = ( EditText ) findViewById ( R . id . note_text ) ;
saveButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View v ) {
String note = noteText . getEditableText () . toString () ;
dao . create ( note ) ;
finish () ;
}
}) ;
}
@Override
protected void onResume () {
dao . open () ;
super . onResume () ;
}
@Override
protected void onPause () {
dao . close () ;
super . onPause () ;
}
}
Cdigo Java 5.9: Main.java

Se lembre de adicionar os nomes das activities no AndroidManifest.xml. Aps isso, rode a aplicao e veja o resultado. Feche a aplicao e abra novamente, para ver se o nome est salva.

46

www.k19.com.br

CAPTULO

HTTP E JSON

muito comum um aplicativo fazer requisies HTTP para fazer consultas a webservices. Dessa
forma, seu aplicativo pode integrar at diferentes servios em uma nica interface.

HTTP
Para fazer requisies, a API do Android oferece duas alternativas. A primeira utilizando a classe
DefaultHttpClient, do projeto Apache. Tambm existe a classe AndroidHttpClient que um subtipo
do DefaultHttpClient j configurado para valores otimizados no Android. Hoje em dia no mais
recomendado utilizar estas classes, porque a equipe do Google no d manuteno a essa implementao.
O mtodo recomendado utilizar a classe HttpUrlConnection, que desenvolvido e suportado
pelo Google. Veja um exemplo abaixo de como utiliz-la:
1
2
3
4
5
6
7
8

URL url = new URL ( " http :// www . android . com / " ) ;
HttpURLConnection urlConnection = ( HttpURLConnection ) url . openConnection () ;
try {
InputStream in = new BufferedInputStream ( urlConnection . getInputStream () ) ;
// l os dados do InputStream
} finally {
urlConnection . disconnect () ;
}
Cdigo Java 6.1: Exemplo.java

JSON
JSON ganhou muita fora nos ltimos anos como o formato mais utilizado no retorno de webservices, devido a sua simplicidade em comparao com XML. O Android possui bibliotecas padro
para lidar com JSON. Existem duas classes que so utilizadas com este propsito, JSONObject e JSONArray. A primeira serve para lidar com um objeto em JSON, enquanto a segunda usada em arrays
de objetos JSON. Veja abaixo um exemplo de uso:
1
2
3
4
5
6
7
8

JSONObject json = new JSONObject ( jsonString ) ;


try {
String campo1 = json . getString ( " campoObrigatorio " ) ;
String campo2 = json . optString ( " campoOpcional " , null ) ;
JSONObject objeto = json . getJSONObject ( " objetoAninhado " ) ;
} catch ( JSONException e ) {
e . printStackTrace () ;
}
Cdigo Java 6.2: Exemplo.java

www.k19.com.br

47

HTTP E JSON

48

Exerccios de Fixao
Crie um novo projeto Android. Use como nome para o projeto HttpAndJson. O nome do pacote
deve ser br.com.k19.android.cap06, e o nome da activity deve ser MainActivity.
1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

Na pasta res/layouts crie um arquivo chamado main.xml. Ele deve conter o seguinte contedo:
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
xmlns:tools = " http: // schemas . android . com / tools "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical "
android:padding = " 16 dp "
android:background = " # EEEEEE " >
< TextView
android:id = " @ + id / name_text "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:textSize = " 20 dp "
android:textColor = " #064 E83 "
android:paddingBottom = " 8 dp "
android:textStyle = " bold " / >
< TextView
android:id = " @ + id / address_text "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:textColor = " #6 C6C6C " / >
< TextView
android:id = " @ + id / city_text "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:textColor = " #6 C6C6C " / >
< TextView
android:id = " @ + id / phone_text "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:textColor = " #6 C6C6C " / >
< TextView
android:id = " @ + id / likes_text "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:textColor = " #6 C6C6C " / >
</ LinearLayout >
Cdigo XML 6.1: main.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10

48

< resources >


< string
< string
< string
< string
< string
< string
< string
< string

name = " app_name " > HttpAndJson </ string >


name = " hello_world " > Hello world ! </ string >
name = " menu_settings " > Settings </ string >
name = " title_activity_main " > HttpAndJson </ string >
name = " phone_label " > Telefone: %1$ s </ string >
name = " address_label " > Endereo: %1$ s </ string >
name = " city_label " > Cidade: %1$ s </ string >
name = " likes_label " > Total de likes: %1$ d </ string >

www.k19.com.br

49
11
12

HTTP E JSON

</ resources >


Cdigo XML 6.2: strings.xml

Crie um novo arquivo java chamado MainActivity.java com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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

package br . com . k19 . android . cap06 ;


import
import
import
import
import
import

java . io . BufferedReader ;
java . io . IOException ;
java . io . InputStream ;
java . io . InputStreamReader ;
java . net . HttpURLConnection ;
java . net . URL ;

import org . json . JSONException ;


import org . json . JSONObject ;
import
import
import
import
import

android . app . Activity ;


android . os . Bundle ;
android . os . StrictMode ;
android . view . Menu ;
android . widget . TextView ;

public class MainActivity extends Activity {


@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
TextView
TextView
TextView
TextView
TextView

nameText = ( TextView ) findViewById ( R . id . name_text ) ;


phoneText = ( TextView ) findViewById ( R . id . phone_text ) ;
addressText = ( TextView ) findViewById ( R . id . address_text ) ;
cityText = ( TextView ) findViewById ( R . id . city_text ) ;
likesText = ( TextView ) findViewById ( R . id . likes_text ) ;

StrictMode . ThreadPolicy policy = new StrictMode . ThreadPolicy . Builder () . permitAll () . build () ;


StrictMode . setThreadPolicy ( policy ) ;
String response = makeRequest ( " http :// graph . facebook . com / k19treinamentos " ) ;
try {
JSONObject json = new JSONObject ( response ) ;
String name = json . getString ( " name " ) ;
String phone = json . getString ( " phone " ) ;
int likes = json . getInt ( " likes " ) ;
String address = json . getJSONObject ( " location " ) . getString ( " street " ) ;
String city = json . getJSONObject ( " location " ) . getString ( " city " ) ;
nameText . setText ( name ) ;
phoneText . setText ( getString ( R . string . phone_label , phone ) ) ;
addressText . setText ( getString ( R . string . address_label , address ) ) ;
cityText . setText ( getString ( R . string . city_label , city ) ) ;
likesText . setText ( getString ( R . string . likes_label , likes ) ) ;
} catch ( JSONException e ) {
e . printStackTrace () ;
}
}
private String makeRequest ( String urlAddress ) {
HttpURLConnection con = null ;
URL url = null ;
String response = null ;
try {
url = new URL ( urlAddress ) ;

www.k19.com.br

49

HTTP E JSON
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
87
88
89
90
91
92
93
94
95
96

50

con = ( HttpURLConnection ) url . openConnection () ;


response = readStream ( con . getInputStream () ) ;
} catch ( Exception e ) {
e . printStackTrace () ;
} finally {
con . disconnect () ;
}
return response ;
}
private String readStream ( InputStream in ) {
BufferedReader reader = null ;
StringBuilder builder = new StringBuilder () ;
try {
reader = new BufferedReader ( new InputStreamReader ( in ) ) ;
String line = null ;
while (( line = reader . readLine () ) != null ) {
builder . append ( line + " \ n " ) ;
}
} catch ( IOException e ) {
e . printStackTrace () ;
} finally {
if ( reader != null ) {
try {
reader . close () ;
} catch ( IOException e ) {
e . printStackTrace () ;
}
}
}
return builder . toString () ;
}
}
Cdigo Java 6.3: MainActivity.java

Aps isso, rode a aplicao e veja o resultado.


3

Na pasta res/values crie um arquivo chamado colors.xml com o contedo abaixo:

1
2
3
4
5
6
7
8

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< resources >
< color name = " light_gray " ># EEEEEE </ color >
< color name = " blue " > #064 E83 </ color >
< color name = " gray " > #6 C6C6C </ color >
</ resources >
Cdigo XML 6.3: colors.xml

Na pasta res/values crie um arquivo chamado dimens.xml com o contedo abaixo:


1
2
3
4
5
6
7
8
9

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< resources >
< dimen
< dimen
< dimen
< dimen

name = " padding_small " >8 dp </ dimen >


name = " padding_medium " >8 dp </ dimen >
name = " padding_large " > 16 dp </ dimen >
name = " title_size " > 20 dp </ dimen >

</ resources >


Cdigo XML 6.4: colors.xml

50

www.k19.com.br

51

HTTP E JSON

Edite novamente o arquivo main.xml, deixando igual ao exemplo abaixo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
xmlns:tools = " http: // schemas . android . com / tools "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical "
android:padding = " @dimen / padding_large "
android:background = " @color / light_gray " >
< TextView
android:id = " @ + id / name_text "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:textSize = " @dimen / title_size "
android:textColor = " @color / blue "
android:paddingBottom = " @dimen / padding_medium "
android:textStyle = " bold " / >
< TextView
android:id = " @ + id / address_text "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:textColor = " @color / gray " / >
< TextView
android:id = " @ + id / city_text "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:textColor = " @color / gray " / >
< TextView
android:id = " @ + id / phone_text "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:textColor = " @color / gray " / >
< TextView
android:id = " @ + id / likes_text "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:textColor = " @color / gray " / >
</ LinearLayout >
Cdigo XML 6.5: main.xml

Rode novamente a aplicao e veja se est igual ao que era antes.

www.k19.com.br

51

HTTP E JSON

52

52

www.k19.com.br

CAPTULO

T HREADS E A SYNC TASKS

No Android, existe uma thread principal que responsvel por desenhar a tela e lidar com os
eventos de toque na tela. Esta thread conhecida como UI thread (User Interface Thread), ou tambm como main thread. Se o desenvolvedor no utilizar nenhum tipo de concorrncia, todo o cdigo que escrever ir rodar nesta thread principal. Isso se torna um problema para tarefas que levam
muito tempo a serem executadas, pois enquanto a tarefa est sendo executada, a interface para de
responder a eventos, como toques feito pelo usurio.
Se houver qualquer processamento que ocupe a UI thread por mais de 5 segundos, a aplicao ir
receber automaticamente um ANR (Application not responding), e o sistema ir fechar a aplicao.
Por isso, qualquer processamento mais lento deve ser feito em outras threads para no ocupar a UI
thread.

Threads e Handlers
No Android suportado o mesmo tipo de concorrncia dos demais aplicativos Java. Podemos
utilizar threads, que executam objetos do tipo Runnable. O nico porm, que no podemos alterar nada relativo a UI dentro destas threads que rodam em background. Apenas a UI thread que
pode alterar a UI. Para contornar esse problema podemos utilizar Handlers. Um Handler um objeto que possui o mtodo post(Runnable). O Runnable que passado ao mtodo post executado
posteriormente dentro da main thread e por isso pode realizar alteraes na interface da aplicao.
Outra alternativa que no envolve criar um Handler utilizar o mtodo runOnUiThread(Runnable),
que pertence a Activity. O Runnable que passado a este mtodo tambm executado dentro da
main thread.

Exerccios de Fixao
Crie um novo projeto Android. Use como nome para o projeto Threads. O nome do pacote deve
ser br.com.k19.android.cap07, e o nome da activity deve ser MainActivity.
1

1
2
3
4
5
6
7
8
9
10
11

Na pasta res/layouts crie um arquivo chamado main.xml. Ele deve conter o seguinte contedo:
<? xml version = " 1.0 " encoding = " utf -8 " ? >
< RelativeLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent " >
< ProgressBar
android:id = " @ + id / progress_bar "
style = " ? android:attr / progressBarStyleHorizontal "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:layout_centerInParent = " true "

www.k19.com.br

53

T HREADS E A SYNC TASKS


12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

54

android:indeterminate = " false "


android:max = " 10 "
android:padding = " 8 dp " >
</ ProgressBar >
< Button
android:id = " @ + id / start_button "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_below = " @id / progress_bar "
android:layout_centerHorizontal = " true "
android:text = " @string / start " >
</ Button >
</ RelativeLayout >
Cdigo XML 7.1: main.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2
3
4
5
6
7
8

< resources >


< string
< string
< string
< string

name = " app_name " > Threads </ string >


name = " menu_settings " > Settings </ string >
name = " title_activity_main " > MainActivity </ string >
name = " start " > Iniciar </ string >

</ resources >


Cdigo XML 7.2: strings.xml

Edite o arquivo MainActivity.java com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

54

package br . com . k19 . cap07 ;


import
import
import
import
import
import
import

android . app . Activity ;


android . os . Bundle ;
android . os . Handler ;
android . view . View ;
android . view . View . OnClickListener ;
android . widget . Button ;
android . widget . ProgressBar ;

public class MainActivity extends Activity {


private Handler handler ;
private ProgressBar progress ;
private Button startButton ;
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
progress = ( ProgressBar ) findViewById ( R . id . progress_bar ) ;
startButton = ( Button ) findViewById ( R . id . start_button ) ;
handler = new Handler () ;
startButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View v ) {
Runnable runnable = new Runnable () {
@Override
public void run () {
for ( int i = 1; i <= 10; i ++) {
final int value = i ;
try {
Thread . sleep (1000) ;

www.k19.com.br

55
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

T HREADS E A SYNC TASKS


} catch ( InterruptedException e ) {
e . printStackTrace () ;
}
handler . post ( new Runnable () {
@Override
public void run () {
progress . setProgress ( value ) ;
}
}) ;
}
}
};
new Thread ( runnable ) . start () ;
}
}) ;
}
}
Cdigo Java 7.1: MainActivity.java

Aps isso, rode a aplicao e veja o resultado. Clique no boto para iniciar o progresso.
3

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

Edite novamente o arquivo MainActivity.java e deixe-o igual ao exemplo abaixo:


package br . com . k19 . cap07 ;
import
import
import
import
import
import

android . app . Activity ;


android . os . Bundle ;
android . view . View ;
android . view . View . OnClickListener ;
android . widget . Button ;
android . widget . ProgressBar ;

public class MainActivity extends Activity {


private ProgressBar progress ;
private Button startButton ;
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
progress = ( ProgressBar ) findViewById ( R . id . progress_bar ) ;
startButton = ( Button ) findViewById ( R . id . start_button ) ;
startButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View v ) {
Runnable runnable = new Runnable () {
@Override
public void run () {
for ( int i = 1; i <= 10; i ++) {
final int value = i ;
try {
Thread . sleep (1000) ;
} catch ( InterruptedException e ) {
e . printStackTrace () ;
}
runOnUiThread ( new Runnable () {
@Override
public void run () {
progress . setProgress ( value ) ;
}
}) ;
}
}
};

www.k19.com.br

55

T HREADS E A SYNC TASKS


44
45
46
47
48
49

56

new Thread ( runnable ) . start () ;


}
}) ;
}
}
Cdigo Java 7.2: MainActivity.java

Rode novamente a aplicao e veja se funciona como o esperado.

AsyncTasks
Outra alternativa para utilizar concorrncia no Android utilizar AsyncTasks. Um AsyncTask um
objeto que encapsula em uma interface simples o uso de threads. Uma AsyncTask deve implementar
obrigatoriamente o mtodo doInBackground(), que exatamente a tarefa que est sendo executada
em background. Caso seja necessrio alguma atualizao na interface, s sobrescrever o mtodo
onPostExecute(). Tudo que estiver dentro deste mtodo executado na UI thread. Outro mtodo
interessante que pode ser sobrescrito o mtodo onPreExecute() que executado antes do doInBackground() e que tambm executado na UI thread.

Exerccios de Fixao
Crie um novo projeto Android. Use como nome para o projeto AsyncTask. O nome do pacote
deve ser br.com.k19.android.cap07_02, e o nome da activity deve ser MainActivity.
4

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

Na pasta res/layouts crie um arquivo chamado main.xml. Ele deve conter o seguinte contedo:
<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< Button
android:id = " @ + id / start_button "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:onClick = " downloadPicture "
android:text = " @string / start_image_download " >
</ Button >
< ImageView
android:id = " @ + id / image_view "
android:layout_width = " match_parent "
android:layout_height = " match_parent " >
</ ImageView >
</ LinearLayout >
Cdigo XML 7.3: main.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2

56

< resources >

www.k19.com.br

57
3
4
5
6
7
8
9

T HREADS E A SYNC TASKS


< string
< string
< string
< string
< string

name = " app_name " > AsyncTask </ string >


name = " title_activity_main " > MainActivity </ string >
name = " start_image_download " > Iniciar download da imagem </ string >
name = " download " > Download </ string >
name = " downloading " > downloading </ string >

</ resources >


Cdigo XML 7.4: strings.xml

Edite o arquivo MainActivity.java com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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

package br . com . k19 . android . cap07_02 ;


import
import
import
import
import

java . io . IOException ;
java . io . InputStream ;
java . net . HttpURLConnection ;
java . net . MalformedURLException ;
java . net . URL ;

import
import
import
import
import
import
import
import
import
import

android . app . Activity ;


android . app . ProgressDialog ;
android . graphics . Bitmap ;
android . graphics . BitmapFactory ;
android . os . AsyncTask ;
android . os . Bundle ;
android . view . View ;
android . view . View . OnClickListener ;
android . widget . Button ;
android . widget . ImageView ;

public class MainActivity extends Activity {


private
private
private
private

ProgressDialog dialog ;
Button startButton ;
ImageView imageView ;
DownloadImageTask task ;

@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
imageView = ( ImageView ) findViewById ( R . id . image_view ) ;
startButton = ( Button ) findViewById ( R . id . start_button ) ;
startButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View v ) {
dialog = ProgressDialog . show ( MainActivity . this ,
getString ( R . string . download ) ,
getString ( R . string . downloading ) ) ;
task = new DownloadImageTask () ;
task . execute ( " http :// k19 . com . br / css / img / main - header - logo . png " ) ;
}
}) ;
}
@Override
protected void onDestroy () {
if ( dialog != null && dialog . isShowing () ) {
dialog . dismiss () ;
dialog = null ;
}
if ( task != null ) {
task . cancel ( true ) ;
}

www.k19.com.br

57

T HREADS E A SYNC TASKS


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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

58

super . onDestroy () ;
}
private class DownloadImageTask extends AsyncTask < String , Void , Bitmap > {
@Override
protected Bitmap doInBackground ( String ... params ) {
try {
return downloadBitmap ( params [0]) ;
} catch ( IOException e ) {
e . printStackTrace () ;
}
return null ;
}
@Override
protected void onPreExecute () {
super . onPreExecute () ;
dialog . show () ;
}
@Override
protected void onPostExecute ( Bitmap result ) {
super . onPostExecute ( result ) ;
dialog . dismiss () ;
if ( result != null ) {
imageView . setImageBitmap ( result ) ;
}
}
private Bitmap downloadBitmap ( String url ) throws IOException {
URL imageUrl = null ;
try {
imageUrl = new URL ( url ) ;
} catch ( MalformedURLException e ) {
e . printStackTrace () ;
return null ;
}
Bitmap bitmapImage = null ;
try {
HttpURLConnection conn = ( HttpURLConnection ) imageUrl
. openConnection () ;
conn . setDoInput ( true ) ;
conn . connect () ;
InputStream is = conn . getInputStream () ;
bitmapImage = BitmapFactory . decodeStream ( is ) ;
} catch ( IOException e ) {
e . printStackTrace () ;
}
return bitmapImage ;
}
}
}
Cdigo Java 7.3: MainActivity.java

Adicione a permisso para internet no AndroidManifest.xml. Basta adicionar a seguinte linha:


1

< uses - permission android:name = " android . permission . INTERNET " / >
Cdigo XML 7.5: AndroidManifest.xml

Aps isso, rode a aplicao e veja o resultado.

58

www.k19.com.br

CAPTULO

S ERVICES E B ROAD C AST R ECEIVERS

Servios
Servios so aplicaes que executam, em geral, processos longos em background desprovidos de
interface. Uma aplicao, por exemplo, pode requisitar a um servio para fazer um download ou
mesmo executar uma msica enquanto o usurio interage com a interface ou mesmo sai da aplicao host. A aplicao e o Servio podem ainda se comunicar entre si.
Por padro, um servio sempre executado na Thread principal da aplicao host. Porm, isto
pode ser configurado para que o servio inicie outras threads quando chamado evitando assim que
a interface trave durante uma execuo que consuma muito processamento.

Manifest
Para criar um servio preciso declarar o nome da classe no Manifest.
1
2
3
4
5
6
7

< manifest ... >


...
< application ... >
< service android:name = " . ExampleService " / >
...
</ application >
</ manifest >
Cdigo XML 8.1: android:name o nico atributo obrigatrio

O servico pode ser utilizado por qualquer aplicao atravs de um Intent. Se o servio a ser
implementado for apenas util para a aplicao que o contm, ento preciso explicitar que o servio
privado no Manifest.
1
2
3
4
5
6
7
8
9
10

< manifest ... >


...
< application ... >
< service
android:name = " . ExampleService "
android:exported = " false "
/>
...
</ application >
</ manifest >
Cdigo XML 8.2: Tornando o servio local

www.k19.com.br

59

S ERVICES E B ROAD C AST R ECEIVERS

60

Classe Service
Para criar um servio preciso implementar uma extenso da classe Service e sobreescrever alguns mtodos de callback.

onStartCommand() - Mtodo que inicia um servio indefinidamente. O servio apenas termina


quando o mtodo stopSelf() executado a partir do prprio servio ou quando o mtodo stopService() executado a partir de outra aplicao.
onBind() - Mtodo que chamado pelo sistema para associar o servio a uma aplicao. Ele deve
prover uma interface de comunicao entre ambos. Este mtodo deve ser implementado obrigatoriamente, logo, se o servio no for desenhado para suportar Bind ento o mtodo onBind
deve devolver null.
onCreate() - Mtodo chamado pelo sistema no momento da criao do servio e pode ser utilizado
para realizar pr configuraes.
onDestroy() - Mtodo chamado pelo sistema quando o servio for destruido e pode ser utilizado
para liberar recursos utilizados.

Abaixo temos uma implementao simples de um servio.


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

public class ExampleService extends Service {


@Override
public void onCreate () {
// metodo executado no momento em que o servico e criado
}
@Override
public int onStartCommand ( Intent intent , int flags , int startId ) {
// execucao do servico
return START_STICKY ;
}
@Override
public IBinder onBind ( Intent intent ) {
// sem suporte a Binding
return null ;
}
@Override
public void onDestroy () {
// metodo executado no momento em que o servico e destruido
}
}
Cdigo Java 8.1: Extendendo a classe Service

Observe que o mtodo onStartCommand() devolve um inteiro. Este valor indica como o sistema
deve continuar o servico caso o sitema o mate. Existem 3 valores possveis:

START_NOT_STICKY - No reinicia o servio a menos que hajam Intents a serem entregues;


START_STICKY - Reinicia o servio mas no continua a partir do Intent que estava em execuo
mas apenas para os que estavam pendentes;
60

www.k19.com.br

61

S ERVICES E B ROAD C AST R ECEIVERS

START_REDELIVER_INTENT - Reinicia o servio retomando a partir do Intent que estava em execuo.


Lembre-se de que a thread que executa o servio a thread principal da aplicao host. Caso o
servio ocupe muito processamento preciso que o servio utilize uma nova thread evitando assim
travamentos na interface. No exemplo abaixo, a classe do servico foi modificada para executar sua
tarefa em uma thread separada.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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

public class ExampleService extends Service {


private Looper mServiceLooper ;
private ServiceHandler mServiceHandler ;
// Handler que executa de fato a tarefa do servico em uma thread separada
private final class ServiceHandler extends Handler {
public ServiceHandler ( Looper looper ) {
super ( looper ) ;
}
@Override
public void handleMessage ( Message msg ) {
// Implementacao da tarefa do servico
...
// Parando explicitamente o servico
stopSelf ( msg . arg1 ) ;
}
}
@Override
public void onCreate () {
// Criando a thread responsavel pela execucao da tarefa
HandlerThread thread = new HandlerThread ( " ServiceStartArguments " ,
Process . THREAD_PRIORITY_BACKGROUND ) ;
thread . start () ;
// Obtendo o Looper da thread e passando como parametro para o Handler
mServiceLooper = thread . getLooper () ;
mServiceHandler = new ServiceHandler ( mServiceLooper ) ;
}
@Override
public int onStartCommand ( Intent intent , int flags , int startId ) {
Toast . makeText ( this , " service starting " , Toast . LENGTH_SHORT ) . show () ;
// Para cada chamada ao servico enfileiramos uma tarefa no Handler
Message msg = mServiceHandler . obtainMessage () ;
msg . arg1 = startId ;
mServiceHandler . sendMessage ( msg ) ;
// Se o servico morrer a partir deste ponto , reiniciar
return START_STICKY ;
}
@Override
public IBinder onBind ( Intent intent ) {
// sem suporte a Binding
return null ;
}
@Override
public void onDestroy () {
Toast . makeText ( this , " service done " , Toast . LENGTH_SHORT ) . show () ;
}
}
Cdigo Java 8.2: Executando o servio em uma thread a parte

www.k19.com.br

61

S ERVICES E B ROAD C AST R ECEIVERS

62

Um detalhe importante que o mtodo onStartCommand() pode ser chamado pelo sistema diversas vezes, uma para cada requisio da aplicao. Cada uma delas vem acompanhada de um id
(startId). Se ao final de uma execuo o mtodo stopSelf() for chamado enquanto uma outra requisio est sendo executada, o servio terminaria sem completar a segunda execuo. Para evitar isto,
o mtodo stopSelf() pode receber um inteiro que representa o id da requisio que terminou. Se o id
for igual ao da ltima requisio o servio termina, caso contrrio ele continua a executar at que as
requisies acabem.
muito comum implementar servios que utilizem sua prpria thread para executar as tarefas
requisitadas, desta forma, o framework fornece uma extenso da classe Service que simplifica a criao de servios como o mostrado no ltimo exemplo. O cdigo abaixo implementa um servio que
se comporta como o exemplo anterior utilizando a classe IntentService.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

public class ExampleService extends IntentService {


/* *
* O contrutor e obrigatorio e deve chamar o contrutor da super classe
* passando o nome da Thread worker
*/
public ExampleService () {
super ( " ExampleService " ) ;
}
/* *
* Este metodo e chamado pela IntentService a partir de um worker Thread e recebe o
* Intent que iniciou o servico . Quando o metodo termina o IntentService para o
* servico .
*/
@Override
protected void onHandleIntent ( Intent intent ) {
// Implementacao da tarefa do servico
}
}
Cdigo Java 8.3: Utilizando a classe IntentService

Quando utilizamos a classe IntentService, no necessrio se preocupar em parar o servio.

Iniciando um servio
Para dar incio a um servio basta criar um intent e pass-lo como parmetro ao mtodo startService() como no exemplo a seguir:
1
2

Intent intent = new Intent ( this , ExampleService . class ) ;


startService ( intent ) ;
Cdigo Java 8.4: Iniciando um servio

Exerccios de Fixao
1 Crie um novo projeto Android. Use como nome para o projeto Services. O nome do pacote deve
ser br.com.k19.android.cap08, e o nome da activity deve ser MainActivity.
2

62

Na pasta res/layouts crie um arquivo chamado main.xml. Ele deve conter o seguinte contedo:
www.k19.com.br

63
1
2
3
4
5
6
7
8
9
10
11
12
13
14

S ERVICES E B ROAD C AST R ECEIVERS


<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< Button
android:id = " @ + id / start_button "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:text = " @string / start_downloads "
android:layout_gravity = " center " / >
</ LinearLayout >
Cdigo XML 8.3: main.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11

< resources >


< string
< string
< string
< string
< string
< string
< string

name = " app_name " > Services </ string >


name = " hello_world " > Hello world ! </ string >
name = " menu_settings " > Settings </ string >
name = " title_activity_main " > MainActivity </ string >
name = " start_downloads " > Iniciar downloads </ string >
name = " download_error " > Erro ao fazer download . </ string >
name = " download_success " > Download feito com sucesso %1$ s . </ string >

</ resources >


Cdigo XML 8.4: strings.xml

Crie um arquivo chamado DownloadService.java com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

package br . com . k19 . android . cap08 ;


import
import
import
import
import
import

java . io . File ;
java . io . FileOutputStream ;
java . io . IOException ;
java . io . InputStream ;
java . io . InputStreamReader ;
java . net . URL ;

import
import
import
import
import
import
import
import
import

android . app . Activity ;


android . app . IntentService ;
android . content . Intent ;
android . net . Uri ;
android . os . Bundle ;
android . os . Environment ;
android . os . Message ;
android . os . Messenger ;
android . util . Log ;

public class DownloadService extends IntentService {


private int result = Activity . RESULT_CANCELED ;
public DownloadService () {
super ( " DownloadService " ) ;
}
@Override
protected void onHandleIntent ( Intent intent ) {
Uri data = intent . getData () ;
String urlPath = intent . getStringExtra ( " urlPath " ) ;

www.k19.com.br

63

S ERVICES E B ROAD C AST R ECEIVERS


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

64

String fileName = data . getPath () ;


File output = new File ( Environment . getExternalStorageDirectory () ,
fileName ) ;
if ( output . exists () ) {
output . delete () ;
}
InputStream stream = null ;
FileOutputStream fos = null ;
try {
URL url = new URL ( urlPath ) ;
stream = url . openConnection () . getInputStream () ;
InputStreamReader reader = new InputStreamReader ( stream ) ;
fos = new FileOutputStream ( output . getPath () ) ;
int next = -1;
while (( next = reader . read () ) != -1) {
fos . write ( next ) ;
}
result = Activity . RESULT_OK ;
} catch ( Exception e ) {
e . printStackTrace () ;
} finally {
if ( stream != null ) {
try {
stream . close () ;
} catch ( IOException e ) {
e . printStackTrace () ;
}
}
if ( fos != null ) {
try {
fos . close () ;
} catch ( IOException e ) {
e . printStackTrace () ;
}
}
}
Bundle extras = intent . getExtras () ;
if ( extras != null ) {
Messenger messenger = ( Messenger ) extras . get ( " messenger " ) ;
Message msg = Message . obtain () ;
msg . arg1 = result ;
msg . obj = output . getAbsolutePath () ;
try {
messenger . send ( msg ) ;
} catch ( android . os . RemoteException e1 ) {
Log . e ( " DownloadService " , " Erro ao enviar mensagem " , e1 ) ;
}
}
}
}
Cdigo Java 8.5: DownloadService.java

Edite o arquivo MainActivity.java com o seguinte contedo:


1
2
3
4
5
6
7
8
9

64

package br . com . k19 . android . cap08 ;


import
import
import
import
import
import
import

android . app . Activity ;


android . content . Intent ;
android . net . Uri ;
android . os . Bundle ;
android . os . Handler ;
android . os . Message ;
android . os . Messenger ;

www.k19.com.br

65
10
11
12
13
14
15
16
17
18
19
20
21
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

S ERVICES E B ROAD C AST R ECEIVERS


import
import
import
import

android . view . View ;


android . view . View . OnClickListener ;
android . widget . Button ;
android . widget . Toast ;

public class MainActivity extends Activity {


private Handler handler = new Handler () {
public void handleMessage ( Message message ) {
Object path = message . obj ;
if ( message . arg1 == RESULT_OK && path != null ) {
Toast . makeText ( MainActivity . this ,
getString ( R . string . download_success , path . toString () ) ,
Toast . LENGTH_LONG ) . show () ;
} else {
Toast . makeText ( MainActivity . this ,
getString ( R . string . download_error ) , Toast . LENGTH_LONG )
. show () ;
}
};
};
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
Button startButton = ( Button ) findViewById ( R . id . start_button ) ;
startButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View v ) {
Intent intent = new Intent ( MainActivity . this ,
DownloadService . class ) ;
Messenger messenger = new Messenger ( handler ) ;
intent . putExtra ( " messenger " , messenger ) ;
intent . setData ( Uri . parse ( " cursos . html " ) ) ;
intent . putExtra ( " urlPath " , " http :// k19 . com . br / cursos " ) ;
startService ( intent ) ;
}
}) ;
}
}

Cdigo Java 8.6: MainActivity.java

Aps isso, rode a aplicao e veja o resultado. Clique no boto para iniciar o download.

BroadCast Receivers
Um BroadCast Receiver um objeto que herda BroadCastReceiver, e que implementa o mtodo
onReceive(). Eles devem ser registrados no AndroidManifest.xml. Um receiver em geral deve ser
usado para receber alguma notificao do sistema, e executar uma tarefa dependendo do tipo de
notificao recebido. Por exemplo, se sua aplicao recebeu uma notificao de que a bateria est
baixa, ele pode foradamente parar servios ou tarefas que estejam consumindo muito processamento, ou at fechar o aplicativo.

Exerccios de Fixao
www.k19.com.br

65

S ERVICES E B ROAD C AST R ECEIVERS

66

Crie um novo projeto Android. Use como nome para o projeto Reveiver. O nome do pacote deve
ser br.com.k19.android.cap08_02, e o nome da activity deve ser MainActivity.
3

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

Crie um arquivo chamado PhoneReceiver.java com o seguinte contedo:


package br . com . k19 . android . cap08_02 ;
import
import
import
import
import
import

android . content . BroadcastReceiver ;


android . content . Context ;
android . content . Intent ;
android . os . Bundle ;
android . telephony . TelephonyManager ;
android . util . Log ;

public class PhoneReceiver extends BroadcastReceiver {


private static final String TAG = " PhoneReceiver " ;
@Override
public void onReceive ( Context context , Intent intent ) {
Bundle extras = intent . getExtras () ;
if ( extras != null ) {
String state = extras . getString ( TelephonyManager . EXTRA_STATE ) ;
Log . w ( TAG , state ) ;
if ( state . equals ( TelephonyManager . EXTRA_STATE_RINGING ) ) {
String phoneNumber = extras
. getString ( TelephonyManager . EXTRA_INCOMING_NUMBER ) ;
Log . w ( TAG , phoneNumber ) ;
}
}
}
}
Cdigo Java 8.7: PhoneReceiver.java

Edite o arquivo AndroidManifest.xml, e deixe-o igual ao exemplo abaixo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

66

< manifest xmlns:android = " http: // schemas . android . com / apk / res / android "
package = " br . com . k19 . android . cap08_02 "
android:versionCode = " 1 "
android:versionName = " 1.0 " >
< uses - sdk
android:minSdkVersion = " 8 "
android:targetSdkVersion = " 15 " / >
< uses - permission android:name = " android . permission . READ_PHONE_STATE " / >
< application
android:icon = " @drawable / ic_launcher "
android:label = " @string / app_name "
android:theme = " @style / AppTheme " >
< activity
android:name = " . MainActivity "
android:label = " @string / title_activity_main " >
< intent - filter >
< action android:name = " android . intent . action . MAIN " / >
< category android:name = " android . intent . category . LAUNCHER " / >
</ intent - filter >
</ activity >
< receiver android:name = " . PhoneReceiver " >
< intent - filter >
< action android:name = " android . intent . action . PHONE_STATE " >
</ action >

www.k19.com.br

67
30
31
32
33
34

S ERVICES E B ROAD C AST R ECEIVERS


</ intent - filter >
</ receiver >
</ application >
</ manifest >
Cdigo XML 8.5: AndroidManifest.xml

Aps isso, rode a aplicao. Para testar, voc deve simular uma ligao no emulador. Para fazer
isso, mude a perspectiva para DDMS, e encontre a aba tEmulator Control. Nesta aba, basta preencher um nmero e pressionar o boto Call. Aps isso, veja no LogCat se deu certo.

www.k19.com.br

67

S ERVICES E B ROAD C AST R ECEIVERS

68

68

www.k19.com.br

CAPTULO

N OTIFICAES

Dialogs
Quando voc precisa mostrar avisos ao usurio, o mais indicado utilizar dialogs. Para criar
um dialog no Android, o indicado herdar a classe DialogFragment. Ao criar uma subclasse, voc
deve sobrescrever os mtodos onCreate() e onCreateView() para criar o seu dilogo customizado.
Outra opo caso voc queira um dilogo simples, como um AlertDialog por exemplo, voc pode
sobrescrever o mtodo onCreateDialog().

Exerccios de Fixao
1
Crie um novo projeto Android. Use como nome para o projeto Dialogs. O nome do pacote deve
ser br.com.k19.android.cap09, e o nome da activity deve ser MainActivity.
2

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

Na pasta res/layouts crie um arquivo chamado main.xml. Ele deve conter o seguinte contedo:
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
xmlns:tools = " http: // schemas . android . com / tools "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< Button
android:id = " @ + id / show_progress_dialog_button "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:padding = " 5 dp "
android:layout_margin = " 8 dp "
android:text = " @string / show_progress_dialog " / >
< Button
android:id = " @ + id / show_alert_dialog_button "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:padding = " 5 dp "
android:layout_margin = " 8 dp "
android:text = " @string / show_alert_dialog " / >
< Button
android:id = " @ + id / show_custom_dialog_button "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:padding = " 5 dp "
android:layout_margin = " 8 dp "
android:text = " @string / show_custom_dialog " / >
</ LinearLayout >
Cdigo XML 9.1: main.xml

www.k19.com.br

69

N OTIFICAES

70

Copie o logo do site da K19 para a pasta drawable-hdpi. O arquivo deve-se chamar k19_logo.png.
Na pasta res/layouts crie um arquivo chamado custom_dialog.xml. Ele deve conter o seguinte
contedo:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:orientation = " vertical " >
< ImageView
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:src = " @drawable / k19_logo "
android:layout_gravity = " center_horizontal "
android:padding = " 8 dp "
android:contentDescription = " @string / logo " / >
</ LinearLayout >
Cdigo XML 9.2: main.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

< resources >


< string
< string
< string
< string
< string
< string
< string
< string
< string
< string
< string
< string
< string
< string

name = " app_name " > Notifications </ string >


name = " title_activity_main " > MainActivity </ string >
name = " attention " > Ateno </ string >
name = " which_button_gonna_press " > Qual boto voc ir apertar ? </ string >
name = " yes " > Sim </ string >
name = " pressed_yes " > Pressionou sim </ string >
name = " no " > No </ string >
name = " pressed_no " > Pressionou no </ string >
name = " wait " > Aguarde ... </ string >
name = " k19_training " > K19 Treinamentos </ string >
name = " show_progress_dialog " > Mostrar Progress Dialog </ string >
name = " show_alert_dialog " > Mostrar Alert Dialog </ string >
name = " show_custom_dialog " > Mostrar Custom Dialog </ string >
name = " logo " > logo </ string >

</ resources >


Cdigo XML 9.3: strings.xml

Edite o arquivo MainActivity.java com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

70

package com . example . notifications ;


import
import
import
import
import
import
import
import
import
import
import
import
import

android . app . Activity ;


android . app . AlertDialog ;
android . app . Dialog ;
android . app . DialogFragment ;
android . app . ProgressDialog ;
android . content . DialogInterface ;
android . os . Bundle ;
android . view . LayoutInflater ;
android . view . View ;
android . view . View . OnClickListener ;
android . view . ViewGroup ;
android . widget . Button ;
android . widget . Toast ;

public class MainActivity extends Activity {

www.k19.com.br

71
19
20
21
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

N OTIFICAES
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
Button progressButton = ( Button ) findViewById ( R . id . show_progress_dialog_button ) ;
Button alertButton = ( Button ) findViewById ( R . id . show_alert_dialog_button ) ;
Button customButton = ( Button ) findViewById ( R . id . show_custom_dialog_button ) ;
progressButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View v ) {
DialogFragment dialog = ProgressDialogFragment . newInstance () ;
dialog . show ( getFragmentManager () , " progress " ) ;
}
}) ;
alertButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View v ) {
DialogFragment dialog = AlertDialogFragment . newInstance () ;
dialog . show ( getFragmentManager () , " alert " ) ;
}
}) ;
customButton . setOnClickListener ( new OnClickListener () {
@Override
public void onClick ( View v ) {
DialogFragment dialog = CustomDialogFragment . newInstance () ;
dialog . show ( getFragmentManager () , " custom " ) ;
}
}) ;
}
public static class AlertDialogFragment extends DialogFragment {
public static AlertDialogFragment newInstance () {
AlertDialogFragment frag = new AlertDialogFragment () ;
return frag ;
}
@Override
public Dialog onCreateDialog ( Bundle savedInstanceState ) {
AlertDialog dialog = new AlertDialog . Builder ( getActivity () )
. create () ;
dialog . setTitle ( getActivity () . getString ( R . string . attention ) ) ;
dialog . setMessage ( getActivity () . getString ( R . string . which_button_gonna_press ) ) ;
dialog . setButton ( DialogInterface . BUTTON_POSITIVE , getActivity () . getString ( R . string . yes ) ,
new DialogInterface . OnClickListener () {
@Override
public void onClick ( DialogInterface dialog , int which ) {
Toast . makeText ( getActivity () , R . string . pressed_yes ,
Toast . LENGTH_SHORT ) . show () ;
}
}) ;
dialog . setButton ( DialogInterface . BUTTON_NEGATIVE , getActivity () . getString ( R . string . no ) ,
new DialogInterface . OnClickListener () {
@Override
public void onClick ( DialogInterface dialog , int which ) {
Toast . makeText ( getActivity () , R . string . pressed_no ,
Toast . LENGTH_SHORT ) . show () ;
}
}) ;
return dialog ;
}

69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

www.k19.com.br

71

N OTIFICAES
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

72

public static class ProgressDialogFragment extends DialogFragment {


public static ProgressDialogFragment newInstance () {
ProgressDialogFragment frag = new ProgressDialogFragment () ;
return frag ;
}
@Override
public Dialog onCreateDialog ( Bundle savedInstanceState ) {
Dialog dialog = new ProgressDialog ( getActivity () ) ;
dialog . setTitle ( R . string . wait ) ;
return dialog ;
}
}
public static class CustomDialogFragment extends DialogFragment {
public static CustomDialogFragment newInstance () {
CustomDialogFragment frag = new CustomDialogFragment () ;
return frag ;
}
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
}
@Override
public View onCreateView ( LayoutInflater inflater , ViewGroup container ,
Bundle savedInstanceState ) {
View v = inflater . inflate ( R . layout . custom_dialog , container ,
false ) ;
getDialog () . setTitle ( R . string . k19_training ) ;
return v ;
}
}
}
Cdigo Java 9.1: MainActivity.java

Aps isso, rode a aplicao e veja o resultado. Clique nos botes para ver o que acontece.

Notifications
Outro estilo de notificao o conhecido como Status Bar Notifications, que so aqueles alertas
que aparecem na barra de status. Existem diferentes tipos de alertas que podem ser criados. Em
todos os casos, voc deve utilizar a classe NotificationManager para enviar as notificaes para o
sistema. Para construir uma notificao, utilizado o Notification.Builder() que possui diferentes
mtodos que customizam o contedo e aparncia da notificao.

Exerccios de Fixao
Crie um novo projeto Android. Use como nome para o projeto Notifications. O nome do pacote
deve ser br.com.k19.android.cap09_02, e o nome da activity deve ser MainActivity.
3

Na pasta res/layouts crie um arquivo chamado main.xml. Ele deve conter o seguinte contedo:

<? xml version = " 1.0 " encoding = " utf -8 " ? >

72

www.k19.com.br

73
2
3
4
5
6
7
8
9
10
11
12
13

N OTIFICAES
< RelativeLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent " >
< Button
android:id = " @ + id / create_notification_button "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:text = " @string / create_notification "
android:layout_centerInParent = " true " / >
</ RelativeLayout >
Cdigo XML 9.4: main.xml

Na pasta res/layouts crie um arquivo chamado notification.xml. Ele deve conter o seguinte contedo:
1
2
3
4
5
6
7
8
9
10
11
12
13

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< RelativeLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent " >
< TextView
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:layout_centerInParent = " true "
android:text = " @string / notification_activity_description "
android:gravity = " center_horizontal " / >
</ RelativeLayout >
Cdigo XML 9.5: main.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11

< resources >


< string name = " app_name " > Notifications </ string >
< string name = " menu_settings " > Settings </ string >
< string name = " title_activity_main " > MainActivity </ string >
< string name = " new_notification " > Nova notificao </ string >
< string name = " notification_content " > Contedo descrevendo a notificao . </ string >
< string name = " create_notification " > Criar notificao </ string >
< string name = " notification_activity_description " > Esta tela foi aberta a partir da notificao . </ string >
</ resources >
Cdigo XML 9.6: strings.xml

Crie um arquivo chamado NotificationActivity.java com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12

package br . com . k19 . android . cap09_02 ;


import br . com . k19 . android . cap09_02 . R ;
import android . app . Activity ;
import android . os . Bundle ;
public class NotificationActivity extends Activity {
@Override
protected void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . notification ) ;

www.k19.com.br

73

N OTIFICAES
13
14

74

}
}
Cdigo Java 9.2: NotificationActivity.java

Edite o arquivo MainActivity.java com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

package br . com . k19 . android . cap09_02 ;


import
import
import
import
import
import
import
import
import

android . app . Activity ;


android . app . Notification ;
android . app . NotificationManager ;
android . app . PendingIntent ;
android . content . Intent ;
android . os . Bundle ;
android . view . View ;
android . view . View . OnClickListener ;
android . widget . Button ;

public class MainActivity extends Activity {


@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
Button createNotification = ( Button ) findViewById ( R . id . create_notification_button ) ;
createNotification . setOnClickListener ( new OnClickListener () {

22
23
24
25
26
27

@Override
public void onClick ( View v ) {
Intent intent = new Intent ( MainActivity . this , NotificationActivity . class ) ;
PendingIntent pendingIntent = PendingIntent . getActivity ( MainActivity . this , 0 , intent , 0) ;

28
29
30
31

Notification notification = new Notification . Builder ( MainActivity . this )


. setContentTitle ( getString ( R . string . new_notification ) )
. setContentText ( getString ( R . string . notification_content ) ) . setSmallIcon ( R . drawable . ic_action_search )
. setContentIntent ( pendingIntent )
. getNotification () ;

32
33
34
35
36
37
38
39
40
41
42

notification . flags |= Notification . FLAG_AUTO_CANCEL ;


NotificationManager notificationManager = ( NotificationManager ) getSystemService ( NOTIFICATION_SERVICE ) ;
notificationManager . notify (0 , notification ) ;
}
}) ;
}
}
Cdigo Java 9.3: MainActivity.java

Aps isso, rode a aplicao e veja o resultado. Clique no boto, e logo em seguida na notificao
que deve aparecer.

74

www.k19.com.br

CAPTULO

M APAS E GPS

10

Uma das vantagens de se desenvolver aplicaes para dispositivos mveis que podemos tirar
proveito da geolocalizao e criar aplicativos teis para o usurio, que levam em considerao a sua
localizao.

Utilizando o GPS
Para utilizar o GPS, necessrio utilizar a classe LocationManager. Esta classe permite obter
a posio do usurio, registrar listeners de localizao, etc. Para obter uma posio, necessrio
escolher um LOCATION PROVIDER. O provider define como a posio do usurio ser obtida:

network - utiliza as antenas de rede e Wi-Fi para determinar a posio do usurio. mais rpido em
geral do que o GPS, e funciona melhor em ambientes fechados tambm.
gps - utiliza o sistema de GPS do aparelho para determinar a posio. A preciso nesse caso melhor
do que usando network.

Para utilizar o GPS, necessrio incluir a permisso ACCESS_FINE_LOCATION. Para usar apenas
a rede necessrio incluir a permisso ACCESS_COARSE_LOCATION.
possvel usar um objeto do tipo Criteria para auxiliar que tipo de provider ser utilizado. Com
este objeto definimos paramtros como preciso, velocidade de resposta, etc, e ele se encarrega de
escolher o provider mais adequado.

Exerccios de Fixao

Crie um novo projeto Android. Use como nome para o projeto LocationApi. O nome do pacote
deve ser br.com.k19.android.cap10, e o nome da activity deve ser MainActivity.
1

Na pasta res/layouts crie um arquivo chamado main.xml. Ele deve conter o seguinte contedo:

1
2
3
4
5
6
7
8
9
10

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< LinearLayout
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:layout_marginTop = " 40 dp "

www.k19.com.br

75

M APAS E GPS
11
12
13
14
15
16
17
18
19
20
21
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

76
android:orientation = " horizontal " >
< TextView
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_marginLeft = " 10 dp "
android:layout_marginRight = " 5 dp "
android:text = " @string / latitude_label "
android:textSize = " 20 dp " >
</ TextView >

< TextView
android:id = " @ + id / latitude_text "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:text = " @string / unknown "
android:textSize = " 20 dp " >
</ TextView >
</ LinearLayout >
< LinearLayout
android:layout_width = " match_parent "
android:layout_height = " wrap_content " >
< TextView
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_marginLeft = " 10 dp "
android:layout_marginRight = " 5 dp "
android:text = " @string / longitude_label "
android:textSize = " 20 dp " >
</ TextView >
< TextView
android:id = " @ + id / longitude_text "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:text = " @string / unknown "
android:textSize = " 20 dp " >
</ TextView >
</ LinearLayout >
</ LinearLayout >
Cdigo XML 10.1: main.xml

Edite o arquivo AndroidManifest.xml. Ele deve conter o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

76

< manifest xmlns:android = " http: // schemas . android . com / apk / res / android "
package = " com . example . locationapi "
android:versionCode = " 1 "
android:versionName = " 1.0 " >
< uses - sdk
android:minSdkVersion = " 8 "
android:targetSdkVersion = " 15 " / >
< uses - permission android:name = " android . permission . INTERNET " / >
< uses - permission android:name = " android . permission . ACCESS_FINE_LOCATION " / >
< uses - permission android:name = " android . permission . ACCESS_COARSE_LOCATION " / >
< application
android:icon = " @drawable / ic_launcher "
android:label = " @string / app_name "
android:theme = " @style / AppTheme " >
< activity
android:name = " . MainActivity "
android:label = " @string / app_name " >
< intent - filter >

www.k19.com.br

77
22
23
24
25
26
27
28
29

M APAS E GPS
< action android:name = " android . intent . action . MAIN " / >
< category android:name = " android . intent . category . LAUNCHER " / >
</ intent - filter >
</ activity >
</ application >
</ manifest >
Cdigo XML 10.2: main.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11

< resources >


< string
< string
< string
< string
< string
< string
< string

name = " app_name " > LocationApi </ string >


name = " menu_settings " > Settings </ string >
name = " point_label " > %.4 f </ string >
name = " location_not_available " > Local no disponvel </ string >
name = " latitude_label " >" Latitude: " </ string >
name = " longitude_label " >" Longitude: " </ string >
name = " unknown " > desconhecido </ string >

</ resources >


Cdigo XML 10.3: strings.xml

Edite o arquivo MainActivity.java com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

package com . example . locationapi ;


import
import
import
import
import
import
import
import
import
import

android . app . Activity ;


android . content . Context ;
android . location . Criteria ;
android . location . Location ;
android . location . LocationListener ;
android . location . LocationManager ;
android . os . Bundle ;
android . util . Log ;
android . widget . TextView ;
android . widget . Toast ;

public class MainActivity extends Activity implements LocationListener {


private static final String TAG = " MainActivity " ;
private
private
private
private

TextView latitudeText ;
TextView longitudeText ;
LocationManager locationManager ;
String provider ;

@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
latitudeText = ( TextView ) findViewById ( R . id . latitude_text ) ;
longitudeText = ( TextView ) findViewById ( R . id . longitude_text ) ;
locationManager = ( LocationManager ) getSystemService ( Context . LOCATION_SERVICE ) ;
Criteria criteria = new Criteria () ;
provider = locationManager . getBestProvider ( criteria , false ) ;
Location location = locationManager . getLastKnownLocation ( provider ) ;
if ( location != null ) {
Log . d ( TAG , " Provider " + provider + " foi selecionado . " ) ;

www.k19.com.br

77

M APAS E GPS
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

78

onLocationChanged ( location ) ;
} else {
latitudeText . setText ( R . string . location_not_available ) ;
longitudeText . setText ( R . string . location_not_available ) ;
}
}
@Override
protected void onResume () {
super . onResume () ;
locationManager . requestLocationUpdates ( provider , 400 , 1 , this ) ;
}
@Override
protected void onPause () {
super . onPause () ;
locationManager . removeUpdates ( this ) ;
}
@Override
public void onLocationChanged ( Location location ) {
double lat = location . getLatitude () ;
double lng = location . getLongitude () ;
latitudeText . setText ( getString ( R . string . point_label , lat ) ) ;
longitudeText . setText ( getString ( R . string . point_label , lng ) ) ;
}
@Override
public void onStatusChanged ( String provider , int status , Bundle extras ) {
}
@Override
public void onProviderEnabled ( String provider ) {
Toast . makeText ( this , " Novo provider " + provider ,
Toast . LENGTH_SHORT ) . show () ;
}
@Override
public void onProviderDisabled ( String provider ) {
Toast . makeText ( this , " Provider desabilitado " + provider ,
Toast . LENGTH_SHORT ) . show () ;
}
}
Cdigo Java 10.1: MainActivity.java

Rode novamente a aplicao e veja se funciona como o esperado.

Usando o MapView
possvel mostrar mapas na aplicao utilizando o MapView. Para isso necessrio utilizar um
target com suporte Google APIs, e incluir a seguinte tag no AndroidManifest.xml:
1

< uses - permission android:name = " android . permission . INTERNET " / >
Cdigo XML 10.4: AndroidManifest.xml

necessrio tambm ter uma chave cadastrada no Google Maps API, para que a nossa aplicao
possa ter acesso ao Maps API do Google.

78

www.k19.com.br

79

M APAS E GPS

Mais Sobre
Para descobrir como gerar a sua chave para uso (que ser necessria no prximo exerccio) acesse a url abaixo:

https://developers.google.com/maps/documentation/android/mapkey

Exerccios de Fixao
Crie um novo projeto Android. Use como nome para o projeto MapsExample. O nome do pacote
deve ser br.com.k19.android.cap10_02, e o nome da activity deve ser MainActivity.
3

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

Edite o arquivo AndroidManifest.xml e deixe-o com o seguinte contedo:


< manifest xmlns:android = " http: // schemas . android . com / apk / res / android "
package = " br . com . k19 . android . cap10_02 "
android:versionCode = " 1 "
android:versionName = " 1.0 " >
< uses - sdk
android:minSdkVersion = " 8 "
android:targetSdkVersion = " 15 " / >
< uses - permission android:name = " android . permission . INTERNET " / >
< application
android:icon = " @drawable / ic_launcher "
android:label = " @string / app_name "
android:theme = " @style / AppTheme " >
< uses - library android:name = " com . google . android . maps " / >
< activity
android:name = " . MainActivity "
android:label = " @string / title_activity_main " >
< intent - filter >
< action android:name = " android . intent . action . MAIN " / >
< category android:name = " android . intent . category . LAUNCHER " / >
</ intent - filter >
</ activity >
</ application >
</ manifest >
Cdigo XML 10.5: AndroidManifest.xml

Crie um arquivo chamado CustomItemizedOverlay com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11

package br . com . k19 . android . cap10_02 ;


import java . util . ArrayList ;
import
import
import
import
import
import

android . app . AlertDialog ;


android . app . AlertDialog . Builder ;
android . content . Context ;
android . content . DialogInterface ;
android . graphics . drawable . Drawable ;
android . widget . Toast ;

www.k19.com.br

79

M APAS E GPS
12
13
14
15
16
17
18
19
20
21
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

80

import com . google . android . maps . ItemizedOverlay ;


import com . google . android . maps . OverlayItem ;
public class CustomItemizedOverlay extends ItemizedOverlay < OverlayItem > {
private ArrayList < OverlayItem > mOverlays = new ArrayList < OverlayItem >() ;
private Context context ;
public CustomItemizedOverlay ( Context context , Drawable defaultMarker ) {
super ( boundCenterBottom ( defaultMarker ) ) ;
this . context = context ;
}
public void addOverlay ( OverlayItem overlay ) {
mOverlays . add ( overlay ) ;
populate () ;
}
@Override
protected OverlayItem createItem ( int i ) {
return mOverlays . get ( i ) ;
}
@Override
public int size () {
return mOverlays . size () ;
}
protected boolean onTap ( int index ) {
OverlayItem item = mOverlays . get ( index ) ;
AlertDialog . Builder dialog = new AlertDialog . Builder ( context ) ;
dialog . setTitle ( item . getTitle () ) ;
dialog . setMessage ( item . getSnippet () ) ;
dialog . show () ;
return true ;
};
}
Cdigo Java 10.2: CustomItemizedOverlay.java

Baixe a imagem do logo no site da K18 (http://k19.com.br e salve na pasta res/drawable-hdpi


com o nome de k19_logo.png.
Edite o arquivo main.xml e deixe-o igual ao exemplo abaixo:
1
2
3
4
5
6
7

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< com . google . android . maps . MapView xmlns:android = " http: // schemas . android . com / apk / res / android "
android:id = " @ + id / mapview "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:apiKey = " API KEY "
android:clickable = " true " / >
Cdigo XML 10.6: main.xml

Edite o arquivo MainActivity.java com o seguinte contedo:


1
2
3
4
5
6
7
8

80

package br . com . k19 . android . cap10_02 ;


import java . util . List ;
import
import
import
import

android . content . Context ;


android . graphics . drawable . Drawable ;
android . location . Location ;
android . location . LocationListener ;

www.k19.com.br

81
9
10
11
12
13
14
15
16
17
18
19
20
21
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

M APAS E GPS
import android . location . LocationManager ;
import android . os . Bundle ;
import
import
import
import
import
import
import

com . google . android . maps . GeoPoint ;


com . google . android . maps . MapActivity ;
com . google . android . maps . MapController ;
com . google . android . maps . MapView ;
com . google . android . maps . MyLocationOverlay ;
com . google . android . maps . Overlay ;
com . google . android . maps . OverlayItem ;

public class MainActivity extends MapActivity {


private
private
private
private

MapController mapController ;
MapView mapView ;
CustomItemizedOverlay itemizedOverlay ;
MyLocationOverlay myLocationOverlay ;

public void onCreate ( Bundle bundle ) {


super . onCreate ( bundle ) ;
setContentView ( R . layout . main ) ;
mapView = ( MapView ) findViewById ( R . id . mapview ) ;
mapView . setBuiltInZoomControls ( true ) ;
mapView . setSatellite ( false ) ;
mapController = mapView . getController () ;
mapController . setZoom (14) ;
myLocationOverlay = new MyLocationOverlay ( this , mapView ) ;
mapView . getOverlays () . add ( myLocationOverlay ) ;

List < Overlay > mapOverlays = mapView . getOverlays () ;


Drawable drawable = this . getResources () . getDrawable ( R . drawable . k19_logo ) ;
itemizedOverlay = new CustomItemizedOverlay ( this , drawable ) ;
GeoPoint point = new GeoPoint ( -23570794 , -46690747) ;
OverlayItem overlayitem = new OverlayItem ( point , " K19 " , " Cursos e Treinamentos " ) ;
itemizedOverlay . addOverlay ( overlayitem ) ;
mapOverlays . add ( itemizedOverlay ) ;
}
@Override
protected boolean isRouteDisplayed () {
return false ;
}
}
Cdigo Java 10.3: MainActivity.java

Rode a aplicao e veja o resultado.

www.k19.com.br

81

M APAS E GPS

82

82

www.k19.com.br

CAPTULO

A PNDICE - M ULTIMEDIA

11

Introduo
O Android prov uma API robusta para desenvolvimento de aplicaes com suporte a reproduo e
gravao de udio e imagem. Neste captulo vamos entender como funcionam as principais funes
de manipulao de mdia.

Reproduo de Mdia
O framework de multimedia do Android capaz reproduzir os tipos mais comuns de mdia. Com ele
possvel reproduzir udio de vdeo puros ou codificados a partir do sistema de arquivos ou mesmo
atravs da internet.

Classes importantes
A reproduo de mdia uma tarefa relativamente simples e para adicionarmos esta funcionalidade em uma aplicao Android vamos utilizar duas das classes mais importantes do framework.
MediaPlayer - Principal classe para execuo de som e video
AudioManager - Esta classe manipula as entradas e sadas de udio do dispositivo.

Manifest
Dependendo da funcionalidade que a aplicao ir utilizar do framework ser preciso configurar
o manifesto com as permisses necessrias:
Caso seja necessrio utilizar o MediaPlayer como player de um stream atravs da internet ento
temos que adicionar a seguinte permisso:
1

< uses - permission android:name = " android . permission . INTERNET " / >
Cdigo XML 11.1: Internet Permission

Caso o seu player precise manter a tela sem esmaecer ou manter o processador sem entrar em
modo de economia de energia ento preciso adicionar a seguinte permisso para que os mtodos
MediaPlayer.setScreenOnWhilePlaying() or MediaPlayer.setWakeMode() sejam executados.
1

< uses - permission android:name = " android . permission . WAKE_LOCK " / >
Cdigo XML 11.2: Wake Lock Permission

www.k19.com.br

83

A PNDICE - M ULTIMEDIA

84

Utilizando o MediaPlayer
O MediaPlayer um dos componentes de mdia mais importantes do framework do Android.
Uma instancia desta classe capaz de buscar, decodificar e reproduzir contedos de udio e vdeo
exigindo pouca configurao.
Principais funes da classe MediaPlayer:
MediaPlayer.setDataSource() - Seleciona a mdia (caminho do arquivo local ou remoto) a ser reproduzida;
MediaPlayer.prepare() - Prepara (decodifica, pr-armazena, etc) a mdia transformando-a em udio puro pronto para ser reproduzido;
MediaPlayer.start() - Inicia a reproduo do udio;
MediaPlayer.pause() - Pausa a reproduo do udio;
MediaPlayer.stop() - Encerra a reproduo do udio;
mediaPlayer.setAudioStreamType() - Define o tipo de mdia que ser reproduzido. Para arquivos
de msica vamos passar como parmetro a constante AudioManager.STREAM_MUSIC.
Abaixo temos um trecho de cdigo que reproduz um arquivo de udio puro localizado em res/raw/. Neste caso estamos utilizando como entrada o recurso de udio da prpria aplicao.
1
2
3
4

// criando a instancia do MediaPlayer


MediaPlayer mediaPlayer = MediaPlayer . create ( context , R . raw . arquivo_som_puro ) ;
// iniciando a reproduo
mediaPlayer . start () ;
Cdigo Java 11.1: Reproduo de udio puro

No caso acima, como o arquivo contm som puro, no existe a necessidade de nenhuma preparao (decodificao) para ser reproduzido. Contudo, sero raras as vezes em que a mdia a ser reproduzida no estar codificada. Por esta razo a classe MediaPlayer suporta os tipos mais comuns
de formatos e podemos utilizar o mtodo MediaPlayer.prepare() para reproduz-los como mostra o
cdigo a seguir.
1
2
3
4
5
6
7
8
9
10
11
12

// localizao do arquivo local de mdia


Uri myUri = ....;
// criando um player
MediaPlayer mediaPlayer = new MediaPlayer () ;
// definindo que o tipo de stream arquivo de msica
mediaPlayer . setAudioStreamType ( AudioManager . STREAM_MUSIC ) ;
// fazendo com que o player encontre o arquivo de entrada
mediaPlayer . setDataSource ( getApplicationContext () , myUri ) ;
// preparando a msica para ser reproduzida
mediaPlayer . prepare () ;
// iniciando a reproduo
mediaPlayer . start () ;
Cdigo Java 11.2: Arquivo de mdia local

1
2

84

// localizao do arquivo remoto de mdia


String url = " http ://........ " ;

www.k19.com.br

85
3
4
5
6
7
8
9
10
11
12

A PNDICE - M ULTIMEDIA
// criando um player
MediaPlayer mediaPlayer = new MediaPlayer () ;
// definindo que o tipo de stream arquivo de msica
mediaPlayer . setAudioStreamType ( AudioManager . STREAM_MUSIC ) ;
// fazendo com que o player encontre o arquivo de entrada
mediaPlayer . setDataSource ( url ) ;
// preparando a msica para ser reproduzida
mediaPlayer . prepare () ;
// iniciando a reproduo
mediaPlayer . start () ;
Cdigo Java 11.3: Mdia transmitida pela internet

Mais Sobre
Para saber mais sobre os tipos de mdia suportados pelo MediaPlayer acesse http://

developer.android.com/guide/appendix/media-formats.html

Preparao Assncrona
Com o que foi visto at este ponto podemos desenvolver uma aplicao que reproduz udio sem
muito esforo. Porm, quando se trata de uma mdia codificada em algum formato especfico, ento
a chamada do mtodo MediaPlayer.prepare() pode levar muito tempo para busca, decodificao e
pr-carregamento do udio e isto pode acarretar em uma lentido sensvel da nossa aplicao.
Para evitar este tipo de problema no podemos executar este procedimento utilizando a thread
da interface, mas sim, iniciar um processo assncrono que realizar estas atividades custosas e em
seguia comunicar a thread principal que a tarefa foi concluda. Este tipo de abordagem to comum que a classe MediaPlayer j fornece suporte a carregamento assncrono atravs do mtodo
prepareAsync().
Basta associar ao player um objeto que implementa a interface MediaPlayer.OnPreparedListener
e sobreescrever o mtodo MediaPlayer.OnPreparedListener.onPrepared(). Uma vez que o mtodo
prepareAsync() for chamado e terminar de preparar a mdia o mtodo onPrepared() ser executado
e o player pode iniciar a reproduo da mdia.
O cdigo abaixo um exemplo do uso assncrono do mtodo prepare().
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

public class AudioPlaybackTest extends Activity implements MediaPlayer . OnPreparedListener {


MediaPlayer mMediaPlayer = null ;
...
@Override
public void onCreate ( Bundle icicle ) {
super . onCreate ( icicle ) ;
...
mMediaPlayer = ... // inicializao do MediaPlayer
mMediaPlayer . setOnPreparedListener ( this ) ;
mMediaPlayer . prepareAsync () ;
}
/* * Chamado quando o MediaPlayer estiver pronto */
@Override
public void onPrepared ( MediaPlayer player ) {
player . start () ;

www.k19.com.br

85

A PNDICE - M ULTIMEDIA
19
20

86

}
}

Cdigo Java 11.4: Exemplo de Activity com preparao assncrona

Estados de execuo

Quando estamos utilizando o MediaPlayer devemos levar em considerao o estado em que ele
est antes de executar um comando. Cada comando s pode ser utilizado em alguns estados e se isto
no for respeitado a aplicao pode se comportar de maneira inesperada eu at ser finalizada com
erro.
Quando criamos um objeto do tipo MediaPlayer, ele est no estado Idle. Ao executar o mtodo
setDataSource ele passa para o estado Initialized. Depois da execuo do mtodo prepare (ou prepareAsync) o objeto passa a assumir o estado Prepared. Os mtodos start e pause alternam o estado do
player entre Started e Paused. Quando a execuo termina o estado PlaybackCompleted e quando
o mtodo stop executado o estado do player Stopped.
Um exemplo de comando invlido seria chamar o mtodo start com o player no estado Stopped. Neste estado preciso chamar novamente o mtodo prepare() se desejar reproduzir a mdia
novamente.
Veja abaixo o mapa de estados completo do MediaPlayer.
86

www.k19.com.br

87

A PNDICE - M ULTIMEDIA
reset()

release()

IDLE

setDataSource()

prepareAsync()

Preparing

OnErrorListener.onError()

END

ERROR

Initialized

OnPrepareListener.onPrepared()

prepare()

seekTo()

Prepared

strart()

prepareAsync()

stop()
Looping == true && playback completes

prepare()

Started
seekTo()/start()
strart()
stop()

pause()
seekTo()/pause()

stop()
Stoped

stop()
Looping == false &&
onCompletion() invoked
on OnCompletionListener

Paused

strart()
(note: from beginnig)

stop()

seekTo()
Playback
Completed

Figura 11.1: Resultado da tela.

Desalocando o recurso do MediaPlayer


preciso sempre ter em mente que o MediaPlayer consome muito recurso do dispositivo e portanto deve-se ter certeza de que no estamos segurando recursos por tempo alm do que realmente
necessrio.
Observe abaixo o cdigo que pode ser utilizado para liberar o recurso do MediaPlayer.
1
2
3

// liberando o recurso alocado


mediaPlayer . release () ;
// perdendo a referncia do MediaPlayer

www.k19.com.br

87

A PNDICE - M ULTIMEDIA
4

88

mediaPlayer = null ;
Cdigo Java 11.5: Liberao de recurso alocado pelo MediaPlayer

Se a inteno desenvolver uma aplicao que no mantenha a reproduo em background


(vamos explicar a seguir) ento interessante liberar o recurso do MediaPlayer no momento da chamada onStop() da activity.

Reproduzindo mdia em Background


Para desenvolver uma aplicao que reproduza mdia em background, ou seja, continue executando a mdia mesmo que outra aplicao esteja na tela, ento ser preciso iniciar um Servio (visto
em captulos anteriores) e controlar o MediaPlayer atravs dele. Assim como recomendado em uma
Activity normal, o Service deve executar as tarefas assincronamente. Observe o cdigo de exemplo
abaixo:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

public class MyService extends Service implements MediaPlayer . OnPreparedListener {


private static final ACTION_PLAY = " br . com . k19 . action . PLAY " ;
MediaPlayer mMediaPlayer = null ;
public int onStartCommand ( Intent intent , int flags , int startId ) {
...
if ( intent . getAction () . equals ( ACTION_PLAY ) ) {
mMediaPlayer = ... // inicializao do player
mMediaPlayer . setOnPreparedListener ( this ) ;
mMediaPlayer . prepareAsync () ; // preparando a mdia assncronamente
}
}
/* * Chamado quando o MediaPlayer estiver pronto */
@Override
public void onPrepared ( MediaPlayer player ) {
player . start () ;
}
}
Cdigo Java 11.6: Reproduo em background

Podemos ainda melhorar a implementao acima adicionando tratamento de erros de operaes


assncronas. Bastando, para isto, associar ao player um objeto que implementa MediaPlayer.OnErrorListener
utilizando o mtodo setOnErrorListener() e sobreescrever o mtodo MediaPlayer.OnErrorListener.onError().
Se ocorrer algum erro fora da thread principal o mtodo onError() ser executado e o erro poder ser
tratado apropriadamente.
Por timo, lembre-se de que o MediaPlayer consome muito recurso e recomendado chamar explicitamente o mtodo MediaPlayer.release() j que o Garbage Collector pode demorar muito at liberar os recursos alocados. Para garantir este comportamento, sobreescreva o mtodo Service.onDestroy().
1
2
3
4
5
6
7
8
9

88

public class MyService extends Service implements MediaPlayer . OnPreparedListener , MediaPlayer . OnErrorListener {
private static final ACTION_PLAY = " br . com . k19 . action . PLAY " ;
MediaPlayer mMediaPlayer = null ;
public int onStartCommand ( Intent intent , int flags , int startId ) {
...
if ( intent . getAction () . equals ( ACTION_PLAY ) ) {
mMediaPlayer = ... // inicializao do player
mMediaPlayer . setOnPreparedListener ( this ) ;

www.k19.com.br

89
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

A PNDICE - M ULTIMEDIA
mMediaPlayer . setOnErrorListener ( this ) ;
mMediaPlayer . prepareAsync () ; // preparando a mdia assncronamente
}
}
@Override
public void onPrepared ( MediaPlayer player ) {
player . start () ;
}
@Override
public boolean onError ( MediaPlayer mp , int what , int extra ) {
// Tratamento do erro
}
@Override
public void onDestroy () {
if ( mMediaPlayer != null ) mMediaPlayer . release () ;
}
}
Cdigo Java 11.7: Verso melhorada

importante lembrar que se ocorrer algum erro no MediaPlayer o seu estado passar para Error
e dever ser resetado utilizando o mtodo reset() para ser til novamente.

Exerccios de Fixao
Crie um novo projeto Android. Use como nome para o projeto MediaPlayer. O nome do pacote
deve ser br.com.k19.android.cap11, e o nome da activity deve ser MainActivity.
1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

Edite o arquivo AndroidManifest.xml e deixe-o com o seguinte contedo:


< manifest xmlns:android = " http: // schemas . android . com / apk / res / android "
package = " br . com . k19 . android . cap11 "
android:versionCode = " 1 "
android:versionName = " 1.0 " >
< uses - sdk
android:minSdkVersion = " 8 "
android:targetSdkVersion = " 15 " / >
< application
android:icon = " @drawable / ic_launcher "
android:label = " @string / app_name "
android:theme = " @style / AppTheme " >
< activity
android:name = " . MainActivity "
android:label = " @string / title_activity_main " >
< intent - filter >
< action android:name = " android . intent . action . MAIN " / >
< category android:name = " android . intent . category . LAUNCHER " / >
</ intent - filter >
</ activity >
< service android:name = " . MediaPlayerService " >
</ service >
</ application >
</ manifest >

www.k19.com.br

89

A PNDICE - M ULTIMEDIA

90

Cdigo XML 11.3: Manifest.xml

Crie uma pasta chamada raw dentro da pasta res. Coloque um arquivo mp3 chamado sample.mp3 dentro de raw.
3

Crie um arquivo na pasta src chamado MediaPlayerService.java e crie nela uma classe chamada
MediaPlayerService que herda de Service e implementa as interfaces OnPreparedListener e OnErrorListener. O cdigo deve ficar como o exemplo abaixo:
4

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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

90

package br . com . k19 . android . cap11 ;


import java . io . IOException ;
import
import
import
import
import
import
import
import

android . app . Service ;


android . content . Intent ;
android . media . MediaPlayer ;
android . media . MediaPlayer . OnErrorListener ;
android . media . MediaPlayer . OnPreparedListener ;
android . net . Uri ;
android . os . IBinder ;
android . widget . Toast ;

public class MediaPlayerService extends Service implements OnPreparedListener , OnErrorListener {


private MediaPlayer mMediaPlayer ;
@Override
public int onStartCommand ( Intent intent , int flags , int startId ) {
Toast . makeText ( this , " Iniciando o Servico " , Toast . LENGTH_SHORT ) . show () ;
try {
mMediaPlayer = new MediaPlayer () ;
Uri path = Uri . parse ( " android . resource :// br . com . k19 . android . cap11 / " + R . raw . sample ) ;
mMediaPlayer . setDataSource ( getApplicationContext () , path ) ;
mMediaPlayer . setOnPreparedListener ( this ) ;
mMediaPlayer . prepareAsync () ;
}
catch ( IOException e ) {
// recurso nao encontrado
}
return super . onStartCommand ( intent , flags , startId ) ;
}
@Override
public void onDestroy () {
super . onDestroy () ;
Toast . makeText ( this , " Terminando o Servico " , Toast . LENGTH_SHORT ) . show () ;
if ( mMediaPlayer != null ) {
mMediaPlayer . release () ;
mMediaPlayer = null ;
}
}
@Override
public IBinder onBind ( Intent intent ) {
return null ;
}
public void onPrepared ( MediaPlayer mp ) {
mMediaPlayer . start () ;
}

www.k19.com.br

91
55
56
57
58
59

A PNDICE - M ULTIMEDIA
public boolean onError ( MediaPlayer arg0 , int arg1 , int arg2 ) {
// tratamento de erros
return false ;
}
}
Cdigo Java 11.8: MediaPlayer

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:

1
2
3
4
5
6

< resources >


< string name = " app_name " > MediaPlayer </ string >
< string name = " hello_world " > Now playing ! </ string >
< string name = " menu_settings " > Settings </ string >
< string name = " title_activity_main " > MainActivity </ string >
</ resources >
Cdigo XML 11.4: string.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

A classe MainActivity deve ficar parecida com o cdigo a seguir:


package br . com . k19 . android . cap11 ;
import
import
import
import
import

br . com . k19 . android . cap11 . R ;


android . os . Bundle ;
android . app . Activity ;
android . content . Intent ;
android . view . Menu ;

public class MainActivity extends Activity {


private Intent intent ;
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . activity_main ) ;
intent = new Intent ( this , ExampleService . class ) ;
startService ( intent ) ;
}
@Override
protected void onDestroy () {
super . onDestroy () ;
stopService ( intent ) ;
};
@Override
public boolean onCreateOptionsMenu ( Menu menu ) {
getMenuInflater () . inflate ( R . menu . activity_main , menu ) ;
return true ;
}
}
Cdigo Java 11.9: Activity

Rode a aplicao.

Captura de udio
www.k19.com.br

91

A PNDICE - M ULTIMEDIA

92

O framework do Android suporta tambm gravao de udio nos formato mais comuns tornando
a aplicao bastante verstil. A classe mais importante para esta tarefa a MediaRecorder.

Manifest
preciso explicitar no arquivo de manifesto o pedido de permisso para gravar udio.
1

< uses - permission android:name = " android . permission . RECORD_AUDIO " / >
Cdigo XML 11.5: Permisso de gravaao de udio

Gravando udio pelo microfone


Para iniciar uma gravao de udio pelo microfone basta seguir alguns passos:
1. Criar uma instancia de android.media.MediaRecorder.
2. Configurar a fonte de udio, que neste cso o microfone, utilizando o mtodo MediaRecorder.setAudioSource() passando a constante MediaRecorder.AudioSource.MIC.
3. Em seguida configure o formato de sada MediaRecorder.setOutputFormat() passando o formato desejado. Veja abaixo as opes:
AAC_ADTS - AAC ADTS file format
AMR_NB - AMR NB file format
AMR_WB - AMR WB file format
DEFAULT - Tipo padro
MPEG_4 - MPEG4 media file format
THREE_GPP - 3GPP media file format
4. D um nome ao arquivo de sada atravs do mtodo MediaRecorder.setOutputFile() passando
um file descriptor (String) que define o arquivo de sada. Exemplo:
1

mRecorder . setOutputFile ( fileName ) ;


Cdigo Java 11.10: Definindo arquivo de sada

5. O prximo passo definir o encoder usando o mtodo MediaRecorder.setAudioEncoder().


Veja abaixo as opes:
AAC - AAC Low Complexity (AAC-LC) audio codec
AAC_ELD - Enhanced Low Delay AAC (AAC-ELD) audio codec
AMR_NB - AMR (Narrowband) audio codec
92

www.k19.com.br

93

A PNDICE - M ULTIMEDIA

AMR_WB - AMR (Wideband) audio codec

DEFAULT - Tipo padro

HE_AAC - High Efficiency AAC (HE-AAC) audio codec

6. Com estas informaes definidas podemos chamar o mtodo MediaRecorder.prepare().


7. Quando o recorder estiver preparado podemos iniciar a gravao com o mtodo MediaRecorder.start().
8. Para terminar de gravar basta chamar o mtodo MediaRecorder.stop().
9. Depois de concluda a gravao, lembre-se de chamar o mtodo MediaRecorder.release() para
liberar os recursos alocados pelo gravador.
Observe abaixo um trecho de cdigo de um exemplo simples de gravao a partir do microfone.
1
2
3
4
5
6
7
8
9
10

MediaRecorder recorder = new MediaRecorder () ;


recorder . setAudioSource ( MediaRecorder . AudioSource . MIC ) ;
recorder . setAudioEncoder ( MediaRecorder . AudioEncoder . AMR_NB ) ;
recorder . setOutputFormat ( MediaRecorder . OutputFormat . THREE_GPP ) ;
recorder . setOutputFile ( PATH_NAME ) ;
recorder . prepare () ;
recorder . start () ;
// iniciando a gravao
...
recorder . stop () ;
recorder . release () ; // Liberando o recurso alocado

Cdigo Java 11.11: Gravando a partir do microfone

Estados de execuo

Assim como o MediaPlayer, o MediaRecorder pode assumir alguns estados dependendo da etapa
de gravao que a aplicao estiver realizando. Novamente, dependendo do estado que o recorder
estiver, alguns comandos podem ou no ser executados.
Veja abaixo o mapa completo de possveis estados do MediaRecorder.
www.k19.com.br

93

A PNDICE - M ULTIMEDIA

Error occurs or
an invalid call

94

reset()

Error

Initial

release()
reset()

Released

setAudioSource()/
setVideoSource()

Initialized

reset()/
stop()

setAudioSource()/
setVideoSource()
reset()

setOutputFormat()

reset()

DataSourceCongured

Recording

prepare()

start()

setAudioEncoder()
setVideoEncoder()
setOutputFile()
setVideoSize()
setVideoFrameRate()
setPreviewDisplay()

Prepared

Figura 11.2: Resultado da tela

Exerccios de Fixao
8
Crie um novo projeto Android. Use como nome para o projeto MediaRecorder. O nome do
pacote deve ser br.com.k19.android.cap11, e o nome da activity deve ser MainActivity.

Na pasta res/layouts crie um arquivo chamado activity_main.xml. Ele deve conter o seguinte
contedo:
9

1
2
3
4
5
6

94

< RelativeLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
xmlns:tools = " http: // schemas . android . com / tools "
android:layout_width = " match_parent "
android:layout_height = " match_parent " >
< TextView

www.k19.com.br

95
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

A PNDICE - M ULTIMEDIA
android:id = " @ + id / textView1 "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_centerHorizontal = " true "
android:layout_centerVertical = " true "
android:text = " @string / hello_world "
tools:context = " . MainActivity " / >
< Button
android:id = " @ + id / button1 "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_alignParentLeft = " true "
android:layout_alignParentTop = " true "
android:text = " @string / gravar_button_label " / >
< Button
android:id = " @ + id / button2 "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_alignParentRight = " true "
android:layout_alignParentTop = " true "
android:text = " @string / reproduzir_button_label " / >
</ RelativeLayout >
Cdigo XML 11.6: activity_main.xml

10

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:

1
2
3
4
5
6
7
8

< resources >


< string name = " app_name " > MediaRecorder </ string >
< string name = " hello_world " > Recording Audio ! </ string >
< string name = " menu_settings " > Settings </ string >
< string name = " title_activity_main " > MainActivity </ string >
< string name = " gravar_button_label " > Iniciar gravacao </ string >
< string name = " reproduzir_button_label " > Iniciar reproducao </ string >
</ resources >
Cdigo XML 11.7: strings.xml

11

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

O arquivo AndroidManifest.xml deve ficar com o seguinte contedo:


< manifest xmlns:android = " http: // schemas . android . com / apk / res / android "
package = " br . com . k19 . android . cap11 "
android:versionCode = " 1 "
android:versionName = " 1.0 " >
< uses - sdk
android:minSdkVersion = " 8 "
android:targetSdkVersion = " 15 " / >
< uses - permission android:name = " android . permission . RECORD_AUDIO " / >
< uses - permission android:name = " android . permission . WRITE_EXTERNAL_STORAGE " / >
< application
android:icon = " @drawable / ic_launcher "
android:label = " @string / app_name "
android:theme = " @style / AppTheme " >
< activity
android:name = " . MainActivity "
android:label = " @string / title_activity_main " >
< intent - filter >
< action android:name = " android . intent . action . MAIN " / >
< category android:name = " android . intent . category . LAUNCHER " / >
</ intent - filter >

www.k19.com.br

95

A PNDICE - M ULTIMEDIA
25
26
27
28

96

</ activity >


</ application >
</ manifest >
Cdigo XML 11.8: AndroidManifest.xml

12

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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

96

Edite o arquivo MainActivity.java com o seguinte contedo:


package br . com . k19 . android . cap11 ;
import java . io . File ;
import java . io . IOException ;
import
import
import
import
import
import
import
import
import
import
import

android . app . Activity ;


android . media . MediaPlayer ;
android . media . MediaPlayer . OnCompletionListener ;
android . media . MediaRecorder ;
android . os . Bundle ;
android . os . Environment ;
android . util . Log ;
android . view . MenuItem ;
android . view . View ;
android . view . View . OnClickListener ;
android . widget . Button ;

public class MainActivity extends Activity


{
private final String LOG_TAG = " MainActivity " ;
private MediaRecorder mRecorder ;
private boolean recording ;
Button gravarButton ;
private MediaPlayer mPlayer ;
private boolean playing ;
Button reproduzirButton ;
private String mFileName ;
private void onPlay () {
if ( playing ) {
reproduzirButton . setText ( " Iniciar execucao " ) ;
mPlayer . stop () ;
mPlayer . release () ;
mPlayer = null ;
}
else {
try {
reproduzirButton . setText ( " Parar execucao " ) ;
mPlayer = new MediaPlayer () ;
mPlayer . setOnCompletionListener ( new OnCompletionListener () {
public void onCompletion ( MediaPlayer mp ) {
playing = true ;
onPlay () ;
}
}) ;
mPlayer . setDataSource ( mFileName ) ;
mPlayer . prepare () ;
mPlayer . start () ;
}
catch ( Exception e ) {
Log . e ( LOG_TAG , e . getMessage () ) ;
}
}
playing = ! playing ;
}

www.k19.com.br

97
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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

A PNDICE - M ULTIMEDIA

private void onRecord () {


if ( recording ) {
gravarButton . setText ( " Iniciar gravacao " ) ;
mRecorder . stop () ;
mRecorder . release () ;
mRecorder = null ;
}
else {
try {
mRecorder = new MediaRecorder () ;
mRecorder . setAudioSource ( MediaRecorder . AudioSource . MIC ) ;
mRecorder . setOutputFormat ( MediaRecorder . OutputFormat . THREE_GPP ) ;
mRecorder . setOutputFile ( mFileName ) ;
mRecorder . setAudioEncoder ( MediaRecorder . AudioEncoder . AMR_NB ) ;
mRecorder . prepare () ;
mRecorder . start () ;
gravarButton . setText ( " Parar gravacao " ) ;
} catch ( IOException e ) {
Log . e ( LOG_TAG , e . getMessage () ) ;
}
}
recording = ! recording ;
}
@Override
protected void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
String filepath = Environment . getExternalStorageDirectory () . getPath () ;
File file = new File ( filepath , " RecordFolder " ) ;
if (! file . exists () ) {
file . mkdirs () ;
}
mFileName = file . getAbsolutePath () + " / lastRecordedFile .3 gp " ;
recording = false ;
setContentView ( R . layout . activity_main ) ;
gravarButton = ( Button ) findViewById ( R . id . button1 ) ;
reproduzirButton = ( Button ) findViewById ( R . id . button2 ) ;
gravarButton . setOnClickListener ( new OnClickListener () {
public void onClick ( View v ) {
onRecord () ;
}
}) ;
reproduzirButton . setOnClickListener ( new OnClickListener () {
public void onClick ( View v ) {
onPlay () ;
}
}) ;
}
@Override
public boolean onMenuItemSelected ( int featureId , MenuItem item ) {
return super . onMenuItemSelected ( featureId , item ) ;
}
}

Cdigo Java 11.12: MainActivity.java

Execute a aplicao. Note que por uma questo de simplicidade no tomamos todos cuidados
com relao a concorrncia entre gravao e reproduo, bem como acessos a arquivos inexistentes.
13

www.k19.com.br

97

A PNDICE - M ULTIMEDIA

98

Captura de Vdeo

Objetivo
Nesta seo vamos aprender a manipular a cmera produzindo imagens e videos com udio. O
android expe dos recursos da cmera, quando presente, de duas maneiras: Via intent ou diretamente via API. Veremos a seguir que cada modo deve ser utilizado de acordo com a necessidade.

Manifest
Antes de utilizar o recurso de captao de imagens em nossa aplicao devemos considerar se a
cmera e suas funes so ou no obrigatrias para um bom funcionamento do seu aplicativo. Se
sim preciso declarar no Manifesto o uso da cmera e desta maneira no ser permitida a instalao
do aplicativo em dispositivos sem cmera.
Sua aplicao deve requisitar permisso para uso da cmera.
1

< uses - permission android:name = " android . permission . CAMERA " / >
Cdigo XML 11.9: Permisso para utilizao de cmera.

Sua aplicao deve tambm requisitar acesso algumas funes da cmera:


1

< uses - feature android:name = " android . hardware . camera " / >
Cdigo XML 11.10: Permisso para utilizao de recursos da cmera.

A declarao de utilizao de funes interessante para que o Google Play evite que sua aplicao seja instalada em dispositivos que no tenham a funo especfica. Veja outras funes:
1
2
3

< uses - feature android . hardware . camera . autofocus / >


< uses - feature android . hardware . camera . flash / >
< uses - feature android . hardware . camera . front / >
Cdigo XML 11.11: Mais tipos de permisses para acesso a recursos da cmera.

Se a aplicao utilizar dos recursos da cmera no sendo eles obrigatrios ento preciso adicionar um atributo na declarao indicando que ela opcional mas desejvel. Exemplo:
1

< uses - feature android:name = " android . hardware . camera " android:required = " false " / >
Cdigo XML 11.12: Recurso desejvel

Existem outros tipos de permisso que podem ser teis em nossa aplicao com cmera:
Permisso de armazenamento - Se sua aplicao salva imagens ou videos em dispositivos externos de armazenamento.
1

98

< uses - permission android:name = " android . permission . WRITE_EXTERNAL_STORAGE " / >

www.k19.com.br

99

A PNDICE - M ULTIMEDIA

Cdigo XML 11.13: Permisso de armazenamento

Permisso de gravao de udio - Para gravar audio durante a captura de vdeo.


1

< uses - permission android:name = " android . permission . RECORD_AUDIO " / >
Cdigo XML 11.14: Permisso de gravao de udio

Permisso de localizao - Se sua aplicao utiliza informao de localizao para classificar imagens.
1

< uses - permission android:name = " android . permission . ACCESS_FINE_LOCATION " / >
Cdigo XML 11.15: Permisso de localizao

Utilizando a cmera via intent


Quando queremos apenas manipular fotos e videos sem ter que escrever muito cdigo podemos
requisitar a captura da imagem para uma outra aplicao via intent. Esta outra aplicao realiza a
captura da imagem ou vdeo e devolve o controle para a sua aplicao poder manipular o item recm
capturado.
O primeiro passo criar um intent que ir requisitar a imagem ou vdeo. Este intent pode ser de
dois tipos:

MediaStore.ACTION_IMAGE_CAPTURE - Intent utilizado para requisitar imagens de uma aplicao de cmera existente.
MediaStore.ACTION_VIDEO_CAPTURE - Intent utilizado para requisitar vdeos de uma aplicao
de camera existente.

Em seguida precisamos inicializar o intent. Neste passo vamos utilizar o mtodo startActivityForResult() para executar o intent e ento o transeferido para a aplicao de manipulao de cmera e
o usurio poder tirar a sua foto ou gravar o seu vdeo. Observe abaixo dois exemplos de implementao de aplicaes. Uma que captura imagens e outra que captura vdeos.

Capturando imagens
No cdigo abaixo podemos ver como podem ser feitos os dois primeiros passos descritos acima.
Note ainda que adicionamos um atributo extra ao intent definindo onde o arquivo de sada ser
gravado. Para isto utilizamos o mtodo Intent.putExtra().
1
2
3
4
5
6

private static final int CAPTURE_IMAGE_ACTIVITY_REQUEST_CODE = 100;


private Uri fileUri ;
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;

www.k19.com.br

99

A PNDICE - M ULTIMEDIA
7
8
9
10
11
12
13
14
15
16
17
18

100

setContentView ( R . layout . main ) ;


// criando o Intent
Intent intent = new Intent ( MediaStore . ACTION_IMAGE_CAPTURE ) ;
// configurando onde o arquivo de sada ser gravado
fileUri = getOutputMediaFileUri ( MEDIA_TYPE_IMAGE ) ;
intent . putExtra ( MediaStore . EXTRA_OUTPUT , fileUri ) ;
// iniciando o Intent
startActivityForResult ( intent , CAPTURE_IMAGE_ACTIVITY_REQUEST_CODE ) ;
}
Cdigo Java 11.13: Capturando imagens

Perceba que alm do intent, o mtodo startActivityForResult ainda recebe um inteiro que ser
utilizado, mais adiante, para identificar o intent.

Capturando videos
De uma maneira muito similar ao exemplo anterior podemos criar um intent para captura de
vdeo e execut-lo da maneira abaixo. Note que alm do atributo MediaStore.EXTRA_OUTPUT que
define o local onde o vdeo ser armazenado estamos tambm configurando a qualidade de gravao
de vdeo colocando o valor 1 na propriedade MediaStore.EXTRA_VIDEO_QUALITY (o valor 0 indica
baixa qualidade de captura).
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

private static final int CAPTURE_VIDEO_ACTIVITY_REQUEST_CODE = 200;


private Uri fileUri ;
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
// criando o intent
Intent intent = new Intent ( MediaStore . ACTION_VIDEO_CAPTURE ) ;
// configurando onde o arquivo de sada ser gravado
fileUri = getOutputMediaFileUri ( MEDIA_TYPE_VIDEO ) ;
intent . putExtra ( MediaStore . EXTRA_OUTPUT , fileUri ) ;
// configurando a qualidade do video
intent . putExtra ( MediaStore . EXTRA_VIDEO_QUALITY , 1) ;
// iniciando o Intent
startActivityForResult ( intent , CAPTURE_VIDEO_ACTIVITY_REQUEST_CODE ) ;
}
Cdigo Java 11.14: Capturando vdeos

Podemos tambm definir o tamanho mximo do vdeo, em segundos, configurando a propriedade MediaStore.EXTRA_DURATION_LIMIT, ou limitar o tamanho mximo do vdeo, em bytes, utilizando a propriedade MediaStore.EXTRA_SIZE_LIMIT.

Recuperando os dados gravados


Por ltimo precisamos recuperar os dados capturados no passo anterior. Para recebermos o resultado da ao do usurio no aplicativo de cmera devemos sobreescrever o mtodo onActivityRe100

www.k19.com.br

101

A PNDICE - M ULTIMEDIA

sult(int requestCode, int resultCode, Intent data) da atividade que iniciou o intent. Uma vez que o
usurio termine a ao no aplicativo de cmera este mtodo ser chamado (callback) e receberemos
a imagem ou o vdeo para que a nossa aplicao os manipule.
Vamos utilizar o parmetro requestCode para descobrir qual intent gerou aquela resposta (foto
ou video). Em seguida testamos a varivel resultCode para verificar se tudo correu bem com a captura ou o usurio cancelou a aplicao sem tirar uma foto ou gravar um vdeo. No caso de sucesso, a
imagem ou o vdeo estar disponvel como resultado da chamada data.getData().
Observe o trecho abaixo com um exemplo de implementao do callback.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

private static final int CAPTURE_IMAGE_ACTIVITY_REQUEST_CODE = 100;


private static final int CAPTURE_VIDEO_ACTIVITY_REQUEST_CODE = 200;
@Override
protected void onActivityResult ( int requestCode , int resultCode , Intent data ) {
// verificando o tipo da respost
if ( requestCode == CAPTURE_IMAGE_ACTIVITY_REQUEST_CODE ) {
if ( resultCode == RESULT_OK ) {
Toast . makeText ( this , " Imagem salva em :\ n " + data . getData () , Toast . LENGTH_LONG ) . show () ;
} else if ( resultCode == RESULT_CANCELED ) {
// Cancelamento da operacao
} else {
// Ocorreu algo inesperado
}
}
// verificando o tipo da respost
if ( requestCode == CAPTURE_VIDEO_ACTIVITY_REQUEST_CODE ) {
if ( resultCode == RESULT_OK ) {
Toast . makeText ( this , " Video salvo em :\ n " +
data . getData () , Toast . LENGTH_LONG ) . show () ;
} else if ( resultCode == RESULT_CANCELED ) {
} else {
}
}
}
Cdigo Java 11.15: Capturando vdeos

Utilizando a cmera via API


Quando queremos desenvolver uma verso customizada de aplicao de cmera proporcionando
uma experincia de uso mais interessante e complexa com funes especiais, ento ao invs de utilizar o recurso via Intent (utilizando outro aplicativo) podemos acessar a cmera diretamente via
API.
Para possibilitar a captura de imagens ou vdeo precisamos seguir alguns passos:

Deteco e acesso cmera


Caso a sua aplicao no necessite da cmera obrigatoriamente podemos definir um mtodo
para verificao da existncia do recurso no dispositivo. Uma instncia do PackageManager que est
www.k19.com.br

101

A PNDICE - M ULTIMEDIA

102

no contexto da aplicao permide que o mtodo PackageManager.hasSystemFeature() seja executado. Este mtodo retorna um valor booleano indicando a presena ou nao de uma feature.
1
2
3
4
5
6
7
8

private boolean checkCameraHardware ( Context context ) {


// consultando a presena da cmera no dispositivo
if ( context . getPackageManager () . hasSystemFeature ( PackageManager . FEATURE_CAMERA ) ) {
return true ;
} else {
return false ;
}
}
Cdigo Java 11.16: verificando o hardware

Uma maneira segura de obter o recurso da cmera a seguinte:


1
2
3
4
5
6
7
8
9
10
11

public static Camera getCameraInstance () {


Camera c = null ;
try {
c = Camera . open () ;
}
catch ( Exception e ) {
// o recurso pode estar indisponvel ou sendo utilizado
// preciso prever estas situaes
}
return c ;
}
Cdigo Java 11.17: Criando a instncia da Camera

Criao de uma classe para a visualizao da cmera


Vamos criar uma classe (View) que extende SurfaceView e implementa a interface SurfaceHolder
para ser utilizada na visualizao das imagens geradas pela cmera.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

102

/* * A basic Camera preview class */


public class CameraPreview extends SurfaceView implements SurfaceHolder . Callback {
private SurfaceHolder mHolder ;
private Camera mCamera ;
public CameraPreview ( Context context , Camera camera ) {
super ( context ) ;
mCamera = camera ;
// Adicionando um SurfaceHolder . Callback assim receberemos uma notificao
// assim qeu o Surface criado .
mHolder = getHolder () ;
mHolder . addCallback ( this ) ;
// configuracao obsoleta , necessaria apenas nas versoes anteriores ao Android 3.0
mHolder . setType ( SurfaceHolder . SURFACE_TYPE_PUSH_BUFFERS ) ;
}
public void surfaceCreated ( SurfaceHolder holder ) {
// Com o Surface criado preciso dizer onde desenhar a imagem prvia
try {
mCamera . setPreviewDisplay ( holder ) ;
mCamera . startPreview () ;
} catch ( IOException e ) {
Log . d ( TAG , " Erro ao associar o preview : " + e . getMessage () ) ;
}
}

www.k19.com.br

103
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

A PNDICE - M ULTIMEDIA
public void surfaceDestroyed ( SurfaceHolder holder ) {
}
public void surfaceChanged ( SurfaceHolder holder , int format , int w , int h ) {
// E preciso acompanhar as rotacoes da tela e demais mudancas no preview
if ( mHolder . getSurface () == null ) {
return ;
}
// parando o preview antes de modifica - lo
try {
mCamera . stopPreview () ;
} catch ( Exception e ) {
Log . d ( TAG , " Problemas para parar o preview : " + e . getMessage () ) ;
}
// ajustar o preview
// reiniciar o preview
try {
mCamera . setPreviewDisplay ( mHolder ) ;
mCamera . startPreview () ;
} catch ( Exception e ) {
Log . d ( TAG , " Problemas para iniciar o preview : " + e . getMessage () ) ;
}
}
}
Cdigo Java 11.18: Criando a View

Criao de um layout de visualizao


Posteriormente vamos tambm associar a classe de visualizao a um layout. neste passo que
vamos definir a tela que o usurio vai utilizar para capturar imagens/videos. A tela vai conter apenas
o frame que vai comportar o vdeo e um boto de incio de captura.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns : android = " http :// schemas . android . com / apk / res / android "
android : orientation = " horizontal "
android : layout_width = " fill_parent "
android : layout_height = " fill_parent "
>
< FrameLayout
android : id = " @ + id / camera_preview "
android : layout_width = " fill_parent "
android : layout_height = " fill_parent "
android : layout_weight = " 1 "
/>
< Button
android : id = " @ + id / button_capture "
android : text = " Capture "
android : layout_width = " wrap_content "
android : layout_height = " wrap_content "
android : layout_gravity = " center "
/>
</ LinearLayout >
Cdigo Java 11.19: Criando o Layout

www.k19.com.br

103

A PNDICE - M ULTIMEDIA

104

interessante fixar a orientao da tela. Por uma questo de simplicidade vamos fazer isso adicionando as configurao a seguir no manifesto.
1
2
3
4
5
6
7
8
9
10
11

< activity android : name = " . CameraActivity "


android : label = " @string / app_name "
android : screenOrientation = " landscape " >
<! - - fixando a orientacao em retrato -->
< intent - filter >
< action android : name = " android . intent . action . MAIN " / >
< category android : name = " android . intent . category . LAUNCHER " / >
</ intent - filter >
</ activity >
Cdigo Java 11.20: Ajustando a orientao da tela

Liberao de recurso
Depois de utilizar a cmera preciso liberar o recurso para que outras aplicaes possam utilizlo. Isto pode ser feito chamando o mtodo Camera.release(). Observe o cdigo abaixo:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

public class CameraActivity extends Activity {


private Camera mCamera ;
private SurfaceView mPreview ;
private MediaRecorder mMediaRecorder ;
...
@Override
protected void onPause () {
super . onPause () ;
releaseMediaRecorder () ;
releaseCamera () ;
}
private void releaseMediaRecorder () {
if ( mMediaRecorder != null ) {
mMediaRecorder . reset () ;
mMediaRecorder . release () ;
mMediaRecorder = null ;
mCamera . lock () ;
}
}
private void releaseCamera () {
if ( mCamera != null ) {
mCamera . release () ;
mCamera = null ;
}
}
}
Cdigo Java 11.21: Liberando o recurso

Capturando imagem
Com a View e o Layout definidos estamos prontos para codificar a aplicao que captura imagem. Para isto vamos implementar a interface Camera.PictureCallback e sobreescrever o mtodo
104

www.k19.com.br

105

A PNDICE - M ULTIMEDIA

onPictureTaken(). Quando a foto for tomada este o mtodo que ser chamado. No exemplo abaixo,
quando o mtodo chamado a imagem ser armazenada.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

private PictureCallback mPicture = new PictureCallback () {


@Override
public void onPictureTaken ( byte [] data , Camera camera ) {
File pictureFile = getOutputMediaFile ( MEDIA_TYPE_IMAGE ) ;
if ( pictureFile == null ) {
Log . d ( TAG , " Problemas na criacao da midia : " +
e . getMessage () ) ;
return ;
}
try {
FileOutputStream fos = new FileOutputStream ( pictureFile ) ;
fos . write ( data ) ;
fos . close () ;
} catch ( FileNotFoundException e ) {
Log . d ( TAG , " Arquivo nao encontrado : " + e . getMessage () ) ;
} catch ( IOException e ) {
Log . d ( TAG , " Problemas no acesso ao arquivo : " + e . getMessage () ) ;
}
}
};
Cdigo Java 11.22: Definindo o callback

Em seguida temos que associar o boto definido no layout ao mtodo Camera.takePicture().


este mtodo que de fato tira a foto, ele recebe como parmetro o callback definido anteriormente.
1
2
3
4
5
6
7
8
9
10
11

// Adicionando um listener ao botao de captura


Button captureButton = ( Button ) findViewById ( id . button_capture ) ;
captureButton . setOnClickListener (
new View . OnClickListener () {
@Override
public void onClick ( View v ) {
// obtendo imagem da camera
mCamera . takePicture ( null , null , mPicture ) ;
}
}
);
Cdigo Java 11.23: Adicionando o Listener

Capturando vdeo
Para realizar a captura de vdeo o processo um pouco mais delicado e exige que cada passo seja
feito em ordem. Nesta tarefa vamos utilizar,alm da classe Cmera, a classe Media Recorder para
armazenar o vdeo produzido.
Configurando o MediaRecorder Para armazenar o vdeo precisamos de um objeto MediaRecorder
configurado apropriadamente. Esta configurao deve ser feita em uma ordem especfica. Uma vez
definidas as propriedades vamos chamar o mtodo MediaRecorder.prepare() que far uma validao
da configurao e em seguida vai preparar o nosso recorder para gravao. Veja o exemplo abaixo:
1
2
3

private boolean prepareVideoRecorder () {


mCamera = getCameraInstance () ;

www.k19.com.br

105

A PNDICE - M ULTIMEDIA
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

106

mMediaRecorder = new MediaRecorder () ;


mCamera . unlock () ;
mMediaRecorder . setCamera ( mCamera ) ;
mMediaRecorder . setAudioSource ( MediaRecorder . AudioSource . CAMCORDER ) ;
mMediaRecorder . setVideoSource ( MediaRecorder . VideoSource . CAMERA ) ;
mMediaRecorder . setProfile ( CamcorderProfile . get ( CamcorderProfile . QUALITY_HIGH ) ) ;
mMediaRecorder . setOutputFile ( getOutputMediaFile ( MEDIA_TYPE_VIDEO ) . toString () ) ;
mMediaRecorder . setPreviewDisplay ( mPreview . getHolder () . getSurface () ) ;
try {
mMediaRecorder . prepare () ;
} catch ( IllegalStateException e ) {
Log . d ( TAG , " IllegalStateException : " + e . getMessage () ) ;
releaseMediaRecorder () ;
return false ;
} catch ( IOException e ) {
Log . d ( TAG , " IOException : " + e . getMessage () ) ;
releaseMediaRecorder () ;
return false ;
}
return true ;
}
Cdigo Java 11.24: Preparando o gravador de vdeo

Em seguida vamos associar um callback ao boto definido no layout. Novamente toda vez que
a gravao comear ou terminar devemos executar os comandos em uma ordem especfica como
vemos a seguir:
START
1 - Desbloqueie a cmera Camera.unlock()
2 - Configure a uma instancia de MediaRecorder
3 - inicie a gravao MediaRecorder.start()
4 - Grave o vdeo
STOP
5 - Para a gravao usando MediaRecorder.stop()
6 - Libere o recurso do gravador MediaRecorder.release()
7 - Bloqueie a cmera usando Camera.lock()
Abaixo temos um exemplo de cdigo que ilustra exatamente a ordem especificada.
1
2
3
4
5
6

106

private boolean isRecording = false ;


// Adicionando um listener ao botao de captura
Button captureButton = ( Button ) findViewById ( id . button_capture ) ;
captureButton . setOnClickListener (
new View . OnClickListener () {

www.k19.com.br

107
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

A PNDICE - M ULTIMEDIA
@Override
public void onClick ( View v ) {
if ( isRecording ) {
mMediaRecorder . stop () ;
releaseMediaRecorder () ;
mCamera . lock () ;
setCaptureButtonText ( " Capture " ) ;
isRecording = false ;
} else {
if ( prepareVideoRecorder () ) {
mMediaRecorder . start () ;
setCaptureButtonText ( " Stop " ) ;
isRecording = true ;
} else {
releaseMediaRecorder () ;
}
}
}
}
);
Cdigo Java 11.25: Adicionando o listener ao boto de captura

Exerccios de Fixao
Crie um novo projeto Android. Use como nome para o projeto Camera. O nome do pacote deve
ser br.com.k19.android.cap11, e o nome da activity deve ser MainActivity.
14

15

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

Modifique o arquivo AndroidManifest.xml seguindo o cdigo a seguir:


< manifest xmlns:android = " http: // schemas . android . com / apk / res / android "
package = " br . com . k19 . android . cap11 "
android:versionCode = " 1 "
android:versionName = " 1.0 " >
< uses - sdk
android:minSdkVersion = " 8 "
android:targetSdkVersion = " 15 " / >
< uses - permission android:name = " android . permission . CAMERA " / >
< uses - permission android:name = " android . permission . WRITE_EXTERNAL_STORAGE " / >
< application
android:icon = " @drawable / ic_launcher "
android:label = " @string / app_name "
android:theme = " @style / AppTheme " >
< activity
android:name = " . MainActivity "
android:label = " @string / title_activity_main "
android:screenOrientation = " landscape " >
< intent - filter >
< action android:name = " android . intent . action . MAIN " / >
< category android:name = " android . intent . category . LAUNCHER " / >
</ intent - filter >
</ activity >
</ application >
</ manifest >
Cdigo XML 11.16: AndroidManifest.xml

www.k19.com.br

107

A PNDICE - M ULTIMEDIA
16

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

108

Modifique o arquivo activity_main.xml seguindo o cdigo a seguir:


<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:orientation = " horizontal "
android:layout_width = " fill_parent "
android:layout_height = " fill_parent "
>
< Button
android:id = " @ + id / button_photo "
android:text = " @string / photo_button_label "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_gravity = " center "
/>
< Button
android:id = " @ + id / button_video "
android:text = " @string / video_button_label "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_gravity = " center "
/>
</ LinearLayout >
Cdigo XML 11.17: activity_main.xml

17

1
2
3
4
5
6
7
8
9
10

Modifique o arquivo strings.xml seguindo o cdigo a seguir:


< resources >
< string
< string
< string
< string
< string
< string

name = " app_name " > Camera </ string >


name = " hello_world " > Hello world ! </ string >
name = " menu_settings " > Settings </ string >
name = " title_activity_main " > MainActivity </ string >
name = " video_button_label " > Capturar Video </ string >
name = " photo_button_label " > Capturar Photo </ string >

</ resources >


Cdigo XML 11.18: strings.xml

18

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

108

Modifique o arquivo MainActivity.java seguindo o cdigo a seguir:


package br . com . k19 . android . cap11 ;
import java . io . File ;
import java . text . SimpleDateFormat ;
import java . util . Date ;
import br . com . k19 . android . cap11 . R . id ;
import
import
import
import
import
import
import
import
import
import
import

android . net . Uri ;


android . os . Bundle ;
android . os . Environment ;
android . provider . MediaStore ;
android . app . Activity ;
android . content . Intent ;
android . util . Log ;
android . view . Menu ;
android . view . View ;
android . widget . Button ;
android . widget . Toast ;

public class MainActivity extends Activity {


public static final int MEDIA_TYPE_IMAGE = 1;
public static final int MEDIA_TYPE_VIDEO = 2;

www.k19.com.br

109
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
87
88
89
90
91
92
93

A PNDICE - M ULTIMEDIA
private static final int CAPTURE_IMAGE_ACTIVITY_REQUEST_CODE = 100;
private static final int CAPTURE_VIDEO_ACTIVITY_REQUEST_CODE = 200;
private Uri fileUri ;
private static Uri getUri ( int type ) {
File mediaStorageDir = new File ( Environment . getExternalStoragePublicDirectory (
Environment . DIRECTORY_PICTURES ) , " CameraOutput " ) ;
if (! mediaStorageDir . exists () ) {
if (! mediaStorageDir . mkdirs () ) {
Log . d ( " CameraOutput " , " nao foi possivel criar o diretorio " ) ;
return null ;
}
}
String timeStamp = new SimpleDateFormat ( " yyyyMMdd_HHmmss " ) . format ( new Date () ) ;
File mediaFile ;
if ( type == MEDIA_TYPE_IMAGE ) {
mediaFile = new File ( mediaStorageDir . getPath () + File . separator +
" IMG_ " + timeStamp + " . jpg " ) ;
} else if ( type == MEDIA_TYPE_VIDEO ) {
mediaFile = new File ( mediaStorageDir . getPath () + File . separator +
" VID_ " + timeStamp + " . mp4 " ) ;
} else {
return null ;
}
return Uri . fromFile ( mediaFile ) ;
}

@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . activity_main ) ;
Button captureButton = ( Button ) findViewById ( id . button_photo ) ;
captureButton . setOnClickListener (
new View . OnClickListener () {
public void onClick ( View v ) {
// Cria o Intent
Intent intent = new Intent ( MediaStore . ACTION_IMAGE_CAPTURE ) ;
fileUri = getUri ( MEDIA_TYPE_IMAGE ) ;
intent . putExtra ( MediaStore . EXTRA_OUTPUT , fileUri ) ;
// Inicia o Intent
startActivityForResult ( intent , CAPTURE_IMAGE_ACTIVITY_REQUEST_CODE ) ;
}
}
);
captureButton = ( Button ) findViewById ( id . button_video ) ;
captureButton . setOnClickListener (
new View . OnClickListener () {
public void onClick ( View v ) {
// Cria o Intent
Intent intent = new Intent ( MediaStore . ACTION_VIDEO_CAPTURE ) ;
fileUri = getUri ( MEDIA_TYPE_VIDEO ) ;
intent . putExtra ( MediaStore . EXTRA_OUTPUT , fileUri ) ;
intent . putExtra ( MediaStore . EXTRA_VIDEO_QUALITY , 1) ;
// Inicia o Intent
startActivityForResult ( intent , CAPTURE_VIDEO_ACTIVITY_REQUEST_CODE ) ;
}
}
);
}

www.k19.com.br

109

A PNDICE - M ULTIMEDIA
94
95
96
97
98
99
100
101
102
103
104
105

@Override
public boolean onCreateOptionsMenu ( Menu menu ) {
getMenuInflater () . inflate ( R . menu . activity_main , menu ) ;
return true ;
}
@Override
protected void onActivityResult ( int requestCode , int resultCode , Intent data ) {
if ( requestCode == CAPTURE_IMAGE_ACTIVITY_REQUEST_CODE ) {
if ( resultCode == RESULT_OK ) {
Toast . makeText ( this , " Imagem salva em :\ n " + fileUri . getPath () , Toast . LENGTH_LONG ) . show () ;
} else if ( resultCode == RESULT_CANCELED ) {
// Cancelou a captura
} else {
// Ocorreu algum problema nao esperado
}
}

106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

110

if ( requestCode == CAPTURE_VIDEO_ACTIVITY_REQUEST_CODE ) {
if ( resultCode == RESULT_OK ) {
Toast . makeText ( this , " Imagem salva em :\ n " + fileUri . getPath () , Toast . LENGTH_LONG ) . show () ;
} else if ( resultCode == RESULT_CANCELED ) {
// Cancelou a captura
} else {
// Ocorreu algum problema nao esperado
}
}
}
}
Cdigo Java 11.26: MainActivity.java

19

110

Rode o programa e e teste a capture de imagem e vdeo.

www.k19.com.br

CAPTULO

A PNDICE - A PP W IDGETS

12

Introduo
AppWidgets so pequenas visualizaes de aplicaes que podem ser inseridas em outras aplicaes. Estas pores de aplicaes so pulicadas utilizando um provedor de App Widget. Vamos
entrar no detalhe deste processo mais adiante.

Principais classes
Para criar um AppWidget vamos precisar de um objeto do tipo AppWidgetProviderInfo. Este objeto descreve os metadados do nosso AppWidget tais como: layout, update frequency, provedor, etc.
Outro objeto importante uma implementao de AppWidgetProvider que vai definir os mtodos bsicos que faro interface, por meio de eventos, com o nosso Widget. por ele que vamos
receber mensagens informando quando o Widget foi atualizado, habilitado, deletado, etc.
Por ltimo vamos precisar tambm de um layout, que como vai parecer o nosso Widget.

Manifest
No Manifest vamos definir um elemento chamado receiver. nele que vamos definir o provedor
utilizando o atributo android:name.
1
2

< receiver android : name = " ExampleAppWidgetProvider " >


</ receiver >
Cdigo Java 12.1: Definindo o receiver

Dentro do receiver vamos especificar duas informaes: - Quais eventos o nosso Widget ir atender usando o elemento intent-filter; - Qual o nome e onde est o nosso AppWidgetProviderInfo
Observe abaixo como ficou nosso Manifest.
1
2
3
4
5
6
7

< receiver android : name = " ExampleAppWidgetProvider " >


< intent - filter >
< action android : name = " android . appwidget . action . APPWIDGET_UPDATE " / >
</ intent - filter >
< meta - data android : name = " android . appwidget . provider "
android : resource = " @xml / example_appwidget_info " / >
</ receiver >
Cdigo Java 12.2: exemplo de Manifest

www.k19.com.br

111

A PNDICE - A PP W IDGETS

112

Note que o elemento intent-filter contm apenas a action android.appwidget.action.APPWIDGET_UPDATE,


o que significa que o Widget s ir atender a eventos do tipo update. O Widget pode ser sensvel a
quatro tipos de eventos:

android.appwidget.action.ACTION_APPWIDGET_UPDATE
android.appwidget.action.ACTION_APPWIDGET_DELETED
android.appwidget.action.ACTION_APPWIDGET_ENABLED
android.appwidget.action.ACTION_APPWIDGET_DISABLED

Configurando o AppWidgetProviderInfo
Como vimos anteriormente, este objeto responsvel por definir as caractersticas do Widget.
Para configur-lo vamos criar um recurso do tipo xml e salv-lo em res/xml/. Este xml possui apenas
elemento <appwidget-provider>.
dentro deste elemento que vamos adicionar as caractersticas que desejamos por meio de alguns atributos. Abaixo podemos observar algumas das propriedades mais importantes:

android:minWidth - Largura mnima que o Widget vai ocupar por padro;


android:minHeight - Altura mnima que o Widget vai ocupar por padro;
android:minResizeWidth - Largura mnima que o aplicativo deve ter sem comprometer a usabilidade;
android:minResizeHeight - Altura mnima que o aplicativo deve ter sem comprometer a usabilidade;
android:updatePeriodMillis - Frequncia com que o Widget ir consultar o AppWidgetProvider para
atualizaes;
android:initialLayout - Atributo que faz referncia ao recurso que define o layout do Widget;
android:configure - Atributo que define qual aplicao de configurao do Widget ser aberta em
sua primeira execuo (opcional);
android:previewImage - Imagem do Widget sugerindo sua aparncia depois de configurado. Se
este atributo no for utilizado a imagem padro ser o cone do Widget.
android:resizeMode - Define como o Widget pode ser redimensionado. O atributo pode assumir os
seguintes valores: "horizontal", "vertical", "horizontal|vertical"ou "none".

Definindo o Layout
112

www.k19.com.br

113

A PNDICE - A PP W IDGETS

Uma AppWidget mais limitada quanto a quais views podem ser usadas. Os layouts disponveis so FrameLayout, LinearLayout e RelativeLayout. As views disponveis so AnalogClock, Button,
Chronometer, ImageButton, ImageView, ProgressBar e TextView. A partir do Android 3.0 foram adicionadas as views GridView, ListView, StackView, ViewFlipper e AdapterViewFlipper.
A nica interao possvel com um Widget atravs de um OnClickListener.

Exerccios de Fixao
Crie um novo projeto Android. Use como nome para o projeto AppWidget. O nome do pacote
deve ser br.com.k19.android.cap12. Voc pode criar o projeto sem nenhuma activity por padro.
1

Na pasta res/drawable (seno existir, pode criar) crie um arquivo chamado shape.xml. Ele deve
conter o seguinte contedo:
2

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

<? xml version = " 1.0 " encoding = " UTF -8 " ? >
< shape xmlns:android = " http: // schemas . android . com / apk / res / android "
android:shape = " rectangle " >
< stroke
android:width = " 2 dp "
android:color = " # FFFFFFFF " / >
< gradient
android:angle = " 225 "
android:endColor = " # DD2ECCFA "
android:startColor = " # DD000000 " / >
< corners
android:bottomLeftRadius = " 7 dp "
android:bottomRightRadius = " 7 dp "
android:topLeftRadius = " 7 dp "
android:topRightRadius = " 7 dp " / >
</ shape >
Cdigo XML 12.1: shape.xml

Na pasta res/layouts crie um arquivo chamado widget_layout.xml. Ele deve conter o seguinte
contedo:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:id = " @ + id / layout "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:layout_margin = " 8 dp "
android:background = " @drawable / shape " >
< TextView
android:id = " @ + id / update "
style = " @android:style / TextAppearance . Large "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:layout_gravity = " center "
android:gravity = " center_horizontal | center_vertical "
android:layout_margin = " 4 dp " >
</ TextView >
</ LinearLayout >

www.k19.com.br

113

A PNDICE - A PP W IDGETS

114

Cdigo XML 12.2: widget_layout.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2
3
4
5
6

< resources >


< string name = " app_name " > AppWidget </ string >
< string name = " number_label " > Sorteado: % d </ string >
</ resources >
Cdigo XML 12.3: strings.xml

Dentro da pasta res/xml (seno existir, pode criar) crie um arquivo chamado widget_info.xml,
com o seguinte contedo:
1
2
3
4
5
6
7
8

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< appwidget - provider xmlns:android = " http: // schemas . android . com / apk / res / android "
android:initialLayout = " @layout / widget_layout "
android:minHeight = " 72 dp "
android:minWidth = " 300 dp "
android:updatePeriodMillis = " 300000 " >
</ appwidget - provider >
Cdigo XML 12.4: widget_info.xml

Crie um arquivo WidgetProvider.java com o seguinte contedo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

114

package br . com . k19 . android . cap12 ;


import java . util . Random ;
import
import
import
import
import
import
import

android . app . PendingIntent ;


android . appwidget . AppWidgetManager ;
android . appwidget . AppWidgetProvider ;
android . content . ComponentName ;
android . content . Context ;
android . content . Intent ;
android . widget . RemoteViews ;

public class WidgetProvider extends AppWidgetProvider {


private static final String ACTION_CLICK = " ACTION_CLICK " ;
@Override
public void onUpdate ( Context context , AppWidgetManager appWidgetManager ,
int [] appWidgetIds ) {
ComponentName thisWidget = new ComponentName ( context ,
WidgetProvider . class ) ;
int [] allWidgetIds = appWidgetManager . getAppWidgetIds ( thisWidget ) ;
for ( int widgetId : allWidgetIds ) {
int number = ( new Random () . nextInt (100) ) ;
RemoteViews remoteViews = new RemoteViews ( context . getPackageName () ,
R . layout . widget_layout ) ;
remoteViews . setTextViewText ( R . id . update , // String . valueOf ( number ) ) ;
context . getString ( R . string . number_label , number ) ) ;

www.k19.com.br

115
35
36
37
38
39
40
41
42
43
44
45
46

A PNDICE - A PP W IDGETS
Intent intent = new Intent ( context , WidgetProvider . class ) ;
intent . setAction ( AppWidgetManager . ACTION_APPWIDGET_UPDATE ) ;
intent . putExtra ( AppWidgetManager . EXTRA_APPWIDGET_IDS , appWidgetIds ) ;
PendingIntent pendingIntent = PendingIntent . getBroadcast ( context ,
0 , intent , PendingIntent . FLAG_UPDATE_CURRENT ) ;
remoteViews . setOnClickPendingIntent ( R . id . update , pendingIntent ) ;
appWidgetManager . updateAppWidget ( widgetId , remoteViews ) ;
}
}
}
Cdigo Java 12.3: MainActivity.java

Edite o AndroidManifest.xml e deixe-o igual ao exemplo abaixo:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

< manifest xmlns:android = " http: // schemas . android . com / apk / res / android "
package = " br . com . k19 . android . cap12 "
android:versionCode = " 1 "
android:versionName = " 1.0 " >
< uses - sdk
android:minSdkVersion = " 15 "
android:targetSdkVersion = " 15 " / >
< application
android:icon = " @drawable / ic_launcher "
android:label = " @string / app_name "
android:theme = " @style / AppTheme " >
< receiver android:name = " . WidgetProvider " >
< intent - filter >
< action android:name = " android . appwidget . action . APPWIDGET_UPDATE " / >
</ intent - filter >
< meta - data
android:name = " android . appwidget . provider "
android:resource = " @xml / widget_info " / >
</ receiver >
</ application >
</ manifest >
Cdigo XML 12.5: AndroidManifest.xml

Aps isso, rode a aplicao. Voc ir precisar instalar o widget na Home Screen para poder ver o
resultado.

www.k19.com.br

115

A PNDICE - A PP W IDGETS

116

116

www.k19.com.br

CAPTULO

A PNDICE - P UBLICANDO NO Google


Play

13

Aps fazer um aplicativo, voc pode disponibiliz-lo na loja de aplicativos oficial do Android, a
Google Play. A partir de l outros usurios podem baixar o seu aplicativo. Para isso, antes necessrio
que o desenvolvedor se cadastre para poder publicar aplicativos. Ao se inscrever, necessrio pagar
uma taxa de US $15,00 e ter (ou criar) uma google account.

Mais Sobre
Caso voc queira fazer a inscrio, acesse o endereo abaixo e siga os passos.

https://play.google.com/apps/publish

Como gerar um aplicativo


Para subir um aplicativo no Play necessrio antes gerar um pacote do nosso aplicativo. O pacote um arquivo com a extenso .apk. possvel gerar um pacote assinado ou no assinado. Um
pacote no assinado um pacote cuja autoria do desenvolvedor no pode ser identificada. Um pacote assinado um pacote que inclui uma assinatura no pacote, de acordo com um certificado que
apenas o desenvolvedor possui. Esse certificado no deve ser compartilhado com mais ningum que
no seja o desenvolvedor, seno outras pessoas podem assinar aplicativos como se fosse o prprio
desenvolvedor e utilizar isto para fins maliciosos.
Por padro, o Eclipse usa um certificado para debug (a debug.keystore) que utilizado durante
o processo de desenvolvimento para diminuir o trabalho de ter que gerar sempre um APK assinado.
Quando for criar um APK para distribuir o seu aplicativo, recomendado que seja utilizado um certificado diferente do que utilizado durante o desenvolvimento.

Exerccios de Fixao
Vamos criar um pacote assinado. Selecione qualquer um dos projetos Android que estejam
finalizados no Eclipse. Clique com o boto direito sobre o projeto, e selecione a opo Android Tools
-> Export Signed Application Package. Ao selecionar, ir aparecer a tela abaixo:
1

www.k19.com.br

117

A PNDICE - P UBLICANDO NO Google Play

118

Figura 13.1: Wizard para criar pacotes assinados.

No momento que voc gera um apk assinado, o Eclipse ir rodar o Android Lint, que ir verificar
por erros na sua aplicao. Vrios warnings durante o desenvolvimento so considerados erros neste
passo. Imagens faltando na pasta drawable, strings de traduo faltando em alguma das verses do
strings.xml so exemplos de erros comuns. Caso seja acusado algum erro, voc deve arrum-los
antes de gerar o apk.
Depois que voc corrigir todos os problemas, ou caso no tenha nenhum problema, voc pode
avanar para a tela seguinte, igual ao exemplo abaixo.
118

www.k19.com.br

A PNDICE - P UBLICANDO NO Google Play

119

Figura 13.2: Wizard para criar pacotes assinados.

Voc deve criar uma nova keystore e selecionar uma senha. Escolha um nome e local para salvar
a keystore e digite uma senha segura, que no seja fcil de adivinhar. Depois disso, continue e clique
em Next.
www.k19.com.br

119

A PNDICE - P UBLICANDO NO Google Play

120

Figura 13.3: Wizard para criar pacotes assinados.

Nesta tela voc deve escolher um nome para a chave (uma keystore pode armazenar mais de
uma chave), e uma senha de acesso s para esta chave. Novamente, escolha um nome que voc ir
se lembrar depois, e digite uma senha segura. Voc deve escolher tambm por quantos anos esta
chave ser vlida antes de expirar. O recomendado 25 anos. Por ltimo, voc deve preencher as
informaes do desenvolvedor (pelo menos o nome obrigatrio). Depois de preenchidos, pode
continuar.
120

www.k19.com.br

A PNDICE - P UBLICANDO NO Google Play

121

Figura 13.4: Wizard para criar pacotes assinados.

Por ltimo deve ser escolhido o local onde o apk ser salvo. Escolhar uma pasta de sua preferncia e clique para concluir.

Mais Sobre
Agora que foi criado uma keystore e uma chave, voc pode utiliz-las nas prximas
vezes que for gerar um novo apk assinado. Neste caso, basta apenas deixar marcado a
opo Use existing keystore quando for gerar um novo pacote.

www.k19.com.br

121

A PNDICE - P UBLICANDO NO Google Play

122

122

www.k19.com.br

CAPTULO

A PNDICE - S ENSORES

14

O Bsico
O framework de sensores do Android fornece acesso a uma srie de leitores disponibilizando ferramentas de medies para sensores baseados em hardware e software. preciso lembrar que nem
todo o dispositivo possue todos os tipos de sensores e dependendo do que for utilizado pode restringir muito o nmero de dispositivos candidatos a instalar o aplicativo. Outro detalhe impotante que
alguns dispositivos podem ter at mais do que apanas um sensor do mesmo tipo.
Tipos de sensores:
ACCELEROMETER - Sensor de Acelerao (inclui gravidade).
AMBIENT_TEMPERATURE - Sensor de temperatura.
GRAVITY - Sensor de gravidade.
GYROSCOPE - Sensor de Acelerao (no inclui a gravidade).
LIGHT - Sensor de LUZ.
LINEAR_ACCELERATION - Sensor de acelerao linear.
MAGNETIC_FIELD - Sensor de campo magntico.
ORIENTATION - Sensor de orientao.
PRESSURE - Sensor de presso.
PROXIMITY - Sensor de proximidade
RELATIVE_HUMIDITY - Sensor de umidade relativa.
ROTATION_VECTOR - Sensor de rotao.

Classes importantes
Sensor - Classe que representa um sensor;
SensorManager - Classe que d acesso aos sensores do dispositivo, associa listeners a eventos alm
de facilitar contas fornecendo uma srie de constantes, por exemplo: a gravidade da Terra, de
Marte, a luminncia em uma noite de lua cheia, o campo magntico da Terra, presso atmosfrica no nvel do mar entre outros.
SensorEvent - Classe que representa a leitura de um sensor, fornecendo, por exempo, a preciso, o
timestamp do registro, o tipo do sensor alm da prpria medio registrada.
www.k19.com.br

123

A PNDICE - S ENSORES

124

SensorEventListener - Classe que notificada das mudanas nos valores de leitura e preciso dos
sensores

Obtendo a instcia de um sensor


Em primeiro lugar preciso obter o SensorManager. Isto pode ser feito chamando o mtodo
getSystemService() passandO o parmetro Context.SENSOR_SERVICE. Em seguida podemos, atravs do SensorManager, obter uma instancia de Sensor executando SensorManager.getDefaultSensor()
passando o tipo do sensor desejado, por exempo, Sensor.TYPE_ACCELEROMETER.
Veja o trecho de cdigo que obtm a instncia de um Sensor
1
2
3
4

private SensorManager mSensorManager ;


private Sensor mSensor ;
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_ACCELEROMETER ) ;
Cdigo Java 14.1: Obtenda instncia de um Sensor

Recebendo os eventos do Sensor


Usando o SensorManager, vamos associar uma instncia que implemente SensorEventListener
ao sensor que se queira receber leituras incluindo tambm no parmetro a frequncia de recebimento das informaes. Esta associao feito executando o mtodo SensorManager.registerListener().
O listener deve implementar dois mtodos:
SensorEventListener.onSensorChanged() - chamado quando houve uma mudana nos valores do
sensor.
SensorEventListener.onAccuracyChanged() - chamado quando houve uma alterao na preciso
do sensor.
No exemplo abaixo o listener a prpria atividade.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

124

public class SensorTest extends Activity implements SensorEventListener {


private SensorManager mSensorManager ;
private Sensor mSensor ;
protected void onCreate () {
super . onCreate () ;
...
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_ACCELEROMETER ) ;
mSensorManager . registerListener ( this , mSensor , SensorManager . SENSOR_DELAY_NORMAL ) ;
}
public void onSensorChanged ( SensorEvent event ) {
// utilizao dos dados lidos do sensor
}
public void onAccuracyChanged ( SensorEvent event , int accuracy ) {

www.k19.com.br

125
20
21
22

A PNDICE - S ENSORES
// resposta modificao de preciso
}
}

Cdigo Java 14.2: Associando eventos a listeners

O Parmetro que definie a periodicidade de recebimento de eventos do sensor, em milisegundos,


um inteiro que serve apenas como referncia para o sistema. Os eventos podem acontecer antes
ou depois do especificado. Para facilitar o framework possui intervalos pr-definidos em constantes:
SENSOR_DELAY_NORMAL, SENSOR_DELAY_UI, SENSOR_DELAY_GAME, ou SENSOR_DELAY_FASTEST.

Sensores de Movimento
A API do Android fornece suporte a vrios tipos de sensores de movimento do dispositivo. Os
tipos so classificados em dois grupos: sensores baseados em hardware e sensores baseados em
software. O acelermetro e o giroscpio so sempre baseados em hardware enquanto os sensores
de gravidade, acelerao linear e de vetores de rotao podem sem tanto por hardware quanto por
software.
Os sensores por software baseiam seus clculos utilizando os sensores de hardware disponveis,
portanto, sua disponibilidade fortemente dependente dos recusros de hardware presentes do dispositivo.

Formato dos valores

Todos os sensores de movimento fornecem valores multidimensionais, ou seja, fazendo a leitura


do acelermetro receberemos um array de float com trs valores, um para cada eixo (x, y e z). No caso
do sensor de rotao um quarto componente com um valor escalar compes a resposta da leitura.
www.k19.com.br

125

A PNDICE - S ENSORES

126

x
z

Figura 14.1: Resultado da tela.

Mais Sobre
Para saber mais sobre os tipos de sensores de movimento suportados e quais os valores
retornados. Acesse: http://developer.android.com/guide/topics/sensors/

sensors_motion.html

Acelermetro
O Acelermetro, como pode-se deduzir do prprio nome, mede a acelerao aplicada no dispositivo, incluindo a fora da gravidade. Quando o celular est em repouso em uma mesa, por exemplo,
126

www.k19.com.br

127

A PNDICE - S ENSORES

a acelerao medida a da gravidade e quando o dipositivo esta em queda livre e acelerao medida
zero. A unidade de medida m/s 2 . Exemplo de utilizao:
1
2
3
4
5

private SensorManager mSensorManager ;


private Sensor mSensor ;
...
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_ACCELEROMETER ) ;
Cdigo Java 14.3: Exemplo de uso do Acelermetro

Sensor de Gravidade
O sensor de gravidade fornece um vetor tridimensional contendo a direo e a amplitude da
gravidade. Os valores so medidos em m/s 2 . Quando o dispositivo est em repouso, o sensor de
gravidade faz a mesma leitura que o acelermetro. Exemplo de utilizao:
1
2
3
4
5

private SensorManager mSensorManager ;


private Sensor mSensor ;
...
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_GRAVITY ) ;
Cdigo Java 14.4: Exemplo de uso do Sensor de Gravidade

Giroscpio
O Giroscpio mede a rotao em r ad /s em torno dos eixos x, y e z do dispositivo. Exemplo de
utilizao:
1
2
3
4
5

private SensorManager mSensorManager ;


private Sensor mSensor ;
...
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_GYROSCOPE ) ;
Cdigo Java 14.5: Exemplo de uso do Giroscpio

Acelermetro Linear
Este sensor fornece uma medida, em m/s 2 , da acelerao em torno de cada eixo (x, y, e z) excluindose a acelerao da gravidade. Exemplo de utilizao:
1
2
3
4
5

private SensorManager mSensorManager ;


private Sensor mSensor ;
...
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_LINEAR_ACCELERATION ) ;
Cdigo Java 14.6: Exemplo de uso do Acelermetro Linear

www.k19.com.br

127

A PNDICE - S ENSORES

128

Sensor de Vetor de Rotao


Um evento deste sensor representa a orientao do dispositivo como combinao de um ngulo
e eu eixo. Os elementos de um vetor de rotao no possuem unidade. So quatro informaes
resultantes de uma leitura: um vetor tridimensional (x, y e z) e um valor representando a magnitude.
Exemplo de utilizao:
1
2
3
4
5

private SensorManager mSensorManager ;


private Sensor mSensor ;
...
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_ROTATION_VECTOR ) ;
Cdigo Java 14.7: Exemplo de uso do Sensor de Rotao

Sensores de Posio
A API do Android prov tambm dois tipos de sensores de posicionamento: o sensor de campo
geomagntico e o de orientao. Alm destes, existe um sensor que determina distncia chamado
sensore de proximidade. O sensor de orientao baseado em software e est em desuso desde o
Android 2.2.
Assim como os sensores de movimento, os sensores geomagntico e de orienteo devolvem um
vetor tridimensional, ou seja, so floats representando as trs dimanses: x, y e z. J o sensor de
proximidade o retorno apenas um valor representando a distncia.

Mais Sobre
Para saber mais sobre os tipos de sensores de posicionamento suportados e quais
os valores retornados. Acesse: http://developer.android.com/guide/topics/

sensors/sensors_position.htm

Sensor de Orientao
Este sensor fornece a posio do dispositivo reletivo ao norte magntico da Terra. O tipo do
retorno em graus. Exemplo de utilizao:
1
2
3
4
5

private SensorManager mSensorManager ;


private Sensor mSensor ;
...
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_ORIENTATION ) ;
Cdigo Java 14.8: Exemplo de uso do Sensor de Orientao

Sensor de Campo Geomagntico


Permite acompanhar as mudanas no campo magntico da Terra. Em geral a informao deste
sensor deve ser utilizada em conjunto com os sensores de rotao ou o acelermetro. O tipo de dado
128

www.k19.com.br

129

A PNDICE - S ENSORES

retornado pelo sensor T . Exemplo de utilizao:


1
2
3
4
5

private SensorManager mSensorManager ;


private Sensor mSensor ;
...
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_MAGNETIC_FIELD ) ;
Cdigo Java 14.9: Exemplo de uso do Sensor de Campo Geomagntico

Sensor de Proximidade
O sensor de proximidade determina o quo distante est um objeto do dispositivo. A informao
da distncia retornada em um float em centmetros. Exemplo de utilizao:
1
2
3
4
5

private SensorManager mSensorManager ;


private Sensor mSensor ;
...
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_PROXIMITY ) ;
Cdigo Java 14.10: Exemplo de uso do Sensor de Proximidade

Alguns sensores de proximidade podem devolver valores binrios indicando apenas se o objeto
est longe ou perto.

Sensores de Ambiente
A API do Android ainda fornece suporte a sensores de monitorao de ambiente tais como: temperatura, presso, luminncia, umidade. Este tipo de sensor o de maior facilidade de manipulao
pois no requer ajustes de calibrao, modificaes e seus dados podem ser utilizados diretamente.
Observe abaixo a lista dos sensores e os tipos de dados que eles fornecem.

Mais Sobre
Para saber mais sobre os tipos de sensores de ambiente suportados e quais os valores
retornados. Acesse: http://developer.android.com/guide/topics/sensors/

sensors_environment.html

Sensor de Luz
Obtm do ambiente a luminncia atual. A informao medida em lux (l x). Exemplo de utilizao:
1
2
3
4
5

private SensorManager mSensorManager ;


private Sensor mSensor ;
...
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_LIGHT ) ;
Cdigo Java 14.11: Exemplo de uso do Sensor de Luz

www.k19.com.br

129

A PNDICE - S ENSORES

130

Sensor de Presso
Obtm do ambiente a presso atmosfrica. A informao medida em hectopascal (hPa). Exemplo de utilizao:
1
2
3
4
5

private SensorManager mSensorManager ;


private Sensor mSensor ;
...
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_PRESSURE ) ;
Cdigo Java 14.12: Exemplo de uso do Sensor de Presso

Sensor de Temperatura
Obtm a temperatura ambiente em graus Celcius (C). Exemplo de utilizao:
1
2
3
4
5

private SensorManager mSensorManager ;


private Sensor mSensor ;
...
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_AMBIENT_TEMPERATURE ) ;
Cdigo Java 14.13: Exemplo de uso do Sensor de Temperatura

Existe um tipo de sensor de temperatura (TYPE_TEMPERATURE) que mede a temperatura do


dispositivo mas entrou em desuso com o Android 4.0.

Sensor de Umidade Relativa


Obtm a umidade relativa do ambiente em porcentagem (temperatura ambiente possvel, por
exemplo, calcular a umidade absoluta. Exemplo de utilizao:
1
2
3
4
5

private SensorManager mSensorManager ;


private Sensor mSensor ;
...
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_RELATIVE_HUMIDITY ) ;
Cdigo Java 14.14: Exemplo de uso do Sensor de Umidade Relativa

Exerccios de Fixao
Crie um novo projeto Android. Use como nome para o projeto Sensores. O nome do pacote
deve ser br.com.k19.android.animation, e o nome da activity deve ser MainActivity.
1

Modifique o arquivo activity_main.xml seguindo o cdigo a seguir:

1
2
3

< RelativeLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
xmlns:tools = " http: // schemas . android . com / tools "
android:layout_width = " match_parent "

130

www.k19.com.br

131
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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

A PNDICE - S ENSORES
android:layout_height = " match_parent " >
< TextView
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_marginLeft = " 100 dp "
android:layout_marginTop = " 80 dp "
android:text = " X: "
tools:context = " . MainActivity " / >
< TextView
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_marginLeft = " 100 dp "
android:layout_marginTop = " 110 dp "
android:text = " Y: "
tools:context = " . MainActivity " / >
< TextView
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_marginLeft = " 100 dp "
android:layout_marginTop = " 140 dp "
android:text = " Z: "
tools:context = " . MainActivity " / >
< TextView
android:id = " @ + id / textView1 "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_centerHorizontal = " true "
android:layout_marginTop = " 80 dp "
android:text = " @string / acc_value1 "
tools:context = " . MainActivity " / >
< TextView
android:id = " @ + id / textView2 "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_centerHorizontal = " true "
android:layout_marginTop = " 110 dp "
android:text = " @string / acc_value2 "
tools:context = " . MainActivity " / >
< TextView
android:id = " @ + id / textView3 "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_centerHorizontal = " true "
android:layout_marginTop = " 140 dp "
android:text = " @string / acc_value3 "
tools:context = " . MainActivity " / >
</ RelativeLayout >
Cdigo XML 14.1: activity_main.xml

Modifique o arquivo strings.xml seguindo o cdigo a seguir:

1
2
3
4
5
6
7
8

< resources >


< string name = " app_name " > Sensores </ string >
< string name = " acc_value1 " >0 </ string >
< string name = " acc_value2 " >0 </ string >
< string name = " acc_value3 " >0 </ string >
< string name = " menu_settings " > Settings </ string >
< string name = " title_activity_main " > MainActivity </ string >
</ resources >
Cdigo XML 14.2: strings.xml

www.k19.com.br

131

A PNDICE - S ENSORES
4

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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

132

Modifique o arquivo MainActivity.java seguindo o cdigo a seguir:


package br . com . k19 . android . sensores ;
import
import
import
import
import
import
import
import
import

android . hardware . Sensor ;


android . hardware . SensorEvent ;
android . hardware . SensorEventListener ;
android . hardware . SensorManager ;
android . os . Bundle ;
android . app . Activity ;
android . content . Context ;
android . view . Menu ;
android . widget . TextView ;

public class MainActivity extends Activity implements SensorEventListener {


private SensorManager mSensorManager ;
private Sensor mSensor ;
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . activity_main ) ;
mSensorManager = ( SensorManager ) getSystemService ( Context . SENSOR_SERVICE ) ;
mSensor = mSensorManager . getDefaultSensor ( Sensor . TYPE_ACCELEROMETER ) ;
mSensorManager . registerListener (( SensorEventListener ) this , mSensor , SensorManager . SENSOR_DELAY_NORMAL ) ;
}
@Override
public boolean onCreateOptionsMenu ( Menu menu ) {
getMenuInflater () . inflate ( R . menu . activity_main , menu ) ;
return true ;
}
public void onAccuracyChanged ( Sensor arg0 , int arg1 ) {
// TODO Auto - generated method stub
}
public void onSensorChanged ( SensorEvent ev ) {
TextView x = ( TextView ) findViewById ( R . id . textView1 ) ;
TextView y = ( TextView ) findViewById ( R . id . textView2 ) ;
TextView z = ( TextView ) findViewById ( R . id . textView3 ) ;
x . setText ( String . valueOf ( ev . values [0]) ) ;
y . setText ( String . valueOf ( ev . values [1]) ) ;
z . setText ( String . valueOf ( ev . values [2]) ) ;
}
}
Cdigo Java 14.15: MainActivity.java

132

Rode a aplicao e movimente o dispositivo.

www.k19.com.br

CAPTULO

A PNDICE - W EB A PPS COM


W EB V IEW

15

Introduo
WebView uma maneira de disponibilizar contedo web dentro da aplicao client. A classe
WebView extende a classe View do Android e permite que uma pgina seja mostrada como parte
do layout da atividade. importante lembrar que esta visualizao de pginas web no inclui os
controles de navegao e barra de endereo como em um browser padro.
Uma utilizao comum para WebView poderia ser, por exemplo, incluir na aplicao contedo
varivel como licenas de uso, guias de usurio, change logs e etc. Nestes casos pode ser mais interessante desenvolver uma pgina web em formato compatvel com dispositivos mobile ao invs de
obter o contedo via servio, parse-lo e ajust-lo ao layout do client Android.

Manifest
Para utilizar contedo web na aplicao preciso explicitar o pedido de permisso de acesso no
arquivo Manifest. Para isto adiciona a linha abaixo:
1

< uses - permission android:name = " android . permission . INTERNET " / >
Cdigo XML 15.1: Permisso de acesso

Layout
Para adicionar uma WebView na aplicao preciso incluir no layout da activity um elemento do tipo
WebView. No exemplo abaixo a pgina web vai ocupar a tela inteira.
1
2
3
4
5
6

<? xml version = " 1.0 " encoding = " utf -8 " ? >
< WebView xmlns:android = " http: // schemas . android . com / apk / res / android "
android:id = " @ + id / webview "
android:layout_width = " fill_parent "
android:layout_height = " fill_parent "
/>
Cdigo XML 15.2: Elemento WebView

Carregando uma pgina


Depois de adicionado o elemento no layout da aplicao, carregar a pgina no WebView se torna uma
tarefa muito simples. Basta executar o mtodo WebView.loadUrl() passando o endereo da pgina a
ser carragada. Como no cdigo abaixo:
www.k19.com.br

133

A PNDICE - W EB A PPS COM W EB V IEW


1
2

134

WebView myWebView = ( WebView ) findViewById ( R . id . webview ) ;


myWebView . loadUrl ( " http :// www . k19 . com . br " ) ;
Cdigo Java 15.1: Carregando a url

Controlando a Navegao
Em geral, as pginas disponibilizadas via WebView no deveriam ter muitos links restringindo assim
a navegao do usurio, afinal, apresentar pginas web na aplicao no faz dela um browser. Contudo, possivel que o usurio clique em um link que o levar para uma outra pgina. Quando isto
acontece, o comportamento esperado do Android abrir o browser padro para exibir a pgina.
Para evitar que isto acontea, podemos alterar este comportamento e manter a navegao dentro
do WebView. Isto pode ser feito definindo o WebViewClient do WebView como demonstrado no
trecho de cdigo abaixo:
1
2

WebView myWebView = ( WebView ) findViewById ( R . id . webview ) ;


myWebView . setWebViewClient ( new WebViewClient () ) ;
Cdigo Java 15.2: Direcionando a navegao para o prprio WebView

possvel ainda decidir se o nosso WebView vai abrir o link ou vai delegar a tarefa ao browser
padro dada a url. Isto especialmente interessante quando queremos abrir as pginas do prprio
domnio na WebView, j que estariam em um formato para exibio apropriado para dispositivos
mveis, e abrir pginas de domnios externos no web browser padro. Para isto, basta extender a
classe WebViewClient e sobreescrever o mtodo WebViewClient.shouldOverrideUrlLoading(). O cdigo abaixo um exemplo de aplicao:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

private class MyWebViewClient extends WebViewClient {


@Override
public boolean shouldOverrideUrlLoading ( WebView view , String url ) {
if ( Uri . parse ( url ) . getHost () . equals ( " www . k19 . com . br " ) ) {
// Se o domnio for interno
return false ;
}
// Se o domnio for externo ento vamos direcionar para o browser padro
Intent intent = new Intent ( Intent . ACTION_VIEW , Uri . parse ( url ) ) ;
startActivity ( intent ) ;
return true ;
}
}
Em seguida associe esta nova implementao como WebViewClient do WebView .
\ begin { java }{ Associando o WebViewClient customizado }
WebView myWebView = ( WebView ) findViewById ( R . id . webview ) ;
myWebView . setWebViewClient ( new MyWebViewClient () ) ;
Cdigo Java 15.3: Sobrescrevendo a url

O WebView ainda suporta a recuperao do histrico de navegao. Isto s possvel se mais de


uma pgina foi visualizada atravs dele. Deste modo, possvel adicionar funcionalidades "Back"e
"Forward"como as de um navegador padro. Existem 4 mtodos que auxiliam nestas funes:
WebView.goBack() - volta para a pgina anterior.
WebView.goForward() - avana para a prxima pgina.
134

www.k19.com.br

135

A PNDICE - W EB A PPS COM W EB V IEW

WebView.canGoBack() - verifica se existe histrico anterior pgina corrente.


WebView.canGoForward() - verifica se existe histrico posterior pgina corrente.

O exemplo a seguir utiliza estes controles para voltar a navegao caso o usurio aperte o boto
Back do dispositivo. Se no houver pginas no histrico ento a aplicao fecha.
1
2
3
4
5
6
7
8
9
10

@Override
public boolean onKeyDown ( int keyCode , KeyEvent event ) {
// Checando se o boto apertado o Back
if (( keyCode == KeyEvent . KEYCODE_BACK ) && myWebView . canGoBack () {
myWebView . goBack () ;
return true ;
}
// Caso contrrio manter o comportamento padro do boto
return super . onKeyDown ( keyCode , event ) ;
}
Cdigo Java 15.4: Navegando pelo histrico

Associando cdigo JavaScript a cdigo Android


A API do Android tambm permite que um cdigo do cliente Android seja chamado a partir de
um cdigo JavaScript. Isto possvel implementando o cdigo que ser chamado em uma classe que
adicionada ao contexto de execuo do JavaScript. Chamamos esta classe de Interface.
No cdigo abaixo vamos definir um mtodo chamado showToast que, quando executado, mostra uma janela contendo uma mensagem. Este mtodo faz parte de uma classe cuja instancia ser
adicionada ao contexto de execuo do JavaScript. A idia neste exemplo substituir a funo alert()
do JavaScript pelo mtodo showToast();
1
2
3
4
5
6
7
8
9
10
11
12
13

public class JavaScriptInterface {


Context mContext ;
/* Cria a interface guardando nela o contexto */
JavaScriptInterface ( Context c ) {
mContext = c ;
}
/* Mostra a notificao */
public void showToast ( String toast ) {
Toast . makeText ( mContext , toast , Toast . LENGTH_SHORT ) . show () ;
}
}
Cdigo Java 15.5: Classe que implementa o mtodo a ser chamado via JS

Note que, por convenincia, adicionamos o Context no construtor da classe para utiliz-lo durante a chamada do mtodo.
Feita a implementao podemos associar uma instncia de JavaScriptInterface ao WebView chamando o mtodo WebView.addJavascriptInterface(). Este mtodo recebe dois parmetros: a instncia e o nome da Interface como mostra o trecho de cdigo abaixo:
1
2

WebView webView = ( WebView ) findViewById ( R . id . webview ) ;


webView . addJavascriptInterface ( new JavaScriptInterface ( this ) , " Android " ) ;

www.k19.com.br

135

A PNDICE - W EB A PPS COM W EB V IEW

136

Cdigo Java 15.6: Associao da Interface ao WebView

Com a Interface criada podemos acessar o mtodo atravs do nome da Interface ("Android"neste
caso) a partir do cdigo JavaScript. O cdigo a seguir executa uma chamada ao mtodo Android.showToast()
em resposta ao evento click do boto "Say hello".
1
2
3
4
5
6
7

< input type = " button " value = " Say hello " onClick = " showAndroidToast ( Hello Android ! ) " / >
< script type = " text / javascript " >
function showAndroidToast ( toast ) {
Android . showToast ( toast ) ;
}
</ script >
Cdigo HTML 15.1: Cdigo HTML e JS

Exerccios de Fixao
Crie um novo projeto Android. Use como nome para o projeto WebView. O nome do pacote
deve ser br.com.k19.android.cap12, e o nome da activity deve ser MainActivity.
1

1
2
3
4
5
6
7
8
9
10
11
12

Na pasta res/layouts crie um arquivo chamado main.xml. Ele deve conter o seguinte contedo:
<? xml version = " 1.0 " encoding = " utf -8 " ? >
< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< WebView
android:id = " @ + id / webview "
android:layout_width = " match_parent "
android:layout_height = " match_parent " / >
</ LinearLayout >
Cdigo XML 15.3: main.xml

O arquivo res/values/strings.xml deve ficar com o seguinte contedo:


1
2
3
4
5
6
7

< resources >


< string name = " app_name " > WebView </ string >
< string name = " menu_settings " > Settings </ string >
< string name = " title_activity_main " > Site K19 </ string >
</ resources >
Cdigo XML 15.4: strings.xml

Edite o arquivo MainActivity.java com o seguinte contedo:


1
2
3
4

136

package br . com . k19 . android . cap12 ;


import android . app . Activity ;
import android . os . Bundle ;

www.k19.com.br

137
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

A PNDICE - W EB A PPS COM W EB V IEW


import android . webkit . WebSettings ;
import android . webkit . WebView ;
public class MainActivity extends Activity {
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . main ) ;
WebView webView = ( WebView ) findViewById ( R . id . webview ) ;
WebSettings webSettings = webView . getSettings () ;
webSettings . setJavaScriptEnabled ( true ) ;
webView . loadUrl ( " http :// k19 . com . br " ) ;
}
}
Cdigo Java 15.7: MainActivity.java

Adicione a permisso para internet no AndroidManifest.xml. Basta adicionar a seguinte linha:


1

< uses - permission android:name = " android . permission . INTERNET " / >
Cdigo XML 15.5: AndroidManifest.xml

Aps isso, rode a aplicao e veja o resultado.

www.k19.com.br

137

A PNDICE - W EB A PPS COM W EB V IEW

138

138

www.k19.com.br

CAPTULO

A PNDICE - B LUETOOTH

16

A plataforma do Android oferece suporte Bluetooth, permitindo que dispositivos se comuniquem e troquem dados sem utilizar fios, apenas atravs do Bluetooth.

Classes utilizadas
Toda a API referente a Bluetooth se encontra no package android.bluetooth. Entre as classes
importantes encontradas neste package temos:

BluetoothAdapter - representa um adapter, que o ponto de partida para vrias aes, como descobrir aparelhos, parear e transmitir dados.
BluetoothDevice - representa um aparelho conectado.
BluetoothSocket - representa um socket, que um canal de comunicao entre os aparelhos.
BluetoothServerSocket - representa um socket do tipo servidor, que recebe diferentes requisies,
necessrio se quiser conectar com mais de um aparelho android.

Permisses
Existem duas permisses com relao a Bluetooth. A BLUETOOTH e a BLUETOOTH_ADMIN.
A primeira usada para realizar uma conexo por bluetooth, como iniciar uma conexo, aceitar
uma conexo ou transferir dados. A segunda usada para buscar por aparelhos e para alterar as
configuraes de bluetooth do aparelho.
1
2

< uses - permission android:name = " android . permission . BLUETOOTH " / >
< uses - permission android:name = " android . permission . BLUETOOTH_ADMIN " / >
Cdigo XML 16.1: Exemplo

Usando o Bluetooth
necessrio antes ver se o aparelho possui suporte a bluetooth, e caso positivo, se o bluetooth
est habilitado. Caso no esteja habilitado, possvel enviar o usurio para configurar e habilitar o
bluetooth.
1
2

BluetoothAdapter mBluetoothAdapter = BluetoothAdapter . getDefaultAdapter () ;


if ( mBluetoothAdapter != null ) {

www.k19.com.br

139

A PNDICE - B LUETOOTH
3
4
5
6
7
8
9
10
11
12

140

// verifica se o bluetooth est habilitado


if (! mBluetoothAdapter . isEnabled () ) {
// envia o usurio para ativar o bluetooth
Intent enableBtIntent = new Intent ( BluetoothAdapter . ACTION_REQUEST_ENABLE ) ;
startActivityForResult ( enableBtIntent , REQUEST_ENABLE_BT ) ;
}
// restante do cdigo
} else {
// sem suporte a bluetooth
}
Cdigo Java 16.1: Exemplo

Listando dispositivos pareados


1
2
3
4
5
6
7
8
9
10

// retorna os dispositivos pareados


Set < BluetoothDevice > pairedDevices = mBluetoothAdapter . getBondedDevices () ;
if ( pairedDevices . size () > 0) {
// iteramos nos dispositivos
for ( BluetoothDevice device : pairedDevices ) {
// adiciona em um adapter para mostrar em uma ListView , como exemplo
adapter . add ( device . getName () + " \ n " + device . getAddress () ) ;
}
}
Cdigo Java 16.2: Exemplo

Descobrindo dispositivos
Para descobrir dispositivos, necessrio chamar o mtodo startDiscovery() no BluetoothAdapter. O
mtodo assncrono, por isso necessrio registrar um receiver como no exemplo abaixo:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

private final BroadcastReceiver mReceiver = new BroadcastReceiver () {


public void onReceive ( Context context , Intent intent ) {
String action = intent . getAction () ;
// quando um aparelho encontrado
if ( BluetoothDevice . ACTION_FOUND . equals ( action ) ) {
// obter o dispositivo do intent
BluetoothDevice device = intent . getParcelableExtra ( BluetoothDevice . EXTRA_DEVICE ) ;
// adiciona a um adapter para mostrar em uma ListView
adapter . add ( device . getName () + " \ n " + device . getAddress () ) ;
}
}
};
// registra o BroadcastReceiver
IntentFilter filter = new IntentFilter ( BluetoothDevice . ACTION_FOUND ) ;
registerReceiver ( mReceiver , filter ) ;
// lembre - se de remover o registro no onDestroy
Cdigo Java 16.3: Exemplo

Usando conexes
Abaixo est um exemplo de uma thread usada para conectar com outros aparelhos, sendo que o
dispositivo funciona como o servidor.
140

www.k19.com.br

141
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

A PNDICE - B LUETOOTH
private class AcceptThread extends Thread {
private final BluetoothServerSocket mmServerSocket ;
public AcceptThread () {
BluetoothServerSocket tmp = null ;
try {
// UUID o identificador do aparelho , tambm usado pelo cliente
tmp = mBluetoothAdapter . listenUsingRfcommWithServiceRecord ( NAME , MY_UUID ) ;
} catch ( IOException e ) { }
mmServerSocket = tmp ;
}
public void run () {
BluetoothSocket socket = null ;
// continua tentando at encontra um socket ou uma exception
while ( true ) {
try {
socket = mmServerSocket . accept () ;
} catch ( IOException e ) {
break ;
}
// conexo aceita
if ( socket != null ) {
// Faz algo com o socket em uma thread separada
manageConnectedSocket ( socket ) ;
mmServerSocket . close () ;
break ;
}
}
}
public void cancel () {
try {
mmServerSocket . close () ;
} catch ( IOException e ) { }
}
}
Cdigo Java 16.4: Exemplo

Abaixo est um exemplo de como conectar como um cliente a um servidor:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

private class ConnectThread extends Thread {


private final BluetoothSocket mmSocket ;
private final BluetoothDevice mmDevice ;
public ConnectThread ( BluetoothDevice device ) {
BluetoothSocket tmp = null ;
mmDevice = device ;
// obtem um socket para conectar com um dispositivo
try {
// MY_UUID is the app s UUID string , also used by the server code
tmp = device . createRfcommSocketToServiceRecord ( MY_UUID ) ;
} catch ( IOException e ) { }
mmSocket = tmp ;
}
public void run () {
mBluetoothAdapter . cancelDiscovery () ;
try {
mmSocket . connect () ;
} catch ( IOException connectException ) {
// erro ao conectar
try {
mmSocket . close () ;

www.k19.com.br

141

A PNDICE - B LUETOOTH
27
28
29
30
31
32
33
34
35
36
37
38
39
40

142

} catch ( IOException closeException ) { }


return ;
}
// faz alguma coisa com o socket em uma thread separada
manageConnectedSocket ( mmSocket ) ;
}
public void cancel () {
try {
mmSocket . close () ;
} catch ( IOException e ) { }
}
}
Cdigo Java 16.5: Exemplo

Quando voc tem um ou mais aparelhos conectados, voc pode comear a transferir dados entre
eles atravs de um socket. Toda a transmisso de dados feita utilizando a classe InputStream e
OutputStream. Veja abaixo um exemplo de como transferir dados em uma thread.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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

142

private class ConnectedThread extends Thread {


private final BluetoothSocket mmSocket ;
private final InputStream mmInStream ;
private final OutputStream mmOutStream ;
public ConnectedThread ( BluetoothSocket socket ) {
mmSocket = socket ;
InputStream tmpIn = null ;
OutputStream tmpOut = null ;
try {
tmpIn = socket . getInputStream () ;
tmpOut = socket . getOutputStream () ;
} catch ( IOException e ) { }
mmInStream = tmpIn ;
mmOutStream = tmpOut ;
}
public void run () {
byte [] buffer = new byte [1024]; m
int bytes ; // bytes returned from read ()
// continua lendo o inputstream at ocorrer um erro
while ( true ) {
try {
bytes = mmInStream . read ( buffer ) ;
// envia o dado obtido para alguma activity via handler
mHandler . obtainMessage ( MESSAGE_READ , bytes , -1 , buffer )
. sendToTarget () ;
} catch ( IOException e ) {
break ;
}
}
}
public void write ( byte [] bytes ) {
try {
mmOutStream . write ( bytes ) ;
} catch ( IOException e ) { }
}
public void cancel () {
try {
mmSocket . close () ;
} catch ( IOException e ) { }
}

www.k19.com.br

143
48

A PNDICE - B LUETOOTH
}
Cdigo Java 16.6: Exemplo

www.k19.com.br

143

A PNDICE - B LUETOOTH

144

144

www.k19.com.br

CAPTULO

A PNDICE - A NIMAES

17

A partir do Android 3.0, a API Properties Animation foi introduzida e prov suporte para animaes.
Basicamente a API permite que propriedades de um objeto sejam alteradas com o tempo. A
classe bsica da API a Animator mas normalmente usa-se a classe ObjectAnimator. Outra classe
importante a classe AnimatorListener que pode ser utilizada para executar aes antes e depois de
uma animao.
As animaes podem ser utilizadas em Views ou em transies entre Activities.
Neste captulo vamos implementar um exerccio que mostra um exemplo de utilizao da classe
ObjectAnimator.

Exerccios de Fixao
1

Crie um novo projeto Android. Use como nome para o projeto Animacao. O nome do pacote
deve ser br.com.k19.android.animation, e o nome da activity deve ser MainActivity. No se esquea
que, para este app, a verso mnima do SDK 11.
2

Modifique o arquivo AndroidManifest.xml seguindo o cdigo a seguir:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

< manifest xmlns:android = " http: // schemas . android . com / apk / res / android "
package = " br . com . k1 . android . animacao "
android:versionCode = " 1 "
android:versionName = " 1.0 " >
< uses - sdk
android:minSdkVersion = " 11 "
android:targetSdkVersion = " 15 " / >
< application
android:icon = " @drawable / ic_launcher "
android:label = " @string / app_name "
android:theme = " @style / AppTheme " >
< activity
android:name = " . MainActivity "
android:label = " @string / title_activity_main " >
< intent - filter >
< action android:name = " android . intent . action . MAIN " / >
< category android:name = " android . intent . category . LAUNCHER " / >
</ intent - filter >
</ activity >
</ application >

www.k19.com.br

145

A PNDICE - A NIMAES
24
25

146

</ manifest >


Cdigo XML 17.1: AndroidManifest.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

Modifique o layout principal seguindo o cdigo abaixo.


<? xml version = " 1.0 " encoding = " utf -8 " ? >
< RelativeLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:id = " @ + id / layout "
android:layout_width = " match_parent "
android:layout_height = " match_parent "
android:orientation = " vertical " >
< LinearLayout
android:id = " @ + id / test "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content " >
< Button
android:id = " @ + id / Button01 "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:onClick = " startAnimation "
android:text = " Rotate " / >
</ LinearLayout >
< ImageView
android:id = " @ + id / imageView1 "
android:layout_width = " wrap_content "
android:layout_height = " wrap_content "
android:layout_centerHorizontal = " true "
android:layout_centerVertical = " true "
android:src = " @drawable / ic_launcher " / >
</ RelativeLayout >
Cdigo XML 17.2: activity_main.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

146

Altere a MainActivity para que fique como o cdigo a seguir:


package br . com . k1 . android . animacao ;
import
import
import
import
import
import

android . animation . ObjectAnimator ;


android . app . Activity ;
android . os . Bundle ;
android . view . Menu ;
android . view . View ;
android . widget . ImageView ;

public class MainActivity extends Activity {


/* Chamado quando a Activity e criada . */
@Override
public void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState ) ;
setContentView ( R . layout . activity_main ) ;
}
public void startAnimation ( View view ) {
float dest = 0;
ImageView aniView = ( ImageView ) findViewById ( R . id . imageView1 ) ;
if ( view . getId () == R . id . Button01 ) {
dest = 360;
if ( aniView . getRotation () == 360) {

www.k19.com.br

147
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

A PNDICE - A NIMAES
System . out . println ( aniView . getAlpha () ) ;
dest = 0;
}
ObjectAnimator animation1 = ObjectAnimator . ofFloat ( aniView ,
" rotation " , dest ) ;
animation1 . setDuration (2000) ;
animation1 . start () ;
}
}
@Override
public boolean onCreateOptionsMenu ( Menu menu ) {
return super . onCreateOptionsMenu ( menu ) ;
}
}
Cdigo Java 17.1: MainActivity.java

Rode a aplicao e clique no botao para ver o cone da aplicaao rotacionando.

www.k19.com.br

147

A PNDICE - A NIMAES

148

148

www.k19.com.br

CAPTULO

A PNDICE - M ONETIZANDO COM Ads

18

Introduo
Uma das possibilidades para monetizar atravs da uma aplicao alm de vend-la fazendo
uso de publicidade. Neste captulo vamos aprender sobre como inserir banners publicitrios na
aplicao.

Conta de Veculo
Para que os cliques no banner sejam contabilizados corretamente e associados a um veculo, preciso abrir uma conta em uma rede de publicidade mvel. Neste captulo, vamos utilizar um exemplo
com AdMob, que a rede de publicidade do Google.

SDK do servio de Ad
Aberta a conta, o servio da sua escolha deve ainda fornecer as bibliotecas que iro lhe ajudar no desenvolvimento da sua aplicao com publicidade. O Google fornece um lib para facilitar a incluso
de banners na aplicao. Lembre-se que os jar devem ser colocados na pasta lib e includos no BuildPath do Eclipse.
www.k19.com.br

149

A PNDICE - M ONETIZANDO COM Ads

150

Figura 18.1: SDK do AdMob do Google.

Mais Sobre
Para saber mais sobre o AdMob e como fazer o download do SDK acesse: http://

developer.android.com/guide/appendix/media-formats.html

Manifest
Os banners so preenchidos com contedo requisitado na web e para isso preciso explicitar
que o sue aplicativo ir acessar a internet.
1
2
3
4
5

</ manifest >


< uses - permission android : name = " android . permission . INTERNET " / >
...
< application >... </ application >
</ manifest >
Cdigo Java 18.1: AndroidManifest.xml

150

www.k19.com.br

151

18.4. M ANIFEST

Layout
Para posicionar o banner no aplicativo, basta inserir no layout um elemento do tipo com.google.ads.AdView.
Observe o layout abaixo:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

< LinearLayout xmlns:android = " http: // schemas . android . com / apk / res / android "
android:id = " @ + id / ad_catalog_layout "
android:orientation = " vertical "
android:layout_width = " match_parent "
android:layout_height = " match_parent " >
< com . google . ads . AdView
xmlns:googleads = " http: // schemas . android . com / apk / lib / com . google . ads "
android:id = " @ + id / ad "
android:layout_width = " fill_parent "
android:layout_height = " wrap_content "
googleads:adSize = " BANNER "
googleads:adUnitId = " @string / admob_id " / >
< TextView android:id = " @ + id / title "
android:layout_width = " match_parent "
android:layout_height = " wrap_content "
android:text = " @string / banner_top " / >
< TextView android:id = " @ + id / status "
android:layout_width = " match_parent "
android:layout_height = " wrap_content " / >
</ LinearLayout >
Cdigo XML 18.1: Layout.xml

Lembre-se de que estas configuraes so especficas do AdMob e podem variar dependendo da


rede de publicidade que est sendo utilizada.

Inicializando o Ad
Dependendo da arquitetura que foi utilizada na aplicao podemos inicializar o Ad no Activity.onCreate
ou no Fragment.onCreateView. O cdigo abaixo ilustra como o Ad pode ser inicializado:
1
2
3
4
5
6
7
8
9
10
11
12
13

public View onCreateView ( LayoutInflater inflater , ViewGroup container ,


Bundle savedInstanceState ) {
...
View v = inflater . inflate ( R . layout . main , container , false ) ;
mAdStatus = ( TextView ) v . findViewById ( R . id . status ) ;
mAdView = ( AdView ) v . findViewById ( R . id . ad ) ;
mAdView . setAdListener ( new MyAdListener () ) ;
AdRequest adRequest = new AdRequest () ;
adRequest . addKeyword ( " sporting goods " ) ;
mAdView . loadAd ( adRequest ) ;
return v ;
}
Cdigo Java 18.2: Fragment.onCreateView()

Note que um listener foi associado view. Quando disponvel, o banner pode reportar alguns
eventos, tais como, sucesso ou erro no carregamento. O listener pode ajudar quando precisamos
tomar decises frente a estes eventos. Um bom exemplo seria carregar um banner padro caso houvesse um erro no carregamendo a partir do servidor do Ads. O cdigo abaixo implementa um exemplo de listener:
1
2

private class MyAdListener implements AdListener {


...

www.k19.com.br

151

A PNDICE - M ONETIZANDO COM Ads


3
4
5
6
7
8
9
10
11
12
13

152

@Override
public void onFailedToReceiveAd ( Ad ad , ErrorCode errorCode ) {
mAdStatus . setText ( R . string . error_receive_ad ) ;
}
@Override
public void onReceiveAd ( Ad ad ) {
mAdStatus . setText ( " " ) ;
}
}
Cdigo Java 18.3: Listener

152

www.k19.com.br

Você também pode gostar