feat: Windows development tooling — build, install, uninstall scripts + setup guide
- build-windows.ps1: one-command Flutter build + Inno Setup installer pipeline - install.ps1: manual Windows installer (registry, shortcuts, file associations) - uninstall.ps1: clean removal script - docs/windows-setup.md: Windows dev environment setup guide - docs/index.md: updated with new files
This commit is contained in:
@@ -19,10 +19,21 @@
|
||||
| 2026-07-27 | [session-windows-ci.md](session-windows-ci.md) | **Windows setup.exe yeniden derlendi, Gitea CI eklendi** |
|
||||
| 2026-07-27 | [session-2026-07-27.md](session-2026-07-27.md) | **Session özeti** — rotate aktif, StartupWMClass ile taskbar gruplama |
|
||||
| 2026-07-27 | [image-canvas-interactions.md](image-canvas-interactions.md) | Detaylı analiz: contrast, saturation, rotate implementasyon planı |
|
||||
| 2026-08-10 | [windows-setup.md](windows-setup.md) | **Windows Development Ortam Kurulum Rehberi** — Flutter SDK, VS Build Tools, CMake, Inno Setup kurulum adımları |
|
||||
| önceki | [zoom-clamp-mekanizmasi.md](zoom-clamp-mekanizmasi.md) | Zoom clamp mekanizması (letterbox-aware) |
|
||||
|
||||
## Geliştirme Akışı — Otomatik Build ve Kurulum
|
||||
|
||||
### Linux
|
||||
1. Debug build: `flutter build linux --debug`
|
||||
2. Sisteme kurulum: `./install.sh` (debug bundle tercih edilir → `~/.local/lib/imajviewer/`)
|
||||
|
||||
### Windows
|
||||
1. Ortam kurulumu: [windows-setup.md](windows-setup.md) rehberini takip edin
|
||||
2. Build + installer: `.\build-windows.ps1`
|
||||
3. Manuel kurulum (build çıktılarından): `.\install.ps1`
|
||||
4. Kaldırma: `.\uninstall.ps1`
|
||||
|
||||
Projede değişiklik yapıldıktan sonra otomatik yapılır (ayrıca istenmez):
|
||||
1. Debug build: `flutter build linux --debug`
|
||||
2. Sisteme kurulum: `./install.sh` (debug bundle tercih edilir → `~/.local/lib/imajviewer/`)
|
||||
|
||||
217
docs/windows-setup.md
Normal file
217
docs/windows-setup.md
Normal file
@@ -0,0 +1,217 @@
|
||||
# Windows Development Ortam Kurulum Rehberi
|
||||
|
||||
Bu doküman, ImajViewer Flutter projesini Windows üzerinde geliştirmek için gerekli ortamın sıfırdan kurulmasını adım adım anlatır.
|
||||
|
||||
## Gereksinimler
|
||||
|
||||
| Araç | Minimum Versiyon | Açıklama |
|
||||
|------|-----------------|----------|
|
||||
| Flutter SDK | 3.27+ (stable) | UI framework |
|
||||
| Visual Studio 2022 | Build Tools veya Community | C++ derleyici (MSVC) |
|
||||
| CMake | 3.14+ | Build sistemi |
|
||||
| Inno Setup | 6.x | Windows installer (.exe) oluşturma |
|
||||
|
||||
## Adım 1: Flutter SDK Kurulumu
|
||||
|
||||
### Yöntem A: Resmi kurulum (Önerilen)
|
||||
|
||||
1. [Flutter SDK'yı indirin](https://docs.flutter.dev/get-started/install/windows)
|
||||
2. ZIP'i `C:\src\flutter` dizinine çıkarın
|
||||
3. PATH'e ekleyin:
|
||||
|
||||
```powershell
|
||||
# PowerShell (Admin)
|
||||
[Environment]::SetEnvironmentVariable(
|
||||
"PATH",
|
||||
"$([Environment]::GetEnvironmentVariable("PATH", "Machine"))\;C:\src\flutter\bin",
|
||||
"Machine"
|
||||
)
|
||||
```
|
||||
|
||||
4. Yeni terminalde doğrulayın:
|
||||
|
||||
```powershell
|
||||
flutter doctor
|
||||
```
|
||||
|
||||
### Yöntem B: Winget ile kurulum
|
||||
|
||||
```powershell
|
||||
winget install --id OpenFlutter.FlutterSDK
|
||||
```
|
||||
|
||||
### Flutter doctor kontrolleri
|
||||
|
||||
```powershell
|
||||
flutter doctor
|
||||
```
|
||||
|
||||
Çıktıda `[✗]` işaretli bileşenler için önerilen adımları uygulayın. En azından şunlar `✓` olmalı:
|
||||
|
||||
- Flutter
|
||||
- Android toolchain (opsiyonel, sadece mobile geliştirme için)
|
||||
- Visual Studio (eğer kuruluysa)
|
||||
- Connected device (Windows)
|
||||
|
||||
## Adım 2: Visual Studio 2022 Build Tools Kurulumu
|
||||
|
||||
Flutter Windows build'i için MSVC C++ derleyicisi gerekir.
|
||||
|
||||
### Seçenek A: Visual Studio Build Tools (Sadece build araçları)
|
||||
|
||||
1. [Visual Studio Build Tools 2022](https://visualstudio.microsoft.com/visual-cpp-build-tools/) indirin
|
||||
2. Kurulum sihirbazında **"Desktop development with C++"** workload'unu işaretleyin
|
||||
3. Aşağıdaki bileşenler otomatik seçilecektir:
|
||||
- MSVC v143 - VS 2022 C++ x64/x86 build tools
|
||||
- Windows 10/11 SDK
|
||||
- CMake tools (opsiyonel ama önerilir)
|
||||
|
||||
### Seçenek B: Visual Studio Community (Tam IDE)
|
||||
|
||||
1. [Visual Studio Community 2022](https://visualstudio.microsoft.com/vs/community/) indirin
|
||||
2. Kurulumda **"Desktop development with C++"** workload'unu seçin
|
||||
|
||||
### Doğrulama
|
||||
|
||||
```powershell
|
||||
cl
|
||||
```
|
||||
|
||||
Çıktıda `Microsoft (R) C/C++ Optimizing Compiler` görünmelidir.
|
||||
|
||||
## Adım 3: CMake Kurulumu
|
||||
|
||||
Visual Studio Build Tools ile birlikte gelir ancak bağımsız kurulum da yapılabilir.
|
||||
|
||||
### Winget ile:
|
||||
|
||||
```powershell
|
||||
winget install --id Kitware.CMake
|
||||
```
|
||||
|
||||
### Doğrulama:
|
||||
|
||||
```powershell
|
||||
cmake --version
|
||||
```
|
||||
|
||||
## Adım 4: Inno Setup 6 Kurulumu
|
||||
|
||||
Windows installer (.exe) oluşturmak için gereklidir.
|
||||
|
||||
1. [Inno Setup 6](http://www.jrsoftware.org/isdl.php#stable) indirin (`is.exe`)
|
||||
2. Kurulumu tamamlayın (varsayılan: `C:\Program Files (x86)\Inno Setup 6`)
|
||||
|
||||
### Doğrulama:
|
||||
|
||||
```powershell
|
||||
Test-Path "C:\Program Files (x86)\Inno Setup 6\ISCC.exe"
|
||||
```
|
||||
|
||||
## Adım 5: Projeyi Hazırlama
|
||||
|
||||
```powershell
|
||||
cd C:\projects\imajviewer
|
||||
|
||||
# Bağımlılıkları indir
|
||||
flutter pub get
|
||||
|
||||
# Analiz et
|
||||
flutter analyze
|
||||
|
||||
# Test çalıştır
|
||||
flutter test
|
||||
```
|
||||
|
||||
## Adım 6: Windows Build
|
||||
|
||||
### Debug build:
|
||||
|
||||
```powershell
|
||||
flutter build windows --debug
|
||||
```
|
||||
|
||||
Çıktı: `build\windows\x64\runner\Debug\`
|
||||
|
||||
### Release build:
|
||||
|
||||
```powershell
|
||||
flutter build windows --release
|
||||
```
|
||||
|
||||
Çıktı: `build\windows\x64\runner\Release\`
|
||||
|
||||
## Adım 7: Installer Oluşturma (Inno Setup)
|
||||
|
||||
```powershell
|
||||
# Release build yapıldıktan sonra
|
||||
& "C:\Program Files (x86)\Inno Setup 6\ISCC.exe" windows\installer.iss
|
||||
```
|
||||
|
||||
Çıktı: `dist\imajviewer_setup_1.1.0.exe`
|
||||
|
||||
## Tek Komutla Her Şey
|
||||
|
||||
Tüm build + installer pipeline'ını tek komutla çalıştırın:
|
||||
|
||||
```powershell
|
||||
.\build-windows.ps1
|
||||
```
|
||||
|
||||
Bu script:
|
||||
1. `flutter pub get`
|
||||
2. `flutter build windows --release`
|
||||
3. Inno Setup ile `.exe` installer oluşturur
|
||||
|
||||
## Sorun Giderme
|
||||
|
||||
### "Unable to find Visual Studio installation" hatası
|
||||
|
||||
```powershell
|
||||
flutter config --enable-windows-desktop
|
||||
```
|
||||
|
||||
Visual Studio 2022'nin doğru kurulduğunu `flutter doctor` ile kontrol edin.
|
||||
|
||||
### CMake hataları
|
||||
|
||||
CMake'in PATH'te olduğundan emin olun:
|
||||
|
||||
```powershell
|
||||
$env:PATH += ";C:\Program Files\CMake\bin"
|
||||
cmake --version
|
||||
```
|
||||
|
||||
### Inno Setup bulunamadı
|
||||
|
||||
`build-windows.ps1` script'i otomatik arar. Manuel çalıştırmak için:
|
||||
|
||||
```powershell
|
||||
& "C:\Program Files (x86)\Inno Setup 6\ISCC.exe" windows\installer.iss
|
||||
```
|
||||
|
||||
### Flutter doctor'da Android SDK uyarısı
|
||||
|
||||
Sadece desktop geliştirme yapıyorsanız bu uyarıları görmezden gelebilirsiniz.
|
||||
|
||||
## Kurulum Sonrası
|
||||
|
||||
Ortam hazır olduğunda:
|
||||
|
||||
```powershell
|
||||
# Build + installer
|
||||
.\build-windows.ps1
|
||||
|
||||
# Manuel kurulum (build çıktılarından)
|
||||
.\install.ps1
|
||||
|
||||
# Uninstall
|
||||
.\uninstall.ps1
|
||||
```
|
||||
|
||||
## Sistem Gereksinimleri (Minimum)
|
||||
|
||||
- Windows 10 (1809) veya üzeri
|
||||
- 4 GB RAM (8 GB önerilir)
|
||||
- ~4 GB disk alanı (Flutter SDK + VS Build Tools + proje)
|
||||
- x64 mimari
|
||||
Reference in New Issue
Block a user