Skip to content

Latest commit

 

History

History
176 lines (132 loc) · 6.9 KB

README.md

File metadata and controls

176 lines (132 loc) · 6.9 KB

🎮 DOODLE JUMP - VIBECODE PROJECT

📋 Описание проекта

Doodle Jump - это классическая мобильная игра, реализованная на Android с использованием Kotlin. Игрок управляет персонажем, который должен прыгать по платформам, избегая врагов и собирая бонусы, чтобы достичь максимально возможной высоты.

🎯 Основные возможности:

  • Бесконечная игра: Платформы генерируются случайным образом
  • Система очков: Подсчет пройденной высоты
  • Враги: Опасные существа, которых нужно избегать
  • Платформы: Различные типы платформ для прыжков
  • Современный UI: Красивый и интуитивный интерфейс

🛠 Технологии

  • Язык программирования: Kotlin
  • Платформа: Android
  • Минимальная версия Android: API 21 (Android 5.0)
  • Система сборки: Gradle

📁 Структура проекта

DoodleJump/
├── app/
│   ├── src/main/
│   │   ├── java/com/example/doodlejump/
│   │   │   ├── MainActivity.kt      # Главная активность
│   │   │   ├── GameView.kt          # Игровая логика и отрисовка
│   │   │   ├── Player.kt            # Класс игрока
│   │   │   ├── Platform.kt          # Класс платформ
│   │   │   └── Enemy.kt             # Класс врагов
│   │   ├── res/                     # Ресурсы приложения
│   │   └── AndroidManifest.xml      # Манифест приложения
│   └── build.gradle.kts             # Конфигурация сборки
├── build.gradle.kts                 # Корневая конфигурация Gradle
└── settings.gradle.kts              # Настройки проекта

🚀 Как запустить проект

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

  • Android Studio (рекомендуется версия 2023.1.1 или выше)
  • JDK 11 или выше
  • Android SDK API 21+

Пошаговая инструкция:

  1. Клонирование репозитория

    git clone [URL_РЕПОЗИТОРИЯ]
cd DoodleJump

  2. Открытие проекта в Android Studio

    • Запустите Android Studio
    • Выберите "Open an existing project"
    • Укажите путь к папке DoodleJump

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

    • Дождитесь автоматической синхронизации Gradle
    • Или нажмите "Sync Now" если появится уведомление

  4. Запуск на устройстве/эмуляторе

    • Подключите Android устройство или запустите эмулятор
    • Нажмите кнопку "Run" (зеленый треугольник) в Android Studio
    • Выберите целевое устройство
    • Дождитесь установки и запуска приложения

🎮 Как играть

Управление:

  • Касание экрана: Персонаж автоматически прыгает
  • Удержание: Для более высоких прыжков

Цель игры:

  • Прыгайте по платформам как можно выше
  • Избегайте врагов
  • Собирайте бонусы для дополнительных очков
  • Установите новый рекорд!

Игровые элементы:

  • Зеленые платформы: Обычные платформы
  • Красные враги: Опасные существа
  • Бонусы: Дополнительные очки

🔧 Разработка

Основные классы:

MainActivity.kt

Главная активность приложения, отвечает за инициализацию игры и управление жизненным циклом.

GameView.kt

Основной класс игровой логики:

  • Отрисовка игровых объектов
  • Обработка столкновений
  • Генерация платформ и врагов
  • Подсчет очков

Player.kt

Класс игрока:

  • Позиция и движение
  • Физика прыжков
  • Обработка столкновений

Platform.kt

Класс платформ:

  • Различные типы платформ
  • Логика столкновений
  • Генерация позиций

Enemy.kt

Класс врагов:

  • Движение врагов
  • Логика столкновений с игроком

Добавление новых функций:

  1. Новые типы платформ:

    • Создайте новый класс в Platform.kt
    • Добавьте логику в GameView.kt

  2. Новые враги:

    • Расширьте класс Enemy.kt
    • Добавьте отрисовку в GameView.kt

  3. Бонусы:

    • Создайте новый класс Bonus.kt
    • Интегрируйте в игровую логику

📱 Сборка APK

Debug версия:

./gradlew assembleDebug

Release версия:

./gradlew assembleRelease

APK файл будет создан в папке app/build/outputs/apk/

🐛 Отладка

Логи:

  • Используйте Log.d(), Log.e() для отладки
  • Просматривайте логи в Android Studio через Logcat

Профилирование:

  • Android Studio Profiler для анализа производительности
  • Memory Profiler для отслеживания утечек памяти

📄 Лицензия

Этот проект является частью VibeCode и предназначен для образовательных целей.

🤝 Вклад в проект

  1. Форкните репозиторий
  2. Создайте ветку для новой функции
  3. Внесите изменения
  4. Создайте Pull Request

📞 Поддержка

Если у вас возникли вопросы или проблемы:

  • Создайте Issue в репозитории
  • Обратитесь к документации Android
  • Проверьте логи в Android Studio

VibeCode - создание качественных проектов с заботой о деталях! 🚀