154 lines
4.8 KiB
Markdown
154 lines
4.8 KiB
Markdown
# 🤖 Настройка 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
|
||
|