Manifest V2 uzantılarını Manifest V3 uzantılarına dönüştürme rehberi.
Bu bölüm, bir uzantıyı Manifest V2'den Chrome Extensions platformunun en yeni sürümü olan Manifest V3'e yükseltmenize yardımcı olur. Taşıma çalışmaları genel olarak aşağıdaki kategorilere ayrılır. Çalışmanızı takip etmenize yardımcı olmak için bu dokümanların içeriğini özetleyen bir kontrol listesi hazırladık. İçeriğe erişmek için yapılacaklar listesi sayfasını kullanabilir veya ayrıntılı inceleme yapabilirsiniz. Her iki yol da yeni sürüm bir uzantıyla biter.
- Manifest'i güncelleyin:
manifest.json, V3'e özel olmalıdır. Tek başına yapılabilecek değişiklikler bu bölümde açıklanmaktadır. Kodla ilgili manifest değişiklikleri, destekledikleri kod değişiklikleriyle birlikte açıklanır. - Service Worker'a geçiş: Service Worker, arka plan kodunun performansı olumsuz etkileyeceği durumlarda ana iş parçacığının dışında kalmasını sağlamak için uzantının arka planını veya etkinlik sayfasını değiştirir. Bu değişiklik, DOM, pencere ve belirli uzantı API çağrılarının ekran dışı dokümanlara taşınmasını da gerektirir.
- API çağrılarını güncelleyin: Bazı API çağrılarının daha modern eşdeğerleriyle değiştirilmesi gerekir.
- Engellenen web isteği işleyicilerini değiştirin: Manifest V2'de ağ isteklerini engellemek veya değiştirmek, performansı önemli ölçüde düşürebilir ve hassas kullanıcı verilerine aşırı erişim gerektirebilir. Declarative Net Request API, uzantıların daha az izinle ve performansı olumsuz etkilemeden web içeriğini engellemesine veya değiştirmesine olanak tanır.
- Uzantı güvenliğini iyileştirin: Manifest V3, uzantı güvenliğini birkaç yönden iyileştirir. Gelişmiş içerik güvenliği politikasının yanı sıra, uzaktan barındırılan kod ve rastgele dizelerin yürütülmesine yönelik destek kaldırılmıştır.
- Uzantınızı yayınlayın - Bu bölümde, Manifest V3 uzantınızın beklendiği gibi çalıştığından emin olmak için öncelikle sınırlı bir kitleyle test ederek adım adım kullanıma sunma işlemini nasıl gerçekleştireceğiniz açıklanmaktadır.
Ayrıca bir Uzantı Manifest Dönüştürücüsü de vardır. Sizin için her şeyi yapmaz, ancak başlamanızı sağlar. Dönüştürücünün BENİOKU özelliği, aracın neleri değiştirdiğini açıklar.
Mevcut özellik grubunu koruyun
Beklenmedik sorun veya hata olasılığını azaltmak için, taşıma sırasında yeni işlevler eklememenizi öneririz. Örneğin, yeni izinler gerektiren bir özellik eklemek, bir izin uyarısını tetikleyebilir ve kullanıcı yeni izinleri kabul edene kadar uzantınızı devre dışı bırakır. Uyarı görüntülemeden izin eklemenin diğer yollarını öğrenmek için İzin uyarısıyla ilgili en iyi uygulamalar sayfasına göz atın.
Manifest V3, genellikle Chrome 88 veya sonraki sürümlerde desteklenir. API çağrılarını güncellerken, Chrome'un 88 sürümünden sonraki yeni özelliklerin kullanıma sunulmamış olabileceğini fark edebilirsiniz. API referans sayfaları, tek tek API üyelerine ilişkin destek bilgilerini içerir. Bu özelliklerden birine ihtiyacınız olduğunu fark ederseniz manifest dosyasında minimum Chrome sürümü belirtebilirsiniz.
Yeni uzantı platformu özellikleri
Manifest V3'ün yayınlanmasından bu yana yeni özellikler eklemeye devam ettik. Bu özelliklerin çoğu hem Manifest V2 hem de Manifest V3'te kullanılabilir. Dönüşüm sırasında bunları kullanmanız zorunlu değildir. Ancak, eski özelliklerin yerini alacakları özellikleri değiştirmelerini tercih etmeniz ve değiştirilen özelliklerin zaman içinde kullanımdan kaldırılıp kaldırılmalarını beklemeniz gerekir.