README_ru.md

Приложение для курсов обмена валют

🌐

Это приложение для Android, которое позволяет пользователям просматривать курсы обмена различных валют. Приложение использует API API Layer для получения актуальных данных о курсах обмена.

📋 Функциональные возможности

• Показывает список доступных валют.
• Позволяет пользователям выбрать валюту и просмотреть ее курсы обмена.
• Обработка ошибок для улучшения пользовательского опыта.

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

• Android Studio
• Gradle

🛠️ Настройка

1. Регистрация в API Layer

Прежде чем использовать приложение, вам необходимо зарегистрироваться на API Layer для получения ключа API.

2. Добавление ключа API

После регистрации добавьте свой ключ API в файл gradle.properties вашего проекта:

API_KEY="ваш_ключ_api"

3. Зависимости

Убедитесь, что в вашем файле build.gradle есть следующие зависимости:

dependencies {
    implementation 'com.squareup.retrofit2:retrofit:2.9.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.2'
    implementation 'com.google.android.material:material:1.4.0'
}

4. Запуск приложения

1. Откройте проект в Android Studio.
2. Убедитесь, что ваше устройство Android или эмулятор настроены правильно.
3. Запустите приложение из Android Studio.

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

Приложение структурировано следующим образом:

• MainActivity: Главная активность, которая управляет бизнес-логикой и взаимодействиями пользовательского интерфейса.
• ApiLayer: Уровень API, который использует Retrofit для взаимодействия с API API Layer.
• MainViewModel: Класс ViewModel, который управляет состоянием пользовательского интерфейса и выполняет вызовы API.
• activity_main.xml: XML-разметка главной активности.

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

• ☀️ Weather App
• 👤 Social Login
• 📜 Virtual Menu