Konversi XPI menjadi CRX

Sebuah add-on Firefox atau Thunderbird yang disediakan sebagai XPI tidak dapat diinstal langsung di Chrome, Edge, Brave, atau browser lain berbasis Chromium. Paket CRX hanya berguna setelah sumber ekstensi dibuat kompatibel dengan platform ekstensi browser target.

Apa yang berisi file XPI

XPI adalah format paket add-on dari Mozilla, yang digunakan terutama oleh Firefox dan Thunderbird. Sebagian besar XPI saat ini berupa arsip berbasis ZIP yang berisi manifest.json, JavaScript, HTML, ikon, berkas lokalisasi, dan aset ekstensi lainnya.

Add-ons Firefox mendistribusikan XPIs yang ditandatangani. Add-on lama mungkin menggunakan install.rdf, chrome.manifest, overlay XUL, atau kode bootstrap lawas; teknologi-teknologi ini tidak didukung oleh Chromium dan memerlukan pengembangan ulang, bukan sekadar dikemas ulang.

Apa yang disediakan file CRX

CRX adalah format paket ekstensi yang ditandatangani milik Chromium. Browser Chromium saat ini membuat paket CRX3, yang kunci penandatangannya menentukan ID ekstensi; menyimpan kunci tersebut diperlukan agar dapat memublikasikan pembaruan dengan ID yang sama.

CRX terutama berguna untuk penerapan managed-browser dan layanan pembaruan privat. Chrome Web Store menerima ZIP sumber ekstensi yang kompatibel untuk dipublikasikan, bukan CRX yang sudah jadi, dan instalasi Chrome normal umumnya memblokir instalasi langsung file CRX yang diunduh.

Siapkan sumber ekstensi

1. Salin dan ekstrak XPI ke folder kerja. Gunakan 7-Zip di Windows, atau jalankan unzip addon.xpi -d addon-src di macOS atau Linux. Mengganti nama salinan addon.xpi menjadi addon.zip juga memungkinkan ekstraksi oleh alat arsip standar.
2. Periksa manifest.json. Add-on yang hanya berisi berkas Mozilla lawas tidak dapat menjadi ekstensi Chromium yang berfungsi tanpa port kode sumber.
3. Adaptasikan manifest dan kode untuk browser target. Hapus atau pisahkan pengaturan manifest khusus Firefox seperti browser_specific_settings, ganti izin dan API yang tidak didukung, serta gunakan Manifest V3 bila diperlukan. Pengajuan ke Chrome Web Store saat ini memerlukan Manifest V3; ketersediaan Manifest V2 di browser Chromium bergantung pada versi browser dan kebijakan enterprise.
4. Periksa perbedaan API. Kode Firefox yang menggunakan browser.* mungkin memerlukan perubahan terarah atau webextension-polyfill agar kompatibel dengan Chromium. API khusus Firefox, halaman privileged, perilaku proxy, kemampuan tema, serta nama izin mungkin tidak memiliki padanan di Chromium.
5. Uji folder yang sudah diekstrak sebelum dikemas. Buka chrome://extensions, edge://extensions, atau halaman browser yang setara; aktifkan Developer mode; pilih Load unpacked; dan pilih addon-src. Selidiki dulu error manifest, service-worker, izin, dan runtime.

Buat paket CRX

Gunakan browser Chromium target atau Chromium itu sendiri untuk mengemas folder yang sudah diuji. Di halaman ekstensi, aktifkan Developer mode, pilih Pack extension, tentukan folder root ekstensi, dan buat kunci baru atau pilih kunci yang ada .pem.

Alternatif berbasis command-line adalah chromium --pack-extension=/full/path/addon-src. Di Windows, gunakan executable browser yang terpasang, misalnya chrome.exe --pack-extension="C:\work\addon-src". Pengemasan menghasilkan file .crx dan, untuk paket baru, sebuah .pem kunci privat.

Jaga agar file PEM tetap privat dan simpan cadangannya. Bangun ulang dengan kunci yang sama, misalnya chromium --pack-extension=/full/path/addon-src --pack-extension-key=/full/path/addon-src.pem. Kunci baru membuat ID ekstensi baru dan memutus kesinambungan pembaruan.

Batasan deployment dan konversi

Tanda tangan XPI tidak dapat digunakan ulang untuk penandatanganan CRX. Mengekstrak XPI hanya menghasilkan berkas sumber, bukan tanda tangan Chromium yang dapat ditransfer atau identitas ekstensi.

Untuk distribusi publik Chrome, unggah ZIP sumber yang kompatibel ke Chrome Web Store. Untuk perangkat yang dikelola organisasi, terapkan CRX melalui kebijakan enterprise extension-install browser dan, jika diperlukan, sebuah approved update URL.

Konverter arsip online tidak dapat memindahkan API browser, memvalidasi perilaku ekstensi, atau menghasilkan identitas penandatanganan jangka panjang yang dapat digunakan. Jangan unggah sumber ekstensi atau kunci privat .pem ke situs konversi; gunakan alat lokal seperti 7-Zip dan Chrome, Edge, atau extension packer milik Chromium.