# 🤖 Настройка Android SDK для CORP-MAUI

## Проблема
При сборке Android проекта выдается ошибка:
```
error XA5300: Не удалось найти каталог пакета SDK для Android
```

## Решение

У вас установлен Android SDK по пути: `D:\Applications\Android\SDK`

### Способ 1: Использование Directory.Build.props (рекомендуется)

Файл `Directory.Build.props` уже создан в корне решения со следующим содержимым:

```xml
<Project>
  <PropertyGroup>
    <!-- Путь к Android SDK -->
    <AndroidSdkDirectory>D:\Applications\Android\SDK</AndroidSdkDirectory>
  </PropertyGroup>
</Project>
```

### Способ 2: Установка переменных окружения

Установите системные переменные окружения:

**Через PowerShell (от имени администратора):**
```powershell
[System.Environment]::SetEnvironmentVariable("ANDROID_HOME", "D:\Applications\Android\SDK", "User")
[System.Environment]::SetEnvironmentVariable("ANDROID_SDK_ROOT", "D:\Applications\Android\SDK", "User")
```

**Через GUI Windows:**
1. Откройте "Система" → "Дополнительные параметры системы"
2. Нажмите "Переменные среды"
3. В разделе "Переменные среды пользователя" нажмите "Создать"
4. Создайте переменные:
   - `ANDROID_HOME` = `D:\Applications\Android\SDK`
   - `ANDROID_SDK_ROOT` = `D:\Applications\Android\SDK`
5. Нажмите "ОК" и перезапустите IDE

### Способ 3: Использование скриптов сборки

В проекте созданы скрипты для удобной сборки:

**PowerShell скрипт (рекомендуется):**
```powershell
.\build-android.ps1
```

**Batch скрипт:**
```batch
build-android.bat
```

Скрипты автоматически:
- Устанавливают переменные окружения
- Проверяют наличие Android SDK
- Очищают предыдущую сборку
- Восстанавливают зависимости
- Собирают проект для Android

## Проверка установки

После применения любого из способов, проверьте сборку:

```powershell
cd D:\Danil\Projects\DOTNET\CORP-MAUI
dotnet build -c Debug -f net9.0-android
```

Или используйте скрипт:
```powershell
.\build-android.ps1
```

## Требования для Android

Убедитесь, что установлены:

1. **Android SDK Platform** (минимум API 21 для CORP-MAUI)
2. **Android SDK Build-Tools**
3. **Android SDK Platform-Tools**
4. **Android Emulator** (для тестирования)

Проверить установленные компоненты можно в Android Studio:
- Tools → SDK Manager → SDK Platforms
- Tools → SDK Manager → SDK Tools

## Сборка для разных конфигураций

```powershell
# Debug сборка
dotnet build -c Debug -f net9.0-android

# Release сборка
dotnet build -c Release -f net9.0-android

# Запуск на эмуляторе
dotnet build -t:Run -f net9.0-android
```

## Возможные проблемы

### 1. "Java SDK not found"
Установите JDK 17 или выше и добавьте в PATH.

### 2. "Android SDK tools not found"
Убедитесь, что в `D:\Applications\Android\SDK` есть папки:
- `platforms`
- `platform-tools`
- `build-tools`

### 3. Rider не видит Android SDK
1. File → Settings → Build, Execution, Deployment → Toolset and Build
2. Укажите путь к Android SDK: `D:\Applications\Android\SDK`
3. Перезапустите Rider

### 4. После установки переменных среды ничего не изменилось
**Перезапустите:**
- PowerShell / терминал
- JetBrains Rider / Visual Studio
- В крайнем случае - систему

## Вывод APK

После успешной сборки APK файлы находятся в:
```
CORP-MAUI\bin\Debug\net9.0-android\
```

Файлы:
- `com.companyname.corpmaui.apk` - неподписанный APK
- `com.companyname.corpmaui-Signed.apk` - подписанный APK для установки

## Установка APK на устройство

```powershell
# Через ADB
adb install "CORP-MAUI\bin\Debug\net9.0-android\com.companyname.corpmaui-Signed.apk"

# Или используйте Rider
# Run → Edit Configurations → + → .NET MAUI → выберите Android устройство
```

---

**Дата:** 2026-01-09  
**Версия:** 1.0