Surum ve Uyumluluk

Sürüm tabanı, uyumluluk ve yükseltme

English · Türkçe · Languages / Diller

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

Bu Wiki 17 Eylül 2026 tarihinde incelenen v0.5.1 ekosistemini açıklar. Dal uçları değişebilir; kaynak bağlantıları aşağıdaki tam SHA'lara sabitlenmiştir.

Bileşen	Dal	İncelenen commit
Sunucu	main	356106c6610ce817fb9dfb03e391c85dd1726b24
SDK	python-library	9507fa902838f66400a603cea22b271a79d4eb9c
Editör	Editor	a4b3bff9120442533da957621684f34a65fcf15a
Örnekler	exampleApps	9c41f781449127c3c1ca39d41f90381c08a58abf

Release v0.5.1 17 Eylül 2026'da yayımlanmış olarak gözlemlendi. Etiket main commit'ine işaret eder; üç diğer dalın kodunu içeren ortak monorepo etiketi değildir. Aynı GitHub Release'e farklı dallardan üretilmiş varlıklar eklenebilir.

Uyumluluk tablosu

Sözleşme	Mevcut değer	Değişince incelenecek alan
Server/SDK/Editor ürün sürümü	0.5.1	Kurulum, paket ve davranış belgeleri
Python test kapsamı	3.10–3.14	pyproject, CI, binary wheels
Qt asgari	6.4	Compiler/ABI/WebEngine/packaging
Graph schema	1	Graph belgeleri ve compiler
Plugin API	2; IID /2.0	Native plugin yeniden derleme/manifest
Control plane	/__forge/editor/v1	Auth, request modelleri, SDK ve UI
Uygulama API prefix	Projeye ait	SDK helper/route sözleşmesi

v0.5.1'in öne çıkan davranışları

v0.5.0 görsel düzenleme/ekip ekosistemini devam ettirir; JWKS/HTTP egress, DNS rebinding sınırı, lineer-zaman regex, URL/header/ICE metadata ve SDK girdi kontrollerini sıkılaştırır. JSON hot reload ve app hata izolasyonu, güncel CLI/runtime yolunun parçasıdır. Editör dalında aynı 0.5.1 sürüm numarası altında workflow ve installer düzeni düzeltmesi vardır.

Bir önceki sürümde kabul edilen gevşek pattern/header/URL girdisinin artık reddedilmesi beklenebilir. "Patch sürümüdür, hiçbir config değişmez" varsayımıyla canlıya geçmeyin.

Yükseltme akışı

1. Şu anda çalışan server/SDK/Editor commit ve artifact isimlerini kaydedin.
2. app/, iş DB, iç DB, media/attachments ve sırlar için tutarlı yedek alın.
3. Yeni resmi kaynağı ayrı ortamda kurun; mevcut deployment'ın üzerine gelişigüzel extract etmeyin.
4. Gerçek yapılandırmayı sırları uygun ortamdan sağlayarak doğrulayın.
5. forge validate, doctor --production, route/OpenAPI farkı ve DB migration provası yapın.
6. Auth/tenant/owner, idempotency replay, realtime, Editor session/save ve SDK contract'larını test edin.
7. Etkilenen Wiki sayfalarını bakım haritasına göre güncelleyin.
8. Rollout ve gözlemlenebilirlik sonrasında eski binary'ye dönmenin veri/schema açısından mümkün olup olmadığını kontrol edin.

Yayın kaynaklarında gözlenen farklar

Konu	Gözlenen durum	Wiki'nin yaklaşımı
SDK DELETE retry	Eski prose ile kod farklı	Kodda PUT/DELETE anahtarsız izinli
Editor ayar menüsü	Eski EDITOR.md, UI ile farklı	Güncel Settings → Network and editor settings…
postgres-api preset	İsim PostgreSQL çağrıştırıyor	URL verilmezse SQLite olduğu açıklanır
forge init	README tekrar çalıştırmayı öneriyor	Var olan .env reddi ve force rotasyonu belirtilir
Release checksum	Listede sidecar görünmüyor	İlk kurulum kaynak yoluyla verilir
SDK wheel adı	py3-none-any_lib.whl	Doğrulanmış source commit kurulumu kullanılır

Bu farklar bu görevde kaynak koduna uygulanmış düzeltmeler değildir; Wiki doğruluk notlarıdır. Sonraki release'te düzeldiklerinde ilgili notlar kaldırılmalı/güncellenmelidir. Release varlıklarının tam gözlem listesi burada.

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.

• main/CHANGELOG.md
• python-library/json_api_forge/options.py
• Editor/editor/src/MainWindow.cpp
• main/framework/cli.py

---

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