main funcions fixes

2025-09-29 22:06:11 +09:00
parent 40e016e128
commit c8c3274527
7995 changed files with 1517998 additions and 1057 deletions
--- a/android-client/README.md
+++ b/android-client/README.md
@@ -0,0 +1,127 @@
+# 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