Skip to content

Latest commit

 

History

History
118 lines (82 loc) · 6.7 KB

README_ru.md

File metadata and controls

118 lines (82 loc) · 6.7 KB

Вот перевод вашего README на русский язык:

Kotlin Projects Logo WeatherAPP Kotlin Projects Logo

WeatherApp

english version app spanish version app russian version app

🌐 Português Español English Русский 中文 العربية

📜 Описание

WeatherApp — это простое Android-приложение, позволяющее пользователю в реальном времени искать информацию о погоде в любом городе, используя API OpenWeather. С интуитивно понятным интерфейсом пользователь может видеть текущую температуру, ощущаемую температуру, влажность и время последнего обновления погоды.

🌟 Функции

  • Поиск погоды в реальном времени по городу.
  • Отображение текущей температуры (в Цельсиях), ощущения, влажности и названия города.
  • Минималистичный и удобный интерфейс.
  • Персонализированный Toast для ошибок и сообщений.

🛠️ Используемые технологии

  • Kotlin: основной язык, используемый для разработки приложения.
  • Coroutines: используется для асинхронных операций, таких как запросы к API погоды.
  • Retrofit: библиотека, используемая для работы с RESTful API.
  • OpenWeather API: API, используемое для получения метеорологической информации.
  • Material Design: компоненты дизайна Material от Android для визуально приятного интерфейса.
  • Персонализированный Toast: для отображения более заметных сообщений об ошибках.

⚙️ Настройка проекта

Предварительные требования

- Android Studio 4.1 или выше.
- Gradle 7.0 или выше.
- Учетная запись в [OpenWeather API](https://openweathermap.org/api) для получения API-ключа.

Установка

1. Клонируйте репозиторий:
   ```bash
   git clone git@github.com:SamuelRocha91/kotlinWeatherApp.git
   ```

2. Откройте проект в **Android Studio**.

3. Добавьте свой API-ключ OpenWeather в файл `local.properties`:
   ```
   API_KEY=your_api_key_here
   ```

4. Соберите и запустите проект на эмуляторе или устройстве Android.

📂 Структура кода

  • MainActivity.kt: Главная активность приложения, управляющая интерфейсом и обрабатывающая взаимодействия пользователя.
  • OpenWeather.kt: Интерфейс, определяющий вызовы к API погоды с использованием Retrofit.
  • Утилиты: Утилитарные функции, такие как преобразование временной метки Unix в читаемый формат, могут быть извлечены и помещены в класс утилит.
  • Макеты: XML-файлы макетов, определенные в папке res/layout, которые включают структуру пользовательского интерфейса.

📦 Зависимости

  • 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"

🧑‍🤝‍🧑 Как использовать

  1. Откройте приложение.
  2. Введите название города в поле поиска.
  3. Нажмите кнопку «Поиск».
  4. Просмотрите информацию о погоде, включая:
    • Текущую температуру.
    • Ощущаемую температуру.
    • Влажность.
    • Название города и страны.

📁 Другие проекты на Kotlin: