Menggunakan metode penginstalan alternatif

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

• Ekstensi dikaitkan dengan beberapa software lain, dan ekstensi harus diinstal setiap kali pengguna menginstal software lain tersebut.
• Seorang 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 tersebut mendukung penginstalan ekstensi yang dihosting di update_URL. Di Windows dan macOS, update_URL harus mengarah ke Chrome Web Store. Saat 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 karena ekstensi ini 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 Melanjutkan perlindungan 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, catat 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 file ke pengguna Linux dari file lokal, Anda harus mengemas file CRX dan mencatat 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— Ini 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 versinya adalah 1.0 dan ID ekstensi adalah aaabbbcccdddeeefff.

Menggunakan file preferensi

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

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 orang. Jalur juga harus bebas dari tautan simbolis. Batasan ini mencegah pengguna tanpa hak istimewa menyebabkan ekstensi diinstal untuk semua pengguna. Lihat Memecahkan masalah izin.

Memecahkan masalah izin OS Mac

Di macOS, file ekstensi eksternal untuk semua pengguna hanya dibaca jika izin sistem file mencegah pengguna tanpa hak istimewa mengubahnya. Jika Anda tidak melihat ekstensi eksternal yang diinstal saat Chrome diluncurkan, mungkin ada masalah izin dengan file preferensi ekstensi eksternal. Untuk melihat apakah ini masalahnya, ikuti langkah-langkah berikut:

1. Luncurkan program Konsol. Anda dapat menemukannya di bagian /Applications/Utilitas/Konsol.
2. Jika ikon paling kiri di Konsol bertuliskan "Show Log List", klik ikon tersebut. Kolom kedua akan 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 akan menjelaskan masalahnya. Misalnya, jika Anda melihat error berikut: "Jalur /Library/Application Support/Google/Chrome dimiliki oleh grup yang salah", Anda harus menggunakan chgrp atau dialog Get Info Finder untuk mengubah pemilik grup direktori menjadi grup Administrator.
5. Setelah memperbaiki masalah, luncurkan kembali Chrome. Uji apakah ekstensi eksternal kini telah diinstal. Mungkin saja satu error izin mencegah Chrome mendeteksi error kedua. Jika ekstensi eksternal tidak diinstal, ulangi langkah-langkah ini hingga Anda tidak melihat error di aplikasi Console.

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 versi 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-nya.

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

Catatan: Gunakan chmod jika perlu untuk memastikan file aaabbbcccdddeeefff.json dapat dibaca oleh semua orang. Lihat FAQ kesalahan umum file preferensi untuk mendapatkan bantuan tambahan.

Lokalitas yang Didukung

Jika ingin menginstal ekstensi hanya untuk beberapa lokalitas browser, Anda dapat mencantumkan lokalitas yang didukung dalam nama kolom "supported_locales". Lokal dapat menentukan lokalitas induk seperti "en". Dalam hal ini, ekstensi akan diinstal untuk semua lokalitas bahasa Inggris seperti "en-US", "en-GB", dll. Jika lokal browser lain dipilih dan tidak didukung oleh ekstensi, ekstensi eksternal akan di-uninstal. Jika daftar "supported_locales" tidak ada, ekstensi akan diinstal untuk lokalitas apa pun. 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 dengan 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; Anda akan melihat ekstensi tercantum.

Catatan: Lihat Kesalahan umum registry Windows untuk mendapatkan bantuan tambahan.

Memperbarui dan meng-uninstal

Google Chrome akan 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 Anda di-uninstal), hapus file preferensi Anda (misalnya aaabbbcccdddeeefff.json) atau metadata dari registry.

FAQ

Bagian ini menjawab pertanyaan umum tentang ekstensi eksternal.

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

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

Apa saja kesalahan umum saat menginstal dengan file preferensi?

• Tidak menentukan 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.
• Error sintaksis dalam file JSON (lupa memisahkan entri dengan koma atau meninggalkan koma di akhir di suatu tempat).
• Entri file JSON mengarah ke jalur yang salah ke file CRX (atau jalur yang ditentukan tetapi tidak ada nama file)
• Garis miring terbalik di jalur UNC tidak di-escape. Misalnya, "\\server\share\file" salah; seharusnya "\\\\server\\share\\extension".
• Masalah izin di berbagi jaringan.

Apa saja kesalahan umum saat menginstal dengan registry?

• Tidak menentukan ID yang sama dengan yang tercantum di Chrome Web Store.
• Kunci dibuat di lokasi yang salah dalam registry.
• Entri registry mengarah ke jalur yang salah ke file CRX di Chrome Web Store.
• Masalah izin di berbagi jaringan.
• Tidak semua instance Chrome ditutup. Coba mulai ulang komputer setelah menetapkan registry.

Bagaimana jika pengguna meng-uninstal ekstensi?

Jika pengguna meng-uninstal ekstensi melalui UI, ekstensi tidak akan lagi diinstal atau diupdate pada setiap pengaktifan. Dengan kata lain, ekstensi eksternal akan masuk daftar yang tidak diizinkan.

Bagaimana cara menghapus nama saya dari daftar blokir?

Jika pengguna meng-uninstal ekstensi Anda, Anda harus menghormati keputusan tersebut. Namun, jika Anda (developer) tidak sengaja meng-uninstal ekstensi melalui UI, Anda dapat menghapus tag daftar yang tidak diizinkan dengan menginstal ekstensi secara normal melalui UI, lalu meng-uninstal-nya.