Criar um novo projecto

Transcrição

1

2 Criar um novo projecto

3 Criar um novo projecto (2)

4 Criar um novo projecto (3)

5 Criar um novo projecto (4)

6 Criar um novo projecto (5)

7 Criar um novo projecto (6)

8 Estrutura do projecto O Eclipse criou-nos um projecto com um monte de pastas, subpastas e ficheiros. À primeira vista, uma confusão

9 Ou talvez não Vamos por partes

10 Estrutura do projeto /SRC Esta pasta contém os ficheiros java com o código fonte da nossa aplicação. Cada vez que criamos uma Actividade, um Serviço, um BroadCast Receiver (por exemplo), é nesta pasta que fica o código fonte.

11 Estrutura do projeto (2) /RES Nesta pasta são armazenados todos os recursos externos para as nossas aplicações, como por exemplo: imagens, layouts XML, ficheiros, strings, animações, etc. Estes recursos são guardados em cada uma das subpastas apropriadas.

12 Estrutura do projeto (3) Drawables: ficheiros bitmap. Cada subpasta contem os ficheiros com resoluções adequadas a cada tipo de ecrã Layout: Contém os ficheiros XML que definem a UI de uma Activity Menu: Ficheiros XML que definem menús na aplicação Values: Ficheiros XML que definem valores simples, como: strings, vectores, inteiros, dimensões, cores, etc

13 Estrutura do projeto (4) /GEN Esta pasta contém ficheiros java gerados automaticamente pela ADT. O ficheiro R.java contém referências/índices para todos os recursos do nosso programa que foram colocados na pasta RES e das Views descritas nos Layouts. Cada vez que adicionamos um novo recurso ao projecto, o ADT vai gerar automaticamente o ficheiro R.java que contém a referência desse recurso. NUNCA EDITAR ESSE FICHEIRO. Deixem a ADT gerá-lo automagicamente!

14 Ficheiro R.Java Após abertura do ficheiro R.java que se encontra na pasta gen, encontra-se:

15 Ficheiro R.Java (2) E em que, após as seguintes alterações:

16 Estrutura do projeto (5) /Android <versão> : Todas as bibliotecas Android necessárias. Se vos disserem para mexer nisto: ASSETS: Nesta pasta podem ser colocados quaisquer tipos de dados como: audio, video, imagens, etc. BIN: Pasta para onde vão os ficheiros resultantes da compilação: java.class,.apk, etc. AndroidManifest.xml: Este ficheiro contêm toda a informação sobre a App que é importante para o sistema Android, informação que o sistema tem de ter antes de correr qualquer código da aplicação. Vamos falar sobre isto mais à frente, dada a sua importância.

17 Criação da primeira Atividade Nesta parte vamos focar a nossa atenção na criação de um simples menú. Contudo, quando criámos o projecto criámos imediatamente uma Atividade:

18 Criação da primeira Atividade (2) Atividade constituída por: Um monte de imports necessários para utilizar alguns métodos e classes A definição da nossa Actividade, como uma classe que herda todos os atributos da classe Activity (estamos a criar uma Activity personalizada ) Override do método oncreate(). Este método é chamado assim que a Actividade é criada. (Por enquanto esta actividade é criara assim que corremos o programa)

19 Criação da primeira Atividade (3) Atividade constituída por: O novo método oncreate() chama em primeiro lugar o método oncreate() predefinido na classe Activity. Só depois executa o nosso novo código. Isto é necessário porque esse código predefinido tem de ser corrido para garantir o bom funcionamento da aplicação. A Vista (ou Grupo de Vistas) que define a UI é um layout chamado menu_principal. Hmmm.

20 Criação da primeira Atividade (4) Realmente existe um layout com esse nome :D Vamos abrir e ver o que acontece!

21 Criação da primeira Atividade (5) Podemos definir a nossa UI graficamente: Actualmente temos uma Actividade que diz Hello world! (uma espectacularidade no mínimo espectacular) Ou editando directamente o ficheiro XML:

22 Criação da primeira Atividade (5) Por muito fixe que seja uma aplicação com um Hello World, talvez seja possível fazer melhor Vamos então criar um menu que recebe um nome e com alguns botões. Graficamente ou editando o ficheiro XML?

23 Vistas Mas primeiro temos de saber como é constituída a nossa UI. A UI é constituída por Vistas e Grupos de Vistas (Views e Viewgroups). Vista: classe responsável por desenhar algo no ecrã e gerir eventos (toques, etc). Grupo de vistas: classe base dos layouts, contendo Vistas e outros Grupos de vistas.

24 Vistas (2) Exemplos de Vistas: ImageView TextView EditText Button A UI actual da actividade é constituída por um RelativeLayout que contém uma simples TextView: Exemplos de Grupos de Vistas: LinearLayout RelativeLayout

25 Vistas (2) Contudo, e de forma a facilitar este processo vamos manter o Relative Layout, e graficamente adicionar os elementos necessários para termos a seguinte UI final (fazendo alterações no XML quando necessário): Precisamos de: TextViews EditText RadioGroup RadioButtons Button ImageView

26 Vistas (3) Arrastar Double click vai abrir o XML com a view seleccionada Editar o nome da TextView para algo mais sugestivo Alterar o texto para o pretendido

27 Vistas (4) E obtemos a seguinte UI: ATENÇÃO: Num RelativeLayout as posições das views são determinadas relativamente às posições de outras views. Caso queiram views com nomes personalizados, devem editar o nome imediatamente após a inserirem! Senão perde-se a formatação

28 Vistas (5) Para termos um conjunto de Radio Buttons mutuamente exclusivos, estes têm de pertencer todos ao mesmo RadioGroup. Se adicionarmos um RadioGroup graficamente, ele traz consigo 3 Radio Buttons. Depois podemos tirar ou adicionar mais.

29 Vistas (6) E, por último, adicionamos o botão e a imagem que faltavam:

30 Criação da primeira Atividade (6) E pronto, podemos correr a nossa Aplicação.

31 Criação da primeira Atividade (6) E pronto, podemos correr a nossa Aplicação. Ainda não faz grande coisa, mas

32 Atividades Muito se tem falado de Actividades, mas ainda ninguém explicou o que são ou como funcionam. Uma Actividade é uma componente da aplicação responsável por um ecrã com o qual os utilizadores podem interagir. A cada actividade corresponde uma janela na qual se vai desenhar a UI. Cada actividade tem um ciclo de vida, no qual vão ser chamados diferentes métodos, dependendo do estado desta.

33 Criação da primeira Atividade (7) Talvez seja boa ideia meter os elementos nos quais é preciso trabalhar. É possível definir no XML que um clique numa vista chama um determinado método. Múltiplas vistas podem chamar o mesmo método. Qual é o atributo em que definimos essa função?

34 Criação da primeira Atividade (8) Depois é só definir o método na Actividade. Este método recebe uma View (a view que foi clicada), tem de ser público e retornar void.

35 Criação da primeira Atividade (9) Precisamos de adicionar uma variável que guarde a dificuldade A dificuldade será guardada numa String que poderá tomar os valores: facil, medio e dificil

36 Criação da primeira Atividade (10) Convém saber qual dos Radio Buttons foi clicado. Como é que fazemos isso? Verificamos se o Botão foi seleccionado Cast para definir que a vista v é um RadioButton, e para que possamos aceder aos seus métodos. Determinamos o Id da vista que chamou o método Comparamos o Id dessa vista com o Id de cada um dos RadioButtons

37 Criação da primeira Atividade (11) Será que isto funciona? Como é que sabemos? Podemos fazer prints para o LogCat com a função Log.d( tag, mensagem ). Corremos e o que é que obtemos? CAOS!

38 Criação da primeira Atividade (12) Solução: Adicionar um filtro ao LogCat com a tag que definimos na função Log.d(); Resultado:

39 Criação da primeira Atividade (13) Temos uma EditText onde escrevemos cenas. Como guardamos o que foi escrito? Declaramos um EditText Associamos esse EditText ao que temos no nosso layout Depois é só chamar os seguintes métodos, que vão retornar uma String com o conteúdo do EditText no momento em que são invocados.

40 Criação da primeira Atividade (14) Podemos chamar esse método quando carregamos no botão Bora lá

41 Criação de um SplashScreen

42 Criação de um SplashScreen (2)

43 Criação de um SplashScreen (3) Calma Eclipse Já vamos criar o layout!

44 Criação de um SplashScreen (4)

45 Criação de um SplashScreen (5)

46 Criação de um SplashScreen (6)

47 Criação de um SplashScreen (7) Adicionamos também este pedaço de código. Quando esta Actividade deixa de ser visível, é destruída.

48 Criação de um SplashScreen (8) Ok, temos uma nova Actividade, mas a nossa Aplicação só está a correr a Menu_principal. Como é que mudamos isto?

49 O AndroidManifest.xml O que é o manifest e quais as suas funções? Este ficheiro tem de estar presente em todas as aplicações Android. É responsável por apresentar informação essencial sobre a App ao sistema Android, informação essa que o sistema tem de ter antes de correr o código da App. Entre outras coisas o AndroidManifest faz o seguinte: Escolhe o package name para a aplicação. Este é o identificador único da aplicação. Descreve as componentes da aplicação: actividades, serviços, broadcast receivers Declara quais as classes que implementam cada componente e em que condições devem ser executadas. Declara as permissões que a aplicação e as aplicações que interagem com ela têm de ter. Declara o nível mínimo da API Entre outras Isto é capaz de ser o que nós queremos!

50 O AndroidManifest.xml (2) <?xml version="1.0" encoding="utf-8"?> <manifest> <uses-permission /> <permission /> <uses-sdk /> <supports-screens /> <compatible-screens /> <application> <activity> <intent-filter> <action /> <category /> </intent-filter> </activity> <service> <intent-filter>... </intent-filter> </service> <receiver> <intent-filter>... </intent-filter> </receiver> </application> </manifest> Estrutura geral do AndroidManifest (reduzida)

51 O AndroidManifest.xml (3) O que temos actualmente? A acção que inicia esta Actividade é do tipo MAIN (não tem associados valores extra) Esta actividade está listada no sistema como LAUNCHER, e vai ser a primeira actividade da Aplicação a ser corrida

52 O AndroidManifest.xml (4) Alteramos a Action da actividade anterior para o que quisermos. Alteramos a categoria para DEFAULT. Vamos adicionar a Actividade que criámos ao Manifest e definila como LAUNCHER.

53 Criação de um SplashScreen (9) Temos um SplashScreen todo XPTO, mas estamos presos nele. O ideal era ser mesmo um SplashScreen e mudar de Actividade ao fim de alguns segundos, certo? Mas como é que mudamos de Actividade?

54 Intents Um Intent é um objecto que transporta uma mensagem que pode pedir que uma determinada componente da aplicação execute uma acção. São usados principalmente para: Executar uma nova Actividade Executar um novo Serviço Entregar um BroadCast

55 Intents (2) Os Intents podem ser explícitos ou implícitos. Os Intents Explícitos são utilizados para executar uma determinada componente da aplicação (Actividade, Serviço, ) Os Intents Implícitos são utilizados para pedir uma acção por parte de alguma componente ou até mesmo de uma aplicação exterior, desde que a consigam completar.

56 Intents (3) Para fazermos a transição entre o SplashScreen e o Menu_principal, vamos usar um Intent Explícito. O tempo de espera (3 segundos) terá de ser definido numa nova Thread, dado que ao bloquearmos a Thread principal estávamos a impedir que o conteúdo da Actividade fosse desenhado.

57 Intents (4) E que tal se ao clicarmos no logotipo do NEEC que está no Menu_principal o browser abrisse a página do NEEC? Vamos usar um Intent Implícito para isso. Objecto que pode ser utilizado para guardar um endereço ou um caminho, entre outros Vão ser invocadas as aplicações capazes de visualizar o recurso passado por este Intent, e não uma componente em específico. Neste caso o browser dado que se trata de um link

58 Intents (5) Também podemos utilizar Intents para criar um novo serviço. Vamos criar um novo serviço chamado IntentToaster (originalidade acima de tudo ), que pode ser executado utilizando o seguinte Intent Explícito: Oops, parece que ainda não criámos o serviço Mas antes de o criarmos, talvez seja boa ideia sabermos o que é um Serviço!

59 Serviços Serviços são componente da aplicação que tem como principal objecto, a execução de longas operações em background sem disponibilizar uma interface com a qual o utilizador possa agir. Exemplos: Tocar uma música Fazer um Download (legal :D) Aplicar um qualquer algoritmo todo XPTO

60 Serviços (2) Existem duas classes que podemos utilizar para criar um Serviço. São elas: Service A classe base de todos os serviços. Esta classe usa a main thread, pelo que devemos sempre criar uma nova thread para que a UI da aplicação não fique bloqueada. Como é a classe base é mais poderosa, mas também mais difícil de gerir. IntentService Subclasse de Service que usa uma Thread auxiliar para processar todos os pedidos, um de cada vez. Esta classe torna a implementação de um serviço bastante simples, mas não é tão flexível como a classe Service.

61 Serviços (3) Como se cria um serviço usando a classe IntentService? Criamos uma nova classe e fazemos Override do construtor, e dos métodos onhandleintent() e ondestroy() tal como neste código.

62 Serviços (4) Como se cria um serviço usando a classe IntentService? Tal como acontece com as Actividades, temos de adicionar o nosso serviço ao Manifest.

63 Serviços (5) Temos um serviço que não faz nada Que tal mete-lo a fazer alguma coisa? Podíamos fazer Broadcast de mensagens para o sistema Android. Os Intents eram responsáveis por isso não é verdade? Que mensagens vamos usar?... Talvez a letra de uma música :D RickRolling the system Gangnam Styling the system

64 String array resources Dado que a letra de uma música ainda é um array de Strings com algumas entradas, uma maneira elegante de a guardarmos poderá ser num ficheiro XML em vez de o fazermos no código.

65 String array resources (2)

66 String array resources (3)

67 String array resources (4) Este ficheiro vai ter duas String Arrays, cada uma com a letra de uma música. Cada ficheiro XML pode ter múltiplos recursos, como se pode ver. Este ficheiro é dado.

68 String array resources (5) Escolhemos o String Array que queremos Independentemente do nome do ficheiro XML, a informação ficará sempre no campo array

69 Serviços (6) Agora vamos fazer broadcast de cada componente do array de 3 em 3 segundos: Intent Implícito. Será processado pela componente que tenha o Intent Filter que capta a ACTION: com.example.jogodoneec.toasted. Função para fazer o Broadcast É possível colocar informação extra no Intent. Neste caso será a String que queremos fazer Broadcast, que ficará gravada no campo letra.

70 Serviços (7) Para evitar que o serviço fique a correr após termos fechado a aplicação, vamos aplicar uma variável que nos permite sair do ciclo for

71 Serviços (8) Para evitar que o serviço fique a correr após termos fechado a aplicação, vamos aplicar uma variável que nos permite sair do ciclo for stopservice() chama o método ondestroy() do IntentService

72 BroadCast Receivers Estamos a fazer Broadcast para o sistema, mas não temos nada capaz de receber as mensagens. Precisamos de um BroadcastReceiver! Estes podem ser criados e registados dinamicamente numa Actividade para permitirem a sua comunicação com outros componentes, ou numa classe à parte. Neste caso vamos criar um BroadcastReceiver fora de uma Actividade, que vai simplesmente mostrar mensagens cada vez que recebe um broadcast.

73 BroadCast Receivers (2) Vamos registar o nosso BroadCast Receiver no Manifest. Quando são criados dentro de uma Actividade não se registam no Manifest, registam-se dinamicamente.

74 BroadCast Receivers (3) Vamos receber a mensagem e fazer display numa Toast

75 Retoques finais da 1ª parte Como não há tempo para definir um layout em landscape mode, vamos simplemente bloquear as Actividades em portrait mode. Isto é possível da seguinte forma:

76 Fim da primeira parte