# Otomatik güncellemeler

Oleafly'nin platformlar arası güncelleyici akışını nasıl derlediği, imzaladığı, doğruladığı ve yayımladığı.

Oleafly, Tauri'nin güncelleyici eklentisini kullanır. Uygulama açılışta en son GitHub sürümünü denetler ve yeni bir sürüm varsa kendi güncelleme penceresini açar. Kullanıcılar ayrıca uygulama menüsünden ya da **Hakkında → Güncellemeleri denetle** üzerinden denetleyebilir.

## Sürüm akışı

Her platform derlemesi, imzalı güncelleyici artefaktları ve bir `latest.json` parçası oluşturur. Sürüm iş akışı bu parçaları, dört derlemenin tümü bitene kadar ayrı tutar; ardından her hedefin sahip olduğu girdileri tek bir kanonik bildirimde birleştirir.

Son bildirimde macOS Apple Silicon, Windows x64, Linux x64 ve Linux ARM64 için girdiler bulunmalıdır. Bildirim, bir bakımcı korumalı yayımlama iş akışını çalıştırana kadar taslak sürüme bağlı kalır. Kurulu uygulamalar taslağı görmez.

Uygulama, `latest.json` dosyasını GitHub Sürümlerinden indirir. Kurulumdan önce Tauri, güncelleyici imzasını `src-tauri/tauri.conf.json` içine gömülü genel anahtara karşı doğrular. Eksik, imzasız ya da değiştirilmiş artefaktlar reddedilir.

Sürüm notları `CHANGELOG.md` içindeki eşleşen bölümden gelir. İş akışı o bölümü çıkarır ve hem GitHub sürüm gövdesi hem de güncelleme penceresi için kullanır.

## İmzalama anahtarları

Genel güncelleyici anahtarı `src-tauri/tauri.conf.json` içine işlenmiştir. Özel anahtar yalnızca GitHub Actions gizli bilgilerinde bulunur:

- `TAURI_SIGNING_PRIVATE_KEY`
- `TAURI_SIGNING_PRIVATE_KEY_PASSWORD`

Özel anahtarı asla commit etmeyin. Açığa çıkarsa yeni bir anahtar çifti oluşturun, depo gizli bilgisini güncelleyin ve gömülü genel anahtarı değiştirin. Var olan kurulumlar kendi gömülü anahtarlarına güvenir; bu yüzden anahtar döndürme, planlanmış bir elle güncelleme yolu gerektirir.

İşletim sistemi imzalaması, güncelleyici imzalamasından ayrıdır. macOS derlemeleri, sürüm gizli bilgileri mevcut olduğunda Apple kod imzalama ve tasdik kullanır. Windows derlemeleri, kimlik bilgileri mevcut olduğunda Azure Artifact Signing kullanır.

## Başarısızlık ve geri alma

Başarısız bir denetim ya da indirme, kurulu uygulamayı değiştirmez. İmza başarısızlığı kurulumu engeller. Uygulama, yalnızca doğrulanmış indirme başarıyla kurulduktan sonra yeniden başlar.

Oleafly, tamamlanmış bir güncellemeyi kendiliğinden geri almaz. Önceki bir sürüme dönmek için uygulamayı kapatın, önemli projelerinizi yedekleyin, önceki resmi yükleyiciyi indirin, doğrulayın ve geçerli sürümün üzerine kurun.

Taslama ve yayımlama süreci için [Oleafly'yi yayımlamak](/docs/engineering/releasing/) sayfasına bakın.