Tauri Uygulamasınızda macOS QuickLook Önizlemesini Kolayca Nasıl Ekleriz

macOS’un yerleşik dosya önizleme sistemi QuickLook, yıllardır kullanıcıların vazgeçilmezi oldu. Finder’da herhangi bir dosyaya tıklayıp boşluk tuşuna bastığınızda karşınıza çıkan anlık görüntüleme deneyimi, sistemin bütünlüğünü pekiştiriyor. Peki ya bu özellik, Tauri gibi modern masaüstü uygulamalarıyla geliştirilen bir dosya yöneticisinde nasıl kullanılabilir?

HiyokoKit’in MTP destekli dosya yöneticisi, bu yerel deneyimi Rust ve TypeScript’in minimum kod yüküyle masaüstü uygulamalarına taşıyor. QuickLook entegrasyonunun ardındaki teknik detaylara ve kullanıcı deneyimine yakından bakalım.

QuickLook Nedir ve Neden Önemlidir?

macOS’un QuickLook sistemi, dosyaları açmadan hızlıca görüntülemenizi sağlayan yerleşik bir araçtır. Resimler, PDF’ler, videolar ve metin dosyaları için çalışır ve Finder’daki boşluk tuşuyla tetiklenir. Bu sistem, üçüncü parti uygulamaların da yerel deneyime uyum sağlamasını zorunlu kılar.

Bir dosya yöneticisi için QuickLook entegrasyonu, uygulamanın tamamlanmış hissettirmesi için olmazsa olmaz bir özelliktir. Kullanıcılar, boşluk tuşuyla tetiklenen yerel önizlemeyi beklerler. Eğer bu özellik eksikse, uygulama eksik veya profesyonel olmayan bir izlenim bırakabilir. HiyokoKit gibi uygulamalar, bu boşluğu doldurarak macOS ekosistemine doğal bir şekilde entegre olur.

Rust ile QuickLook’u Tetiklemek

Rust tabanlı bir Tauri uygulamasında QuickLook’u tetiklemek oldukça basittir. macOS’un yerleşik qlmanage komut satırı aracı, bu işlem için ideal bir çözümdür. Aşağıdaki kod parçası, bir dosya yolunu alarak QuickLook penceresini açar:

use std::process::Command;

#[tauri::command]
async fn preview_file(file_path: String) -> Result<(), AppError> {
    Command::new("qlmanage")
        .args(["-p", &file_path])
        .spawn()
        .map_err(|e| AppError::Preview(e.to_string()))?;
    Ok(())
}

Burada dikkat edilmesi gereken nokta, qlmanage -p komutunun doğrudan yerel dosya yollarını desteklemesidir. Bu da yerel dosyalar için QuickLook entegrasyonunu son derece basit hale getirir.

MTP Dosyaları için Özel Yaklaşım

MTP (Media Transfer Protocol) üzerinden bağlı cihazlardaki dosyalar, yerel bir dosya sistemi gibi davranmaz. Bu nedenle, QuickLook’u kullanabilmek için dosyaları önce geçici bir konuma indirmek gerekir. İşlem şu şekilde ilerler:

1. Cihazdan geçici bir dizine dosya indirilir.
2. QuickLook ile önizleme yapılır.
3. Geçici dosya belirli bir süre sonra otomatik olarak silinir.

Aşağıdaki Rust kodu, bu akışı nasıl yönetebileceğinizi gösteriyor:

#[tauri::command]
async fn preview_mtp_file(
    device_path: String,
    filename: String,
) -> Result<(), AppError> {
    // Geçici dizine indir
    let temp_path = std::env::temp_dir().join(&filename);
    download_from_device(&device_path, &temp_path).await?;

    // QuickLook’u aç
    Command::new("qlmanage")
        .args(["-p", temp_path.to_str().unwrap()])
        .spawn()?;

    // Geçici dosyayı 30 saniye sonra temizle
    let temp_clone = temp_path.clone();
    tokio::spawn(async move {
        tokio::time::sleep(Duration::from_secs(30)).await;
        std::fs::remove_file(temp_clone).ok();
    });

    Ok(())
}

30 saniyelik bekleme süresi, kullanıcıların dosyayı incelemesi için yeterli bir süredir. Ancak büyük dosyalar (örneğin RAW fotoğraflar veya videolar) için bu süre artırılabilir ya da pencere kapatıldığında temizleme işlemi tetiklenebilir.

Klavye Kısayolu Entegrasyonu

QuickLook’un yerel hissi, boşluk tuşunun doğru şekilde entegre edilmesine bağlıdır. Frontend tarafında bu işlem oldukça basittir. Aşağıdaki TypeScript kodu, seçili dosyaya boşluk tuşuyla basıldığında QuickLook’un tetiklenmesini sağlar:

useEffect(() => {
    const handleKeyDown = (e: KeyboardEvent) => {
        if (e.code === 'Space' && selectedFile) {
            e.preventDefault();
            invoke('preview_file', { filePath: selectedFile.path });
        }
    };

    window.addEventListener('keydown', handleKeyDown);
    return () => window.removeEventListener('keydown', handleKeyDown);
}, [selectedFile]);

Bu kod, Finder’daki davranışla tamamen uyumlu çalışır. Kullanıcılar, alışık oldukları şekilde boşluk tuşuna basar ve anında yerel önizlemeyi görürler.

Sonuç: Küçük Bir Kodla Büyük Bir Etki

QuickLook entegrasyonu, sadece 10 satır Rust ve 10 satır TypeScript koduyla gerçekleştirilebilir. Buna rağmen, kullanıcı deneyiminde oluşturduğu fark oldukça büyüktür. Üçüncü parti bir dosya yöneticisine yerel önizleme eklemek, uygulamanın profesyonel ve tamamlanmış hissetmesini sağlar.

Eğer bir dosya yöneticisi geliştiriyorsanız ya da macOS’ta dosya işlemleriyle ilgilenen bir uygulama üzerinde çalışıyorsanız, bu entegrasyonu uygulamak için gereken çaba neredeyse sıfırdır. Öte yandan, kullanıcıların uygulamanıza olan güvenini ve memnuniyetini önemli ölçüde artırabilir. Bu tür özellikler, uygulamanızın kalitesini doğrudan yansıtır.

Bugün QuickLook entegrasyonunu uygulamaya koymak için harcadığınız birkaç satır kod, kullanıcılarınıza sunduğunuz deneyimi kökten değiştirebilir. Bu basit ama etkili yaklaşımı deneyerek uygulamanızın macOS ekosistemine daha iyi entegre olmasını sağlayabilirsiniz.