128 lines
3.2 KiB
Markdown
128 lines
3.2 KiB
Markdown
# 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
|