# 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)
```bash
# Создать эмулятор 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"

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

### Сборка проекта
```bash
# Debug версия
./gradlew assembleDebug

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

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

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

### Установка APK
```bash
# Найти собранный 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 команды
```bash
# Просмотр логов приложения
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

### Проблемы с правами
```bash
chmod +x gradlew
```

### Проблемы с SDK
```bash
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