Checklist migrasi Manifes V3

Pantau progres migrasi Anda

Catatan: Manifes V3 didukung secara umum di Chrome 88 atau yang lebih baru. Untuk fitur ekstensi yang ditambahkan di versi Chrome terbaru, lihat dokumentasi referensi API untuk informasi dukungan. Jika ekstensi memerlukan API tertentu, Anda dapat menentukan versi Chrome minimum dalam file manifes.

Checklist di bawah ini tersedia untuk membantu Anda memantau pekerjaan migrasi Anda. Mereka menentukan tugas yang harus diselesaikan dengan tautan ke instruksi. Tugas migrasi secara luas dibagi menjadi lima kategori seperti yang dijelaskan dalam Ringkasan migrasi.

Mengupdate manifes

File manifest.json memerlukan format yang sedikit berbeda untuk Manifes V3 daripada Manifes V2. Halaman ini menjelaskan perubahan yang hanya memengaruhi file manifest.json. Namun, banyak perubahan pada skrip dan halaman juga memerlukan perubahan pada manifes. Perubahan tersebut tercakup dalam tugas migrasi yang memerlukannya.

• Mengubah nomor versi manifes.
• Memperbarui izin host.
• Memperbarui referensi yang dapat diakses web.

Melakukan migrasi ke pekerja layanan

Pekerja layanan menggantikan halaman peristiwa atau latar belakang ekstensi untuk memastikan bahwa kode latar belakang tetap berada di luar thread utama. Hal ini memungkinkan ekstensi hanya berjalan saat dibutuhkan, sehingga menghemat resource.

Sebelum memulai, baca perbedaan antara skrip latar belakang dan pekerja layanan ekstensi.

• Memperbarui kolom "latar belakang" di manifes
• Memindahkan panggilan DOM dan jendela ke dokumen di luar layar
• Mengonversi localStorage ke chrome.storage.local
• Mendaftarkan pemroses secara sinkron
• Ganti panggilan ke XMLHttpRequest() dengan fetch() global.
• Mempertahankan status
• Mengonversi timer menjadi alarm
• Membuat pekerja layanan tetap aktif (dalam kasus yang jarang terjadi)

Mengupdate panggilan API

Beberapa fitur perlu diganti dengan fitur yang setara dengan Manifes V3. Sebagian lainnya perlu dihapus seluruhnya.

• Ganti tabs.executeScript() dengan scripting.executeScript().
• Mengganti tabs.insertCSS() dan tabs.removeCSS() dengan scripting.insertCSS() dan scripting.removeCSS().
• Mengganti Tindakan Browser dan Tindakan Halaman dengan Tindakan
• Mengganti fungsi yang mengharapkan konteks latar belakang Manifes V2.
• Mengganti callback dengan promise
• Mengganti API yang tidak didukung

Mengganti pemroses permintaan web yang memblokir

Alih-alih membaca permintaan jaringan secara terprogram dan mengubahnya (seperti yang Anda lakukan di Manifes V2), ekstensi Anda menentukan aturan yang menjelaskan tindakan yang akan dilakukan saat serangkaian kondisi tertentu terpenuhi.

• Perbarui izin
• Membuat aturan permintaan net deklaratif

Setelah menyelesaikan item di atas, sebaiknya tinjau beberapa kasus penggunaan umum:

• Memblokir satu URL
• Beberapa URL untuk pengalihan
• Memblokir cookie

Meningkatkan keamanan ekstensi

Perubahan diperlukan untuk meningkatkan keamanan ekstensi. Ini termasuk menghapus kode yang dihosting dari jarak jauh, yang tidak lagi didukung.

• Hapus eksekusi string arbitrer.
• Menghapus kode yang dihosting dari jarak jauh
• Memperbarui kebijakan keamanan konten.
• Menghapus nilai kebijakan keamanan konten yang tidak didukung

Memublikasikan ekstensi Manifes V3

Setelah melakukan konversi ke Manifest Versi 3, kini saatnya merilis ekstensi Anda di Chrome Web Store. Bergantung pada perubahan yang dibuat, pertimbangkan peluncuran yang bertahap. Pendekatan ini memungkinkan Anda memastikan ekstensi berfungsi seperti yang diharapkan dengan audiens terbatas terlebih dahulu, sebelum merilisnya ke seluruh basis pengguna.

• Publikasikan versi uji beta.
• Luncurkan rilis Anda secara bertahap.
• Rencanakan waktu peninjauan.
• Tips tambahan.