ilk commit

docs/browser_integration.md

@@ -0,0 +1,77 @@
+# 🌐 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:
+1.  **Tarayıcı Eklentisi:** İndirme isteklerini yakalayan JavaScript bileşeni.
+2.  **Browser Bridge (Native Messaging Host):** Tarayıcı ile Windows arasında köprü kuran küçük bir konsol uygulaması.
+3.  **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:
+
+```powershell
+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:
+
+1.  **path:** Buraya derlediğiniz `.exe` dosyasının **tam yolunu** yazın.
+2.  **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):
+```json
+{
+  "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. 
+
+1.  `src/DownloadManager.BrowserBridge/register_bridge.reg` dosyasını bir metin düzenleyici ile açın.
+2.  Dosya yollarının `manifest.json` dosyanızın bulunduğu konumu gösterdiğinden emin olun.
+3.  Dosyaya çift tıklayarak çalıştırın ve gelen uyarıya "Evet" deyin.
+
+---
+
+## 🔌 Adım 4: Eklentiyi Tarayıcıya Yükleme
+1.  Tarayıcınızda (Chrome veya Edge) `chrome://extensions/` adresine gidin.
+2.  Sağ üstteki **"Geliştirici Modu"** (Developer Mode) anahtarını açın.
+3.  **"Paketlenmemiş öğe yükle"** (Load unpacked) butonuna tıklayın.
+4.  Proje klasörünüzdeki `DownloadManager/browser-extension` klasörünü seçin.
+5.  Yükleme tamamlandığında eklenti kutusunda bir **"Kimlik" (ID)** oluşacaktır (Örn: `abcdefg...`).
+6.  **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
+1.  **Download Manager (WPF)** uygulamasını çalıştırın ve açık tutun.
+2.  Tarayıcıda herhangi bir dosyayı (Örn: bir .zip veya .iso dosyası) indirmeye çalışın.
+3.  Eklenti indirmeyi iptal edecek ve linki otomatik olarak Download Manager listesine ekleyecektir.
+4.  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.