Bermigrasi ke Manifes V3

Panduan untuk mengonversi ekstensi Manifes V2 ke ekstensi Manifes V3.

Bagian ini membantu Anda mengupgrade ekstensi dari Manifes V2 ke Manifes V3, versi terbaru platform Ekstensi Chrome. Pekerjaan migrasi dibagi secara luas menjadi kategori di bawah. Untuk membantu melacak pekerjaan Anda, kami telah menyediakan checklist yang meringkas isi dokumen ini. Anda dapat mengakses konten melalui checklist, atau mempelajari kontennya. Kedua jalur diakhiri dengan ekstensi yang diupgrade.

  • Update manifes—manifest.json harus khusus untuk V3. Perubahan yang dapat dilakukan sendiri dijelaskan di bagian ini. Perubahan manifes yang terkait dengan kode dijelaskan dengan perubahan kode yang didukungnya.
  • Migrate to a service worker—Pekerja layanan menggantikan latar belakang atau halaman peristiwa ekstensi untuk memastikan kode latar belakang tetap berada di luar thread utama jika dapat menurunkan performa. Perubahan ini juga memerlukan pemindahan DOM, jendela, dan panggilan API ekstensi tertentu ke dokumen di luar layar.
  • Memperbarui panggilan API—Beberapa panggilan API perlu diganti dengan panggilan API yang lebih modern.
  • Ganti pemroses permintaan web yang diblokir—Memblokir atau mengubah permintaan jaringan di Manifes V2 dapat menurunkan performa secara signifikan dan memerlukan akses berlebihan ke data pengguna yang sensitif. Declarative Net Request API memungkinkan ekstensi memblokir atau memodifikasi konten web dengan lebih sedikit izin dan tanpa menghambat performa.
  • Meningkatkan keamanan ekstensi—Manifes V3 meningkatkan keamanan ekstensi dalam beberapa cara. Selain kebijakan keamanan konten yang ditingkatkan, dukungan akan dihapus untuk kode yang dihosting dari jarak jauh dan eksekusi string arbitrer.
  • Publikasikan ekstensi Anda—Bagian ini menjelaskan cara melakukan peluncuran bertahap untuk memastikan ekstensi Manifes V3 Anda berfungsi seperti yang diharapkan dengan mengujinya kepada audiens terbatas terlebih dahulu.

Kami juga memiliki Pengonversi Manifes Ekstensi. Tidak melakukan segalanya untuk Anda, tetapi akan membantu Anda memulai. README konverter menjelaskan apa yang diubah alat tersebut.

Pertahankan kumpulan fitur saat ini

Untuk mengurangi kemungkinan terjadinya masalah atau bug yang tidak terduga, sebaiknya jangan tambahkan fungsi baru saat melakukan migrasi. Misalnya, menambahkan fitur yang memerlukan izin baru dapat memicu peringatan izin, yang akan menonaktifkan ekstensi Anda hingga pengguna menyetujui izin baru tersebut. Lihat Praktik terbaik peringatan izin untuk mempelajari cara lain menambahkan izin tanpa menampilkan peringatan.

Manifes V3 didukung secara umum di Chrome 88 atau yang lebih baru. Saat mengupdate panggilan API, Anda mungkin mendapati bahwa fitur pengganti mungkin baru tersedia di Chrome setelah versi 88. Halaman referensi API berisi informasi dukungan untuk setiap anggota API. Jika merasa memerlukan salah satu fitur ini, Anda dapat menentukan versi chrome minimum dalam file manifes.

Fitur platform ekstensi baru

Sejak rilis Manifes V3, kami terus menambahkan fitur baru, yang banyak di antaranya dapat digunakan di Manifes V2 dan Manifes V3. Anda tidak harus menggunakannya saat melakukan konversi; namun, saat fitur tersebut menggantikan fitur lama, Anda harus lebih memilih fitur tersebut daripada fitur yang digantikannya dan berharap bahwa fitur yang diganti pada akhirnya tidak akan digunakan lagi dan dihapus.