Uyumluluk rehberi
Manifest V2 ve Manifest V3: Her Chrome sürümü neyi yükleyebilir
Chrome 87'den 156'ya kadar sürüm çizgisini izleyerek her uzantı biçiminin ne zaman çalıştığını, ne zaman bozulduğunu ve eski bir sürümü indirmeden önce neyi kontrol etmeniz gerektiğini görün.
Manifest V2 ve Manifest V3 nedir
- Manifest V2
- Eski Chrome uzantı biçimi. Uzantılar sürekli çalışan bir arka plan sayfasıyla çalışır ve ağ isteklerini doğrudan yakalayıp değiştirebilir. Chrome bu biçimden vazgeçiyor.
- Manifest V3
- Güncel biçim, Chrome 88'den itibaren desteklenir. Arka plan gerektiğinde başlayan bir service worker'a dönüşür, ağ filtreleme bildirime dayalı kurallar (declarativeNetRequest) kullanır ve izinler daha sıkıdır.
Her uzantının manifest.json dosyası hangi biçimi kullandığını belirtir; aşağıda kısaca MV2 ve MV3 denir.
Manifest V2 tamamen kalktı
Tarayıcıda artık hiçbir MV2 anahtarı ya da politikası yok; her yöntem reddedilir. MV3'ün üst sınırı yok — 88'den test ettiğimiz en yeni sürüm olan 156'ya kadar çalıştı. Geriye kalan tek risk çok eski bir tarayıcı.
156Test edilen en yeni sürüm: MV2 her yerde reddedilir, MV3 çalışır.Ölçüldü151Tüm komut satırı anahtarları kaldırıldı.Ölçüldü
MV2 reddediliyor
Sıradan kullanıcılar için MV2 bitti: yüklemeler reddedilir ve yeniden açılamaz; geliştirici modu ve “Paketlenmemiş öğe yükle” işe yaramaz. Yalnızca kurumsal politika (138'e kadar) ve komut satırı anahtarları (150'ye kadar) onu ayakta tutar.
150Komut satırı anahtarlarının çalıştığı son sürüm (ek bir yeniden açma ile).Ölçüldü139ExtensionManifestV2Availability kurumsal politikası kaldırılır.Ölçüldü137MV2 varsayılan olarak reddedilir; yeniden açılamaz.Ölçüldü
MV2 varsayılan olarak kapalı
MV2 uzantıları hâlâ yüklenir, ancak kapalı olarak gelir (unsupportedManifestVersion). Kullanıcı chrome://extensions sayfasından yeniden açabilir ve normal çalışırlar. Google bunu Ekim 2024'ten itibaren aşamalı olarak dağıttığından bazı kullanıcılar daha sonra karşılaştı.
Eki 2024Google kullanıcılara aşamalı dağıtımı başlatır.Chrome belgeleri129Koddaki varsayılan değer MV2'yi kapatmaya başlar.Ölçüldü
İki biçim bir arada; MV3 tamamlanıyor
MV2 ve MV3'ün ikisi de çalışır — en hoşgörülü dönem. Yeni MV3 API'leri tek tek gelir; bunları en düşük sürüm bildirmeden kullanan bir uzantı eski tarayıcılarda yüklenir, ancak o özellikler çalışmaz.
127–128MV2 hâlâ çalışır; Chrome uzantılar sayfasında MV2'nin sonu hakkında uyarmaya başlar.Ölçüldü120userScripts izni kullanılabilir (kullanıcının da etkinleştirmesi gerekir).Chrome belgeleri114sidePanel kullanılabilir.Ölçüldü109offscreen API'si kullanılabilir; önceki sürümler yüklenir ve çalışır, ancak çağrılar başarısız olur.ÖlçüldüOca 2022Chrome Web Mağazası yeni MV2 uzantılarını kabul etmeyi bırakır (mağaza politikası, tarayıcı değişikliği değil).Mağaza politikası96declarativeNetRequestWithHostAccess izni kullanılabilir.Chrome belgeleri92ES modülü arka planları çalışmaya başlar.Ölçüldü
MV3 kararlı sürüme geliyor
Chrome 88'den itibaren MV3 uzantıları yüklenir ve çalışır. ES modülü ("type": "module") olarak yazılmış bir arka plan ise 92'ye kadar yüklense de hiç çalışmaz.
88–91Modül arka planı bir service worker ile listelenir ama hiç başlamaz.Ölçüldü88Temel MV3: yükleme, etkinleştirme ve arka plan çalışıyor.Ölçüldü
Yalnızca MV2 yılları
Tek kararlı biçim Manifest V2'dir. Bir MV3 uzantısı kararlı Chrome'da yüklenir ve etkin görünür, ancak arka plan betiği hiç çalışmaz — fark edilmesi en zor hata.
87Kararlı 87 sürümü en fazla manifest_version 2'yi kabul eder; service_worker arka planları yalnızca Dev kanalındadır.Kaynak kod
Chrome 137'den itibaren MV2 reddedilir ve sıradan kullanıcıların bunu aşma yolu yoktur.
Chrome 129–136, MV2 uzantılarını otomatik olarak kapatır, ancak kullanıcılar yeniden açabilir.
MV3, Chrome 88 veya üstünü gerektirir; daha eski tarayıcılar yükler ama hiç çalıştırmaz.
Eski bir sürümü indirmeden önce
- Manifest sürümünü kontrol edin: Chrome 137 ve sonrasında yalnızca MV3 seçin.
- En düşük sürümü kontrol edin: bunun altında yükleme reddedilir.
- Tarayıcınız eskiyse uyumlu en yeni sürümü seçin veya önce güncelleyin.
Yöntem ve sınırlar
18 Eki 2026'da Linux'ta Chrome for Testing 113–156 ve Chromium 87–112 anlık görüntüleriyle, test uzantıları ve gerçek Google Translate 2.0.13 / 2.0.18 ile AdBlock kullanılarak “yüklendi”, “etkin” ve “arka plan gerçekten çalışıyor” ayrımı yapıldı; CRX yükleme yolu kurumsal politikayla zorunlu yüklemeyle doğrulandı. Chrome for Testing'de aşamalı dağıtım olmadığından yukarıdaki sürümler kodun etkinleştiği anı gösterir; gerçek kullanıcılar değişiklikleri daha geç görmüş olabilir. Windows, Mac, Edge ve diğer Chromium tarayıcılar kapsanmadı. 150 sonrasındaki tarihler Chrome'un dört haftalık sürüm takviminden tahmin edildi.
Edge ve diğer Chromium tarayıcılar kendi takvimlerini izler; burada test edilmediler.