Antes de começarmos a estudar a comunicação com a API, é muito importante conhecermos o nosso projeto.
Eu vou aproveitar este momento para introduizir para vocês o projeto que utilizaremos durante este curso, para conhecerem as funcionalidades e detalhes das implementações. Assim conseguirão acessar o projeto, testar e, quando tiverem mais familiaridade com ele, começaremos com o conteúdo do curso.
Inicialmente, o que precisamos saber do projeto? O nome dele é Ceep e ele tem a proposta de gerenciar notas. Se considerarmos o contexto atual, e pegarmos aplicativos do nosso dia a dia, ele vem com a proposta de simular o Google Keep, que é um aplicativo da Google com a mesma funcionalidade.
Sabendo disso, vamos analisar nosso projeto. Quando acessarem este projeto e executá-lo pela primeira vez, ele terá, inicialmente, essa tela em branco com duas informações.
A primeira está no centro da tela em cinza, escrito "Sem notas", indicando que não temos nenhuma nota. Além disso, no canto inferior direito temos um float action button ciano, com "CRIAR NOTA" escrito dentro dele, indicando uma ação para criarmos uma nota.
Como podemos perceber, este float action button é uma versão personalizada do que trabalhamos anteriormente, que era apenas um círculo. Neste, temos a opção para adicionar texto, no qual eu escrevi o "CRIAR NOTA". O nome desta versão é float action button extended.
Se quiserem utilizá-lo, fiquem à vontade para ver como ele foi implementado no arquivo de layout e para usar este float action button no projeto de vocês.
Dado que passei essa informação inicial, tem um ponto muito importante que eu informarei a vocês, que é a versão do Android Studio que eu estou utilizando. Na barra de navegação superior da janela, clicamos em "Help > About".
Aparece a tela de apresentação do Android Studio e, neste momento, é muito importante descobrirem a versão que vocês estão usando. Desta forma, garantimos que os aspectos visuais que veremos durante o curso sejam os mesmos no momento em que vocês estiverem estudando.
Então, durante o curso, esta foi a versão mais recente que eu tive acesso ao baixar o Android Studio, que é a Android Studio Bumblebee |2021.1.1 Patch 1. Eu recomendo que vocês utilizem esta mesma versão.
Se preferirem, podem utilizar uma versão mais atualizada, mas se notarem algo diferente e quiserem manter exatamente o que verão durante o curso, eu recomento que voltem para esta versão. Portanto, é importante que estejam cientes disso para, caso surja algo diferente do curso, vocês saberem que pode ser por causa da versão.
Outro ponto relevante é que, durante o curso, eu estou utilizando um emulador com uma versão diferente da que utilizamos em outros conteúdos. Este tem a versão 12 do Android, como vou mostrar para vocês acessando "Settings > System > System Update". Portanto, se quiserem manter o mesmo visual deste emulador, precisam desta versão também.
Como podem ver, nesta versão não temos os botões na barra inferior do aparelho, onde tinha o Home, o botão de Voltar, que é o Back e o botão para vermos as tarefas que estão em execução.
Para fazermos isso, existem alguns gestos. Por exemplo, se queremos voltar, nós clicamos no centro da lateral direita da tela e arrastamos para esquerda.
Quando fazemos isso, aparece uma seta apontando para esquerda. Se apenas segurarmos o clique, nada acontece. Se arrastarmos de volta para direita, nada acontece também, mas se clicarmos, arrastarmos para esqueda e soltarmos, a tela volta.
O mesmo acontece se clicarmos no centro da lateral esquerda e arrastarmos para lateral direita. Aparece uma seta apontando para esquerda e, quando soltamos, a tela volta para anterior. É importante saberem que tem uma área específica nas laterais em que podemos fazer este gesto para conseguirmos voltar. Essa é uma informação importante para terem a mesma funcionalidade.
Então, vamos voltar para o app e descobrirmos as funcionalidades diferentes que temos. Basicamente, para criarmos uma nota, clicamos no float action button e digitamos as informações, que seriam um título e uma descrição.
Por exemplo, vou escrever no título "Minha primeira nota" e, na descrição, "minha primeira descrição". Em seguida, temos alguns menus acessíveis para nós.
No canto direito da barra superior, temos o menu "Salvar", com o "✓" e o menu para "Remover", com o sinal de uma lixeira, mesmo que estejamos inserindo uma nova nota. Depois eu vou explicar sobre isso.
Já no canto inferior direito, temos um botão que permite que adicionemos imagens. Já conhecemos este tipo de formulário de outros conteúdos aqui da Alura, mas se é a primeira vez que você está vendo, é um Dialog em que colocamos um layout personalizado.
Ele é focado em receber imagens e oferecer um suporte para que estas elas sejam carregadas a partir de uma URL. Veremos sobre isso logo mais.
Inicialmente, eu vou cancelar a inserção de imagem e fazer uma nota simples para vermos o resultado. Ao clicarmos em "Salvar", percebemos que nossa nota foi salva e aparece na primeira tela.
Também é possível fazer o gerenciamento das notas, alterando-as ou as removendo. Para alterar, clicamos na nota que criamos e, quando ela abre, conseguimos mudar as informaçõe. Podemos, por exemplo, trocar o título para "Minha primeira nota alterada", assim como mudar a descrição para "minha primeira descrição alterada com mais informações para testar o comportamento de alteração".
Eu coloquei muito texto para vermos como a nota fica na nossa lista. Vou aproveitar este momento para também colocar uma imagem. Eu separei uma imagem do site Pexels, que tem imagens gratuitas, e vou copiar a URL desta imagem.
Voltarei na nota, vou clicar no menu de adicionar imagem, colar a URL e clicar no botão "CARREGAR", que fica logo acima do campo onde colamos a URL, e clicar em "CONFIRMAR". Podemos clicar em "CONFIRMAR" sem pedir para carregar a imagem. O carregamento apenas gera um preview.
Quando confirmamos, temos nossa imagem adicionada ao cabeçalho da nota e, ao clicarmos em salvar, somos direcionados para tela com a lista de notas. Com isso, todas as mudanças que fizemos na nossa nota foram salvas, inclusive a nossa imagem. Portanto, esta é outra funcionalidade acessível que nós temos.
Podemos criar mais de uma nota, então vou criar uma nota de teste apenas com o título. Clicando no botão "CRIAR NOTA", vou preencher o título com "nota de teste" e salvar. Percebemos que, mesmo que tenha apenas o título, ela aparece na lista.
Façamos alguns testes com a adição de imagens. Se abrirmos o menu de imagem e clicarmos em confirmar, sem colocar nenhum link, nada acontece. Entretanto, se colocarmos no campo da URL um "sss", ou seja, uma URL inválida, e clicarmos em confirmar, aparece um círculo com uma exclamação no meio onde ficaria a imagem da nossa nota. Ao salvarmos a nota, este ícone permanece no cabeçalho.
Outro ponto importante é que, uma vez que nossas notas têm conteúdos com tamanhos distintos, temos um aspecto um pouco diferente em relação a outros gerenciadores de layout do próprio Recyclerview. Eu usei uma versão chamada de staggered, que escalona a altura de cada item.
Então, as notas com mais conteúdo ficam maiores até determinado limite. Eu não lembro qual é este limite, mas deve ser, aproximadamente, 200 dpi. Já as notas menores aumentam o mínimo necessário.
Por fim, temos a remoção. Se é uma nota já criada, basta abrirmos e clicarmos em "Remover" que ela será apagada. Quando é uma nota que ainda está sendo criada, ao clicarmos em "Remover", ela tenta apagar, não consegue, então volta para lista de notas.
Foi feito desta forma porque eu reutilizei muitos códigos, então evitei adicionar mais complexidade, como é o caso de esconder o menu "Remover", quando for inserção, e só apresentá-lo quando for uma alteração. Caso queiram, vocês podem fazer isso, mas é válido saberem o motivo para eu ter feito assim, ou seja, para simplificar o código e reutilizá-lo ao máximo.
Isso é o que precisamos saber em relação ao nosso app. O próximo passo é aprendermos sobre o projeto, código, build e assim por diante.
Antes disso, é importante notarem que o projeto tem um GitHub que estará acessível para vocês. Então não precisam se atentar tanto aos nomes que eu mostrei aqui. Vocês terão acesso ao projeto via README e poderão lê-lo com calma.
Para acessarem o projeto, vão até à atividade, onde estará tudo o que precisam.