Oleafly'yi yayımlamak

Bir sürüm etiketinden eksiksiz bir taslak derleyin, her platform artefaktını gözden geçirin, ardından korumalı sürüm iş akışıyla yayımlayın.

Oleafly sürümleri bilinçli olarak iki aşamalıdır. Bir sürüm etiketi bir taslağı derler ve doğrular. Bir bakımcı, aynı taslağı ayrı bir iş akışı çalıştırmasıyla yayımlar.

main dalına itmek CI’yi çalıştırır ama sürüm oluşturmaz.

Taslağı derlemek

Güncel ve CI’si yeşil bir main dalından başlayın.

git switch main
git pull --ff-only
./scripts/bump-version.sh 0.3.6
git commit -am "chore: release v0.3.6"
git push origin main
git tag v0.3.6
git push origin v0.3.6

Etiket, .github/workflows/release.yml dosyasındaki iş akışını başlatır. Şu hedefleri derler:

Hedef	Yükleyiciler
macOS Apple Silicon	`.dmg`
Windows x64	`.msi` ve `-setup.exe`
Linux x64	`.AppImage` ve `.deb`
Linux ARM64	`.AppImage` ve `.deb`

Her hedef, kendi sabitlenmiş derleyici sidecar’larını getirir ve doğrular. İş akışı daha sonra dört güncelleyici parçasının tümünü tek bir latest.json dosyasında birleştirir. Taslak, yalnızca zorunlu her yükleyici ve güncelleyici girdisi mevcut olduğunda hazır sayılır.

Taslağı gözden geçirmek

Taslağı GitHub Sürümler sayfasında (yeni sekmede açılır) açın. Sürüm notlarını, yükleyici adlarını, sağlama toplamlarını, imzaları ve latest.json dosyasını denetleyin. Eksik bir taslağı yayımlamayın.

Yayımlamak

Actions → Release → Run workflow bölümünü açın. Aynı etiketi girin ve Publish the release seçeneğini belirleyin.

Yayımlama çalıştırması, derlemeyi ve artefakt denetimlerini yineler. Ayrıca sürüm adayını kullanarak Anthropic ve Google’a karşı canlı sözleşme testleri de çalıştırır. Son iş; desteklenen her platform ve eksiksiz güncelleyici akışı mevcut olmadıkça yayımlamayı reddeder.

Yayımlama, latest.json dosyasını kurulu uygulamaların görebileceği hale getirir. Bunu geri alınamaz bir üretim eylemi olarak görün. Yayımlama çalıştırması başarısız olursa sürümü taslak bırakın, nedenini düzeltin ve yeniden çalıştırın.

Sürüm numaraları

Oleafly anlamsal sürümlemeyi (semantic versioning) izler:

Yama, uyumlu düzeltmeler için; örneğin 0.3.5’ten 0.3.6’ya.
Küçük, uyumlu özellikler için; örneğin 0.3.5’ten 0.4.0’a.
Büyük, kırıcı değişiklikler ya da ilk kararlı sürüm için; örneğin 0.3.5’ten 1.0.0’a.

Önemli denetimler

Etiket; package.json, src-tauri/tauri.conf.json, src-tauri/Cargo.toml ve src-tauri/Cargo.lock dosyalarıyla eşleşmelidir. Bunları tek tek elle düzenlemek yerine scripts/bump-version.sh betiğini kullanın.
Sürüm notları, CHANGELOG.md içindeki eşleşen sürüm bölümünden gelir.
Yayımlanmış bir etiketi yeniden kullanmayın. Başarısız bir taslak için; yayınlanmamış etiketi değiştirmek için açık bir neden yoksa dalı düzeltin ve yeni bir sürüm oluşturun.
macOS imzalama ve tasdik, Apple sürüm gizli bilgilerini kullanır. Windows Authenticode, kendi gizli bilgileri yapılandırıldığında Azure Artifact Signing kullanır. Güncelleyici imzaları, ayrı Tauri imzalama anahtarını kullanır.

Güncelleyici imzalama ve geri alma davranışı için Otomatik güncellemeler sayfasına bakın. Kullanıcı kurulum yönergeleri İndirme ve kurulum bölümündedir.