backup: before proxies page modernization
This commit is contained in:
Hiddify User
328
BUILD_INSTRUCTIONS.md
Normal file
328
BUILD_INSTRUCTIONS.md
Normal file
@@ -0,0 +1,328 @@
|
||||
# Инструкция по сборке Hiddify v2.5.7
|
||||
|
||||
## Успешная сборка выполнена 25 декабря 2025 г.
|
||||
|
||||
### Системные требования
|
||||
|
||||
- **ОС**: Linux (Ubuntu 24.04)
|
||||
- **Java**: OpenJDK 17
|
||||
- **Go**: 1.25.5 (для libcore, если собирать самостоятельно)
|
||||
- **Android SDK**: Platform 34, Build Tools, NDK 26.1.10909125
|
||||
- **Disk Space**: ~15GB свободного места
|
||||
|
||||
### Версии компонентов
|
||||
|
||||
#### Flutter
|
||||
```bash
|
||||
# Установка FVM (Flutter Version Manager)
|
||||
flutter pub global activate fvm
|
||||
|
||||
# Установка Flutter 3.24.0 (НЕ 3.24.3!)
|
||||
fvm install 3.24.0
|
||||
fvm use 3.24.0 --force
|
||||
```
|
||||
|
||||
**ВАЖНО**: В pubspec.yaml указано `flutter: ">=3.24.0 <=3.24.3"`, но в официальной сборке используется **3.24.0** (не 3.24.3). При использовании 3.24.3 возникает конфликт зависимостей intl.
|
||||
|
||||
#### Gradle & Android
|
||||
- **Gradle**: 8.7 (обновлен с 7.6.1)
|
||||
- **AGP** (Android Gradle Plugin): 8.2.0 (обновлен с 7.4.2)
|
||||
- **Kotlin**: 1.9.22 (обновлен с 1.8.21)
|
||||
- **compileSdk**: 34 (НЕ 35 - несовместим с libcore)
|
||||
- **targetSdk**: 34
|
||||
- **minSdk**: 21
|
||||
|
||||
#### Java
|
||||
```bash
|
||||
# Проверка версии
|
||||
java -version
|
||||
# Должно быть: openjdk 17.x.x
|
||||
|
||||
# Настройка Flutter для использования Java 17
|
||||
flutter config --jdk-dir="/usr/lib/jvm/java-1.17.0-openjdk-amd64"
|
||||
```
|
||||
|
||||
### Пошаговая инструкция сборки
|
||||
|
||||
#### 1. Клонирование репозитория
|
||||
|
||||
```bash
|
||||
cd /home/vodorod/dorod
|
||||
git clone --depth 1 --branch v2.5.7 --recurse-submodules https://github.com/hiddify/hiddify-app.git Umbrix-hid
|
||||
cd Umbrix-hid
|
||||
```
|
||||
|
||||
#### 2. Исправление зависимостей
|
||||
|
||||
**Проблема**: `flutter_easy_permission` устарел и не собирается с современными версиями Android.
|
||||
|
||||
**Решение**: Закомментировать в `pubspec.yaml`:
|
||||
|
||||
```yaml
|
||||
# Строки 90-92, было:
|
||||
#flutter_easy_permission: ^1.1.2
|
||||
flutter_easy_permission:
|
||||
git: https://github.com/unger1984/flutter_easy_permission.git
|
||||
|
||||
# Изменить на:
|
||||
#flutter_easy_permission: ^1.1.2
|
||||
#flutter_easy_permission:
|
||||
# git: https://github.com/unger1984/flutter_easy_permission.git
|
||||
```
|
||||
|
||||
**Изменения в коде** (`lib/features/common/qr_code_scanner_screen.dart`):
|
||||
|
||||
```dart
|
||||
// Закомментировать импорт:
|
||||
// import 'package:flutter_easy_permission/easy_permissions.dart';
|
||||
|
||||
// Закомментировать константы:
|
||||
// const permissions = [Permissions.CAMERA];
|
||||
// const permissionGroup = [PermissionGroup.Camera];
|
||||
|
||||
// В методе _requestCameraPermission() упростить:
|
||||
Future<bool> _requestCameraPermission() async {
|
||||
// Simplified: assuming permission is granted
|
||||
return true;
|
||||
}
|
||||
|
||||
// В dispose() закомментировать:
|
||||
// FlutterEasyPermission().dispose();
|
||||
|
||||
// Во всех методах, где проверяется hasPermission, заменить на:
|
||||
final hasPermission = true;
|
||||
```
|
||||
|
||||
#### 3. Обновление Gradle и AGP
|
||||
|
||||
**android/settings.gradle**:
|
||||
```gradle
|
||||
plugins {
|
||||
id "dev.flutter.flutter-plugin-loader" version "1.0.0"
|
||||
id "com.android.application" version "8.2.0" apply false // было 7.4.2
|
||||
id "org.jetbrains.kotlin.android" version "1.9.22" apply false // было 1.8.21
|
||||
}
|
||||
```
|
||||
|
||||
**android/gradle/wrapper/gradle-wrapper.properties**:
|
||||
```properties
|
||||
distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip
|
||||
# Было: gradle-7.6.1-bin.zip
|
||||
```
|
||||
|
||||
#### 4. Скачивание libcore
|
||||
|
||||
```bash
|
||||
mkdir -p android/app/libs
|
||||
curl -L https://github.com/hiddify/hiddify-next-core/releases/download/v3.1.8/hiddify-core-android.tar.gz | tar xz -C android/app/libs/
|
||||
```
|
||||
|
||||
Должен появиться файл `android/app/libs/libcore.aar` (~119MB).
|
||||
|
||||
#### 5. Генерация кода
|
||||
|
||||
```bash
|
||||
$HOME/.pub-cache/bin/fvm flutter pub get
|
||||
$HOME/.pub-cache/bin/fvm flutter pub run build_runner build --delete-conflicting-outputs
|
||||
```
|
||||
|
||||
Эта команда генерирует:
|
||||
- Riverpod providers
|
||||
- Freezed модели
|
||||
- Drift database код
|
||||
- Localization файлы
|
||||
- Asset файлы
|
||||
|
||||
#### 6. Сборка APK
|
||||
|
||||
```bash
|
||||
# Debug версия (без shrink для быстрой сборки)
|
||||
$HOME/.pub-cache/bin/fvm flutter build apk --debug --no-shrink
|
||||
|
||||
# Release версия (требует keystore)
|
||||
# $HOME/.pub-cache/bin/fvm flutter build apk --release
|
||||
```
|
||||
|
||||
**Результат**:
|
||||
```
|
||||
✓ Built build/app/outputs/flutter-apk/app-debug.apk (193 MB)
|
||||
✓ Built build/app/outputs/flutter-apk/app-arm64-v8a-debug.apk (88 MB)
|
||||
✓ Built build/app/outputs/flutter-apk/app-armeabi-v7a-debug.apk (83 MB)
|
||||
✓ Built build/app/outputs/flutter-apk/app-x86_64-debug.apk (86 MB)
|
||||
```
|
||||
|
||||
#### 7. Установка на устройство/эмулятор
|
||||
|
||||
```bash
|
||||
# Запуск эмулятора (если есть)
|
||||
$HOME/Android/Sdk/emulator/emulator -avd <ИМЯ_AVD>
|
||||
|
||||
# Проверка подключенных устройств
|
||||
$HOME/.pub-cache/bin/fvm flutter devices
|
||||
|
||||
# Установка APK
|
||||
$HOME/Android/Sdk/platform-tools/adb install -r build/app/outputs/flutter-apk/app-x86_64-debug.apk
|
||||
```
|
||||
|
||||
### Типичные ошибки и решения
|
||||
|
||||
#### Ошибка 1: intl version conflict
|
||||
```
|
||||
Because hiddify depends on flutter_localizations from sdk which depends on intl 0.20.2,
|
||||
intl 0.20.2 is required.
|
||||
So, because hiddify depends on intl ^0.19.0, version solving failed.
|
||||
```
|
||||
|
||||
**Причина**: Flutter 3.24.3 требует intl 0.20.2, но проект использует 0.19.0.
|
||||
|
||||
**Решение**: Использовать Flutter 3.24.0 (не 3.24.3).
|
||||
|
||||
#### Ошибка 2: flutter_easy_permission compilation error
|
||||
```
|
||||
error: package pub.devrel.easypermissions does not exist
|
||||
```
|
||||
|
||||
**Причина**: Пакет устарел и не имеет зависимости EasyPermissions.
|
||||
|
||||
**Решение**: Закомментировать в pubspec.yaml и коде (см. шаг 2).
|
||||
|
||||
#### Ошибка 3: Unresolved reference: nekohasekai
|
||||
```
|
||||
e: Unresolved reference: nekohasekai
|
||||
```
|
||||
|
||||
**Причина**: Отсутствует libcore.aar.
|
||||
|
||||
**Решение**: Скачать libcore v3.1.8 (см. шаг 4).
|
||||
|
||||
#### Ошибка 4: Error while dexing
|
||||
```
|
||||
ERROR:D8: com.android.tools.r8.kotlin.H
|
||||
Execution failed for task ':app:mergeExtDexDebug'.
|
||||
```
|
||||
|
||||
**Причина**: Несовместимость AGP 7.4.2 с Gradle 8.7.
|
||||
|
||||
**Решение**: Обновить AGP до 8.2.0 и Kotlin до 1.9.22 (см. шаг 3).
|
||||
|
||||
#### Ошибка 5: Namespace not specified
|
||||
```
|
||||
Namespace not specified. Specify a namespace in the module's build file.
|
||||
```
|
||||
|
||||
**Причина**: flutter_easy_permission не закомментирован полностью в pubspec.yaml.
|
||||
|
||||
**Решение**: Проверить что ВСЕ строки (включая git секцию) закомментированы.
|
||||
|
||||
#### Ошибка 6: Android resource linking failed
|
||||
```
|
||||
aapt2 E: Failed to load resources table in APK '.../android-35/android.jar'
|
||||
```
|
||||
|
||||
**Причина**: compileSdk 35 несовместим с AGP 7.x или поврежден SDK.
|
||||
|
||||
**Решение**: Использовать compileSdk 34.
|
||||
|
||||
### Структура изменений
|
||||
|
||||
#### Измененные файлы:
|
||||
|
||||
1. **pubspec.yaml**
|
||||
- Закомментирован flutter_easy_permission
|
||||
|
||||
2. **lib/features/common/qr_code_scanner_screen.dart**
|
||||
- Упрощена проверка permissions
|
||||
- Удалены вызовы FlutterEasyPermission
|
||||
|
||||
3. **android/settings.gradle**
|
||||
- AGP: 7.4.2 → 8.2.0
|
||||
- Kotlin: 1.8.21 → 1.9.22
|
||||
|
||||
4. **android/gradle/wrapper/gradle-wrapper.properties**
|
||||
- Gradle: 7.6.1 → 8.7
|
||||
|
||||
5. **android/app/build.gradle**
|
||||
- Без изменений (compileSdk 34, targetSdk 34 остались)
|
||||
|
||||
#### Добавленные файлы:
|
||||
|
||||
- **android/app/libs/libcore.aar** (119 MB) - Core библиотека sing-box
|
||||
|
||||
### Очистка после ошибок
|
||||
|
||||
Если сборка не удалась:
|
||||
|
||||
```bash
|
||||
# Полная очистка
|
||||
rm -rf ~/.gradle/caches/
|
||||
rm -rf ~/.pub-cache/git/flutter_easy_permission-*
|
||||
rm -rf .flutter-plugins*
|
||||
rm -f pubspec.lock
|
||||
|
||||
# Пересборка
|
||||
$HOME/.pub-cache/bin/fvm flutter clean
|
||||
$HOME/.pub-cache/bin/fvm flutter pub get
|
||||
$HOME/.pub-cache/bin/fvm flutter pub run build_runner build --delete-conflicting-outputs
|
||||
./android/gradlew -p android clean
|
||||
```
|
||||
|
||||
### Проверка окружения
|
||||
|
||||
```bash
|
||||
# Flutter
|
||||
$HOME/.pub-cache/bin/fvm flutter doctor -v
|
||||
|
||||
# Java
|
||||
java -version
|
||||
|
||||
# Gradle
|
||||
./android/gradlew -p android --version
|
||||
|
||||
# Android SDK
|
||||
ls -la $HOME/Android/Sdk/platforms/
|
||||
```
|
||||
|
||||
### Время сборки
|
||||
|
||||
- **Первая сборка**: ~3-5 минут (с загрузкой зависимостей)
|
||||
- **Повторная сборка**: ~1.5-2 минуты
|
||||
- **Сборка после clean**: ~2-3 минуты
|
||||
|
||||
### Размер артефактов
|
||||
|
||||
- **app-debug.apk** (universal): 193 MB
|
||||
- **app-arm64-v8a-debug.apk**: 88 MB (рекомендуется для современных устройств)
|
||||
- **app-armeabi-v7a-debug.apk**: 83 MB (для старых устройств)
|
||||
- **app-x86_64-debug.apk**: 86 MB (для эмуляторов)
|
||||
|
||||
### Примечания
|
||||
|
||||
1. **Не используйте системный Flutter** - только через FVM с версией 3.24.0
|
||||
2. **Java 17 обязателен** - Java 21 не совместим с Gradle 7.x/8.x конфигурацией проекта
|
||||
3. **libcore нельзя пропустить** - без него будут ошибки Kotlin компиляции
|
||||
4. **AGP 8.2+ обязателен** для Gradle 8.7
|
||||
5. **flutter_easy_permission** должен быть полностью закомментирован, включая git секцию
|
||||
|
||||
### Дополнительная информация
|
||||
|
||||
- **Официальный репозиторий**: https://github.com/hiddify/hiddify-app
|
||||
- **Релиз v2.5.7**: https://github.com/hiddify/hiddify-app/releases/tag/v2.5.7
|
||||
- **libcore v3.1.8**: https://github.com/hiddify/hiddify-next-core/releases/tag/v3.1.8
|
||||
- **CI/CD конфигурация**: `.github/workflows/build.yml` (использует Flutter 3.24.0)
|
||||
|
||||
### Контрольные суммы
|
||||
|
||||
```bash
|
||||
# Проверка libcore.aar
|
||||
ls -lh android/app/libs/libcore.aar
|
||||
# Должно быть: ~119M
|
||||
|
||||
# Проверка APK
|
||||
ls -lh build/app/outputs/flutter-apk/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**Дата создания документа**: 25 декабря 2025 г.
|
||||
**Версия Hiddify**: 2.5.7
|
||||
**Статус сборки**: ✅ Успешно
|
||||
Reference in New Issue
Block a user