Manifest V3, Chrome eklentilerinin nasıl tanımlandığını ve tarayıcıyla nasıl çalıştığını belirleyen güncel eklenti mimarisidir. Bir Chrome eklentisi geliştirmek istiyorsanız Manifest V3’ü anlamak önemlidir; çünkü izinler, background işlemleri, güvenlik ve mağaza uyumluluğu bu yapı üzerinden şekillenir.
Bu yazıda Manifest V3’ü teknik detaya boğmadan, işletme ve ürün ekiplerinin anlayacağı şekilde açıklıyoruz.
Manifest Dosyası Ne İşe Yarar?
Her Chrome eklentisinin merkezinde manifest.json dosyası bulunur. Bu dosya eklentinin kimliğidir.
Manifest dosyasında genellikle şunlar yer alır:
- Eklenti adı
- Versiyon
- Açıklama
- İkonlar
- İzinler
- Hangi scriptlerin çalışacağı
- Popup sayfası
- Background service worker
- Hangi sitelerde çalışacağı
Chrome, eklentiyi yüklerken önce bu dosyaya bakar.
Manifest V3 Neden Önemli?
Manifest V3, Chrome eklentilerinde daha güvenli, kontrollü ve performans odaklı bir yapı hedefler. Özellikle arka planda sürekli çalışan eski yapıların yerine service worker mantığı öne çıkar.
Bu değişiklikler şunları etkiler:
- Arka plan işlemleri
- İzin yönetimi
- Ağ istekleri
- Güvenlik politikaları
- Performans
- Chrome Web Store incelemesi
Eklentinizin uzun vadede çalışması için Manifest V3 uyumlu geliştirilmesi gerekir.
Service Worker Nedir?
Manifest V3 ile background script yerine çoğu senaryoda service worker kullanılır. Service worker sürekli açık duran bir sayfa gibi çalışmaz; ihtiyaç olduğunda uyanır, işlemi yapar ve tekrar kapanır.
Bu yaklaşım performans için iyidir, fakat geliştirme planı doğru yapılmazsa bazı eski alışkanlıklar çalışmayabilir. Örneğin sürekli açık bağlantı, uzun süreli işlem veya karmaşık state yönetimi farklı tasarlanmalıdır.
İzinler Nasıl Planlanmalı?
Manifest V3 projelerinde izinler minimumda tutulmalıdır. Kullanıcıya veya mağaza incelemesine gereksiz risk vermemek için eklenti yalnızca gerçekten ihtiyaç duyduğu izinleri istemelidir.
Örnek:
- Sadece aktif sekmede çalışacaksa
activeTabyeterli olabilir. - Tüm sitelere erişim gerekiyorsa bunun nedeni açıkça belirtilmelidir.
- Belirli domainlerde çalışacaksa izin kapsamı o domainlerle sınırlanmalıdır.
Az izin, daha fazla güven anlamına gelir.
Content Script Nedir?
Content script, eklentinin web sayfası içinde çalışan parçasıdır. Sayfadaki metni okuyabilir, belirli alanlara buton ekleyebilir veya kullanıcı etkileşimlerini yakalayabilir.
Örneğin:
- Sayfadaki telefon numaralarını algılamak
- SEO başlıklarını okumak
- Ürün bilgilerini çıkarmak
- Sayfa içine aksiyon butonu eklemek
Content script yazarken sayfanın kendi kodunu bozmamak ve performansı düşürmemek önemlidir.
Manifest V3 ve AI Eklentileri
AI destekli Chrome eklentilerinde genellikle sayfadaki metin alınır, bir backend veya AI API üzerinden işlenir ve kullanıcıya özet, öneri veya sınıflandırma olarak döner.
Bu yapıda dikkat edilmesi gerekenler:
- Kullanıcı verisi açıkça belirtilmeli
- Hassas API anahtarları eklenti içinde tutulmamalı
- Gereksiz veri gönderilmemeli
- Yanıt bekleme ve hata durumları iyi tasarlanmalı
AI özellikleri için yapay zeka entegrasyonu ve Chrome eklentisi geliştirme planı birlikte ele alınmalıdır.
Sonuç
Manifest V3, Chrome eklentilerinin güvenli, performanslı ve mağaza uyumlu çalışması için temel standarttır. İyi planlanmış izinler, doğru service worker yapısı, temiz content script ve şeffaf gizlilik yaklaşımı başarılı bir eklenti için kritik önemdedir.
Manifest V3 uyumlu bir eklenti geliştirmek için Chrome eklentisi geliştirme hizmetimizi inceleyebilirsiniz.