El WeatherApp es una aplicación Android sencilla que permite al usuario buscar información sobre el clima de cualquier ciudad en tiempo real, utilizando la API de OpenWeather. Con una interfaz amigable, el usuario puede ver la temperatura actual, la sensación térmica, la humedad y la hora de la última actualización del clima.
- Búsqueda del clima en tiempo real por ciudad.
- Muestra la temperatura actual (en Celsius), la sensación térmica, la humedad y el nombre de la ciudad.
- Interfaz minimalista y amigable.
- Toast personalizado para errores y mensajes.
- Kotlin: Lenguaje principal utilizado en el desarrollo de la aplicación.
- Coroutines: Utilizado para operaciones asíncronas como solicitudes a la API del clima.
- Retrofit: Biblioteca utilizada para consumir APIs RESTful.
- OpenWeather API: API utilizada para obtener la información meteorológica.
- Material Design: Componentes del diseño material de Android para una interfaz visualmente agradable.
- Toast personalizado: Para mostrar mensajes de error más llamativos.
- Android Studio 4.1 o superior.
- Gradle 7.0 o superior.
- Cuenta en [OpenWeather API](https://openweathermap.org/api) para obtener una clave de API.
1. Clona el repositorio:
```bash
git clone git@github.com:SamuelRocha91/kotlinWeatherApp.git
```
2. Abre el proyecto en **Android Studio**.
3. Agrega tu clave de API de OpenWeather en el archivo `local.properties`:
```
API_KEY=your_api_key_here
```
4. Compila y ejecuta el proyecto en tu emulador o dispositivo Android.
- MainActivity.kt: Actividad principal de la aplicación que gestiona la interfaz y maneja las interacciones del usuario.
- OpenWeather.kt: Interfaz que define las llamadas a la API del clima utilizando Retrofit.
- Utilidades: Funciones utilitarias, como la conversión de timestamp Unix a un formato legible, pueden ser extraídas y colocadas en una clase de utilidades.
- Layouts: Archivos de diseño XML definidos en la carpeta
res/layout, que incluyen la estructura de la interfaz de usuario.
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"
- Abre la aplicación.
- Ingresa el nombre de una ciudad en el campo de búsqueda.
- Haz clic en el botón "Buscar".
- Ve la información sobre el clima, incluyendo:
- Temperatura actual.
- Sensación térmica.
- Humedad.
- Nombre de la ciudad y país.