Natalio Oswaldo Salinas Ponce Jhonathan Noe Suarez ChavezDescripción completa
Descripción completa
Descripción completa
descripcion del so androidDescripción completa
Descripción completa
androidDescripción completa
anDescripción completa
Criando aplicações em android
Descrição completa
Descripción completa
Criando aplicações em android
Sistema AndroidDescripción completa
android punoDescripción completa
Descripción completa
Android BásicoDescrição completa
sok ahDeskripsi lengkap
manual para programar aplicaciones movilesDescripción completa
Mysql-AndroidDescripción completa
copia de un gran trabajo
ملخص دورة اندرويد android summary
Kotlin Android programmationFull description
Kotlin Android programmationDescrição completa
Minicurso Android Avançado
Flávio Augusto de Freitas [email protected] flaviocefetrp@gma il.com http://flavioaf.blogspot.com
Sumário Passos Iniciais .......................................................................................................................................... .................................................................................................................................................................... .......................... 3 Montando um Ambiente de Desenvolvimento para Android ...................................................................................... 4 Configurando um Dispositivo Android com o AVD A VD Manager ....................................................................................... 9 Tutoriais Avançados ...................................................................................................................................................... ........................................................................................................................................................ .. 12 Persistência em Banco de Dados ........................................................................................................ ................................................................................................................................ ........................ 13 Editando Registros do Banco de Dados .......................................................................................................... ...................................................................................................................... ............ 22 Configurando Preferências .................................................................. ........................................................................................................................................ ........................................................................ 36 Ajustando o Layout para Paisagem (II) ........................................................... ....................................................................................................................... ............................................................ 41 Integrando Bibliotecas de Terceiros (Twitter) ............................................................................................................ ............................................................................................................ 44 Utilizando um IntentService..................................................... IntentService........................................................................................................................... ................................................................................... ............. 53 Integrando o GPS ........................................................................................................................................................ .......................................................................................................... .............................................. 57 Alterando o Ícone do Launcher ............................................................ .................................................................................................................................. ........................................................................ 65 Integrando com o Google Maps ................................................................................................................................. .................................................................................................................... ............. 67 Alarmes .............................................................. .................................................................................................................................... ......................................................................................................... ................................... 69 Notificações ................................................................... ........................................................................................................................................ ............................................................................................. ........................ 76 Internacionalização (i18n) ............................................................................... ........................................................................................................................................... ............................................................ 78 Widgets .............................................................. .................................................................................................................................... ......................................................................................................... ................................... 84 Fazendo Ligações (Chamadas) .................................................................................................................................... .................................................................................................................................... 91 Terminamos ........................................................... .............................................................................................................................. ......................................................................................................... ...................................... 97 Contatos ................................................................. ....................................................................................................................................... ......................................................................................................... ................................... 98
Sumário Passos Iniciais .......................................................................................................................................... .................................................................................................................................................................... .......................... 3 Montando um Ambiente de Desenvolvimento para Android ...................................................................................... 4 Configurando um Dispositivo Android com o AVD A VD Manager ....................................................................................... 9 Tutoriais Avançados ...................................................................................................................................................... ........................................................................................................................................................ .. 12 Persistência em Banco de Dados ........................................................................................................ ................................................................................................................................ ........................ 13 Editando Registros do Banco de Dados .......................................................................................................... ...................................................................................................................... ............ 22 Configurando Preferências .................................................................. ........................................................................................................................................ ........................................................................ 36 Ajustando o Layout para Paisagem (II) ........................................................... ....................................................................................................................... ............................................................ 41 Integrando Bibliotecas de Terceiros (Twitter) ............................................................................................................ ............................................................................................................ 44 Utilizando um IntentService..................................................... IntentService........................................................................................................................... ................................................................................... ............. 53 Integrando o GPS ........................................................................................................................................................ .......................................................................................................... .............................................. 57 Alterando o Ícone do Launcher ............................................................ .................................................................................................................................. ........................................................................ 65 Integrando com o Google Maps ................................................................................................................................. .................................................................................................................... ............. 67 Alarmes .............................................................. .................................................................................................................................... ......................................................................................................... ................................... 69 Notificações ................................................................... ........................................................................................................................................ ............................................................................................. ........................ 76 Internacionalização (i18n) ............................................................................... ........................................................................................................................................... ............................................................ 78 Widgets .............................................................. .................................................................................................................................... ......................................................................................................... ................................... 84 Fazendo Ligações (Chamadas) .................................................................................................................................... .................................................................................................................................... 91 Terminamos ........................................................... .............................................................................................................................. ......................................................................................................... ...................................... 97 Contatos ................................................................. ....................................................................................................................................... ......................................................................................................... ................................... 98
Passos Iniciais
Montando um Ambiente de Desenvolvimento para Android Hoje vou mostrar como montar um ambiente de desenvolvimento para Android! Pra quem nunca ouviu falar, o Android é um sistema operacional da Google para dispositivos móveis. Hoje em dia, milhões de celulares e tablets utilizam o Android como sistema. Uma coisa bem legal é que você pode disponibilizar seus aplicativos no Market do Android (após o pagamento de uma taxa) e talvez até ganhar um dinheiro com isso! Legal, né? O desenvolvimento de aplicativos para Android é feito utilizando a linguagem Java, com a utilização de arquivos XML para a criação das interfaces. Apesar de parecer complexo, é relativamente simples criar seus aplicativos. Além disso, é bem fácil ter acesso a diversos recursos geralmente disponíveis em dispositivos móveis, tais como câmera, GPS, Bluetooth, etc. Para facilitar o desenvolvimento, foi criado um plug-in para o Eclipse. Através dele, é fácil gerenciar as plataformas (diversas versões do Android) e as máquinas virtuais para executar seus aplicativos. Bom, então pra começar, vamos fazer o download da JDK. Se você já programa em Java, este passo não é necessário. No momento em que escrevo este tutorial, a versão mais recente é a Java 7 update 2. Siga até esta página e faça o download.
A instalação deve ocorrer sem problemas (o famoso, next, next, next, finish). O próximo passo é baixar o Eclipse. Vá até esta página e faça o download relacionado a versão de seu sistema operacional. Para os nossos propósitos, a versão Eclipse IDE for Java Developers deve ser suficiente.
Ao concluir o download, basta descompactar o arquivo em algum lugar da sua máquina. Eu recomendo, no caso do Windows, na raiz C: ou em sua pasta de usuário (C:\Users\). Neste exemplo, vou referenciar a pasta do Eclipse como C:\eclipse. Prosseguindo, devemos agora baixar o Android SDK. É ele quem nos fornecerá todas as ferramentas da plataforma, como emulador, bibliotecas, etc. Vá até essa página e baixe a versão zipada da SDK (apesar de recomendarem a versão “instalável”) – isso é pra evitarmos problemas de permissão na hora de baixar as SDKs, caso esteja na pasta de programas do sistema (Program Files ou Arquivos de Programas). No momento em que escrevo este tutorial, a versão mais recente é a 16.
Após a conclusão do download, descompacte o arquivo (pode ser no mesmo local onde você colocou o Eclipse). Aqui, por exemplo, vai ficar C:\android-sdk-windows. Após extrair, vamos executar o SDK Manager para baixar uma SDK para começarmos a programar. Ao executar pela primeira vez, o SDK Manager irá verificar os repositórios do Android em busca das últimas versões do SDK.
Para começar, vamos baixar o SDK da versão 2.2, já que os aplicativos desenvolvidos nela funcionam na grande maioria dos dispositivos Android de hoje. Se quiser instalar outras versões, fique à vontade. Expanda a pasta Android 2.2 (API 8 ) e marque as opções SDK Platform. Além disso, na categoria Tools, marque a opção Android SDK Platformtools. Clique em Install 2 packages… (ou mais, se você selecionou mais alguma coisa), ma rque Accept All e então clique em Install.
Após a conclusão dos downloads, é hora de configurar o Eclipse. Vá até o diretório onde ele foi descompactado e execute-o.
Ao ser consultado sobre qual workspace utilizar, basta confirmar e utilizar o padrão ( workspace é o local onde seus projetos serão salvos; ele fica na pasta C:\Users\\workspace). Vamos agora adicionar o plugin para integrar o SDK Manager e o AVD Manager ao Eclipse. Clique no menu Help - > Install New Software… e na janela que abrir, clique no botão Add…. Na tela seguinte, preencha o nome do plugin (ADT Plugin) e coloque o endereço https://dl-ssl.google.com/android/eclipse, conforme a imagem abaixo:
Clique em OK e aguarde o carregamento do repositório. Ao concluir, marque a caixa Developer Tools e cli que em Next > duas vezes. Na tela seguinte, aceite os termos da licença e clique em Finish. Agora aguarde a instalação e, caso seja alertado sobre conteúdo não-assinado, clique em OK para continuar.
Ao final, clique em Restart Now para reiniciar o Eclipse e concluir a instalação. O próximo passo é configurar o local onde as SDKs estão. No Eclipse, vá ao menu Window - > Preferences. Clique no botão Browse… e aponte para a pasta que você descompactou. Após a confirmação, deverão ser exibidas as SDKs que você baixou.
Pronto! Seu ambiente Android já está pronto para ser utilizado! No próximo tutorial veremos como configurar um dispositivo para executar nossa aplicação.
Configurando um Dispositivo Android com o AVD Manager Olá pessoal! No último tutorial sobre Android, vimos como configurar o ambiente para programarmos, utilizando o Eclipse. Neste tutorial, vamos ver como criar um dispositivo para a execução dos aplicativos que serão criados. Assim, você não precisa necessariamente de um celular com Android para começar a desenvolver para a plataforma. Bom, o primeiro passo é abrir o Eclipse e clicar no íco ne do AVD Manager (AVD = Android Virtual Device), ou ir até o menu Window -> AVD Manager.
Será, então, aberta a janela com a listagem de dispositivos criados (no nosso caso, nenhum ainda).
Então, para criarmos um novo dispositivos, clicamos no botão Ne w…. Nesta tela, devemos preencher os dados relativos ao nosso dispositivo, como nome (Name), versão do Android que irá executar (Target), além de dados como tamanho do cartão SD virtual (caso desejado), tamanho da tela e periféricos (câmera, GPS, Acelerômetro, Teclado físico, etc.).
Após montar seu dispositivo, clique em Create AVD e terá seu dispositivo listado!
Quando estiver desenvolvendo, é recomendável criar diferentes tipos de dispositivos, com versões diferentes do Android e tamanhos de tela variados, de forma a fazer seu aplicativo ser executado corretamente em diversas configurações.
Tutoriais Avançados
Persistência em Banco de Dados Olá leitores! No tutorial de hoje, vamos criar um sistema de persistência para a nossa Lista de Restaurantes. Assim, os restaurantes cadastrados serão mantidos a cada execução do aplicativo. O sistema Android nos fornece nativamente as opções de persistir dados utilizando arquivos ou em banco de dados, utilizando o SQLite. Se você não conhece o projeto, é interessante dar uma lida sobre ele. É um banco de dados bastante leve, que nos permite facilmente trabalhar com SQL sobre um arquivo. Neste tutorial, estou assumindo que você tenha um conhecimento básico em SQL. Se você nunca mexeu com isso, não se preocupe, pois os conceitos não são complicados de entender. Bom, começando o nosso tutorial, vamos criar uma classe que gerenciará a criação e abertura do nosso banco de dados. Vamos chamá-la de GerenciadorRestaurantes. Coloque-a no pacote c om.blogspot.flavioaf.restaurante.
package com.blogspot.flavioaf.restaurante; import android.content.Context; import android.database.sqlite.SQLiteDatabase; import android.database.sqlite.SQLiteOpenHelper; public class GerenciadorRestaurantes extends SQLiteOpenHelper { private static final String NOME_BANCO = "restaurantes.db"; private static final int VERSAO_SCHEMA = 1; public GerenciadorRestaurantes(Context context) { super(context, NOME_BANCO, null, VERSAO_SCHEMA); } @Override public void onCreate(SQLiteDatabase db) { db.execSQL("CREATE TABLE restaurantes (_id INTEGER PRIMARY KEY AUTOINCREMENT," + " nome TEXT, endereco TEXT, tipo TEXT, anotacoes TEXT);"); } @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { } }
A princípio, definimos que nosso banco de dados será armazenado no arquivo restaurantes.db e que utilizaremos a primeira versão do schema do banco. Neste ponto o projeto ainda deve compilar sem problemas. Em seguida, vamos implementar o método onCreate() para que ele crie o nosso banco de dados.
18 19 20 21 22
@Override public void onCreate(SQLiteDatabase db) { db.execSQL("CREATE TABLE restaurantes (_id INTEGER PRIMARY KEY AUTOINCREMENT," + " nome TEXT, endereco TEXT, tipo TEXT, anotacoes TEXT);"); }
Neste trecho simplesmente criamos a tabela restaurantes com seus campos. O método onUpgrade() não será útil para nós por enquanto. Em um aplicativo real, você poderia implementá-lo para fazer backup dos dados em uma tabela temporária, atualizar a estrutura do banco e então retornar os dados.
O próximo passo é remover partes do código da classe ListaRestaurantes que não nos serão úteis daqui pra frente (como os trechos que manipulam a nossa barra de progresso). As primeiras exclusões são os atributos estaAtivo e progresso. Em seguida, podemos remover a chamada ao método requestWindowFeature() dentro do método onCreate(). Podemos também excluir as implementações dos métodos onPause(), onResume(), onCreateOptionsMenu() e onOptionsItemSelected(). Por fim, podemos excluir também os métodos iniciarTarefa(), fazerAlgoDemorado() e a nossa tarefaLonga. A classe GerenciadorRestaurantes será a nossa ponte entre a aplicação e o banco de dados. Dessa forma, vamos criar um atributo na classe ListaRestaurantes chamado gerenciador do tipo GerenciadorRestaurante.
34
GerenciadorRestaurantes gerenciador;
Lá no método onCreate(), após a chamada a setContentView(), vamos então instanciar o atributo:
40
gerenciador = new GerenciadorRestaurantes(this);
Complementando, implemente o método onDestroy() na classe ListaRestaurantes.
67 68 69 70 71
@Override public void onDestroy() { super.onDestroy(); gerenciador.close(); }
Nós vamos agora, substituir nosso objeto de modelo (e seu ArrayList associado) pelo banco de dados, utilizando também a classe Cursor do Android para controlar as instâncias. Primeiramente, vamos adicionar o método inserir() na classe GerenciadorRestaurantes:
Neste método, recebemos os valores individuais dos campos que compõem a classe Restaurante e adicionamos a um objeto ContentValues, relacionando os valores com as colunas da tabela do nosso banco de dados. Por fim, obtemos uma instância do banco para escrita e inserimos os valores na tabela restaurantes. Agora, devemos realizar a chamada a este método ao pressionarmos o botão Salvar em nosso formulário (onSave).
93
private OnClickListener onSave = new OnClickListener() {
public void onClick(View arg0) { String tipo = null; switch (tipos.getCheckedRadioButtonId()) { case R.id.rodizio: tipo = "rodizio"; break; case R.id.fast_food: tipo = "fast_food"; break; case R.id.a_domicilio: tipo = "a_domicilio"; break; } gerenciador.inserir(nome.getText().toString(), endereco.getText().toString(), tipo, anotacoes.getText().toString()); } };
Em seguida, vamos fazer com que a listagem de restaurantes seja realizada a partir do nosso banco de dados. Se você já mexeu com banco de dados no Java, já deve ter visto o funcionamento de um ResultSet. Ele armazena o conteúdo de uma consulta ao banco de dados. No Android, utilizamos a classe Cursor que tem funcionamento semelhante. Assim, vamos criar um método na classe GerenciadorRestaurantes para obter a lista de restaurantes salvos no banco. Vamos implementar o método obterTodos():
39 40 41 42
public Cursor obterTodos() { return getReadableDatabase().rawQuery("select id, nome, endereco, tipo, " + "anotacoes FROM restaurantes ORDER BY nome", null); }
Precisaremos também de métodos que nos forneçam acesso a determinados campos do Cursor. Dessa forma, adicione estes métodos à classe GerenciadorRestaurantes:
44 45 46 47 48 49 50 51 52 53 54 55 56 57 58
public String obterNome(Cursor c) { return c.getString(1); } public String obterEndereco(Cursor c) { return c.getString(2); } public String obterTipo(Cursor c) { return c.getString(3); } public String obterAnotacoes(Cursor c) { return c.getString(4); }
Na nossa implementação atual, a classe Adaptador estende a classe ArrayAdapter, de forma que ela não conseguirá manipular os dados contidos no Cursor. Assim, modificaremos sua implementação para, então, estender não mais ArrayAdapter, mas sim CursorAdapter.
class AdaptadorRestaurante extends CursorAdapter { AdaptadorRestaurante(Cursor c) { super(ListaRestaurantes.this, c); } @Override public void bindView(View view, Context context, Cursor cursor) { ArmazenadorRestaurante armazenador = (ArmazenadorRestaurante) view.getTag(); armazenador.popularFormulario(cursor, gerenciador); } @Override public View newView(Context context, Cursor cursor, ViewGroup parent) { LayoutInflater inflater = getLayoutInflater(); View linha = inflater.inflate(R.layout.linha, parent, false); ArmazenadorRestaurante armazenador = new ArmazenadorRestaurante(linha); linha.setTag(armazenador); return linha; } }
Como pode ser percebido, a classe ArmazenadorRestaurante também necessita de alguns ajustes, para manipular o objeto da classe Cursor. Mas antes, vamos modificar o atributo listaRestaurantes do tipo List para Cursor.
28
Cursor listaRestaurantes;
Agora, no método onCreate(), substitua o código que populava o antigo ArrayList por este:
53 54 55 56
listaRestaurantes = gerenciador.obterTodos(); startManagingCursor(listaRestaurantes); adaptador = new AdaptadorRestaurante(listaRestaurantes); lista.setAdapter(adaptador);
Prosseguindo, vamos atualizar a classe ArmazenadorRestaurante para trabalhar com o Cursor:
private OnItemClickListener onListClick = new OnItemClickListener() { public void onItemClick(AdapterView> parent, View view, int position, long id) { listaRestaurantes.moveToPosition(position); nome.setText(gerenciador.obterNome(listaRestaurantes)); endereco.setText(gerenciador.obterEndereco(listaRestaurantes)); anotacoes.setText(gerenciador.obterAnotacoes(listaRestaurantes)); if (gerenciador.obterTipo(listaRestaurantes).equals("rodizio")) { tipos.check(R.id.rodizio); } else if (gerenciador.obterTipo(listaRestaurantes).equals("fast_food")) { tipos.check(R.id.fast_food); } else { tipos.check(R.id.a_domicilio); } getTabHost().setCurrentTab(1); } };
Como último passo precisamos adicionar uma linha para que a lista seja atualizada a cada inserção. Insira a seguinte linha após a inserção lá no onSave:
117
listaRestaurantes.requery();
Pronto! Você já pode executar a sua versão persistente do Lista de Restaurantes! Segue a listagem completa da classe ListaRestaurantes:
public class GerenciadorRestaurantes extends SQLiteOpenHelper { private static final String NOME_BANCO = "restaurantes.db"; private static final int VERSAO_SCHEMA = 1; public GerenciadorRestaurantes(Context context) { super(context, NOME_BANCO, null, VERSAO_SCHEMA); } @Override public void onCreate(SQLiteDatabase db) { db.execSQL("CREATE TABLE restaurantes (_id INTEGER PRIMARY KEY AUTOINCREMENT," + " nome TEXT, endereco TEXT, tipo TEXT, anotacoes TEXT);"); } @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { } public void inserir(String nome, String endereco, String tipo, String anotacoes) { ContentValues valores = new ContentValues(); valores.put("nome", nome); valores.put("endereco", endereco); valores.put("tipo", tipo); valores.put("anotacoes", anotacoes); getWritableDatabase().insert("restaurantes", "nome", valores); } public Cursor obterTodos() { return getReadableDatabase().rawQuery("select _id, nome, endereco, tipo, " + "anotacoes FROM restaurantes ORDER BY nome", null); } public String obterNome(Cursor c) { return c.getString(1); } public String obterEndereco(Cursor c) { return c.getString(2); } public String obterTipo(Cursor c) { return c.getString(3); } public String obterAnotacoes(Cursor c) { return c.getString(4);
59 60
} }
Editando Registros do Banco de Dados No último tutorial, tornamos o nosso aplicativo Lista de Restaurantes persistente. No tutorial de hoje, vamos aprimorar a forma como ele lida com o banco de dados, fazendo com que os registros inseridos possam ser editados. Além disso, também faremos uma mudança no visual da aplicação, retirando as abas e incluindo a tela de adição de restaurantes como uma opção no menu. O primeiro passo é criarmos uma nova Activity, que será onde ficará, a partir de agora, o nosso formulário de cadastro (e consequentemente, de edição). Separaremos as funções da nossa Activity inicial. Então, crie a classe FormularioDetalhes.
1 2 3 4 5 6 7 8 9 10 11 12
package com.blogspot.flavioaf.restaurante; import android.app.Activity; import android.os.Bundle; public class FormularioDetalhes extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); } }
Por enquanto, esta Activity não tem nenhum layout atribuído, já que ainda não criamos o seu layout. Antes de utilizar esta Activity em nosso projeto, precisamos declará-la no arquivo AndroidManifest.xml. Ele encontra-se na raiz da árvore do projeto.
Abra-o e selecione a aba inferior AndroidManifest.xml para abri-lo para a edição. Dentro do nó application, adicionaremos um novo nó activity.
Prosseguindo, precisamos iniciar esta Activity quando clicarmos sobre um dos itens da lista. Assim, modifique o onListClick dessa forma:
80 81 82 83 84 85 86
private OnItemClickListener onListClick = new OnItemClickListener() { public void onItemClick(AdapterView> parent, View view, int position, long id) { Intent i = new Intent(ListaRestaurantes.this, FormularioDetalhes.class); startActivity(i); } };
Se quiser testar a aplicação, ela deve exibir uma tela vazia ao clicar em algum item da lista. Continuando, vamos agora fazer a migração do formulário para a nova Activity. Primeiramente, crie o arquivo form_detalhes.xml na pasta res/layout, podendo utilizar o main.xml como base para ele:
Agora, volte a Activity FormularioDetalhes e adicione esta linha ao final do método onCreate:
11
setContentView(R.layout.form_detalhes);
O próximo passo é mover toda a lógica do formulário para a nossa classe FormularioDetalhes. Primeiramente, adicione os atributos da classe que estavam na ListaRestaurantes para a FormularioDetalhes:
Por fim, vamos copiar a implementação do nosso listener onSave para a classe FormularioDetalhes, porém retirando a parte que trata da inserção no banco de dados:
private OnClickListener onSave = new OnClickListener() { public void onClick(View arg0) { String tipo = null; switch (tipos.getCheckedRadioButtonId()) { case R.id.rodizio: tipo = "rodizio"; break; case R.id.fast_food: tipo = "fast_food"; break; case R.id.a_domicilio: tipo = "a_domicilio"; break; } } };
Agora é hora de “limparmos” a interface original do aplicativo, no main.xml. Retiraremos o formulário que existia e
as abas, além do ajuste no layout para abrigar somente a lista. O que nos resta é isso:
1
2 3 4 5
Após isso, exclua a pasta layout_land e o arquivo main.xml dentro dela. No momento, ListaRestaurantes estende TabActivity. Porém, como modificamos a estrutura de nossa aplicação, isso não é mais necessário. Modifique a classe, de forma que ListaRestaurante estenda ListActivity. Em seguida, modifique o método onCreate() para retirar os códigos que diziam respeito às abas que utilizávamos:
34 35 36 37 38 39 40 41 42 43 44
@Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); gerenciador = new GerenciadorRestaurantes(this); listaRestaurantes = gerenciador.obterTodos(); startManagingCursor(listaRestaurantes); adaptador = new AdaptadorRestaurante(listaRestaurantes); setListAdapter(adaptador); }
Antes de seguirmos em frente, vamos analisar o que vamos fazer: o FormularioDetalhes será utilizado tanto na criação de novos restaurantes quando na edição de restaurantes já cadastrados. Além disso, ele precisa saber, quando estiver editando, qual restaurante se trata. Para isso, precisamos do identificador do restaurante (o campo _id do banco de dados). Primeiramente, vamos criar um atributo para a classe ListaRestaurantes:
27
public final static String _ID = "com.blogspot.flavioaf.restaurante._ID";
Após isso, vamos mudar o objeto onListClick para um onListItemClick(), onde vamos passar o valor do id para a outra Activity:
53 54 55 56 57 58
@Override public void onListItemClick(ListView l, View v, int position, long id) { Intent i = new Intent(ListaRestaurantes.this, FormularioDetalhes.class); i.putExtra(_ID, String.valueOf(id)); startActivity(i); }
Em seguida, adicione o seguinte atributo na classe FormularioDetalhes:
18
String idRestaurante = null;
Este atributo será nulo se estivermos adicionando um novo restaurante, ou o identificador, caso estejamos editando um restaurante.
Como criamos o GerenciadorRestaurantes no método onCreate(), precisamos encerrá-lo no método onDestroy():
36 37 38 39 40
@Override public void onDestroy() { super.onDestroy(); gerenciador.close(); }
Como agora temos o ID como controle dos restaurantes, precisamos de um método que nos retorne o Restaurante com o identificador correspondente. Adicione o seguinte método a classe GerenciadorRestaurantes:
private void carregar() { Cursor c = gerenciador.obterPorId(idRestaurante); c.moveToFirst(); nome.setText(gerenciador.obterNome(c)); endereco.setText(gerenciador.obterEndereco(c)); anotacoes.setText(gerenciador.obterAnotacoes(c)); if (gerenciador.obterTipo(c).equals("rodizio")) { tipos.check(R.id.rodizio); } else if (gerenciador.obterTipo(c).equals("fast_food")) { tipos.check(R.id.fast_food); } else { tipos.check(R.id.a_domicilio); } c.close(); }
Agora, vamos adicionar a opção de menu Adicionar para que possamos, a partir da listagem (que agora será a tela principal do aplicativo), inserir um novo restaurante. Modifique o arquivo opcao.xml que encontra-se em res/menu.
1 2 3 4 5 6
Este item de mídia é padrão do Android, e pode ser encontrado no seu diretório de instalação do SDK, em platforms -> versão do Android que está usando (no meu caso, android-8 (ou 2.2)) -> data -> res -> tamanho de tela (podemos utilizar drawable-mdpi). Procure pelo ícone ic_menu_add.png. Copie-o e coloque na pasta res/drawable da sua aplicação. Para padronizar o nome, eu o renomeei para adicionar.png. Agora que já temos o menu, vamos ajustar a classe ListaRestaurantes para manipulá-lo corretamente. Vamos novamente implementar o método onCreateOptionsMenu():
62 63 64 65 66 67
@Override public boolean onCreateOptionsMenu(Menu menu) { new MenuInflater(this).inflate(R.menu.opcao, menu); return super.onCreateOptionsMenu(menu); }
E adicione, também, a implementação de onOptionsItemSelected():
70 71 72 73 74 75 76 77 78
@Override public boolean onOptionsItemSelected(MenuItem item) { if (item.getItemId() == R.id.adicionar) { startActivity(new Intent(ListaRestaurantes.this, FormularioDetalhes.class)); return true; } return super.onOptionsItemSelected(item); }
Bom, lá na nossa classe GerenciadorRestaurantes, temos o método para inserir um novo restaurante, mas não temos o método para atualizar. Portanto, adicione o seguinte método à classe:
Por fim, precisamos adicionar o comportamento do botão Salvar no formulário. Modifique a implementação do onSave na classe FormularioDetalhes para verificar se a operação é de inclusão ou alteração:
public class GerenciadorRestaurantes extends SQLiteOpenHelper { private static final String NOME_BANCO = "restaurantes.db"; private static final int VERSAO_SCHEMA = 1; public GerenciadorRestaurantes(Context context) { super(context, NOME_BANCO, null, VERSAO_SCHEMA); }
Configurando Preferências Vamos adicionar ao nosso aplicativo Lista de Restaurantes a opção do usuário configurar de que forma deve ocorrer a listagem dos restaurantes (nome, tipo, ordem alfabética, etc.). Pra começar, vamos criar um arquivo XML que tomará conta das configurações de preferência. Dessa forma, crie o arquivo preferencias.xml e coloque- o em res/xml (a pasta ainda não existe… então crie -a). O conteúdo dele será:
1 2 3 4 5 6 7 8 9
Em seguida, vamos criar o arquivo arrays.xml que definirá os dois arrays referenciados no XML definido acima. O arquivo arrays.xml deverá ser salvo na pasta res/values. Seu conteúdo é listado a seguir:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
Por Nome, AscendentePor Nome, DescendentePor TipoPor Endereço, AscendentePor Endereço, Descendentenome ASCnome DESCtipo, nome ASCendereco ASCendereco DESC
O próximo passo é a criação da Activity responsável pelas preferências. Vamos criar a classe EdicaoPreferencias, que estenderá PreferenceActivity, dentro do pacote com.blogspot.flavioaf.restaurante:
1 2 3 4 5 6 7 8 9 10 11 12 13 14
package com.blogspot.flavioaf.restaurante; import android.os.Bundle; import android.preference.PreferenceActivity; public class EdicaoPreferencias extends PreferenceActivity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); addPreferencesFromResource(R.xml.preferencias); } }
Também é necessário atualizar o arquivo AndroidManifest.xml, já que adicionamos uma nova Activity ao nosso projeto.
Continuando, vamos agora vincular a nossa nova Activity ao menu de opções. Primeiramente, vamos editar o arquivo opcao.xml, que se encontra em res/menu.
1 2 3 4 5 6 7 8 9
O ícone referenciado é padrão do sistema e, como mostrado no último tutorial, pode ser encontrado na própria instalação da SDK. Este ícone utilizado se chama ic_menu_preferences (aqui foi renomeado para menu_preferencias em nosso projeto). Agora, vamos modificar o método onOptionsItemSelected na classe ListaRestaurantes para mapear esta nova opção adicionada ao menu:
58 59 60 61 62 63 64
@Override public boolean onOptionsItemSelected(MenuItem item) { if (item.getItemId() == R.id.adicionar) { startActivity(new Intent(ListaRestaurantes.this, FormularioDetalhes.class)); return true; } else if (item.getItemId() == R.id.prefs) { startActivity(new Intent(this, EdicaoPreferencias.class));
Neste ponto, se você rodar a aplicação, já poderá conferir o menu:
Agora, já que a parte visual está pronta, vamos aplicar a ordenação a nossa lista. Primeiramente, precisamos que o método obterTodos() da classe GerenciadorRestaurantes precisa receber o método de ordenação por parâmetro e aplicá-lo a SQL. Modifique-o para que fique assim:
52 53 54 55
public Cursor obterTodos(String ordenacao) { return getReadableDatabase().rawQuery("select _id, nome, endereco, tipo, " + "anotacoes FROM restaurantes ORDER BY " + ordenacao, null); }
Agora, precisamos de um atributo na classe ListaRestaurantes que nos permita saber a ordenação selecionada e aplicá-la a listagem. Adicione um atributo à classe chamado prefs do tipo SharedPreferences.
26
SharedPreferences prefs = null;
Em seguida, adicione a inicialização do atributo no método onCreate(), próximo ao seu início.
Por fim, vamos fazer com que seja aplicada as alterações realizadas pelo usuário em tempo de execução, já que, por enquanto, é necessário fechar a aplicação para que a nova ordenação tenha efeito. Adicione esta linha ao fim do método onCreate():
Agora, referenciamos o recém-criado método inicializarLista() no método onCreate():
30 31 32 33 34 35 36 37 38 39
@Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); prefs = PreferenceManager.getDefaultSharedPreferences(this); gerenciador = new GerenciadorRestaurantes(this); inicializarLista(); prefs.registerOnSharedPreferenceChangeListener(prefListener); }
E então, também fazemos uma chamada ao método inicializarLista() dentro do nosso prefListener:
86 87 88 89 90 91 92 93 94
private OnSharedPreferenceChangeListener prefListener = new OnSharedPreferenceChangeListener() { public void onSharedPreferenceChanged(SharedPreferences sharedPreferences, String key) { if (key.equals("listagem")) { inicializarLista(); } } };
E pronto! Já temos o nosso aplicativo funcionando!
Ajustando o Layout para Paisagem (II) Vamos tratar da adaptação do layout da aplicação Lista de Restaurantes também para o modo paisagem. Neste tutorial vamos fazer a rotação de uma maneira mais organizada, evitando alguns problemas. Primeiramente, precisamos de uma forma de armazenar os valores no caso da mudança de orientação do celular. Lá na classe FormularioDetalhes, vamos sobrescrever o método onSaveInstanceState(), que armazenará os valores pra gente. Adicione a seguinte implementação ao final da classe:
Pronto. Já fizemos com que os valores do formulário fossem salvos. Agora, vamos implementar o método onRestoreInstanceState() que devolverá os dados no formulário.
Por fim, vamos definir novamente o nosso layout em modo paisagem. Crie novamente a pasta (se você a excluiu) res/layout-land e crie o arquivo form_detalhes.xml. Se você ainda tem o arquivo main.xml lá, exclua-o.
E pronto! Quanto a tela de listagem, não precisamos alterar seu layout pois ele funciona bem tanto em modo retrato quanto paisagem.
Observação A pós a última atualização do plugin ADT do Eclipse, ele acusou alguns ‘warnings‘ nos layouts XML. Por enquanto não se preocupem com isso!
Integrando Bibliotecas de Terceiros (Twitter) Veremos neste tutorial como integrar uma biblioteca externa ao nosso aplicativo em Android. Através dela, vamos vincular uma conta do Twitter ao restaurante e poderemos obter os últimos tweets referentes àquele restaurante. Para o acesso ao Twitter, utilizaremos a biblioteca twitter4j, que nos fornece acesso completo aos recursos da rede social. No tutorial vamos utilizar a versão 2.2.5 otimizada para Android (twitter4j-android-2.2.5), ou superior. O primeiro passo é adicionar a conta do Twitter ao nosso modelo de dados. Isso implica em modificar a classe de persistência GerenciadorRestaurantes. Comece alterando o método onCreate() para abrigar o novo campo no banco de dados:
18 19 20 21 22
@Override public void onCreate(SQLiteDatabase db) { db.execSQL("CREATE TABLE restaurantes (_id INTEGER PRIMARY KEY AUTOINCREMENT," + " nome TEXT, endereco TEXT, tipo TEXT, anotacoes TEXT, twitter TEXT);"); }
Além disso, vamos alterar a versão do Schema do banco, para que ele seja atualizado em versões anteriores:
12
private static final int VERSAO_SCHEMA = 2;
Precisamos também atualizar o nosso método onUpdate(), que antes não fazia nada. Ele será executado se o usuário possuir a versão antiga do banco. Nesse caso, iremos adicionar a nova coluna twitter a tabela restaurantes.
24 25 26 27
@Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { db.execSQL("ALTER TABLE restaurantes ADD COLUMN twitter TEXT"); }
Para concluir as modificações nesta classe, vamos atualizar os método obterTodos(), obterPorId(), inserir() e atualizar(). Além disso, também vamos adicionar o método obterTwitter():
valores.put("anotacoes", anotacoes); valores.put("twitter", twitter); getWritableDatabase().update("restaurantes", valores, "_id=?", argumentos); } public Cursor obterTodos(String ordenacao) { return getReadableDatabase().rawQuery("select _id, nome, endereco, tipo, " + "anotacoes, twitter FROM restaurantes ORDER BY " + ordenacao, null); } public String obterTwitter(Cursor c) { return c.getString(5); } public Cursor obterPorId(String id) { String[] argumentos = {id}; return getReadableDatabase().rawQuery( "SELECT _id, nome, endereco, tipo, anotacoes, twitter " + "FROM restaurantes WHERE _id = ?", argumentos); }
Pronto. Com relação aos dados do aplicativo, já estamos prontos. Vamos agora ajustar o formulário de detalhes, adicionando o campo Twitter em ambos. Lembre-se que, como temos duas versões deste formulário (res/layout e res/layout-land), precisaremos fazer a modificação em ambos. P rimeiramente o formulário para modo retrato (res/layout/form_detalhes.xml):
Basicamente, a única modificação é a adição do campo twitter e a remoção do TextView do campo anotações, exibido agora como o atributo hint. A mesma coisa fazemos no formulário do modo paisagem (res/layoutland/form_detalhes.xml):
private OnClickListener onSave = new OnClickListener() { public void onClick(View arg0) { String tipo = null; switch (tipos.getCheckedRadioButtonId()) { case R.id.rodizio: tipo = "rodizio"; break; case R.id.fast_food: tipo = "fast_food"; break; case R.id.a_domicilio: tipo = "a_domicilio"; break; } if (idRestaurante == null) { gerenciador.inserir(nome.getText().toString(), endereco.getText().toString(), tipo, anotacoes.getText().toString(), twitter.getText().toString()); } else { gerenciador.atualizar(idRestaurante, nome.getText().toString(), endereco.getText().toString(), tipo, anotacoes.getText().toString(), twitter.getText().toString()); } finish(); } };
Acompanharam? O próximo passo é adicionar a opção Twitter ao menu. Crie o novo arquivo opcao_detalhes.xml e o salve em res/menu. O ícone tem pra download junto com o projeto lá no final do tutorial.
1 2 3 4
Em seguida, adicione o método onCreateOptionsMenu() a classe FormularioDetalhes.
92 93 94 95 96 97
@Override public boolean onCreateOptionsMenu(Menu menu) { new MenuInflater(this).inflate(R.menu.opcao_detalhes, menu); return super.onCreateOptionsMenu(menu); };
Como vamos utilizar a conexão c onexão de rede do celular com a Internet, precisamos verificar se essa conexão está disponível. Vamos então criar os métodos redeDisponivel() e o método onOptionsItemSelected() lá na classe FormularioDetalhes:
@Override public boolean onOptionsItemSelected(MenuItem item) { if (item.getItemId() == R.id.twitter) { if (redeDisponivel()) { Intent i = new Intent(this, TwitterActivity.class); i.putExtra(TwitterActivity.PERFIL, twitter.getText().toString()); startActivity(i); } else { Toast.makeText(this, "Conexão com a Internet indisponível", Toast.LENGTH_LONG).show(); } return true; } return super.onOptionsItemSelected(item); } private boolean redeDisponivel() { ConnectivityManager cm = (ConnectivityManager) getSystemService(CONNECTIVITY_SERVICE); NetworkInfo info = cm.getActiveNetworkInfo(); return (info != null); }
Ao inserir estes dois métodos, o Eclipse vai chiar pela ausência da classe TwitterActivity. Calma! Já já resolveremos isso. Também precisaremos adicionar ao AndroidManifest.xml que nosso aplicativo precisa de permissão para acessar a rede. Assim, adicione as duas linhas seguintes ao arquivo, antes do nó application.
9 10
Agora vamos começar a mexer com a obtenção dos tweets propriamente ditos. Para adicionar a biblioteca (dentro do arquivo Zip baixado, vamos adicionar o arquivo twitter4j-core-android-2.2.5.jar (ou superior superior)) que se encontra dentro da pasta lib), clique com o botão direito sobre o projeto, selecione Properties, clique em Java Build Path, aba Libraries e clique no botão Add External JARs…. Localize o arquivo, e confirme.
Crie uma nova classe no pacote com.blogspot.flavioaf.restaurante chamada TwitterActivity estendendo ListActivity. Em seguida, adicione o mapeamento desta Activity no AndroidManifest.xml:
28 29
Agora, crie uma classe interna a classe TwitterActivity chamada TarefaTwitter:
Esta classe é a responsável por carregar os tweets da conta selecionada e enviá-los para a Activity (carregamento na linha 43 e atribuição para a Activity na linha 54). Sempre lembrando de corrigir os imports com o Ctrl + Shift + O Prosseguindo, vamos implementar os métodos da classe TwitterActivity referenciados pela cl asse TarefaTwitter. Primeiramente, vamos com o atirarErro():
Por fim, vamos fazer com que os tweets obtidos sejam exibidos. Dentro da TwitterActivity, vamos c riar a classe AdaptadorTweets que será responsável por adaptar os nossos tweets para a exibição.
private class AdaptadorTweets extends BaseAdapter { List status = null; AdaptadorTweets(List status) { super(); this.status = status; } public int getCount() { return status.size(); } public Object getItem(int position) { return status.get(position); } public long getItemId(int position) { return position; } public View getView(int position, View convertView, ViewGroup parent) { View linha = convertView; if (linha == null) { LayoutInflater inflater = getLayoutInflater(); linha = inflater.inflate(android.R.layout.simple_list_item_1, parent, false); } Status item = (Status) getItem(position); ((TextView) linha).setText(item.getText()); return linha; } }
Com este adaptador, vamos exibir os tweets em uma lista comum (android.R.layout.simple_list_item_1). Para gerenciar as instâncias da TarefaTwitter e da lista de tweets, vamos criar uma classe interna StatusInstance:
139 140 141 142
private static class StatusInstancia { List tweets = null; TarefaTwitter tarefa = null; }
Em seguida adicionamos um objeto desta classe como atributo da classe TwitterActivity:
22
private StatusInstancia status = null;
E implemente os métodos onCreate(), onRetainNonConfigurationInstance() e atribuirTweets().
@Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); status = (StatusInstancia) getLastNonConfigurationInstance(); if (status == null) { status = new StatusInstancia(); status.tarefa = new TarefaTwitter(this); status.tarefa.execute(getIntent().getStringExtra(PERFIL)); } else { if (status.tarefa != null) { status.tarefa.anexar(this); } if (status.tweets != null) { atribuirTweets(status.tweets); } } } @Override public Object onRetainNonConfigurationInstance() { if (status.tarefa != null) { status.tarefa.desanexar(); } return status; } private void atribuirTweets(List tweets) { status.tweets = tweets; setListAdapter(new AdaptadorTweets(tweets)); }
E no final, vamos criar o atributo PERFIL na classe:
21
public static final String PERFIL = "com.blogspot.flavioaf.PERFIL";
E prontinho! Cadastre um restaurante e adicione uma conta de Twitter!
Utilizando um IntentService No tutorial anterior, utilizamos uma AsyncTask para recuperar o conteúdo do Twitter. Isso foi necessário para que pudéssemos obter comunicação com a rede fora da thread principal do aplicativo e, portanto, evitar lentidão na interface. Outra forma de resolver esse problema é usando um IntentService. Um IntentService é um componente à parte que aceita comandos vindos de uma Activity, executa os comandos em linhas em background e, opcionalmente, responde às atividades ou o usuário. Neste tutorial, vamos configurar um IntentService como um substituto para a AsyncTask. Primeiramente, crie uma nova classe no pacote com.blogspot.flavioaf.restaurante chamada TwitterService, estendendo IntentService:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
package com.blogspot.flavioaf.restaurante; import android.app.IntentService; import android.content.Intent; public class TwitterService extends IntentService { public TwitterService() { super("TwitterService"); } @Override protected void onHandleIntent(Intent intent) { } }
Em seguida, vamos adicionar um novo nó service lá no arquivo AndroidManifest.xml logo após os nós activity, dentro do nó application.
29 30
O método onHandleIntent() da IntentService é chamado sempre em background, razão principal de a utilizarmos. Vamos começar com uma implementação inicial deste método lá na nossa classe TwitterService, importando parte da lógica que tínhamos no método doInBackground():
18 19 20 21 22 23 24 25 26 27
@Override protected void onHandleIntent(Intent intent) { Twitter t = new TwitterFactory().getInstance(); try { List resultado = t.getUserTimeline(intent.getStringExtra(PERFIL_EXTRA)); } catch (Exception ex) { Log.e("ListaRestaurantes", "Erro manipulando timeline twitter", ex); } }
Adicione também o atributo da classe referenciado no método, que servirá para obter o perfil do Twitter que obteremos os tweets.
14
public static final String PERFIL_EXTRA = "com.blogspot.flavioaf.PERFIL_EXTRA";
Continuando, precisamos agora enviar os tweets para a Activity. Para realizar a comunicação, utilizaremos um Messenger, que servirá para obtermos informações do serviço. Dessa forma, atualize a implementação do método onHandleIntent():
Para completar, só precisamos adicionar o atributo MESSENGER_EXTRA a nossa classe.
18
public static final String MESSENGER_EXTRA = "com.blogspot.flavioaf.MESSENGER_EXTRA";
Por fim, vamos fazer as modificações na TwitterActivity para que ela trabalhe com o TwitterService em vez da TarefaTwitter. Primeiramente, vamos converter a nossa TarefaTwitter para HandlerTwitter, que estenderá Handler em vez de AsyncTask. Os métodos anexar() e desanexar() serão mantidos para gerenciar as mudanças na configuração. Já o método doInBackground() será removido, já que a lógica foi movida para o serviço. O método onTutorialExecute() vira handleMessage(), para pegar o objeto Message do TwitterService, chamando os métodos atribuirTweets() ou atirarErro() dependendo do retorno do serviço. O resultado será esse:
Como não temos mais a TarefaTwitter, não precisamos mais dele no StatusInstancia. Porém, precisamos guardar nosso Handler como parte de nosso status, de forma que quando o usuário rotacionar a tela, nosso objeto Messenger ainda possa comunicar-se corretamente com a TwitterActivity. Assim, modifique a classe StatusInstancia:
122 123 124 125
private static class StatusInstancia { List tweets = null; HandlerTwitter handler = null; }
Assim, também precisaremos modificar o método onRetainNonConfigurationInstance() para acomodar o Handler em vez da tarefa.
44 45 46 47 48 49 50
@Override public Object onRetainNonConfigurationInstance() { if (status.handler != null) { status.handler.desanexar(); } return status; }
Por fim, vamos modificar o método onCreate() para trabalhar com o TwitterService, criando o Messenger caso o status seja nulo, ou anexando-o caso já exista:
@Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); status = (StatusInstancia) getLastNonConfigurationInstance(); if (status == null) { status = new StatusInstancia(); status.handler = new HandlerTwitter(this); Intent i = new Intent(this, TwitterService.class); i.putExtra(TwitterService.PERFIL_EXTRA, getIntent().getStringExtra(PERFIL)); i.putExtra(TwitterService.MESSENGER_EXTRA, new Messenger(status.handler)); startService(i); } else { if (status.handler != null) {
Pronto! Já podemos executar novamente o aplicativo, mas nenhuma mudança deve ser percebida. Se nenhuma mudança é percebida, por que tudo isso? Bem, pode ser que neste caso a diferença não seja visível,
mas imagine que em vez dos tweets fôssemos baixar um vídeo. Utilizando o IntentService, a operação ocorre sem estar vinculada a nenhuma Activity. Ou seja, o usuário não precisa ficar esperando o download terminar para continuar. O IntentService fará o download por si próprio e se auto-destruirá quando terminar.
Integrando o GPS Depois de fazer nosso aplicativo de lista de restaurantes buscar tweets, vamos agora utilizar outro recurso presente nos smartphones: o GPS. Neste tutorial, faremos com que, no momento em que o restaurante for cadastrado, ele guarde a sua localização (contando que o cadastro esteja sendo feito no próprio restaurante) e salve junto ao registro daquele restaurante. Interessante, não? Pra começar, vamos adicionar os dados de latitude e longitude em nosso modelo de dados. Primeiramente, modifique o método onCreate da classe GerenciadorRestaurantes.
18 19 20 21 22 23
@Override public void onCreate(SQLiteDatabase db) { db.execSQL("CREATE TABLE restaurantes (_id INTEGER PRIMARY KEY AUTOINCREMENT," + " nome TEXT, endereco TEXT, tipo TEXT, anotacoes TEXT, twitter TEXT," + " latitude REAL, longitude REAL);"); }
Tal modificação exige que atualizemos a versão do schema do banco de dados:
12
private static final int VERSAO_SCHEMA = 3;
Na hora de modificarmos o método onUpdate() devemos ficar atentos. Precisamos prepará-lo para atualizar bancos tanto com o schema 1 quanto com o schema 2.
25 26 27 28 29 30 31 32 33 34 35
@Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { if (oldVersion < 2) { db.execSQL("ALTER TABLE restaurantes ADD COLUMN twitter TEXT"); } if (oldVersion < 3) { db.execSQL("ALTER TABLE restaurantes ADD COLUMN latitude REAL"); db.execSQL("ALTER TABLE restaurantes ADD COLUMN longitude REAL"); } }
Precisaremos atualizar também os métodos obterTodos() e obterPorId() para abranger também os novos campos.
62 63 64 65 66 67 68 69 70 71 72 73 74
public Cursor obterTodos(String ordenacao) { return getReadableDatabase().rawQuery("select _id, nome, endereco, tipo, " + "anotacoes, twitter, latitude, longitude FROM restaurantes ORDER BY " + ordenacao, null); } public Cursor obterPorId(String id) { String[] argumentos = {id}; return getReadableDatabase().rawQuery( "SELECT _id, nome, endereco, tipo, anotacoes, twitter, latitude," + " longitude FROM restaurantes WHERE _id = ?", argumentos); }
Como não vamos inserir diretamente as coordenadas de latitude e longitude diretamente (pedir pro usuário digitar é picardia, né?), não precisaremos nos preocupar com os métodos inserir() e atualizar(). Criaremos um método atualizarLocalizacao().
O método obviamente só funcionará para restaurantes que já existam no banco de dados, restrições que iremos aplicar através da interface. Por fim, vamos criar os dois métodos para obter os valores de latitude e longitude de um Cursor lido do banco.
98 99 100 101 102 103 104
public double obterLatitude(Cursor c) { return c.getDouble(6); } public double obterLongitude(Cursor c) { return c.getDouble(7); }
Precisamos agora adicionar um lugar para exibir as coordenadas GPS na tela. Na nossa interface, uma porção considerável da tela é ocupada pelo botão Salvar. Na maioria das interfaces, este botão não está presente. Assim, temos duas abordagens para resolver a situação: (1) Adicionar uma opção no menu para salvar ou; (2) Salvar automaticamente quando a Activity passar para o estado de pausa No caso, iremos utilizar a segunda abordagem, para salvar sempre que o usuário pressionar a tecla voltar ou home. Para isso, precisaremos nos desfazer de todas as referências ao botão salvar na classe FormularioDetalhes. Para começar, vamos converter o objeto onSave para um método chamado salvar().
private void salvar() { String tipo = null; switch (tipos.getCheckedRadioButtonId()) { case R.id.rodizio: tipo = "rodizio"; break; case R.id.fast_food: tipo = "fast_food"; break; case R.id.a_domicilio: tipo = "a_domicilio"; break; } if (idRestaurante == null) { gerenciador.inserir(nome.getText().toString(), endereco.getText().toString(),
Remova as linhas que fazem referência ao botão no método onCreate() e implemente o método onPause() que faz a chamada ao método salvar().
48 49 50 51 52 53
@Override public void onPause() { salvar(); super.onPause(); }
O próximo passo é modificar o layout do formulário, removendo o botão salvar e adicionando a opção de menu para obter a localização do GPS. Primeiramente, vamos modificar o layout para o modo retrato (res/layout/form_detalhes.xml).
Também precisamos adicionar no menu a opção para obter a localização. Modifique o arquivo de menu em res/menu/opcao_detalhes.xml.
1 2 3 4 5 6 7 8 9
O ícone pode ser encontrado lá na pasta do SDK sob o nome de ic_menu_compass.png (renomeado para gps.png). Em seguida, vamos adicionar a permissão de acessar a localização, através do arquivo AndroidManifest.xml. Adicione a seguinte linha junto às outras permissões:
11
O próximo passo é obter a localização de fato. Primeiramente, adicione o atributo locationManager na classe FormularioDetalhes:
28
LocationManager locationManager = null;
Em seguida, adicione a sua localização no método onCreate():
Agora, precisamos fazer a chamada ao método requestLocationUpdates() da classe LocationManager para pedir a localização quando o usuário selecionar o botão no menu. Dessa forma, modifique o método onOptionsItemSelected():
@Override public boolean onOptionsItemSelected(MenuItem item) { if (item.getItemId() == R.id.twitter) { if (redeDisponivel()) { Intent i = new Intent(this, TwitterActivity.class); i.putExtra(TwitterActivity.PERFIL, twitter.getText().toString()); startActivity(i); } else { Toast.makeText(this, "Conexão com a Internet indisponível", Toast.LENGTH_LONG).show(); } return true; } else if (item.getItemId() == R.id.localizacao) { locationManager.requestLocationUpdates(LocationManager.GPS_PROVIDER, 0, 0, onLocationChange); } return super.onOptionsItemSelected(item); }
Como pode ser percebido, adicionamos um listener para obter o resultado a chamada. Por isso, vamos implementar o objeto onLocationChange como um atributo da classe FormularioDetalhes:
177 178 179 180 181 182
LocationListener onLocationChange = new LocationListener() { public void onLocationChanged(Location location) { gerenciador.atualizarLocalizacao(idRestaurante, location.getLatitude(), location.getLongitude()); localizacao.setText(String.valueOf(location.getLatitude()) + ", " +
String.valueOf(location.getLongitude())); locationManager.removeUpdates(onLocationChange); Toast.makeText(FormularioDetalhes.this, "Localização salva", Toast.LENGTH_LONG); } public void onProviderDisabled(String provider) { // Requerido pela interface. Não utilizado } public void onProviderEnabled(String provider) { // Requerido pela interface. Não utilizado } public void onStatusChanged(String provider, int status, Bundle extras) { // Requerido pela interface. Não utilizado } };
No caso, obtemos os dados do GPS, atualizamos o banco e a interface e exibimos uma mensagem para o usuário. Porém, pode ocorrer do usuário sair da tela enquanto a requisição estiver sendo processada. Neste caso, é sensato cancelá-la para evitar problemas. Assim, atualize o método onPause():
55 56 57 58 59 60 61
@Override public void onPause() { salvar(); locationManager.removeUpdates(onLocationChange); super.onPause(); }
Por fim, precisamos controlar para somente exibir a opção de obter os dados do GPS se o restaurante já tiver sido salvo no banco de dados. Adicione a implementação do método onPrepareOptionsMenu():
69 70 71 72 73 74 75 76
@Override public boolean onPrepareOptionsMenu(Menu menu) { if (idRestaurante == null) { menu.findItem(R.id.localizacao).setEnabled(false); } return super.onPrepareOptionsMenu(menu); }
Pront! Vamos testar?
Os dois primeiros screenshots foram feitos no emulador e o último foi feito usando um celular real (LG Optimus One). Caso você não tenha um celular real para testar, você pode emular coordenadas GPS conectando via telnet no localhost porta 5554. No console que aparecer, digite o comando:
1
geo fix
Onde e devem ser os valores desejados (você consegue pegar os valores de um lugar facilmente usando o Google Maps).
Alterando o Ícone do Launcher Esse tutorial é curtinho. Nele vamos modificar o ícone do launcher do nosso aplicativo e corrigir um bug que tínhamos até então (que fazia o aplicativo encerrar inesperadamente e não funcionava novamente caso fosse pressionada a tecla voltar no formulário sem preencher nada – provavelmente você nem tenha percebido). Primeiramente, para alterar o ícone, devemos encontrar um ícone no formato PNG com dimensões de 72x72px . A Google possui algumas orientações de design para a confecção deste ícone. É sempre bom seguir tais recomendações caso você venha a disponibilizar seu aplicativo na Play Store (antigo Android Market). Para ler sobre o assunto, basta clicar aqui e aqui. Como no nosso caso é apenas um tutorial, encontre um ícone qualquer que lhe agrade, renomeie-o para ic_launcher.png e coloque-o na pasta res/drawable. E… pronto!
Caso, por algum motivo, você queria colocar o ícone com outro nome, pode utilizá-lo alterando a propriedade android:icon do nó application no arquivo AndroidManifest.xml. Bom, e quanto ao nosso “bug”, o que ocorre é que, caso não preenchemos nada e apertamos a tecla voltar, o
aplicativo tenta salvar valores nulos no banco de dados, o que acaba ocasionando uma exceção (exception). Para corrigir, basta controlar para que a gravação ou atualização não seja feita caso os valores básicos (nome, endereço e tipo) não sejam preenchidos. Assim, altere o método salvar() da classe FormularioDetalhes.
82 83 84 85 86 87
private void salvar() { String tipo = null; switch (tipos.getCheckedRadioButtonId()) { case R.id.rodizio: tipo = "rodizio";
break; case R.id.fast_food: tipo = "fast_food"; break; case R.id.a_domicilio: tipo = "a_domicilio"; break; } if (tipo != null && endereco.getText().toString() != null && nome.getText().toString() != null) { if (idRestaurante == null) { gerenciador.inserir(nome.getText().toString(), endereco.getText().toString(), tipo, anotacoes.getText().toString(), twitter.getText().toString()); } else { gerenciador.atualizar(idRestaurante, nome.getText().toString(), endereco.getText().toString(), tipo, anotacoes.getText().toString(), twitter.getText().toString()); } } finish(); }
Pronto!
Integrando com o Google Maps Vamos aproveitar as coordenadas do GPS obtidas com o tutorial do GPS e inseri-las em um mapa provido pelo Google Maps. Portanto, precisaremos que ele esteja instalado no emulador ou no seu celular para tal funcionalidade. Além disso, você também precisará de uma chave de desenvolvimento para que possa ocorrer a integração. Neste link, você obtém as informações necessárias sobre como conseguir esta chave. Começando, vamos adicionar a opção para a visualização do mapa no FormularioDetalhes. Dessa forma, modifique o arquivo res/menu/opcao_detalhes.xml:
1 2 3 4 5 6 7 8 9 10 11 12
O ícone do menu (mapa.png) é o ícone ic_menu_mapmode.png, devidamente renomeado, que pode ser encontrado lá na pasta da sua instalação do Android SDK. Em seguida, vamos modificar o método onPrepareOptionsMenu() no FormularioDetalhes para somente habilitar esta opção quando já houverem as informações básicas do restaurante (edição).
75 76 77 78 79 80 81 82 83
@Override public boolean onPrepareOptionsMenu(Menu menu) { if (idRestaurante == null) { menu.findItem(R.id.localizacao).setEnabled(false); menu.findItem(R.id.mapa).setEnabled(false); } return super.onPrepareOptionsMenu(menu); }
O próximo passo é criar uma Activity que será responsável por exibir o nosso mapa. Porém, antes disso, vamos informar ao arquivo AndroidManifest.xml que nossa aplicação fará uso da API do Google Maps. Dessa forma, dentro do nó application, adicione a seguinte linha:
16
Em seguida, vamos criar uma nova classe no pacote principal do projeto (com.blogspot.flavioaf.restaurante), com o nome de MapaRestaurante. Esta classe estenderá MapActivity. Inicialmente teremos o método onCreate(), onde simplesmente atribuiremos seu layout, e isRouteDisplayed(), método abstrato exigido. Neste segundo, por ora simplesmente retornaremos falso.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
package com.blogspot.flavioaf.restaurante; import android.os.Bundle; import com.google.android.maps.MapActivity; public class MapaRestaurante extends MapActivity { @Override public void onCreate(Bundle icicle) { super.onCreate(icicle); setContentView(R.layout.mapa); } @Override protected boolean isRouteDisplayed() { return false; } }
O próximo passo é modificar o método onOptionsItemSelected() para que inicie a Activity MapaRestaurante.
@Override public boolean onOptionsItemSelected(MenuItem item) { if (item.getItemId() == R.id.twitter) { if (redeDisponivel()) { Intent i = new Intent(this, TwitterActivity.class); i.putExtra(TwitterActivity.PERFIL, twitter.getText().toString()); startActivity(i); } else { Toast.makeText(this, “Conexão com a Internet indisponível”, Toast.LENGTH_LONG
Alarmes Veremos como criar um alarme para nos avisar a hora do almoço (tudo a ver com o aplicativo de restaurante, não?). O primeiro passo é criarmos uma forma para o usuário configurar o horário em que ele deseja ser avisado do almoço. Poderíamos definir isto em uma Activity, mas esta opção soa mais como uma configuração. Dessa forma, vamos criar a classe PreferenciaHorario no pacote com.blogspot.flavioaf.restaurante, estendendo a classe DialogPreference. Logo em seguida explicarei os conceitos principais dela.
if (positiveResult) { ultimaHora = picker.getCurrentHour(); ultimoMinuto = picker.getCurrentMinute(); String tempo = String.valueOf(ultimaHora) + ":" + String.valueOf(ultimoMinuto); if (callChangeListener(tempo)) { persistString(tempo); } } } @Override protected Object onGetDefaultValue(TypedArray a, int index) { return a.getString(index); } @Override protected void onSetInitialValue(boolean restorePersistedValue, Object defaultValue) { String tempo = null; if (restorePersistedValue) { if (defaultValue == null) { tempo = getPersistedString("00:00"); } else { tempo = getPersistedString(defaultValue.toString()); } } else { tempo = defaultValue.toString(); } ultimaHora = obterHora(tempo); ultimoMinuto = obterMinuto(tempo); } }
Muita coisa? Vamos por partes. Os métodos obterHora() e obterMinuto() servem para extrair a parte inteira do horário que será armazenado como uma string “00:00“. Temos três versões do construtor da classe, que no final sempre referenciam o terceiro. Isso é
devido à superclasse. Ainda no construtor, definimos os nomes dos botões na janela de configuração de horário. onCreateDialogView() devolve um objeto View com a tela criada. Poderíamos aqui definirmos um layout, mas simplesmente devolvemos um widget TimePicker. O método onBindDialogView() é chamado após o onCreateDialogView() é encarregado de preencher a caixa de diálogo. onDialogClose(), como o próprio nome diz, é chamado quando a janelinha é encerrada. Caso o usuário pressione o botão de confirmar (condição positiveResult), o valor é armazenado em SharedPreferences. O método onGetDefaultValue() é utilizado para a c onversão interna do Android para o tipo do objeto. Por último, o método onSetInitialValue(), como o próprio nome diz, atribui um valor padrão. Ele verifica se há algum valor já salvo, ou padrão ou então atribui 00:00. O próximo passo é adicionar a opção para a configuração do alarme pelo usuário. Dessa forma, edite o arquivo preferencias.xml da seguinte forma:
1 2 3 4 5 6
7 8 9 10 11 12 13 14 15 16 17 18 19
android:entryValues="@array/opcoes_ordenacao" android:dialogTitle="Escolha o modo de listagem" />
A primeira opção adicionada, do tipo CheckBoxPreference não tem muito segredo… a segunda, foi a que definimos
na classe PreferenciaH0rario. Configuramos seu valor padrão para 12:00 e definimos que ela depende da opção alarme, ou seja, ela só estará habilitada caso alarme também esteja habilitada. Neste projeto vamos utilizar o AlarmManager para gerenciar o nosso alarme. Porém, ele tem uma falha: toda vez que o celular é desligado, ao ligar novamente os alarmes não são configurados. Para resolver isso, vamos criar a classe ReceptorBoot para realizar essa configuração toda vez que o sistema for ligado. Crie-a no pacote com.blogspot.flavioaf.restaurante.
1 2 3 4 5 6 7 8 9 10 11 12 13
package com.blogspot.flavioaf.restaurante; import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; public class ReceptorBoot extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { } }
A tarefa do ReceptorBoot será realizado no método onReceive(). Por enquanto, coloque-o pra descansar. Já já voltamos nele. Prosseguindo, precisamos adicionar o nó no arquivo AndroidManifest.xml para que ele possa atuar no boot. Adicione-o ao final do nó application.
39 40 41 42 43 44
Além disso, adicione também a permissão para obter o sinal de boot completo do sistema.
12
Precisamos agora tratar as preferências do usuário para configurar o alarme. Quando o usuário ativar o checkbox do alarme, precisamos ativar o alarme no tempo selecionado. Quando o usuário modificar o alarme (por exemplo, para 11:00), devemos criar um novo alarme com o AlarmManager. Se ele desativar, precisamos cancelar o alarme existente. E, por fim, em um processo de boot, se o alarme estiver selecionado, precisamos criá-lo. Para fazer todo esse trabalho, adicione os seguintes métodos na classe ReceptorBoot. Para corrigir os imports, só lembrar do Ctrl + Shift + O.
@Override public void onReceive(Context context, Intent intent) { configurarAlarme(context); }
Bem, no código listado acima, primeiramente, ao receber o sinal do boot (método onReceive()), configuramos o alarme, através do método configurarAlarme(). Neste método, obtemos o AlarmManager, e obtemos as preferências do usuário para o alarme (se existirem), e a montamos em um objeto do tipo Calendar. Caso alarme seja anterior ao horário atual, adicionamos um dia a ele e configuramos para repeti-lo diariamente. Já no método cancelarAlarme(), cancelamos o alarme vinculado ao contexto, obtendo o AlarmManager e obtendo um objeto PendingIntent (como se fosse uma tarefa pendente) com o método obterIntentPendente(). No código que temos até agora, o alarme só é armado na inicialização do sistema. Para que ele funcione da maneira como desejamos, precisamos adicionar alguns método a classe EdicaoPreferencias:
@Override protected void onResume() { super.onResume(); preferencias = PreferenceManager.getDefaultSharedPreferences(this); preferencias.registerOnSharedPreferenceChangeListener(onChange); } @Override protected void onPause() { preferencias.unregisterOnSharedPreferenceChangeListener(onChange); super.onPause(); } OnSharedPreferenceChangeListener onChange = new SharedPreferences.OnSharedPreferenceChangeListener() { public void onSharedPreferenceChanged(SharedPreferences sharedPreferences, String key) { if ("alarme".equals(key)) { boolean habilitado = preferencias.getBoolean(key, false); int flag = (habilitado ? PackageManager.COMPONENT_ENABLED_STATE_ENABLED : PackageManager.COMPONENT_ENABLED_STATE_DISABLED); ComponentName componente = new ComponentName(EdicaoPreferencias.this, ReceptorBoot.class); getPackageManager().setComponentEnabledSetting(componente, flag, PackageManager.DONT_KILL_APP); if (habilitado) { ReceptorBoot.configurarAlarme(EdicaoPreferencias.this); } else { ReceptorBoot.cancelarAlarme(EdicaoPreferencias.this); } } else if ("horario_alarme".equals(key)) { ReceptorBoot.cancelarAlarme(EdicaoPreferencias.this); ReceptorBoot.configurarAlarme(EdicaoPreferencias.this); } } };
Lembre-se também de adicionar o membro privado da classe chamado preferencias:
13
SharedPreferences preferencias = null;
O que nos falta fazer é criar um receptor que exiba o alarme na tela quando o alarme disparar. Para isso, primeiramente crie o arquivo alarme.xml na pasta res/layout:
1 2 3 4 5 6 7
Bastante simples, ele simplesmente exibirá bem grande na tela Hora do almoço!. Agora vamos criar a Activity que exibirá o aviso propriamente dito. Crie a classe AlarmeActivity no pacote com.blogspot.flavioaf.restaurante:
Crie também uma classe chamada ReceptorAlarme que será encarregada de iniciar a AlarmeActivity.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
package com.blogspot.flavioaf.restaurante; import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; public class ReceptorAlarme extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { Intent i = new Intent(context, AlarmeActivity.class); i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); context.startActivity(i); } }
Para terminarmos falta somente adicionarmos esse último receptor no AndroidManifest.xml. Adicione-o no fim do nó application.
45 46
E é isso!
Notificações No tutorial anterior vimos como utilizar alarmes em nossos aplicativos utilizando o AlarmManager. Porém, o alarme que definimos era exibido em tela cheia e, talvez, isso nem sempre é interessante. Agora veremos como adicionar a opção para o caso do usuário preferir uma notificação simples em vez de exibir ela em tela cheia. O primeiro passo é adicionarmos mais essa opção no menu de opções. Assim, edite o arquivo preferencias.xml para adicionar um novo CheckBoxPreference.
@Override public void onReceive(Context context, Intent intent) { SharedPreferences preferencias = PreferenceManager.getDefaultSharedPreferences(context); boolean usarNotificacao = preferencias.getBoolean("usar_notificacao", true); if (usarNotificacao) { NotificationManager gerenciador = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE); Notification nota = new Notification(R.drawable.notificacao, "Hora do Almoço!", System.currentTimeMillis()); PendingIntent i = PendingIntent.getActivity(context, 0, new Intent(context, AlarmeActivity.class), 0); nota.setLatestEventInfo(context, "Lista de Restaurantes", "Hora do Almoço! Está com fome?", i); nota.flags |= Notification.FLAG_AUTO_CANCEL; gerenciador.notify(ID_NOTIFICACAO, nota); } else { Intent i = new Intent(context, AlarmeActivity.class); i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); context.startActivity(i); }
Para essa operação, será necessário adicionarmos um atributo na classe, que é basicamente um número único para diferenciar esta notificação de outras que, eventualmente, venhamos utilizar em nosso aplicativo. O ícone referenciado no aplicativo é o ícone de notificação do GTalk, que pode ser obtido no diretório de instalação da SDK sob o nome de stat_notify_chat. Caso deseje utilizar outro, fique à vontade. E pronto! Já temos nosso aplicativo funcionando. Configure o alarme e realize seus testes.
Internacionalização (i18n) Veremos como traduzir nossa aplicação para que ela se torne multi-linguagem. Isso é bastante interessante caso você tenha a intenção de colocar sua aplicação lá no Google Play. Bom, o grande “segredo” da internacionalização consiste na pasta values do projeto. Nes sa pasta, no caso do nosso
projeto, temos hoje o arquivo arrays.xml e strings.xml. Esses arquivos irão conter valores correspondentes a cada um dos idiomas que nossa aplicação suportará. Hoje, temos nossa aplicação com o idioma padrão Português. Como o emulador do Android 2.2 não tem o idioma português, vamos deixá-lo como padrão mesmo, e adicionar suporte ao idioma Espanhol1 Para início de conversa, vamos preparar nosso aplicativo para a internacionalização. Modifique o arquivo strings.xml para que contenha os seguintes valores:
Hello World, ListaRestaurantes!Lista de RestaurantesNome:Endereço:Tipo:RodízioFast FoodA DomicílioLocalização (não atribuída)AnotaçõesConta do TwitterHora do Almoço!Descartado.Conexão com a Internet indisponívelLocalização salvaDefinirCancelarHora do Almoço! Está com fome?Erro manipulando timeline TwitterErro enviando dados para a ActivityTimeline TwitterSalvar LocalizaçãoExibir MapaAdicionarConfiguraçõesModo de ListagemEscolha o modo de listagem a ser utilizadoEscolha o modo de listagemTocar Alarme no AlmoçoMarque se deseja ser informado sobre a hora do almoçoHorário do Alarme do AlmoçoConfigure seu horário desejado para o alarmeAtivar NotificaçãoMarque caso deseje um ícone na barra de status, ou desmarque para a notificação em tela cheia
Basicamente, definimos alguns alias para as strings do nosso aplicativo. Porém, em alguns trechos do código, ainda temos strings como constantes de texto. Para isso, vamos alterá-los para utilizar os resources deste arquivo. Primeiramente, nos formulários e menus em XML, vamos alterar o s arquivos form_detalhes.xml, tanto na pasta layout…
1
As sentenças mostradas foram todas traduzidas com o auxílio do Google Tradutor e podem não estar totalmente corretas.
Caso a aplicação seja executada agora, ela deve rodar normalmente como rodava antes. Agora, vamos criar os arquivos relativos ao novo idioma. Crie um novo diretório no projeto chamado values-es na pasta res. Dentro dele, teremos 2 arquivos XML, arrays.xml…
1 2 3 4 5 6 7 8
Por Nombre, AscendentePor Nombre, DescendentePor TipoPor Dirección, AscendentePor Dirección, Descendente
9 10 11 12 13 14 15 16 17
nome ASCnome DESCtipo, nome ASCendereco ASCendereco DESC
Hello World, ListaRestaurantes!Lista de RestaurantesNombre:Dirección:Tipo:RotaciónComida RápidaUbicaciónPosición (sin asignar)AnotacionesCuenta de TwitterLa Hora del Almuerzo!Tirado.Conexión com la Internet no está disponiblePosición salvaDefinirCancelarLa Hora del Almuerzo! ¿Tienes hambre?Error de Línea de Tiempo de TwitterErros al enviar datos a la ActivityLínea de Tiempo de TwitterGuardar PosiciónVer MapaAñadirAjustesModo de ListaElija el modo de lista que se utilizaElija el modo de listaReproducir Alarma en el AlmuerzoSelecciona se desea recibir información sobre la hora del almuerzoLa Hora del AlmuerzoAjuste el tiempo deseado para el alarmaHabilitar NotificaciónSeleccione si desea un icono en la barra de estado o borrar la notificación en pantalla completa
E pronto! Para ver seu aplicativo no idioma espanhol, siga até o menu principal, Settings -> Language & keyboard -> Select language e selecione Español.
Widgets Pra quem não sabe, widgets é uma espécie de miniatura do aplicativo que você pode deixar em uma das áreas de trabalho do Android, colocando à disposição do usuário informações de maneira mais rápida e prática. O widget também pode redirecionar o usuário para o aplicativo principal, funcionando como uma espécie de “atalho”.
Primeiramente, precisamos definir o layout do nosso widget. Para isso, crie o arquivo widget.xml dentro da pasta res/layout. Ele será bastante simples, inicialmente apenas exibindo o nome de um restaurante cadastrado. Sendo assim, ele terá apenas um TextView em sua estrutura:
1 2 3 4 5 6 7 8 9 10 11 12 13
De diferente do que já fizemos das outras vezes, somente as propriedades que modificam o tamanho e a cor do texto. No mais, tudo dentro dos conformes. O arquivo frame.9.png pode ser baixado aqui. Por que este 9? Porque a imagem é uma NinePatch, ideal para compor fundos de frames. Entenda melhor como funciona aqui.
frame.9.png
original
ampliado (só por curiosidade)
O próximo passo é criarmos uma classe para gerenciar o conteúdo do widget. Inicialmente, apenas crie uma classe chamada WidgetAplicativo dentro do pacote com.blogspot.flavioaf.restaurante, estendendo AppWidgetProvider.
1 2 3 4 5 6
package com.blogspot.flavioaf.restaurante; import android.appwidget.AppWidgetProvider; public class WidgetAplicativo extends AppWidgetProvider { }
Continuando, vamos agora definir algumas propriedades do widget em um arquivo XML. Crie dentro da pasta res/xml o arquivo provedor_widget.xml.
1 2 3 4 5 6 7
Basicamente definimos a largura e altura mínimas, o tempo de atualização das informações do widget (no caso, dos restaurantes – a cada 30 minutos) e qual o layout a ser utilizado por ele (no caso, o que definimos no XML anterior). Em seguida, precisamos atualizar o AndroidManifest.xml para que o nosso aplicativo suporte o widget. Adicione o seguinte nó receiver ao final do nó application.
Neste trecho, definimos que a classe que representa o widget é a WidgetApp, que o nome e o ícone a serem exibidos nas opções são os mesmos da aplicação no menu (app_name e ic_launcher). Além disso, definimos que o widget realizará operações de atualização e que suas propriedades estão definidas no arquivo provedor_widget dentro da pasta xml. Por fim, vamos implementar o método onUpdate() para a classe WidgetApp. É este método que fará a busca em nosso banco de dados para exibir o nome de um restaurante.
Cria um objeto RemoteView, que nos permite modificar o widget; Estabelece uma conexão com o banco de dados; Verifica quantos restaurantes salvos existem; Carrega um restaurante aleatório (por isso o uso de Math.random()); Exibe o nome do restaurante, ou uma mensagem dizendo que não existem restaurantes cadastrados; Atualiza o widget propriamente dito.
A mensagem “vazio” (R.string.vazio) deve ser definida nos seus ar quivos string.xml nas pastas values que você tem. No meu caso, vou defini-la em português e em espanhol (idiomas que minha aplicação suporta).
string.xml em português: 38
Nenhum registro.
string.xml em espanhol: 38
Ningún registro.
E pronto! Para ativar o widget, clique e segure sobre a área de trabalho para aparecer o menu e a opção de inserir widget.
Até agora vimos como criar um widget simples com o nome do restaurante. Vamos incrementá-lo em dois pontos principais: (1) ele terá um botão que mudará o restaurante que é exibido, mostrando outro aleatoriamente e; (2) ao tocar sobre o nome do restaurante no widget, é aberto o formulário para que você possa ver as outras informações sobre aquele restaurante. O primeiro passo é adicionarmos o botão ao layout de nosso widget. Dessa forma, abra o arquivo widget.xml que está em res/layout e faça a adição da imagem do botão, do tipo ImageButton:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
Os atributos, no ponto em que estamos, não devem ser nenhuma surpresa. Neste ponto, já deve ser possível vê-lo no layout ao recompilar a aplicação.
O arquivo de imagem do ícone pode ser baixado aqui. No tutorial anterior, toda a nossa lógica de consulta ao banco estava dentro do método onUpdate() do nosso widget. Isso funciona bem, mas, caso a lógica se expanda muito, corremos o risco da atualização demorar mais que o esperado e comprometer o desempenho da aplicação, já que o método é chamado em nossa thread principal. Para melhorar isso, vamos novamente fazer uso de um IntentService que nos possibilita a realizar a consulta de modo assíncrono, sem comprometer o sistema. Portanto, crie uma classe chamada WidgetService e coloque-a no pacote com.blogspot.flavioaf.restaurante. Esta classe, que estenderá IntentService abrigará a lógica que estávamos executando no widget.
RemoteViews atualizarFrame = new RemoteViews("com.blogspot.flavioaf.restaurante", R.layout.widget); GerenciadorRestaurantes gerenciador = new GerenciadorRestaurantes(this); AppWidgetManager mgr = AppWidgetManager.getInstance(this); try { Cursor c = gerenciador.getReadableDatabase().rawQuery("SELECT COUNT(*) FROM restaurantes", null); c.moveToFirst(); int contador = c.getInt(0); c.close(); if (contador > 0) { int deslocamento = (int) (contador * Math.random()); String args[] = {String.valueOf(deslocamento)}; c = gerenciador.getReadableDatabase().rawQuery("SELECT _id, nome FROM restaurantes LIMIT 1 OFFSET ?", args); c.moveToFirst(); atualizarFrame.setTextViewText(R.id.nome, c.getString(1)); c.close(); } else { atualizarFrame.setTextViewText(R.id.nome, getString(R.string.vazio)); } } finally { gerenciador.close(); } mgr.updateAppWidget(cn, atualizarFrame); } }
Basicamente o que fizemos foi passar a lógica para o nosso WidgetService. O próximo passo é adicionar esse nosso serviço lá no arquivo AndroidManifest.xml para que ele possa funcionar. Assim, adicione ao fim do nó application a seguinte linha:
57
Agora, vamos atualizar a classe WidgetAplicativo para que faça uso do nosso serviço.
public class WidgetAplicativo extends AppWidgetProvider { @Override public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { context.startService(new Intent(context, WidgetService.class)); } }
Pronto. A parte mais “complicada” está feita. Agora precisamos apenas gerenciar os toques no botão e no nome do
restaurante. Primeiramente, vamos fazer com que um novo restaurante seja exibido caso seja acionado o botão. Para esse processo, utilizaremos um PendingIntent para acionar a nossa Intent qua ndo o “clique” for realizado.
Para isso, adicione as seguintes linhas ao final do método onHandleEvent() da classe WidgetService:
50 51 52 53
Intent i = new Intent(this, WidgetService.class); PendingIntent pi = PendingIntent.getService(this, 0, i, 0); atualizarFrame.setOnClickPendingIntent(R.id.proximo, pi); mgr.updateAppWidget(cn, atualizarFrame);
Com isso, toda vez que o botão for acionado, o nosso serviço de carregamento será executado novamente. Por fim, precisamos agora gerenciar para que, ao tocar sobre o nome do restaurante, seja aberta a tela com o formulário. Para isso, precisaremos de realizar algumas mudanças sutis no método onHandleIntent(). As principais são que, além do nome, precisaremos também do identificador, pois através dele iremos c arregar os dados no formulário. Além disso, também utilizaremos um PendingIntent para acionar a exibição do formulário.
@Override protected void onHandleIntent(Intent intent) { ComponentName cn = new ComponentName(this, WidgetAplicativo.class); RemoteViews atualizarFrame = new RemoteViews("com.blogspot.flavioaf.restaurante", R.layout.widget); GerenciadorRestaurantes gerenciador = new GerenciadorRestaurantes(this); AppWidgetManager mgr = AppWidgetManager.getInstance(this); try { Cursor c = gerenciador.getReadableDatabase().rawQuery("SELECT COUNT(*) FROM restaurantes", null); c.moveToFirst(); int contador = c.getInt(0); c.close(); if (contador > 0) { int deslocamento = (int) (contador * Math.random()); String args[] = {String.valueOf(deslocamento)}; c = gerenciador.getReadableDatabase().rawQuery("SELECT _id, nome FROM restaurantes LIMIT 1 OFFSET ?", args); c.moveToFirst(); atualizarFrame.setTextViewText(R.id.nome, c.getString(1)); Intent i = new Intent(this, FormularioDetalhes.class); i.putExtra(ListaRestaurantes._ID, c.getString(0)); PendingIntent pi = PendingIntent.getActivity(this, 0, i, PendingIntent.FLAG_UPDATE_CURRENT); atualizarFrame.setOnClickPendingIntent(R.id.nome, pi); c.close(); } else { atualizarFrame.setTextViewText(R.id.nome, getString(R.string.vazio)); } } finally { gerenciador.close(); } Intent i = new Intent(this, WidgetService.class); PendingIntent pi = PendingIntent.getService(this, 0, i, 0); atualizarFrame.setOnClickPendingIntent(R.id.proximo, pi); mgr.updateAppWidget(cn, atualizarFrame); }
E… pronto!
Fazendo Ligações (Chamadas) Vamos ver agora como realizar chamadas. Nesta última sessão de modificações em nosso aplicativo, vamos adicionar um campo denominado telefone aos nossos restaurantes e, a partir dele, vamos possibilitar que o usuário faça uma chamada diretamente do nosso aplicativo. Começando, temos inicialmente que atualizar o nosso modelo de dados para que armazene o novo dado necessário (o número de telefone). Primeiramente, modifique o método o nCreate() da classe GerenciadorRestaurantes para abrigar o novo campo:
1 2 3 4 5 6
@Override public void onCreate(SQLiteDatabase db) { db.execSQL("CREATE TABLE restaurantes (_id INTEGER PRIMARY KEY AUTOINCREMENT," + " nome TEXT, endereco TEXT, tipo TEXT, anotacoes TEXT, twitter TEXT," + " latitude REAL, longitude REAL, telefone TEXT);"); }
Em seguida, altere o método onUpgrade() para atualizar o modelo de dados do banco, caso o usuário esteja vindo de uma versão anterior:
25 26 27 28 29 30 31 32 33 34 35 36 37 38 39
@Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { if (oldVersion < 2) { db.execSQL("ALTER TABLE restaurantes ADD COLUMN twitter TEXT"); } if (oldVersion < 3) { db.execSQL("ALTER TABLE restaurantes ADD COLUMN latitude REAL"); db.execSQL("ALTER TABLE restaurantes ADD COLUMN longitude REAL"); } if (oldVersion < 4) { db.execSQL("ALTER TABLE restaurantes ADD COLUMN telefone TEXT"); } }
Pronto. Agora, vamos procurar pelos métodos inserir(), atualizar(), obterTodos() e obterPorId() para adicionar o campo telefone a eles também.
Para concluir as alterações nesta classe, crie o método obterTelefone():
114 115 116
public String obterTelefone(Cursor c) { return c.getString(8); }
Pronto. Com relação a persistência, já estamos aptos a prosseguir. Vamos agora adicionar o campo telefone aos nossos formulários. Como devem estar lembrados, temos 2 layouts, um para o modo retrato, outro para o modo paisagem. Primeiro no modo retrato, adicione o seguinte trecho logo após o campo de endereço, no arquivo res/layout/form_detalhes.xml.
14 15 16 17
Agora no res/layout-land/form_detalhes.xml. Também, logo depois do trecho do campo de endereço.
16 17 18 19 20
Pronto. Nossas modificações agora serão na classe FormularioDetalhes. Primeiramente adicione o atributo telefone à classe:
25
EditText telefone = null;
Agora, precisamos atualizar os métodos onCreate(), salvar(), carregar(), onSaveInstanceState() e onRestoreInstanceState(). Pode parecer bastante coisa, mas são apenas ajustes leves para adicionar o novo campo.
Prosseguindo, precisamos dizer ao Android que nossa aplicação deseja realizar chamadas. Para isso, adicione a seguinte linha às permissões no arquivo AndroidManifest.xml.
13
Agora, vamos criar a opção ao menu para realizar as chamadas. Edite o arquivo res/menu/opcao_detalhes.xml para acomodar a nova opção (é… vai ficar meio espremido em telas pequenas…).
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
O arquivo de ícone utilizado foi o ic_menu_call.png encontrado na pasta de instalação do Android e devidamente renomeado para chamada.png. Agora precisamos definir as novas strings utilizadas no formulário e no menu. Adicione-as ao arquivo res/values/strings.xml…
39 40
Telefone:Telefonar
… e no res/values-es/strings.xml.
39 40
Teléfono: Llamar
Por fim, vamos fazer com que a opção de menu realize a chamada. Adicione o seguinte trecho aos encadeamentos de ifs no método onOptionsItemSelected().
155 156 157 158 159 160
} else if (item.getItemId() == R.id.chamar) { String numero = "tel:" + telefone.getText().toString(); if (numero.length() > 4) { startActivity(new Intent(Intent.ACTION_DIAL, Uri.parse(numero))); } }
Execute a aplicação para conferir as modificações.
Caso queira que a ligação seja realizada diretamente, sem exibir o discador, modifique, na linha 158 da última listagem de código, ACTION_DIAL por ACTION_CALL.
Terminamos Parabéns, você chegou ao fim desse curso avançado de Android.