3.4 KiB
3.4 KiB
🚀 Быстрая сборка Windows Portable ZIP
Проблема решена! ✅
Теперь в ZIP будут файлы которые помогут пользователям не запутаться:
umbrix-portable/
├── 📄 README.txt ⭐ ПЕРВЫЙ в списке - ясная инструкция!
├── 🚀 Запустить Umbrix.bat ⭐ Удобный запуск одним кликом
├── 📱 Umbrix.exe ⭐ Основное приложение
├── ⚙️ UmbrixCli.exe ⚠️ Служебная утилита
└── ...DLL и папки...
📦 Команда для сборки на Windows
# 1. Собрать Release
flutter build windows --release
# 2. Скопировать файлы для пользователей + создать ZIP
$buildPath = "build\windows\x64\runner\Release"
Copy-Item "windows\packaging\portable\README.txt" -Destination "$buildPath\" -Force
Copy-Item "windows\packaging\portable\Запустить Umbrix.bat" -Destination "$buildPath\" -Force
$zipName = "umbrix-1.7.5-portable-windows-x64.zip"
Compress-Archive -Path "$buildPath\*" -DestinationPath $zipName -Force
# 3. Проверить
Get-Item $zipName | Select-Object Name, @{N="MB";E={[math]::Round($_.Length/1MB,2)}}
✅ Что увидит пользователь после распаковки
-
README.txt - первый файл (по алфавиту с символом '═')
- Большой заголовок с инструкцией
- Указывает запускать Umbrix.exe
- Предупреждает не запускать UmbrixCli.exe
-
Запустить Umbrix.bat - второй файл
- Русское название понятное всем
- Запускает Umbrix.exe автоматически
-
Umbrix.exe - основное приложение
- Яркая цветная иконка
- Выделяется визуально
-
UmbrixCli.exe - служебная утилита
- Название "Cli" намекает что это командная строка
- Большинство не будет трогать
🎯 Альтернативы (если не понравится)
Вариант 1: Скрыть CLI в подпапку
# При создании ZIP переместить CLI в tools/
New-Item -Path "$buildPath\tools" -ItemType Directory -Force
Move-Item "$buildPath\UmbrixCli.exe" "$buildPath\tools\" -Force
Compress-Archive -Path "$buildPath\*" -DestinationPath $zipName -Force
Вариант 2: Переименовать основное приложение
Изменить в windows/packaging/exe/make_config.yaml:
executable_name: Start-Umbrix.exe # Без пробела!
⚠️ Но это сломает update скрипты которые ищут umbrix.exe
Вариант 3: Только батник
Удалить README.txt, оставить только Запустить Umbrix.bat как единственный понятный способ запуска.
📝 Полная документация
См. WINDOWS_PORTABLE_ZIP.md для:
- Создания релиза в Gitea
- Загрузки ZIP через API
- Тестирования auto-update
- Сравнения ZIP vs EXE