Consulte detalhes sobre endereços de forma prática e eficiente
Kepify é um aplicativo Android que permite consultar informações detalhadas sobre um CEP informado, incluindo estado, cidade, bairro, rua e imagens associadas ao local. O projeto foi desenvolvido com Kotlin e Jetpack Compose, aplicando conceitos essenciais do desenvolvimento Android moderno, como:
- Composables: Criação de interfaces declarativas reutilizáveis
- Recomposição: Atualização eficiente da UI conforme mudanças no estado
- Corotinas: Execução assíncrona para chamadas de rede e processos em segundo plano
- ViewModel: Gerenciamento de estado e ciclo de vida
- Activity: Estrutura base do app
- MVVM (Model-View-ViewModel): Arquitetura para separação de responsabilidades
O projeto utiliza diversas tecnologias para oferecer uma experiência otimizada:
- Kotlin: Linguagem moderna e concisa para desenvolvimento Android
- Jetpack Compose: Framework para UI declarativa e reativa
- Material3: Design moderno e consistente com as diretrizes do Material Design 3
- Koin: Injeção de dependências simplificada
- Retrofit: Cliente HTTP para consumo de APIs REST
- Ktor: Cliente HTTP alternativo para chamadas de rede
- Coil: Carregamento e exibição eficiente de imagens
- JUnit: Framework para testes unitários
- Mockk: Biblioteca para mocks em testes
⚠️ Atenção: Em um projeto real, recomenda-se utilizar ou Retrofit ou Ktor, não ambos simultaneamente. Neste projeto de estudo, os dois foram incluídos para explorar a criação de uma interface que suporte ambas as bibliotecas, permitindo alternar entre elas sem modificar a implementação subjacente.
- Busca de endereços por CEP
- Exibição de informações detalhadas do local
- Apresentação de imagens relacionadas ao CEP
- Interface intuitiva e responsiva
- Compartilhamento das informações
- Android Studio instalado (versão mais recente recomendada)
- Kotlin configurado
- Emulador ou dispositivo Android conectado
- Chave de API do Google Maps (para pesquisar imagens das ruas)
- Clone este repositório:
git clone https://github.com/SilvanoGPM/kepify.git
- Abra o projeto no Android Studio
- Crie na raiz do projeto o arquivo
secret.propertiese adicone a linha:GOOGLE_API_KEY="SUA_API_KEY" - Construa e execute o aplicativo no emulador ou dispositivo
Sinta-se à vontade para contribuir! Sugestões, melhorias e correções são bem-vindas.
- Faça um fork do projeto
- Crie uma branch para sua feature (
git checkout -b minha-feature) - Commit suas alterações (
git commit -m 'Adicionando nova feature') - Envie para o repositório (
git push origin minha-feature) - Abra um Pull Request