Hello People

Um "Hello" em Diversos Idiomas para o Usuario

🚀 Finalizado 🚀

Tabela de Conteúdos

• Sobre o projeto
  • Funcionalidades
  • Como executar o projeto
    • Pré-requisitos
    • Baixando o Projeto
    • Instalando o APP
  • Tecnologias e Informações
    • Estrutura
    • Explicação do APP
    • Pontos Desenvolvidos
  • Contribuidores
  • Referencias
  • Como contribuir no projeto

💻 Sobre o projeto

Hello People - Projeto Desenvolvido para Obter um "Olá" no Idioma Local do Usuario (Pelo seu IP) ou em um dos diversos Idiomas Disponiveis. Tambem será exibido Informações Publicas sobre o IP do Usuario.

📚 Inicialmente, esse APP realiza uma busca do IP do Usuario, obtendo a Cidade, Estado, País e outros Dados Publicos desse IP. Após essa busca, por padrão, é obtido um "Ola" no Idioma Local do Usuario.

Esse Projeto utilizou 3 APIs no seu Desenvolvimento, uma Biblioteca (Material Design) de Widgets e uma Organização dos Diretorios, de forma que os Itens semelhantes estivessem no mesmo Escopo. Para mais Informações, acesse o Item Tecnologias, e veja os Pontos de Aprendizado

Obs: Esse APP NÃO ARMAZENA nenhum Dado de Uso (Nome, Senha, IP, Dados do Dispositivo, etc). Nenhum dado inserido ou obtido no APP é salvo de forma externa

Funcionalidades

• Login
  • Inputs de Nome e Senha
  • Ocultação da Senha
  • Validação no Nome e Senha (Mensagem e Erro e Mudança de Cor)
  • Botão Login e Logout
  • Botão Logout Limpando Reiniciando os Inputs
• "Hello"
  • Ao Completar um novo Login: <hello-in-native-language> <user-name> you have successfully logged in!
  • Ao Realizar um Login Novamente: Have a great day <user-name>!
• Extras
  • Usuario Escolher o Idioma
  • Informações Adicionais (Endereço de IP, Cidade, Região, Nome do País e Fuso Horário)

🚀 Como executar o projeto

Pré-requisitos

Antes de começar, você vai precisar ter instalado em sua máquina:

• Git → Atualizações e Versionamento no Codigo
• Android Studio → Editor da Google voltado ao Desenvolvimento Android

📥 Baixando o Projeto

Execute os Comandos abaixo no Git Bash, dentro da sua pasta escolhida. Dessa Forma, é possivel acessar o Projeto e seus Diretorios com mais Facilidade 😄

# Clone este repositório
https://github.com/GuilhermePalma/Hello_People.git

# Acesse a pasta do projeto no terminal/cmd
cd Hello_People

# Abra o Android Studio

Instalando o APP

Caso deseje apenas Instalar o APP para poder interagir com ele, acesse a aba Releases.

Após acessar, Selecione a Versão mais Recente, deslize a tela até a parte inferior e baixe o arquivo anexado como app-release.apk.

Pegue seu dispositivo mobile, abra o aplicativo Configurações, selecione o Item Segurnaça e ative o Item Permitir Fontes Desconhecidas

Com um Cabo USB, conecte seu dispositivo mobile e mova o arquivo app-release.apk para alguma pasta do Dispositivo. Em seu aparelho, utilize algum aplicativo para acessar as pastas (como por exemplo, o app Meus Arquivos), navegue até o local onde o arquivo app-release.apk se encontrea e clique nele para começar a Instalação no Aparelho.

Durante a Instalação, seu dispositivo pode exibir alguns avisos informando que o APP vem de um Fonte Desconhecida e fora da PlayStore. Entretanto, o APP não desempenha nenhum risco ao seu dispositivo, por isso clique em "Instalar" ou "Continuar mesmo assim" ou "Confiar nesse Aplicativo"

Após a Instalação do APP, é recomendado que desabilite a opção "Confiar em Fontes Desconecidas" (3° Paragrafo)

🛠 Tecnologias e Informações

Para a Construção desse APP, foi utilizada a Linguagem Java, em conjunto com a IDE da JetBrains, Android Studio.

Para o Versionamento do APP, foi utilizado o Git junto com o GitHub. Para facilitar a manipulação do Git, foi utilizada a Interface Grafica integrada no Android Studio.

Para o Desenvolvimento do APP, foram utilizados os seguintes recursos:

• API: Check IP - Obtem o IP do Usuario
• API: IP API - Obtem os Detalhes do IP
• API: Fourton Fish (Project: Hello, Salut!) - Obtem o "Hello" em Diversos Idiomas
• Widgets: Material Design - Documentação e Widgets

Estrutura

Este projeto é divido nas seguintes partes:

1. Layout das Telas
2. Configurações das Telas
3. Classes das Entidades
4. Classes de Funcionalidades

É possivel encontrar outros arquivos "Fora" dessa organização. As partes descritas acima são apenas generealização da organização do Projeto

Explicação do APP

O APP Hello é um dos Projetos da Coleção APP Ideas, que se trata de um repositorio OpenSource (License MIT) com sugestões de Projetos. Essas Sugestões listam os Requisitos (User Stories) que o projeto deve abranger e as possiveis implementações extras. Clique aqui para ver os dados desse projeto.

Nesse APP foi desenvolvido um Formulario que o Usuario insere o seu Nome e uma Senha e, caso deseje, pode escolher o Idioma da mensagem do "Hello".

Durante a Execução do APP, é utilizado APIs em requisições HTTP. Essas APIs tem como o Objetivo obter o "Hello" nos diversos Idioams e os Detalhes do IP. Essas APIs são:

• Check IP - Obtem o IP do Usuario
• IP API - Obtem os Detalhes do IP
• Fourton Fish (Project: Hello, Salut!) - Obtem o "Hello" em Diversos Idiomas

Após clicar no botão Login, é feita uma Verificação nos Dados Inseridos. Caso haja algum erro, informa ao usuario. Se não, os Dados são salvos em SharedPreferences e inicia-se uma nova Tela exibindo o "Hello". Por padrão, o "Hello" é exibido em um idioma detectado de forma automatica pelo IP do Usuario, entretanto, caso o usuario tenha selecionado algum Idioma especifico, o "Hello" será obtido nesse Idioma.

Por se tratar de um projeto mais simples, os dados são salvos de Forma Local em uma SharedPreferences - tendo inclusive, uma classe no APP somente para centraliza-las e controla-las. Dessa forma, uma vez que seja limpo os Dados do APP ou ocorra a Desinstalação do APP, os dados serão perdidos.

Pontos Desenvolvidos

• Divisão da Responsabilidade dos Itens do Projeto, seguindo o conceito da POO (Programação Orientada a Objetos)
• Utilização da SharedPreferences
  • Utilização de uma Classe que centralizava as Operações da SharedPreferences. Mantendo uma maior organização e facilidade para a Manutenabilidade do Sistema
• Chamadas Assincronas
  • Utilização do ExecutorService, Callable e Future para a criação e execução de uma nova Thread em Background
  • Exibição dos Resultados no Layout por meio do runUiThread
  • Manipulação de Variaveis
• Requisições HTTP
  • Utilização do Metodo GET
  • Verificação do Status Code da Requisição
  • Formação da URL por meio da Classe Uri
• Serialização de JSON
  • Verificação de Itens Nulos
  • Normalização de Caracteres HTML

👨‍💻 Contribuidores

💜 Desenvolvedores que contruiram o Aplicativo :)

Guilherme Palma 🚀

💪 Contribuir no Projeto

1. Faça um fork do projeto.
2. Crie uma nova branch com as suas alterações: git checkout -b my-feature
3. Realize e Salve suas alterações, colocando uma Mensagem Contando o que Você Fez: git commit -m "Feature: Update XXX"
4. Envie as suas Alterações: git push origin my-feature
5. Entre no seu Branch no GitHub e clique em Contribute e em Seguida em Open Pull Request
6. Informe em base o Branch main desse Repositorio e em compare o seu Branch de Alterações
7. Insira um Titulo e escreva um Mensagem indicando o que foi feito nessa sua Branch

Referencias

Florinpop17: APP-Ideas → Projeto "Hello"