corp-app/ANDROID_SETUP.md

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

Проблема

При сборке Android проекта выдается ошибка:

error XA5300: Не удалось найти каталог пакета SDK для Android

Решение

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

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

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

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

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

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

Через 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 скрипт (рекомендуется):

.\build-android.ps1

Batch скрипт:

build-android.bat

Скрипты автоматически:

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

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

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

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

Или используйте скрипт:

.\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

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

# 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 на устройство

# Через 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