🌐 Tarayıcı Entegrasyonu Kurulum Kılavuzu

Bu belge, Download Manager'ın Google Chrome ve Microsoft Edge tarayıcıları ile nasıl entegre edileceğini adım adım açıklar. Bu entegrasyon sayesinde tarayıcıda bir indirme başladığında otomatik olarak yakalanır veya sağ tık menüsü ile indirmeler uygulamaya gönderilir.

🏗️ Mimari Yapı

Sistem üç ana bileşenden oluşur:

Tarayıcı Eklentisi: İndirme isteklerini yakalayan JavaScript bileşeni.
Browser Bridge (Native Messaging Host): Tarayıcı ile Windows arasında köprü kuran küçük bir konsol uygulaması.
Main App (WPF): İndirmeyi gerçekleştiren ana uygulama.

🛠️ Adım 1: Browser Bridge'i Derleme

Tarayıcının bir .exe dosyası ile konuşması gerekir. Önce köprü uygulamasını derleyin:

cd DownloadManager
dotnet build src/DownloadManager.BrowserBridge/DownloadManager.BrowserBridge.csproj -c Release

Derleme sonrası oluşan dosya yolu şuna benzer olacaktır: D:\Calismalar\AI\hDM\DownloadManager\src\DownloadManager.BrowserBridge\bin\Release\net8.0\DownloadManager.BrowserBridge.exe

📝 Adım 2: Manifest Dosyasını Yapılandırma

src/DownloadManager.BrowserBridge/manifest.json dosyasını açın ve şu iki alanı güncelleyin:

path: Buraya derlediğiniz .exe dosyasının tam yolunu yazın.
allowed_origins: Buraya eklentiyi tarayıcıya yükledikten sonra alacağınız Eklenti ID'sini yazacaksınız (3. adımda).

Örnek (Geçici):

{
  "name": "com.downloadmanager.bridge",
  "description": "Download Manager Native Messaging Bridge",
  "path": "D:\\Calismalar\\AI\\hDM\\DownloadManager\\src\\DownloadManager.BrowserBridge\\bin\\Release\\net8.0\\DownloadManager.BrowserBridge.exe",
  "type": "stdio",
  "allowed_origins": [
    "chrome-extension://[EKLEMTI_ID_BURAYA]/"
  ]
}

🔑 Adım 3: Registry (Kayıt Defteri) Kaydı

Tarayıcının bu köprüyü tanıması için Windows Kayıt Defteri'ne eklenmesi gerekir.

src/DownloadManager.BrowserBridge/register_bridge.reg dosyasını bir metin düzenleyici ile açın.
Dosya yollarının manifest.json dosyanızın bulunduğu konumu gösterdiğinden emin olun.
Dosyaya çift tıklayarak çalıştırın ve gelen uyarıya "Evet" deyin.

🔌 Adım 4: Eklentiyi Tarayıcıya Yükleme

Tarayıcınızda (Chrome veya Edge) chrome://extensions/ adresine gidin.
Sağ üstteki "Geliştirici Modu" (Developer Mode) anahtarını açın.
"Paketlenmemiş öğe yükle" (Load unpacked) butonuna tıklayın.
Proje klasörünüzdeki DownloadManager/browser-extension klasörünü seçin.
Yükleme tamamlandığında eklenti kutusunda bir "Kimlik" (ID) oluşacaktır (Örn: abcdefg...).
Bu ID'yi kopyalayın ve 2. adımdaki manifest.json dosyasında [EKLEMTI_ID_BURAYA] yerine yapıştırın.

🚀 Kullanım ve Test

Download Manager (WPF) uygulamasını çalıştırın ve açık tutun.
Tarayıcıda herhangi bir dosyayı (Örn: bir .zip veya .iso dosyası) indirmeye çalışın.
Eklenti indirmeyi iptal edecek ve linki otomatik olarak Download Manager listesine ekleyecektir.
Alternatif olarak, herhangi bir linke Sağ Tık > Download Manager ile İndir diyebilirsiniz.

❓ Sorun Giderme

İndirme Yakalanmıyor: DownloadManager.WPF.exe'nin açık olduğundan emin olun.
Tarayıcı Hatası: Tarayıcı "Native host not found" hatası veriyorsa Registry yolunu ve manifest.json içindeki path değerini kontrol edin.
Loglar: Köprü uygulaması hata aldığında kendi klasöründe bridge_error.log dosyası oluşturur, burayı kontrol edebilirsiniz.

3.7 KiB Raw Blame History Unescape Escape