1 Building from Source
BBQQYT edited this page 2025-08-10 18:58:39 +03:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Сборка из исходников

Если вы хотите внести свои изменения, добавить новые функции или просто скомпилировать приложение для себя, следуйте этому руководству.

📋 Требования

  1. Android Studio: Рекомендуется последняя стабильная версия (Hedgehog или новее). Скачать можно с официального сайта.
  2. Java Development Kit (JDK): JDK 17 или выше. Обычно поставляется вместе с последними версиями Android Studio.
  3. Git: Для клонирования репозитория.

🔧 Процесс сборки

  1. Клонируйте репозиторий

    Откройте терминал или Git Bash и выполните команду:

    git clone https://github.com/BBQQYT/ChaosAlicePro.git
    

    Или используйте встроенные средства Android Studio: File -> New -> Project from Version Control... и вставьте URL репозитория.

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

    После клонирования откройте папку ChaosAlicePro в Android Studio. Система сборки Gradle автоматически начнет синхронизацию и скачивание всех необходимых зависимостей. Этот процесс может занять несколько минут.

  3. Дождитесь окончания сборки

    Следите за прогрессом в нижней части окна Android Studio. После успешной синхронизации вы сможете видеть структуру проекта в панели слева.

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

    • Подключите Android-устройство к компьютеру (с включенным режимом отладки по USB) или запустите эмулятор Android через Device Manager.
    • Убедитесь, что ваше устройство или эмулятор выбрано в выпадающем списке рядом с кнопкой "Run".
    • Нажмите зеленую кнопку "Run 'app'" (Shift + F10).

    Android Studio скомпилирует, соберет APK и установит его на ваше устройство/эмулятор.

️Возможные проблемы

  • Ошибка Hilt/Kapt: Если вы столкнулись с ошибками компиляции, связанными с Hilt, попробуйте выполнить полную очистку и пересборку проекта через меню Android Studio:
    Build -> Rebuild Project
    
  • Несовместимость версий: Убедитесь, что версии Gradle, Android Gradle Plugin (AGP) и Kotlin, указанные в файлах build.gradle, совместимы с вашей версией Android Studio.

После успешной сборки приложение запустится на вашем устройстве. Не забудьте настроить API-ключи, как описано в руководстве Начало работы.