Editor Derleme

Editörü derleme, Qt Creator, ZIP ve installer

English · Türkçe · Languages / Diller

Kapsam: JSON API Forge 0.5.1 · İnceleme: 17 Eylül 2026 · Dil: Türkçe

Gereksinimler

CMake 3.24+, C++20 compiler, Qt 6.4+ Core/Gui/Widgets/Network, test için Qt Test, Ninja gerekir. WebEngineWidgets opsiyoneldir. Proje Qt public API'leri ve bundled bounded ZIP decoder kullanır; Qt private ZIP header'ı gerekmez.

Kaynak: büyük harfle Editor dalı. Bu Wiki commit'i a4b3bff9120442533da957621684f34a65fcf15adır. main veya server v0.5.1 tag'inden desktop source beklemeyin.

CLI build

git clone --branch Editor --single-branch https://github.com/YoungLionOrganization/JSON-API-Forge.git JSON-API-Forge-Editor
cd JSON-API-Forge-Editor
git checkout a4b3bff9120442533da957621684f34a65fcf15a
cmake -S . -B build/editor -G Ninja -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTING=ON -DFORGE_EDITOR_WARNINGS_AS_ERRORS=ON
cmake --build build/editor --parallel
ctest --test-dir build/editor --output-on-failure
cmake --install build/editor --prefix build/stage

Qt CMake paketi bulunamıyorsa kit/environment ya da CMAKE_PREFIX_PATH bu makinede seçilir; kişisel mutlak Qt yolunu ortak repoya sabitlemeyin. Farklı mimari/compiler için ayrı build dizini kullanın.

Qt Creator

Repository root CMakeLists.txt açılır. Kit compiler, Qt sürümü ve CPU mimarisi eşleşir. CMakePresets.json içindeki dev veya release preset seçilir. Target JSONAPIForgeEditor, executable JSON-API-Forge-Editor adını taşır.

Windows'ta resmi CI MSVC kitlerini kullanır. LLVM-MinGW veya başka toolchain seçilecekse Qt binary'si aynı ABI'ye ait olmalıdır; yalnız compiler yolunu değiştirmek yeterli değildir. WebEngine paketi her compiler/mimari kombinasyonunda bulunmayabilir; eksikse güvenli external-browser fallback vardır.

Stage, portable ZIP ve runtime

Sistem	Stage sonrası
Windows	Staged EXE üzerinde windeployqt --release --no-translations --compiler-runtime
Linux	editor/packaging/linux/bundle-qt.sh + resmi launcher
macOS	Staged .app üzerinde macdeployqt -always-overwrite

editor/packaging/stage-notices.py ve CMake'in kurduğu legal notices korunur. ZIP stage içeriğini kapsar; sadece executable koymak portable dağıtım değildir. Paketlenmiş uygulamayı temiz ortamda başlatın ve screenshot/test sonucunu kontrol edin.

Qt Installer Framework

Resmi workflow platforma uygun, hash'i sabitlenmiş IFW 4.8.1 araçlarını kullanır. Windows örneği:

./editor/packaging/qtifw/build-installer.ps1 `
  -StageDir build/stage `
  -OutputFile JSON-API-Forge-Editor-v0.5.1-windows-x64-setup.exe

Linux/macOS:

bash editor/packaging/qtifw/build-installer.sh build/stage JSON-API-Forge-Editor-v0.5.1-linux-x64-setup.run linux
# macOS için platform ve çıktı adını değiştirin:
# bash editor/packaging/qtifw/build-installer.sh build/stage JSON-API-Forge-Editor-v0.5.1-macos-arm64-setup.dmg macos

Önce platform Qt runtime deploy adımı tamamlanmalı ve binarycreator PATH'te bulunmalıdır. Shared tema editor/packaging/qtifw/config/installer.qss içindedir. Büyük logo header pixmap yerine platform/application icon kullanılır.

Ubuntu 24.04 ARM64 IFW araçları için resmi prepare-linux-tools.sh private compatibility kitaplıklarını hazırlar; bunlar Editor runtime'ına veya sistem library'lerine kopyalanmaz. IFW macOS Intel aracı Apple Silicon'da Rosetta gerektirebilir; paketlenen Editor yine native ARM64 olabilir.

Doğrulama

Altı hedefin her biri ZIP + installer üretir; toplam 12 ürün dosyası ve checksum sidecar'ları workflow çıktısının parçasıdır. Artifact üretimi resmi Release'e yüklemeyi kendiliğinden yapmaz. --graph-preview, --team-preview, --window-size ve --screenshot görsel inceleme argümanlarıdır; bütün etkileşimli özelliklerin uçtan uca testi değildir.

Kaynak ve doğrulama

Bu sayfa aşağıdaki sabit commitlerdeki davranışı açıklar. Yeni bir sürümde aynı davranışın sürdüğünü varsaymayın.

• Editor/CMakeLists.txt
• Editor/editor/CMakeLists.txt
• Editor/CMakePresets.json
• Editor/QT-CREATOR-BUILD-GUIDE.md
• Editor/.github/workflows/editor-build.yml

---

Wiki ana sayfa · Tüm sayfalar · Sürüm ve bakım