Manifest V2 uzantılarını Manifest V3 uzantılarına dönüştürme kılavuzu.
Bu bölüm, bir uzantıyı Chrome Uzantıları platformunun en yeni sürümü olan Manifest V2'den Manifest V3'e yükseltmenize yardımcı olur. Taşıma çalışmaları genel olarak aşağıdaki kategorilere ayrılır. Çalışmalarınızı takip etmenize yardımcı olmak için bu belgelerin içeriğini özetleyen bir yapılacaklar listesi hazırladık. İçeriğe erişmek için yapılacaklar listesini kullanabilir veya içeriği ayrıntılı olarak inceleyebilirsiniz. Her iki yol da yeni sürüme geçirilmiş bir uzantıyla sona erer.
- Manifesti 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. - Hizmet çalışanına geçiş yapın: Hizmet çalışanı, arka plan kodunun performansı olumsuz etkileyebileceği ana iş parçacığında kalmamasını sağlamak için uzantının arka plan veya etkinlik sayfasının yerini alır. Bu değişiklik, DOM, pencere ve belirli uzantı API çağrılarının ekran dışı dokümanlara taşınmasını da gerektirir.
- Update API çağrıları: Bazı API çağrılarının daha modern olanlarla değiştirilmesi gerekir.
- Engellenen web isteği dinleyicilerinin yerine geçme: Manifest V2'de ağ isteklerinin engellenmesi veya değiştirilmesi performansı önemli ölçüde düşürebilir ve hassas kullanıcı verilerine aşırı erişim gerektirebilir. Declarative Net Request API, uzantıların web içeriğini daha az izinle ve performansı engellemeden engellemesine veya değiştirmesine olanak tanır.
- Uzantı güvenliğini artırma: Manifest V3, uzantı güvenliğini çeşitli şekillerde artırır. 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ülmesi için destek kaldırıldı.
- Uzantınızı yayınlama: Bu bölümde, önce sınırlı bir kitleyle test ederek Manifest V3 uzantınızın beklendiği gibi çalıştığından emin olmak için uzantınızı aşamalı olarak nasıl yayınlayacağınız açıklanmaktadır.
Ayrıca Extension Manifest Converter aracımız da var. Her şeyi sizin için yapmaz ancak başlamanıza yardımcı olur. Dönüştürücünün README dosyasında, aracın neyi değiştirdiği açıklanır.
Mevcut özellikler kümesini koruma
Beklenmedik sorun veya hatalarla karşılaşma ihtimalini azaltmak için taşıma sırasında yeni işlevler eklememenizi öneririz. Örneğin, yeni izinler gerektiren bir özellik eklemek izin uyarısını tetikleyebilir. Bu durumda, kullanıcı yeni izinleri kabul edene kadar uzantınız devre dışı kalır. Uyarı göstermeden izin eklemenin diğer yolları hakkında bilgi edinmek için İzin uyarısıyla ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.
Manifest V3, Chrome 88 veya sonraki sürümlerde genel olarak desteklenir. API çağrılarını güncellerken, değiştirilen özelliklerin Chrome'a 88. sürümden sonra eklendiğini görebilirsiniz. API referans sayfalarında, tek tek API üyeleriyle ilgili destek bilgileri yer alır. 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üştürme sırasında bunları kullanmanız gerekmez. Ancak, eski özelliklerin yerini aldıklarında, yerini aldıkları özelliklere kıyasla bunları tercih etmeniz ve yerini aldıkları özelliklerin zaman içinde desteğinin sonlandırılacağını ve kaldırılacağını beklemeniz gerekir.