Alternatif yükleme yöntemlerini kullanın

Chrome kullanıcıları uzantıları genellikle Chrome Web Mağazası'ndaki bir uzantının girişini ziyaret ederek ve uzantıyı doğrudan söz konusu sayfadan yükleyerek yükler. Ancak bazı durumlarda diğer yükleme akışları daha uygun olabilir. Örneğin:

  • Bir uzantı başka bir yazılımla ilişkilendirilir ve kullanıcı bu yazılımı her yüklediğinde yüklenmelidir.
  • Bir ağ yöneticisi, aynı uzantıları kuruluşunun tamamına yüklemek istiyor.

Önceki durumlarda, Google Chrome aşağıdaki uzantı yükleme yöntemlerini destekler:

Her iki yöntem de update_URL içinde barındırılan bir uzantının yüklenmesini destekler. Windows ve macOS'te update_URL, Chrome Web Mağazası'nı işaret etmelidir. Bir uzantı bu yöntemler kullanılarak yüklendiğinde, Windows ve macOS kullanıcılarının aşağıdaki onay iletişim kutusunu kullanarak uzantıyı etkinleştirmesi gerekir:

Harici uzantı uyarısı

Linux'ta, tercihler dosyası bir Chrome Web Mağazası uzantısını, harici olarak barındırılan bir uzantıyı veya kullanıcının bilgisayarındaki bir CRX uzantı dosyasını işaret edebilir. Linux kullanıcılarından uzantıyı etkinleştirmeleri istenmez; uzantı otomatik olarak yüklenir.

Başlamadan önce

Chrome Web Mağazası'ndan yükleyin

Chrome Web Mağazası'nda barındırılan bir uzantıyı dağıtıyorsanız öncelikle uzantıyı yayınlamanız gerekir. Sonra aşağıdaki noktaları not edin:

  • Güncelleme URL'si: https://clients2.google.com/service/update2/crx. Bu URL Chrome Web Mağazası'nı gösterir.
  • Uzantının kimliği: Bu, uzantının Chrome Web Mağazası URL'sinde bulunabilir.

Chrome Web Mağazası öğe kimliği

Yerel CRX dosyasından yükle

Linux kullanıcılarına yerel bir dosyadan dağıtım yapıyorsanız bir CRX dosyası paketlemeniz ve aşağıdaki bilgilere dikkat etmeniz gerekir:

  • Uzantı kimliği: Bu kimlik, uzantı yönetimi sayfasında chrome://extensions bulunabilir.

  • Uzantı sürümü - Bu bilgi, uzantı yönetimi sayfasında chrome://extensions veya manifest JSON dosyasında görünür.

Uzantı kimliği ve sürümünü nasıl bulunur?

  • CRX dosyasının konumu - Bu, yerel bir dizin veya ağ paylaşımı olabilir. Dosyanın, uzantıyı yüklemek istediğiniz makinede bulunduğundan emin olun.

Kişisel sunucudan yükle

Linux kullanıcıları için kişisel sunucuda barındırılan bir uzantı dağıtıyorsanız Linux'a uzantı yükleme talimatlarını uygulamanız ve aşağıdaki bilgilere dikkat etmeniz gerekir:

  • Uzantı kimliği: Bu kimlik, uzantı yönetimi sayfasında chrome://extensions bulunabilir.

  • update_url XML dosyası yolu: Bu yol, manifest JSON dosyasında belirtilen update_url alanının yoluyla eşleşmelidir.

Aşağıdaki örneklerde, sürümün 1.0 ve uzantı kimliğinin aaabbbcccdddeeefff olduğu varsayılmaktadır.

Tercihler dosyası kullanma

macOS

  1. Uzantı kimliğine sahip bir JSON dosyası oluşturun. Örneğin: aaabbbcccdddeeefff.json

  2. Dosyayı aşağıdaki klasörlerden birine yerleştirin:

    Belirli bir kullanıcı için
    ~USERNAME/Library/Application Support/Google/Chrome/External Extensions/
    Tüm kullanıcılar için
    /Library/Application Support/Google/Chrome/External Extensions/

  3. Güncelleme URL'sini "external_update_url" alan adıyla belirtin. Örneğin: json { "external_update_url": "https://clients2.google.com/service/update2/crx" }

  4. JSON dosyasını kaydedin.

  5. Google Chrome'u başlatın ve chrome://extensions sayfasına gidin. Uzantıyı listede görürsünüz.

Mac OS izin sorunlarını giderme

macOS'te, tüm kullanıcıların harici uzantı dosyaları yalnızca dosya sistemi izinleri, ayrıcalığı olmayan kullanıcıların dosyayı değiştirmesini engelliyorsa okunur. Chrome başlatıldığında yüklenen harici uzantıları görmüyorsanız, harici uzantı tercihleri dosyalarıyla ilgili bir izin sorunu olabilir. Sorunun bu olup olmadığını anlamak için şu adımları uygulayın:

  1. Console programını başlatın. Bu dosyayı /Applications/Utilities/Console altında bulabilirsiniz.
  2. Konsolun en solundaki simgede "Günlük Listesini Göster" yazıyorsa o simgeyi tıklayın. Solda ikinci bir sütun görünür.
  3. Sol bölmede "Console Messages"ı (Konsol İletileri) tıklayın.
  4. Can't read external extensions dizesini arayın. Harici uzantı dosyalarını okurken bir sorun yaşarsanız bir hata mesajı görürsünüz. Hemen öncesinde başka bir hata mesajı arayın. Bu mesaj, sorunu açıklayabilir. Örneğin, "Path /Kitaplık/Uygulama Desteği/Google/Chrome yanlış gruba ait" hatasını görürseniz dizinin grup sahibini Yönetici grubu olarak değiştirmek için chgrp veya Finder'ın Bilgi Al iletişim kutusunu kullanmanız gerekir.
  5. Sorunu düzelttikten sonra Chrome'u yeniden başlatın. Harici uzantının şu anda yüklü olup olmadığını test edin. Bir izin hatası, Chrome'un ikinci bir hatayı algılamasını engelleyebilir. Harici uzantı yüklü değilse Console uygulamasında bir hata görene kadar bu adımları tekrarlayın.

Linux

  1. Uzantı kimliğine sahip bir JSON dosyası oluşturun. Örneğin: aaabbbcccdddeeefff.json.

  2. Dosyayı aşağıdaki klasörlerden birine yerleştirin:

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

  3. Aşağıdaki listede, Chrome Web Mağazası'ndan, bir CRX dosyasından veya bir kişisel sunucudan uzantı yükleme işlemi açıklanmaktadır:

    • Bir Chrome Web Mağazası uzantısı yüklemek için, güncelleme URL'sini "external_update_url" alan adıyla belirtin. Örneğin: json { "external_update_url": "https://clients2.google.com/service/update2/crx" }
    • Uzantıyı bir CRX dosyasından yüklemek için konumu "external_crx", sürümü ise "external_version" içinde belirtin. Örneğin: json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" }
    • Kişisel bir sunucuda barındırılan uzantıyı yüklemek için "external_update_url" alanı, aşağıdaki örnekte gösterildiği gibi xml dosyasına işaret etmelidir: json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }

  4. JSON dosyasını kaydedin.

  5. Google Chrome'u başlatın ve chrome://extensions sayfasına gidin. Uzantıyı listede görürsünüz.

Desteklenen Yerler

Uzantıyı yalnızca bazı tarayıcı yerel ayarları için yüklemek istiyorsanız desteklenen yerel ayarları "supported_locales" alan adında listeleyebilirsiniz. Yerel ayar "en" gibi bir üst yerel ayar belirtebilir. Bu durumda, uzantı "en-US", "en-GB" gibi tüm İngilizce yerel ayarlar için yüklenir. Uzantı tarafından desteklenmeyen başka bir tarayıcı yerel ayarı seçilirse harici uzantılar kaldırılır. "supported_locales" listesi eksikse uzantı tüm yerel ayarlar için yüklenir. Örneğin:

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

Windows kayıt defterini kullanma

  1. Kayıt defterinde aşağıdaki anahtarı bulun veya oluşturun:

    32 bit Windows
    HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions
    64 bit Windows
    HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions

  2. Uzantılar anahtarının altında, uzantınızın kimliğiyle aynı ada sahip yeni bir anahtar (klasör) oluşturun. Örneğin: aaabbbcccdddeeefff.

  3. Uzantı anahtarınızda bir "update_url" özelliği oluşturun ve şu değere ayarlayın: json { "update_url": "https://clients2.google.com/service/update2/crx" }

  4. Chrome'u başlatın.

  5. chrome://extensions sayfasına gidin. Uzantının listelendiğini göreceksiniz.

Güncelleme ve kaldırma

Google Chrome, tarayıcı her başlatıldığında tercihler ve kayıt defterindeki meta veri girişlerini tarar ve Chrome Web Mağazası'nda barındırılan yüklü harici uzantılarda gerekli değişiklikleri yapar.

Yerel bir CRX dosya uzantısını yeni bir sürüme güncellemek için dosyayı güncelleyin ve ardından tercihler json dosyasında sürümü güncelleyin.

Uzantınızı kaldırmak için (örneğin, yazılımınız kaldırılmışsa) tercih dosyanızı (örneğin, aaabbbcccdddeeefff.json) veya meta verileri kayıt defterinden kaldırın.

SSS

Bu bölümde, harici uzantılar hakkında sık sorulan sorular yanıtlanmaktadır.

"Önceden yükleme" özelliği Google Chrome tarafından hâlâ destekleniyor mu?

Evet, ancak yalnızca bir Chrome Web Mağazası'ndan update_url yükleme olarak; yerel CRX yolundan değil. Daha fazla bilgi için Uygulama ve Uzantı politikaları bölümüne bakın.

Tercihler dosyasıyla yükleme yaparken sık yapılan hatalar nelerdir?

  • CRX dosyasında listelenen kimliği veya sürümü belirtmemek.
  • JSON dosyası (örneğin, aaabbbcccdddeeefff.json) yanlış konumda veya belirtilen kimlik, uzantı kimliğiyle eşleşmiyor.
  • JSON dosyasında söz dizimi hatası (girişleri virgülle ayırmayı unutmak veya bir yere virgül koymamak).
  • JSON dosyası girişi, CRX dosyasının yanlış yolunu (veya yol belirtilmiş ancak dosya adı belirtilmemiş) işaret ediyor
  • UNC yolundaki ters eğik çizgiler kod dışına alınmaz. Örneğin, "\\server\share\file" yanlış; "\\\\server\\share\\extension" olmalıdır.
  • Ağ paylaşımında izin sorunları.

Kayıt defteri ile yükleme yaparken karşılaşılan bazı yaygın hatalar nelerdir?

  • Chrome Web Mağazası'nda listelenen kimlikle aynı kimliği belirtmemek.
  • Anahtar, kayıt defterinde yanlış konumda oluşturuldu.
  • Kayıt defteri girişi, Chrome Web Mağazası'nda CRX dosyasının yanlış yolunu işaret ediyor.
  • Ağ paylaşımında izin sorunları.
  • Chrome'un tüm örnekleri kapalı değildir. Kayıt defterini ayarladıktan sonra bilgisayarınızı yeniden başlatmayı deneyin.

Kullanıcı uzantıyı kaldırırsa ne olur?

Kullanıcı, uzantıyı kullanıcı arayüzü üzerinden kaldırırsa uzantı artık her başlatmada yüklenmez veya güncellenmez. Diğer bir deyişle, harici uzantı engellenenler listesine alınır.

Engellenenler listesinden nasıl çıkabilirim?

Kullanıcı uzantınızı kaldırırsa bu karara uymalısınız. Bununla birlikte, siz (geliştirici) uzantınızı kullanıcı arayüzü üzerinden yanlışlıkla kaldırdıysanız, uzantıyı normal bir şekilde kullanıcı arayüzünden yükleyerek ve ardından kaldırarak engellenenler listesi etiketini kaldırabilirsiniz.