Linux adalah satu-satunya platform tempat pengguna Chrome dapat menginstal ekstensi yang dihosting di luar
Chrome Web Store. Artikel ini menjelaskan cara memaketkan, menghosting, dan mengupdate file crx
dari server web untuk tujuan umum. Jika Anda mendistribusikan ekstensi atau tema hanya
melalui Chrome Web Store, baca artikel Hosting dan
update Webstore.
Package (Paket)
Ekstensi dan tema ditayangkan sebagai file .crx
. Saat mengupload melalui Dasbor Developer Chrome, dasbor akan membuat file crx
secara otomatis. Jika dipublikasikan
di server pribadi, file crx
harus dibuat secara lokal atau didownload dari
Chrome Web Store.
Download .crx dari Chrome Web Store
Jika ekstensi dihosting di Chrome Web Store, file .crx
dapat didownload dari
Dasbor Developer. Temukan ekstensi di bagian "Listingan Anda" dan klik "Info selengkapnya". Di jendela pop-up, klik link main.crx
berwarna biru untuk mendownloadnya.
File yang didownload dapat dihosting di server pribadi. Ini adalah cara yang paling aman untuk menghosting ekstensi secara lokal karena konten ekstensi akan ditandatangani oleh Chrome Web Store. Hal ini membantu mendeteksi potensi serangan dan gangguan.
Membuat .crx secara lokal
Direktori ekstensi dikonversi menjadi file .crx
di Halaman Pengelolaan Ekstensi. Buka
chrome://extensions/
di omnibox, atau klik menu Chrome, tahan kursor ke "Alat Lainnya", lalu
pilih "Ekstensi".
Di Halaman Pengelolaan Ekstensi, aktifkan Mode Developer dengan mengklik tombol di samping Mode developer. Lalu pilih tombol PACK EKSTENSI.
Tentukan jalur ke folder ekstensi di kolom direktori utama Ekstensi, lalu klik tombol PACK EXTENSION. Abaikan kolom Private key untuk paket pertama kali.
Chrome akan membuat dua file, file .crx
dan file .pem
, yang berisi kunci pribadi ekstensi.
Jangan kehilangan kunci pribadi. Simpan file .pem
di tempat yang rahasia dan aman, karena Anda perlu mengupdate ekstensi.
Memperbarui paket .crx
Update file .crx
ekstensi dengan meningkatkan nomor versi di manifest.json
.
{
...
"version": "1.5",
...
}
}
{
...
"version": "1.6",
...
}
}
Kembali ke Halaman Pengelolaan Ekstensi dan klik tombol PACK EKSTENSI. Tentukan jalur ke direktori ekstensi dan lokasi kunci pribadi.
Halaman akan menyediakan jalur untuk ekstensi paket yang diupdate.
Paket melalui command line
Kemas ekstensi di command line dengan memanggil chrome.exe
. Gunakan flag --pack-extension
untuk menentukan lokasi folder ekstensi dan tanda --pack-extension-key
untuk menentukan lokasi file kunci pribadi ekstensi.
chrome.exe --pack-extension=C:\myext --pack-extension-key=C:\myext.pem
Host
Server yang menghosting file .crx
harus menggunakan header HTTP yang sesuai agar pengguna dapat menginstal ekstensi dengan mengklik link.
Google Chrome menganggap file dapat diinstal jika salah satu hal berikut berlaku:
- File memiliki jenis konten
application/x-chrome-extension
- Akhiran file adalah
.crx
dan kedua hal berikut berlaku:- File tidak ditayangkan dengan header HTTP
X-Content-Type-Options: nosniff
- File ditampilkan dengan salah satu jenis konten berikut:
- string kosong
"text/plain"
"application/octet-stream"
"unknown/unknown"
"application/unknown"
"\*/\*"
- File tidak ditayangkan dengan header HTTP
Alasan paling umum mengapa file yang dapat diinstal tidak dikenali adalah server mengirimkan header X-Content-Type-Options: nosniff
. Alasan paling umum kedua adalah server mengirimkan
jenis konten yang tidak diketahui—jenis konten yang tidak ada dalam daftar sebelumnya. Untuk memperbaiki masalah header HTTP, ubah
konfigurasi server atau coba hosting file .crx
di server lain.
Update
Setiap beberapa jam, browser akan memeriksa ekstensi yang terinstal untuk menemukan URL update. Untuk masing-masingnya, parser akan membuat permintaan ke URL tersebut untuk mencari file XML manifes update.
- Konten yang ditampilkan oleh pemeriksaan update adalah dokumen XML manifes update yang mencantumkan versi terbaru sebuah ekstensi.
Jika manifes update menyebutkan versi yang lebih baru daripada yang diinstal, browser
akan mendownload dan menginstal versi baru. Seperti update manual, file .crx
yang baru harus ditandatangani
dengan kunci pribadi yang sama dengan versi yang saat ini terinstal.
URL Pembaruan
Ekstensi yang dihosting di server di luar Chrome Web Store harus menyertakan kolom update_url
di
file manifest.json
-nya.
{
"name": "My extension",
...
"update_url": "https://myhost.com/mytestextension/updates.xml",
...
}
Mengupdate manifes
Manifes update yang ditampilkan oleh server harus berupa dokumen XML.
<?xml version='1.0' encoding='UTF-8'?>
<gupdate xmlns='http://www.google.com/update2/response' protocol='2.0'>
<app appid='aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'>
<updatecheck codebase='https://myhost.com/mytestextension/mte_v2.crx' version='2.0' />
</app>
</gupdate>
Format XML ini dipinjam dari yang digunakan oleh Omaha, yaitu infrastruktur update Google. Sistem
ekstensi menggunakan atribut berikut untuk elemen <app>
dan <updatecheck>
dari
manifes update:
- appid
- ID ekstensi dibuat berdasarkan hash kunci publik, seperti yang dijelaskan dalam kemasan. ID ekstensi ditampilkan di Halaman Pengelolaan Ekstensi.
- codebase
- URL HTTPS ke file
.crx
. - versi
- Digunakan oleh klien untuk menentukan apakah harus mendownload file
.crx
yang ditentukan olehcodebase
. Nilai ini harus cocok dengan nilai "version" dalam filemanifest.json
file.crx
.
File XML manifes update dapat berisi informasi tentang beberapa ekstensi dengan menyertakan beberapa
elemen <app>
.
Pengujian
Frekuensi pemeriksaan update default adalah beberapa jam, tetapi update dapat dipaksakan menggunakan tombol Update ekstensi sekarang di Halaman Pengelolaan Ekstensi.
Tindakan ini akan memulai pemeriksaan untuk semua ekstensi yang terinstal.
Penggunaan lanjutan: parameter permintaan
Mekanisme update otomatis dasar dirancang untuk membuat sisi server berfungsi semudah melepas file XML statis ke server web biasa, seperti Apache, dan mengupdate file XML tersebut saat versi ekstensi baru dirilis.
Developer yang menghosting beberapa ekstensi dapat memeriksa parameter permintaan, yang menunjukkan ID dan versi ekstensi dalam permintaan update. Dengan menyertakan parameter ini, ekstensi dapat diupdate dari URL yang sama yang menjalankan kode sisi server dinamis, bukan file XML statis.
Format parameter permintaan adalah:
?x=EXTENSION_DATA
Di mana EXTENSION_DATA
adalah string berenkode URL dari format:
id=EXTENSION_ID&v=EXTENSION_VERSION
Misalnya, dua ekstensi mengarah ke URL update yang sama (https://test.com/extension_updates.php
):
- Ekstensi 1
- ID: "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
- Versi: "1.1"
- Ekstensi 2
- ID: "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
- Versi: "0.4"
Permintaan untuk memperbarui setiap ekstensi individu adalah,
https://test.com/extension_updates.php?x=id%3Daaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa%26v%3D1.1
dan
https://test.com/extension_updates.php?x=id%3Dbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb%26v%3D0.4
Beberapa ekstensi dapat dicantumkan dalam satu permintaan untuk setiap URL update unik. Untuk contoh sebelumnya, jika pengguna telah menginstal kedua ekstensi tersebut, kedua permintaan tersebut akan digabungkan menjadi satu permintaan:
https://test.com/extension_updates.php?x=id%3Daaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa%26v%3D1.1&x=id%3Dbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb%26v%3D0.4
Jika jumlah ekstensi terinstal yang menggunakan URL update yang sama cukup besar sehingga URL permintaan GET terlalu panjang (lebih dari 2.000 karakter), pemeriksaan update akan mengeluarkan permintaan GET tambahan sesuai kebutuhan.
Penggunaan lanjutan: versi browser minimum
Seiring semakin banyak API yang ditambahkan ke sistem ekstensi, versi ekstensi terupdate yang hanya berfungsi dengan versi browser yang lebih baru dapat dirilis. Meski Google Chrome diupdate secara otomatis,
perlu waktu beberapa hari sebelum sebagian besar basis pengguna mengupdate ke rilis baru tertentu. Untuk
memastikan bahwa update tertentu hanya akan berlaku untuk versi Google Chrome pada atau yang lebih tinggi dari versi
tertentu, tambahkan atribut "prodversionmin" ke elemen <app>
dalam respons update.
<?xml version='1.0' encoding='UTF-8'?>
<gupdate xmlns='http://www.google.com/update2/response' protocol='2.0'>
<app appid='aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'>
<updatecheck codebase='http://myhost.com/mytestextension/mte_v2.crx' version='2.0' prodversionmin='3.0.193.0'/>
</app>
</gupdate>
Hal ini akan memastikan bahwa pengguna akan otomatis diupdate ke versi 2 hanya jika mereka menjalankan Google Chrome 3.0.193.0 atau yang lebih baru.