Документация по настройке проекта Osclass Android App в Android Studio

Содержание

1. Требования к системе

2. Установка Android Studio

3. Настройка Android Studio

4. Получение исходного кода проекта

5. Импорт проекта в Android Studio

6. Настройка проекта

7. Настройка эмулятора

8. Запуск проекта

9. Устранение неполадок

---

1. Требования к системе {#требования}

Минимальные требования:

• Операционная система: Windows 10/11, macOS 10.14+, Linux (Ubuntu 18.04+)

• Оперативная память: 8 ГБ (рекомендуется 16 ГБ)

• Свободное место на диске: 10 ГБ (рекомендуется 20 ГБ)

• Разрешение экрана: 1280×800 минимум

• Процессор: 64-битный

Дополнительные требования:

• JDK 17 (включена в Android Studio)

• Доступ в интернет для загрузки SDK компонентов

---

2. Установка Android Studio {#установка-android-studio}

Шаг 1: Загрузка Android Studio

1. Перейдите на официальный сайт Android Studio

2. Нажмите «Download Android Studio»

3. Выберите версию для вашей операционной системы

Шаг 2: Установка на Windows

1. Запустите скачанный файл .exe

2. Следуйте инструкциям мастера установки

3. Выберите компоненты для установки:

   • Android Studio

   • Android Virtual Device

   • Performance (Intel® HAXM) — для ускорения эмулятора

4. Укажите путь установки (рекомендуется оставить по умолчанию)

5. Завершите установку

Шаг 3: Установка на macOS

1. Откройте скачанный файл .dmg

2. Перетащите Android Studio в папку Applications

3. Запустите Android Studio из папки Applications

Шаг 4: Установка на Linux

1. Распакуйте скачанный архив в выбранную директорию

2. Перейдите в директорию android-studio/bin

3. Запустите studio.sh

4. Для создания ярлыка используйте меню Tools → Create Desktop Entry

---

3. Настройка Android Studio {#настройка-android-studio}

Первый запуск и настройка

1. Запустите Android Studio

2. Импорт настроек (при первом запуске):

   • Выберите «Do not import settings» если запускаете впервые

3. Мастер настройки:

   • Выберите тип установки: Standard (рекомендуется)

   • Выберите тему: Light или Darcula

   • Проверьте выбранные компоненты SDK

4. Завершение установки:

   • Дождитесь загрузки компонентов SDK

   • Нажмите «Finish» после завершения

---

4. Получение исходного кода проекта {#получение-исходного-кода}

Вариант 1: Клонирование из Git

git clone https://github.com/seoadd/osclass_java_app1.git
cd osclass_java_app1

Вариант 2: Загрузка архива

1. Скачайте архив проекта

2. Распакуйте в удобную директорию

3. Запомните путь к папке проекта

---

5. Импорт проекта в Android Studio {#импорт-проекта}

Шаг 1: Открытие проекта

1. Запустите Android Studio

2. На стартовом экране выберите:

   • «Open» — для уже существующего проекта

   • «Get from VCS» — для клонирования из Git

Шаг 2: Настройка импорта

1. Укажите путь к папке проекта (где находится build.gradle)

2. Дождитесь синхронизации Gradle

3. При запросе на обновление Gradle wrapper выберите вариант:

   • «Don’t remind me again for this project» (если проект использует конкретную версию)

Шаг 3: Настройка JDK

1. Перейдите в File → Project Structure

2. В разделе SDK Location убедитесь, что выбран путь к Android SDK

3. Убедитесь, что используется JDK версии 11 или 17

---

6. Настройка проекта {#настройка-проекта}

Файл local.properties

Создайте файл app/local.properties если его нет:

sdk.dir=C\\:\\\\Users\\\\[Username]\\\\AppData\\\\Local\\\\Android\\\\Sdk
# или для macOS/Linux
# sdk.dir=/Users/[Username]/Library/Android/sdk

Настройка Gradle

1. Откройте файл build.gradle (Module: app)

2. Проверьте следующие настройки:

android {
    compileSdk 33  // Проверьте версию SDK
    
    defaultConfig {
        applicationId "com.example.osclassapp"
        minSdk 23    // Минимальная версия Android
        targetSdk 33 // Целевая версия Android
        versionCode 1
        versionName "1.0"
    }
    
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

Настройка зависимостей

Проверьте файл app/build.gradle в разделе dependencies:

dependencies {

implementation ‘androidx.appcompat:appcompat:1.5.1’
implementation ‘androidx.core:core:1.9.0’

// Material Design
implementation ‘com.google.android.material:material:1.7.0’

    
    // Другие зависимости Osclass App
    // ...
}

Синхронизация Gradle

1. Нажмите «Sync Now» вверху экрана

2. Или выберите File → Sync Project with Gradle Files

3. Дождитесь загрузки всех зависимостей

---

7. Настройка эмулятора {#настройка-эмулятора}

Создание виртуального устройства

1. Откройте Device Manager (иконка вверху спрада)

2. Нажмите «Create device»

3. Выберите тип устройства (рекомендуется Pixel 5)

4. Выберите образ системы (рекомендуется):

   • Release Name: Tiramisu

   • API Level: 33

   • ABI: x86_64 (для производительности)

5. Завершите создание устройства

Настройка HAXM (для Windows)

1. Проверьте включение виртуализации в BIOS/UEFI

2. Запустите SDK Manager

3. Перейдите на вкладку SDK Tools

4. Установите «Intel x86 Emulator Accelerator (HAXM installer)»

---

8. Запуск проекта {#запуск-проекта}

Шаг 1: Сборка проекта

1. Выберите Build → Make Project или Ctrl+F9

2. Проверьте окно «Build» внизу на наличие ошибок

Шаг 2: Запуск на эмуляторе

1. Выберите созданное устройство в списке устройств

2. Нажмите кнопку «Run» (зеленая стрелка) или Shift+F10

3. Дождитесь запуска эмулятора и установки приложения

Шаг 3: Запуск на реальном устройстве

1. Включите «Режим разработчика» на телефоне:

   • Настройки → О телефоне → 7 раз нажмите «Номер сборки»

2. Включите «Отладку по USB»

3. Подключите телефон через USB

4. Разрешите отладку при появлении запроса

5. Выберите устройство в Android Studio и запустите приложение

---

9. Устранение неполадок {#устранение-неполадок}

Распространенные проблемы и решения

1. Ошибка Gradle sync failed

# Решение:
# Очистите кэш Gradle:
File → Invalidate Caches and Restart

2. Ошибка SDK location not found

# Решение:
# Создайте или обновите local.properties с правильным путем к SDK

3. Ошибки сборки с зависимостями

# Решение:
# Очистите проект:
Build → Clean Project
Build → Rebuild Project

4. Медленная работа эмулятора

# Решение:
- Увеличьте RAM эмулятора (3-4 ГБ)
- Включите графический ускоритель
- Используйте образы x86_64

5. Проблемы с подключением реального устройства

# Решение:
- Установите драйверы ADB для вашего устройства
- Проверьте кабель USB
- Перезагрузите телефон и компьютер

Полезные сочетания клавиш

• Build Project: Ctrl+F9

• Run App: Shift+F10

• Debug App: Shift+F9

• Sync Project with Gradle Files: Ctrl+Shift+O

• Search Everywhere: Shift+Shift

---

Дополнительные настройки для разработки

Настройка Git

git config --global user.name "Ваше Имя"
git config --global user.email "ваш@email.com"

Настройка кода

1. Форматирование кода: Ctrl+Alt+L

2. Импорт оптимизации: Ctrl+Alt+O

3. Автоматическое форматирование: File → Settings → Editor → Code Style

Мониторинг производительности

1. Профилировщик: View → Tool Windows → Profiler

2. Логи: View → Tool Windows → Logcat

3. Инспектор макета: Tools → Layout Inspector

Примечание: Данная документация актуальна для Android Studio Giraffe 2022.3.1 и выше. Настройки могут отличаться в зависимости от версии Android Studio и конфигурации проекта Osclass Android App.