88 lines
3.4 KiB
Markdown
88 lines
3.4 KiB
Markdown
# 🚀 Быстрая сборка Windows Portable ZIP
|
||
|
||
## Проблема решена! ✅
|
||
|
||
Теперь в ZIP будут файлы которые помогут пользователям не запутаться:
|
||
|
||
```
|
||
umbrix-portable/
|
||
├── 📄 README.txt ⭐ ПЕРВЫЙ в списке - ясная инструкция!
|
||
├── 🚀 Запустить Umbrix.bat ⭐ Удобный запуск одним кликом
|
||
├── 📱 Umbrix.exe ⭐ Основное приложение
|
||
├── ⚙️ UmbrixCli.exe ⚠️ Служебная утилита
|
||
└── ...DLL и папки...
|
||
```
|
||
|
||
---
|
||
|
||
## 📦 Команда для сборки на Windows
|
||
|
||
```powershell
|
||
# 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)}}
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ Что увидит пользователь после распаковки
|
||
|
||
1. **README.txt** - первый файл (по алфавиту с символом '═')
|
||
- Большой заголовок с инструкцией
|
||
- Указывает запускать **Umbrix.exe**
|
||
- Предупреждает не запускать UmbrixCli.exe
|
||
|
||
2. **Запустить Umbrix.bat** - второй файл
|
||
- Русское название понятное всем
|
||
- Запускает Umbrix.exe автоматически
|
||
|
||
3. **Umbrix.exe** - основное приложение
|
||
- Яркая цветная иконка
|
||
- Выделяется визуально
|
||
|
||
4. **UmbrixCli.exe** - служебная утилита
|
||
- Название "Cli" намекает что это командная строка
|
||
- Большинство не будет трогать
|
||
|
||
---
|
||
|
||
## 🎯 Альтернативы (если не понравится)
|
||
|
||
### Вариант 1: Скрыть CLI в подпапку
|
||
```powershell
|
||
# При создании 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`:
|
||
```yaml
|
||
executable_name: Start-Umbrix.exe # Без пробела!
|
||
```
|
||
⚠️ Но это сломает update скрипты которые ищут `umbrix.exe`
|
||
|
||
### Вариант 3: Только батник
|
||
Удалить README.txt, оставить только `Запустить Umbrix.bat` как единственный понятный способ запуска.
|
||
|
||
---
|
||
|
||
## 📝 Полная документация
|
||
|
||
См. [WINDOWS_PORTABLE_ZIP.md](./WINDOWS_PORTABLE_ZIP.md) для:
|
||
- Создания релиза в Gitea
|
||
- Загрузки ZIP через API
|
||
- Тестирования auto-update
|
||
- Сравнения ZIP vs EXE
|