O WeatherApp é uma aplicação Android simples que permite ao usuário buscar informações sobre o clima de qualquer cidade em tempo real, usando a API do OpenWeather. Com uma interface amigável, o usuário pode ver a temperatura atual, sensação térmica, umidade e o horário da última atualização do clima.
- Busca de clima em tempo real por cidade.
- Exibe a temperatura atual (em Celsius), sensação térmica, umidade e nome da cidade.
- Interface minimalista e amigável.
- Toast customizado para erros e mensagens.
- Kotlin: Linguagem principal usada no desenvolvimento do app.
- Coroutines: Utilizado para operações assíncronas como requisições à API de clima.
- Retrofit: Biblioteca usada para consumo de APIs RESTful.
- OpenWeather API: API usada para obter as informações meteorológicas.
- Material Design: Componentes do Android Material Design para uma interface visualmente agradável.
- Toast customizado: Para exibir mensagens de erro mais chamativas.
- Android Studio 4.1 ou superior.
- Gradle 7.0 ou superior.
- Conta no [OpenWeather API](https://openweathermap.org/api) para obter uma chave de API.
1. Clone o repositório:
```bash
git clone git@github.com:SamuelRocha91/kotlinWeatherApp.git
```
2. Abra o projeto no **Android Studio**.
3. Adicione sua chave da API do OpenWeather no arquivo `local.properties`:
```
API_KEY=your_api_key_here
```
4. Compile e rode o projeto no seu emulador ou dispositivo Android.
- MainActivity.kt: Principal atividade da aplicação que gerencia a interface e lida com as interações do usuário.
- OpenWeather.kt: Interface que define as chamadas à API de clima usando Retrofit.
- Utilidades: Funções utilitárias, como a conversão de timestamp Unix para formato legível, podem ser extraídas e colocadas em uma classe de utilidades.
- Layouts: Arquivos de layout XML definidos na pasta
res/layout
, que incluem a estrutura da interface do usuário.
implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.5.2"
implementation "com.squareup.retrofit2:retrofit:2.9.0"
implementation "com.squareup.retrofit2:converter-gson:2.9.0"
implementation "com.google.android.material:material:1.4.0"
- Abra o app.
- Insira o nome de uma cidade no campo de busca.
- Clique no botão "Buscar".
- Veja as informações sobre o clima, incluindo:
- Temperatura atual.
- Sensação térmica.
- Umidade.
- Nome da cidade e país.