How to setup environment Projeto F

Transcrição

1 1 1. Download de Ferramentas: 1.1. Android Developer Tools [ADT]: How to setup environment Projeto F O Android Developer Tools (ADT) é um plugin para Eclipse que oferece um ambiente de desenvolvimento de nível profissional para a construção de aplicativos Android. É uma IDE Java completa com recursos avançados para ajudar a construir, testar, depurar e empacotar seus aplicativos Android. No link abaixo, você encontra para download, o pacote completo contendo tudo que é necessário para iniciar a desenvolver para Android: Eclipse + ADT Plugin Android SDK Tools Android Platform-tools A mais recente plataforma Android A imagem mais recente do sistema Android para o emulador Link para Download: 2. Configurações Básicas: 2.1. ADT com Subclipse [SVN plugin para eclipse]: Com o Subclipse, o Eclipse é capaz, por si só, de manipular (praticamente) todas as funções do SVN, tornando o desenvolvimento mais ágil. Para instalá-lo, basta seguir os passos abaixo: 1. Menu Help >> Install New Software...

2 2 2. Adicione um novo repositório, clicando no botão Add e adicione o nome e o link para o repositório e deixe-o carregar: Location: 3. Com o repositório carregado, clique sobre o pacote Subclipse para instalá-lo e clique em Next, a partir deste ponto é só verificar os pacotes que serão instalados, confirmar o Acordo de Licença e reiniciar o Eclipse [ADT]: Usando o Subclipse [SVN]: Para usar o plugin Subclipse para dar checkout no projeto mantido no sourceforge.net, siga os seguintes passos com o eclipse-adt aberto:

3 3 1. File >> New >> Other 2. Navegue em: SVN >> Checkout Projects from SVN, e clique em Next:

4 4 3. Crie um novo local de repositório: >> Create a new repository location e clique em Next: 4. Cole a url de hospedagem do source do projeto e clique em Next: URL:

5 5 5. Clique sobre o projeto [source] desejado e clique em Next: 6. Verifique possíveis configurações adicionais nesta próxima tela (como por exemplo escolher qual revision dar um checkout) e clique em Next:

6 6 7. Configure o local onde será mantido o projeto em seu computador, para você trabalhar localmente com o projeto, salvando as mudanças apenas em sua máquina e clique em Finish: 8. Espere o plugin fazer o checkout do projeto para você começar a trabalhar no código. Para trabalhar com os comandos com o SVN, clique com o botão direito em cima do projeto em questão, vá no menu Team e veja o que é possível com o plugin Subclipse:

7 7 Por exemplo [principais comandos]: Update: Atualiza a cópia de trabalho com o repositório Checkout: Faz uma cópia dos arquivos para edição no diretório de trabalho. Commit: Submete arquivos para o repositório 2.2. Adicionando plataformas e pacotes com o SDK O SDK do Android separa ferramentas, plataformas e outros componentes em pacotes que você pode baixar usando o Gerenciador de SDK Android Inicie o Gerenciador de SDK (Andoid SDK Manager). Se você já usou o instalador do Windows para instalar as ferramentas do SDK, você já deve ter o ícone Android SDK no Eclipse, Figura 1. Caso contrário, você pode iniciar o Gerenciador de SDK Android da seguinte forma: SDK Android. No Windows, clique duas vezes no Manager.exe SDK arquivo na raiz do diretório do Figura 1. Ícone do Android SDK Manger no Eclipse O Gerenciador de SDK mostra todos os pacotes SDK disponível para você adicionar ao seu SDK Android. Configuração mínima instale o seguinte: As mais recentes ferramentas de pacotes (confira o Tools pasta). A última versão do Android (confira o primeiro Android da pasta). A Biblioteca de Apoio Android (abra o Extras pasta e verificar Biblioteca Suporte Android). Depois de ter escolhido os seus pacotes, clique em Instalar, Figura 2. Com estes pacotes instalados, você está pronto para começar a desenvolver.

8 8 Figura 2. O gerente SDK Android SDK mostra os pacotes que estão disponíveis, já instalados, ou para que uma atualização esteja disponível. Criar um projeto com Eclipse 1. Clique em Novo na barra de ferramentas, Figura 3. Figura 3. Botão novo no Eclipse. 2. Na janela que aparece, abra o Android pasta, selecione Projeto Aplicativo para Android e clique em Próxima, Figura 4. Depois será exibida outra tela, como mostra na Figura 5. Figura 4. assistente do projeto New Android App no Eclipse.

9 9 Figura 5. assistente do projeto New Android App no Eclipse. 3. Preencha o formulário que aparece, como mostra na Figura 5: Nome do aplicativo é o nome do aplicativo que aparece para os usuários. Para este projeto, usar "My First App". Nome do Projeto é o nome do diretório do projeto eo nome visível no Eclipse. Nome do pacote é o namespace do pacote para seu aplicativo (seguindo as mesmas regras que os pacotes na linguagem de programação Java). Seu nome de pacote deve ser único em todos os pacotes instalados no sistema Android Mínimo Necessário SDK é a versão menor do Android que o aplicativo suporta, indicado usando o nível API. Alvo SDK indica a versão mais recente do Android (também usando o nível API ) com o qual você já testou com a sua aplicação. Com compilar é a versão da plataforma com a qual você irá compilar o seu aplicativo. Por padrão, isso é definido como a última versão do Android disponível no seu SDK. Tema especifica o Android estilo UI para aplicar para o seu aplicativo. Você pode deixar isso sozinho. Clique em Próxima. 4. Na próxima tela para configurar o projeto, deixe as seleções padrão e clique em Avançar. 5. A próxima tela pode ajudar a criar um ícone do lançador para o seu aplicativo. Clique em Próxima. 6. Agora você pode selecionar um modelo de atividade de que para começar a construir sua aplicação. Clique Próxima. 7. Deixe todos os detalhes para a atividade em seu estado padrão e clique em Finish.

10 10 Executando o seu App Executar no Emulator No Eclipse para executar seu aplicativo no emulador, você precisa primeiro criar um dispositivo virtual Android (AVD), Figura 6. Um AVD é uma configuração do dispositivo para o emulador Android que permite modelar diferentes dispositivos. Figura 6. O Gerente de AVD mostrando alguns dispositivos virtuais. Para criar um AVD: 1. Lançar o Android Virtual Device Manager: a. Em Eclipse, clique em Android Virtual Device Manager a partir da barra de ferramentas. 2. No Gerenciador de dispositivos Android Virtual painel, clique em Novo. 3. Preencha os detalhes para o AVD. Dê-lhe um nome, um alvo plataforma, um tamanho de cartão SD, e uma pele (HVGA é o padrão). 4. Clique em Criar AVD. 5. Selecione o novo AVD do Android Virtual Device Manager e clique em Iniciar. 6. Após o emulador é inicializado, desbloquear a tela do emulador. Para executar o aplicativo a partir de Eclipse: 1. Abra um dos arquivos do seu projeto e clique em Executar na barra de ferramentas. 2. No Executar como janela que aparece, selecione Aplicativo para Android e clique em OK.

11 11 Figura 7. Tela do Emulador com o App HelloWord. 3. Configurações Avançadas 3.1. Configurando o projeto android para acesso ao google-maps O Google fornece uma API para acesso ao Google Maps de dentro de aplicações Android. Para poder acessar o Google Maps, de dentro da sua aplicação, você precisa de uma chave de registro na API do Google Maps, ela é gratuita e fácil de ser conseguida. Assim para usar as classes da biblioteca externa do Google Maps no aplicativo é necessário: 1 - Instalar o complemento das APIs do Google, conforme descrito no documento Como instalar. 2 - Configurar um novo projeto Android (ou reconfigurar um projeto existente) para ser criado no complemento instalado das APIs do Google. 3 - Configurar um dispositivo virtual Android que utilize um complemento das APIs do Google 4 - Adicionar um elemento uses-library ao arquivo de manifesto de seu aplicativo, para referenciar a biblioteca do Google Maps. 5 - Usar a classe do Google Maps em seu aplicativo

12 Obter uma chave da API do Google Maps para que seu aplicativo possa exibir dados do serviço do Google Maps. 7 - Assinar corretamente seu aplicativo usando um certificado que corresponda à sua chave de API. 1.1 Configurando o projeto Android já criado Considerando que um projeto Android simples já foi criado, vamos agora realizar as configurações necessárias para a comunicação com a API do Google Maps: Primeiramente seguindo os requisitos acima temos que localizar as APIs do Google Add-On no Android SDK e AVD Manager sob a janela d0o nome do componente "APIs do Google, o Google Inc." Note que o nome do componente especifica a versão da plataforma Android incluído por seu nível API. Em Eclipse, escolha Gerenciador de Janelas> Android SDK. Ainda com o Android SDK aberto, na lista de pacotes que aparece na pasta Extras você deve expandi-lo e selecione Google Play services e instale o pacote. Usando o Eclipse, importe o projeto de biblioteca em sua workspace. Clique e File> Import, selecione Android > Existing Android Code into Workspace que

13 13 estará por exemplo na no caminho D:\<android-sdkfolder>/extras/google/google_play_services/libproject/google-play-services_lib. Após isso ter sido feito vá em Properties do seu projeto (Clique com o botão direito no seu projeto) e selecione o menu Android na Library como mostra a figura abaixo, clique em Add e então escolha google-play-services_lib para adicioná-lo ao seu projeto. 1.2 Obtendo a chave Map Api Key O Google Maps API v2 Android usa um novo sistema de gerenciamento de chaves. Obter uma chave para a aplicação requer várias etapas. A chave do Google Maps API é baseada em um pequeno formulário de certificado digital do seu aplicativo, conhecido como SHA-1 fingerprint. A fingerprint é uma sequência de texto único, gerado a partir do algoritmo comumente usado SHA-1 hashing. Porque a fingerprint é única, o Google Maps pode usá-lo como uma forma de identificar a sua aplicação.

14 14 Para exibir o fingerprint para chave de debug devemos segui os seguintes passos: 1.1 Localize o arquivo de debug keystore. O nome do arquivo é debug.keystore, e é criado a primeira vez que você cria seu projeto. Por padrão, ele é armazenado no mesmo diretório do seu dispositivo AVD: Usando o Eclipse selcione Windows > Prefs > Android > Build para verificar o caminho completo (Default debug keystore); 1.2 Usando o Terminal do windows (cmd) navegue até a pasta bin do jdk da sua máquina para ter acesso aos comandos Keytool 1.3 Execute a seguinte linha de comando subistituindo o caminho do arquivo debug.keystore pelo seu visualizado anteriormente: keytool -list -v -keystore "C:\Users\your_user_name\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android Caso você tenha ma exceção de formato no keystore, você deve alterar as configurações regionais do seu Windows colocando Formato e Local para Estados Unidos 1.4 Você deverá ver uma saída semelhante a da imagem abaixo e dentre as informações você já pode ver seu SHA-1 fingerprint: Após consegui certificado digital do SHA1 temos agora que gerar a chave do Google Maps API para isso deve acessar o Google APIs Console link:

15 15 Se você não usou o Google APIs Console antes, você será solicitado a criar um projeto que você usará para controlar o uso do Google Maps API Android. Clique em Create Project e crie um novo projeto chamado Projeto API. Na próxima página, este nome aparece no canto superior esquerdo. Para renomear ou gerenciar um projeto clique em seu nome. Se você já está usando o Google APIs Console, você vai ver imediatamente uma lista de seus projetos existentes e os serviços disponíveis. Ainda é uma boa ideia usar um novo projeto para o Google Maps API Android, portanto, selecione o nome do projeto no canto superior esquerdo e, em seguida, clique em Create (veja a seta vermelha da imagem abaixo). Uma vez que você tem um projeto definido, você pode solicitar uma ou mais chave. Você deverá ver uma lista de APIs e serviços na janela principal. Se você não estiver vendo isso, selecione Services da barra de navegação à esquerda (veja seta verde da imagem acima). Na lista de serviços exibidos no centro da página, role para baixo até ver o Google Maps API v2 Android. Clique no indicador de interruptor, de modo que ele está ligado e aceite os termos de serviço.

16 Agora crie a chave clicando em API Acess clique no botão [Create New Android Key...] digite o SHA-1 fingerprint, em seguida, um ponto e vírgula, em seguida, o nome do pacote do aplicativo. Então clique em Create e aparecerá uma chave como ilustra a imagem abaixo: 16

17 17 Pronto já temos uma chave do Google Maps para o nosso projeto, agora vamos adicionar a API Key a aplicação. O valor API key é esse destacado abaixo como mostra a imagem Essa será a nossa chave que deverá ser adicionada no arquivo AndroidManifest.xml de seu projeto: <meta-data android:name="com.google.android.maps.v2.api_key" android:value="your_api_key"/> OBS: substitua your_api_key Pela sua chave API Key obtida anteriormente. Ainda na AndroidManifest é necessário adicionar permissões de acordo com a sua necessidade, para inicio a mais importante são MAPS_RECEIVE e INTERNET, veja exemplos de permissões abaixo:

18 18 Também é necessária um uses-feature no seu manifesto, isso porque esta nova API faz uso do Open GL e, o device que executar seu aplicativo, deve fornecer suporte de forma obrigatório a ele: <uses-feature android:glesversion="0x " android:required="true"/> Além da implementação necessária da classe java Activity e o arquivo XML do layout para a Activity. Exemplos básicos de implementação usando a classe MapView, que exibe um mapa (com os dados obtidos a partir do serviço Google Maps) e quando focado, ele irá capturar teclas pressionadas e gestos de toque para mover o mapa podem ser facilmente encontrado no site: Pronto, depois de todo os procedimentos realizado o que resta é compilar a aplicação e executar em um dispositivo com Android compatível Uso do SQLite em aplicações Android Como o Banco SQLite já vem integrado com o ADT do Android, para poder utilizalo basta fazer um import da biblioteca pelo seguinte comando import android.database.sqlite.sqlitedatabase. Para fazer a criação de um banco ou a sua abertura usamos o método openorcreatedatabase(string name, int mode, CursorFactory factory);. Exemplo: BancoDados = openorcreatedatabase(nomebanco, MODE_WORLD_READABLE, null); Onde BancoDados é uma variável do tipo SQLiteDatabase para poder manipular as expressões SQL e a variável NomeBanco do tipo String que é o nome do banco. E temos o método que usamos para fazer a execução de uma expressão SQL que é BancoDados.execSQL(sql); onde sql é uma String com uma expressão SQl que pode ser os comandos para deletar, atualizar, criar, inserir,

19 selecionar. E para fechar o banco utilizamos o método close(). Exemplo: BancoDados.close();. 19