god_eye/android-client/README.md

GodEye Android Client - Setup Instructions

Требования для разработки

1. Android SDK

• Android SDK Platform-tools
• Android SDK Build-tools 34.0.0
• Android 14 (API 34) Platform
• Android Emulator

2. Java Development Kit

• JDK 8 или выше

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

Создание AVD (Android Virtual Device)

# Создать эмулятор Android 14 с Google APIs
avdmanager create avd -n "GodEye_Emulator" -k "system-images;android-34;google_apis;x86_64" -d "pixel_4"

# Запуск эмулятора
emulator -avd GodEye_Emulator -no-snapshot-save

Альтернативно через Android Studio:

1. Tools → AVD Manager
2. Create Virtual Device
3. Choose Pixel 4 или подобное устройство
4. Select Android 14 (API 34) system image
5. Name: "GodEye_Emulator"

Команды сборки

Сборка проекта

# Debug версия
./gradlew assembleDebug

# Release версия  
./gradlew assembleRelease

# Установка на эмулятор/устройство
./gradlew installDebug

# Запуск тестов
./gradlew test

Установка APK

# Найти собранный APK
ls app/build/outputs/apk/debug/

# Установить через adb
adb install app/build/outputs/apk/debug/app-debug.apk

# Или напрямую
./gradlew installDebug

Настройки IDE

Android Studio

1. Open Project → выбрать папку /android-client
2. File → Project Structure → Project SDK: Android API 34
3. Build → Make Project
4. Run → Run 'app'

IntelliJ IDEA

1. New → Project from Existing Sources
2. Import as Gradle project
3. SDK Location: установить путь к Android SDK
4. Gradle JVM: JDK 8+

Отладка

ADB команды

# Просмотр логов приложения
adb logcat | grep "GodEye\|SocketManager\|CameraManager"

# Просмотр устройств
adb devices

# Перенаправление портов для локального сервера
adb reverse tcp:3001 tcp:3001

Настройка сети для эмулятора

• Localhost backend: http://10.0.2.2:3001
• Внешний сервер: http://YOUR_IP:3001

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

android-client/
├── app/
│   ├── src/main/
│   │   ├── java/com/godeye/android/
│   │   │   ├── MainActivity.kt
│   │   │   ├── network/SocketManager.kt
│   │   │   └── camera/CameraManager.kt
│   │   ├── res/layout/activity_main.xml
│   │   └── AndroidManifest.xml
│   └── build.gradle
├── gradle/wrapper/
├── gradlew
└── settings.gradle

Troubleshooting

Проблемы с правами

chmod +x gradlew

Проблемы с SDK

export ANDROID_HOME=/path/to/android/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools

Проблемы с сетью в эмуляторе

• Убедиться что backend сервер запущен на порту 3001
• Использовать 10.0.2.2 вместо localhost в эмуляторе
• Проверить правила firewall