Menggunakan metode penginstalan alternatif

Biasanya, pengguna Chrome menginstal ekstensi dengan mengunjungi listingan ekstensi di Chrome Web Store dan menginstal ekstensi langsung dari halaman tersebut. Namun, dalam beberapa kasus, alur penginstalan lain mungkin lebih tepat. Contoh:

• Ekstensi dikaitkan dengan beberapa software lain, dan ekstensi tersebut harus diinstal setiap kali pengguna menginstal software lain tersebut.
• Administrator jaringan ingin menginstal ekstensi yang sama di seluruh organisasinya.

Catatan: Administrator juga dapat menggunakan kebijakan perusahaan untuk mengelola penginstalan ekstensi. Untuk mempelajari lebih lanjut, lihat kebijakan Ekstensi Enterprise.

Untuk kasus sebelumnya, Google Chrome mendukung metode penginstalan ekstensi berikut:

• Menggunakan file JSON preferensi (khusus macOS X dan Linux)
• Menggunakan registry Windows (khusus Windows)

Kedua cara ini mendukung penginstalan ekstensi yang dihosting di update_URL. Di Windows dan macOS, update_URL harus mengarah ke Chrome Web Store. Jika ekstensi diinstal menggunakan metode ini, pengguna Windows dan macOS harus mengaktifkan ekstensi menggunakan dialog konfirmasi berikut:

Di Linux, file preferensi dapat mengarah ke ekstensi Chrome Web Store, ekstensi yang dihosting secara eksternal, atau file ekstensi CRX di komputer pengguna. Pengguna Linux tidak akan diminta untuk mengaktifkan ekstensi; ekstensi akan diinstal secara otomatis.

Peringatan: Penginstalan Windows dan Mac harus berasal dari Chrome Web Store: Mulai Chrome 33, tidak ada penginstalan eksternal yang diizinkan dari jalur ke file CRX lokal di Windows (lihat Melindungi pengguna Windows dari ekstensi berbahaya). Mulai Chrome 44, tidak ada penginstalan eksternal yang diizinkan dari jalur ke file CRX lokal di Mac OS (lihat Terus melindungi pengguna Chrome dari ekstensi berbahaya).

Sebelum memulai

Instal dari Chrome Web Store

Jika mendistribusikan ekstensi yang dihosting di Chrome Web Store, Anda harus memublikasikan ekstensi terlebih dahulu. Kemudian, perhatikan hal-hal berikut:

• URL update— https://clients2.google.com/service/update2/crx. URL ini mengarah ke Chrome Web Store.
• ID ekstensi— ID ini dapat ditemukan di URL Chrome Web Store ekstensi.

Instal dari file CRX Lokal

Jika mendistribusikan aplikasi kepada pengguna Linux dari file lokal, Anda perlu mengemas file CRX dan memperhatikan informasi berikut:

• ID ekstensi— ID ini dapat ditemukan di halaman pengelolaan ekstensi chrome://extensions.

• Versi ekstensi— Ini muncul di halaman pengelolaan ekstensi chrome://extensions atau dalam file JSON manifes.

• Lokasi file CRX— Dapat berupa direktori lokal atau berbagi jaringan. Pastikan file tersedia untuk komputer tempat Anda ingin menginstal ekstensi.

Menginstal dari server pribadi

Jika mendistribusikan ekstensi yang dihosting di server pribadi untuk pengguna Linux, Anda harus mengikuti petunjuk untuk Menginstal ekstensi di Linux dan memperhatikan informasi berikut:

• ID ekstensi— ID ini dapat ditemukan di halaman pengelolaan ekstensi chrome://extensions.

• Jalur file XML update_url— Jalur ini harus cocok dengan jalur kolom update_url yang dideklarasikan dalam file JSON manifes.

Contoh berikut mengasumsikan versi adalah 1.0 dan ID ekstensinya adalah aaabbbcccdddeeefff.

Menggunakan file preferensi

Catatan: Khusus MacOS X dan Linux: Jangan gunakan file preferensi untuk Windows. Sebagai gantinya, gunakan Windows registry.

macOS

1. Buat file JSON dengan nama ID ekstensi. Contoh: aaabbbcccdddeeefff.json

2. Tempatkan di salah satu folder berikut:

   Untuk pengguna tertentu

   ~USERNAME/Library/Application Support/Google/Chrome/External Extensions/

   Untuk semua pengguna

   /Library/Application Support/Google/Chrome/External Extensions/

3. Tentukan URL update dengan nama kolom "external_update_url". Contoh: json { "external_update_url": "https://clients2.google.com/service/update2/crx" }

4. Simpan file JSON.

5. Luncurkan Google Chrome dan buka chrome://extensions; Anda akan melihat ekstensi tercantum.

Catatan: File ekstensi eksternal untuk semua pengguna bersifat hanya baca jika setiap direktori dalam jalur dimiliki oleh pengguna root, memiliki grup admin atau wheel, dan tidak dapat ditulis oleh semua pengguna. Jalur tersebut juga harus bebas dari link simbolis. Batasan ini mencegah pengguna yang tidak memiliki hak istimewa menyebabkan ekstensi diinstal untuk semua pengguna. Lihat Memecahkan masalah izin.

Memecahkan masalah izin Mac OS

Di macOS, file ekstensi eksternal untuk semua pengguna hanya akan dibaca jika izin sistem file mencegah pengguna yang tidak memiliki hak istimewa agar tidak mengubahnya. Jika Anda tidak melihat ekstensi eksternal yang terinstal saat Chrome diluncurkan, mungkin terdapat masalah izin pada file preferensi ekstensi eksternal. Untuk melihat apakah ini masalahnya, ikuti langkah-langkah berikut:

1. Luncurkan program Console. Anda dapat menemukannya di bagian /Applications/Applications/Console.
2. Jika ikon paling kiri di Konsol bertuliskan "Show Log List", klik ikon tersebut. Kolom kedua muncul di sebelah kiri.
3. Klik "Console Messages" di panel kiri.
4. Telusuri string Tidak dapat membaca ekstensi eksternal. Jika ada masalah saat membaca file ekstensi eksternal, Anda akan melihat pesan error. Cari pesan error lain tepat sebelum pesan error tersebut, yang seharusnya menjelaskan masalahnya. Misalnya, jika Anda melihat error berikut: "Path /Library/Application Support/Google/Chrome dimiliki oleh grup yang salah", Anda perlu menggunakan chgrp atau dialog Get Info di Finder untuk mengubah pemilik grup direktori ke grup Administrator.
5. Setelah memperbaiki masalah, luncurkan kembali Chrome. Uji apakah ekstensi eksternal kini telah diinstal. Ada kemungkinan bahwa satu error izin mencegah Chrome mendeteksi error kedua. Jika ekstensi eksternal tidak diinstal, ulangi langkah-langkah ini hingga Anda tidak melihat error dalam aplikasi Konsol.

Linux

1. Buat file JSON dengan nama ID ekstensi. Misalnya: aaabbbcccdddeeefff.json.

2. Tempatkan di salah satu folder berikut:

   • /opt/google/chrome/extensions/
   • /usr/share/google-chrome/extensions/

3. Daftar berikut menjelaskan penginstalan ekstensi dari Chrome Web Store, file CRX, atau server pribadi:

   • Untuk menginstal ekstensi Chrome Web Store, tentukan URL update dengan nama kolom "external_update_url". Misalnya: json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
   • Untuk menginstal ekstensi dari file CRX, tentukan lokasi di "external_crx" dan versinya di "external_version". Misalnya: json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" }
   • Untuk menginstal ekstensi yang dihosting di server pribadi, kolom "external_update_url" harus mengarah ke file xml, seperti dalam contoh berikut: json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }

4. Simpan file JSON.

5. Luncurkan Google Chrome dan buka chrome://extensions; Anda akan melihat ekstensi tercantum.

Catatan: Gunakan chmod jika perlu untuk memastikan bahwa file aaabbbcccdddeeefff.json dapat dibaca secara global. Lihat FAQ tentang kesalahan umum file preferensi untuk mendapatkan bantuan tambahan.

Lokalitas yang Didukung

Jika ingin menginstal ekstensi hanya untuk beberapa lokal browser, Anda dapat mencantumkan lokalitas yang didukung dalam nama kolom "supported_locales". Lokalitas dapat menentukan lokalitas induk seperti "en", dalam hal ini ekstensi akan diinstal untuk semua lokal bahasa Inggris seperti "en-US", "en-GB", dll. Jika lokalitas browser lain dipilih yang tidak didukung oleh ekstensi, ekstensi eksternal akan di-uninstal. Jika daftar "supported_locales" tidak ada, ekstensi akan diinstal untuk semua lokalitas. Contoh:

{
  "external_update_url": "https://clients2.google.com/service/update2/crx",
  "supported_locales": [ "en", "fr", "de" ]
}

Menggunakan registry Windows

1. Temukan atau buat kunci berikut di registry:

   Windows 32 bit

   HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions

   Windows 64 bit

   HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions

2. Buat kunci (folder) baru di bagian kunci Extensions dengan nama yang sama seperti ID ekstensi Anda. Contoh: aaabbbcccdddeeefff.

3. Di kunci ekstensi, buat properti "update_url" dan tetapkan ke nilai berikut: json { "update_url": "https://clients2.google.com/service/update2/crx" }

4. Luncurkan Chrome.

5. Buka chrome://extensions, lalu Anda akan melihat ekstensi yang tercantum.

Catatan: Periksa kesalahan umum registry Windows untuk mendapatkan bantuan tambahan.

Mengupdate dan meng-uninstal

Google Chrome memindai entri metadata di preferensi dan registry setiap kali browser dimulai, dan membuat perubahan yang diperlukan pada ekstensi eksternal terinstal yang dihosting di Chrome Web Store.

Untuk mengupdate ekstensi file CRX lokal ke versi baru, update file, lalu update versi di file JSON preferensi.

Untuk meng-uninstal ekstensi (misalnya, jika software di-uninstal), hapus file preferensi Anda (misalnya, aaabbbcccdddeeefff.json) atau metadata dari registry.

FAQ

Bagian ini menjawab pertanyaan umum tentang ekstensi eksternal.

Apakah "pra-instal" masih didukung oleh Google Chrome?

Ya, tetapi hanya sebagai penginstalan dari Chrome Web Store update_url, bukan dari jalur CRX lokal. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Aplikasi dan Ekstensi.

Apa saja kesalahan umum saat menginstal dengan file preferensi?

• Tidak mencantumkan ID atau versi yang sama dengan yang tercantum dalam file CRX.
• File JSON (misalnya, aaabbbcccdddeeefff.json) berada di lokasi yang salah atau ID yang ditentukan tidak cocok dengan ID ekstensi.
• Terjadi error sintaksis dalam file JSON (lupa memisahkan entri dengan koma atau meninggalkan koma di suatu tempat).
• Entri file JSON menunjuk ke jalur yang salah ke file CRX (atau jalur yang ditetapkan namun tidak ada nama file)
• Garis miring terbalik di jalur UNC tidak akan di-escape. Misalnya, "\\server\share\file" salah; seharusnya "\\\\server\\share\\extension".
• Masalah izin pada berbagi jaringan.

Apa saja kesalahan umum saat menginstal dengan registry?

• Tidak mencantumkan ID yang sama dengan yang tercantum di Chrome Web Store.
• Kunci dibuat di lokasi yang salah dalam registry.
• Entri registry menunjuk ke jalur yang salah ke file CRX di Chrome Web Store.
• Masalah izin pada berbagi jaringan.
• Tidak semua instance Chrome ditutup. Coba reboot komputer Anda setelah menyetel registry.

Bagaimana jika pengguna meng-uninstal ekstensi?

Jika pengguna meng-uninstal ekstensi melalui UI, ekstensi tidak akan diinstal atau diupdate lagi pada setiap startup. Dengan kata lain, ekstensi eksternal tersebut tidak diizinkan untuk digunakan.

Bagaimana cara keluar dari daftar yang tidak diizinkan?

Jika pengguna meng-uninstal ekstensi, Anda harus mematuhi keputusan tersebut. Namun, jika Anda (developer) tidak sengaja meng-uninstal ekstensi melalui UI, Anda dapat menghapus tag daftar yang tidak diizinkan dengan menginstal ekstensi seperti biasa melalui UI, lalu meng-uninstalnya.