İzin uyarısı kuralları

Chrome uzantıları, kullanıcının tarayıcı deneyimini geliştirir. Bunu yapmak için belirli izinler gerektiren Chrome API'lerini kullanın. Bazı izinler daha az rahatsız edicidir ve herhangi bir uyarı görüntülemez. Diğer izinler, kullanıcıların izin vermesi gereken bir uyarıyı tetikler. Bu sayfada, izin uyarılarıyla çalışmayla ilgili yönergeler yer almaktadır. Belirli uyarılar, geçerli oldukları iznin altındaki İzinler bölümünde belirtilmiştir.

Kullanıcı yeni bir uzantı eklediğinde izin uyarıları örnekleri gösterilir
Şekil 1: Yükleme sırasında görüntülenen izin uyarıları iletişim kutusu.

Uyarı tetikleyen yeni bir izin eklendiğinde, kullanıcı yeni izni kabul edene kadar uzantı devre dışı bırakılır. Bu davranışı nasıl test edeceğinizi öğrenmek için İzinleri güncelleme bölümüne bakın.

Kullanıcı yeni izni kabul edene kadar devre dışı bırakılan bir uzantı örneği.
Şekil 2: Kullanıcı yeni izni kabul edene kadar devre dışı bırakılacak bir uzantı.

Bazı izinler, diğer izinlerle eşlendiğinde uyarı göstermeyebilir. Örneğin, uzantı "<all_urls>" izni de istiyorsa "tabs" uyarısı gösterilmez.

En iyi uygulamalar

İzin uyarıları, API'lerin sağladığı özellikleri açıklar ancak bazı uyarıların anlaşılması diğerlerinden daha zordur. Kullanıcıların aşağıdaki kurallara uyan uzantıları yükleme olasılığı daha yüksektir:

İlgili izinleri isteyin
Uzantılar tek bir amacı yerine getirmek ve İzinlerin kullanımı politikasına uymak için gereklidir. Yalnızca uzantının ana işlevini destekleyen izinleri istediğinizden emin olun.
İsteğe bağlı izinleri kullanma
Çalışma zamanında izin isteyerek ilk katılım deneyimini iyileştirin. Bu, belirli bir izinle ilgili daha fazla bağlam sağlamanıza ve kullanıcıların etkinleştirmek istedikleri özellikleri seçmelerine olanak tanır. Uygulama ayrıntıları için Permissions API'ye bakın.
"activeTab" iznini kullanın
Bu izin, izin uyarısı göstermez. Kullanıcının bulunduğu siteye geçici ana makine izni verir. Ayrıntılar için activeTab iznini anlama bölümüne bakın.

Uyarıları göster

Bir uzantının izin uyarılarını görüntülemek için aşağıdaki seçenekleri kullanabilirsiniz:

Uzantı Güncelleme Test Aracı'nı Kullanma

Başlamadan önce

  1. Node.js ve AİOY'yi yükleyin.
  2. Chromium'u yükleyin.
  3. extension-update-testing-tool deposunu klonlayın.
  4. npm install komutunu deponun kökünde çalıştırın.

Aracı kullanma

  1. npm start komutunu çalıştırın.
  2. Chromium'da http://localhost:8080 adresindeki yerel sunucuyu açın.
  3. Paketlenmemiş bir uzantıyı (klasör veya .zip dosyası) sayfaya sürükleyin.
  4. Uzantıyı indirip yüklemek için "Manuel olarak yükleme" başlığı altındaki talimatları uygulayın.

Uzantıyı manuel olarak paketleyerek

  1. chrome://extensions adlı müşteriye gidin
  2. Geliştirici modunu etkinleştir
  3. Paket Uzantısı'nı tıklayın.
    Uzantıyı paketle
    Şekil 3: Uzantı yönetimi sayfasında geliştirici modu etkin
  4. Uzantı kök dizini alanında, uzantı klasörünün yolunu belirtin. İlk kez paket için Özel anahtar alanını yoksayın.
  5. Paket Uzantısı düğmesini tıklayın.

    Uzantı Yolunu Belirtin, ardından Uzantıyı Paketle&#39;yi tıklayın
    Şekil 4: Uzantı Yolunu Belirtme
  6. Chrome, .crx dosyası ve .pem dosyası olmak üzere iki dosya oluşturur. .pem dosyası, uzantıyı imzalamak için kullanılan özel anahtarı içerir. Bu dosyaların hangi dizine kaydedildiğini hatırladığınızdan emin olun.

    Paketli Uzantı Dosyaları
    Şekil 5: Paketli Uzantı Dosyaları
  7. .pem dosyasını gizli ve güvenli bir yerde saklayın; uzantıyı güncellemek için bu dosya gerekecektir.

  8. .crx dosyasını Uzantının Yönetim sayfasına bırakarak yükleyin.

    Yüklenecek Dosyayı Bırakın
    Şekil 6: Yüklemek için dosyayı bırakın
  9. .crx dosyasını bıraktıktan sonra tarayıcı, uzantının eklenip eklenemeyeceğini sorar ve uyarılar gösterir.

    Yeni Sekme Uzantısıyla İlgili Uyarı
    Şekil 7: Yeni Sekme uzantısıyla ilgili uyarı

İzinleri güncelle

Bir uzantı bir uyarı tetikleyen yeni bir izin eklediğinde bunu geçici olarak devre dışı bırakabilir. Uzantı, yalnızca kullanıcı yeni izni kabul ettikten sonra yeniden etkinleştirilir.

Yeni bir izin eklerken uzantınızın devre dışı bırakılıp bırakılmayacağını kontrol etmek için aşağıdaki seçenekleri kullanabilirsiniz:

Uzantı Güncelleme Test Aracı'nı kullanarak güncelleme

Bu adımlarda, sunucuyu başlatmak için Uzantı Güncelleme Test Aracı'nı Kullanma talimatlarını izlediğiniz varsayılmaktadır.

Aracı kullanma

  1. Uyarı içeren yeni bir izin ekleyin.
  2. Uzantının sürüm numarasını artırın.
  3. Paketlenmemiş uzantıyı (klasör veya .zip dosyası) sayfaya sürükleyin.
  4. Şuraya git: chrome://extensions.
  5. Güncelle düğmesini tıklayın.

Uzantınızı manuel olarak güncelleyin

  1. Yeni oluşturduğunuz .crx dosyasını Uyarıları Görüntüle bölümünde bulun.
  2. Alanı yeniden adlandırın veya silin.
  3. manifest.json cihazınızı açın ve uyarı tetikleyen izinleri ekleyin.
  4. Şuraya git: chrome://extensions. Daha önce yüklenmiş olan paketi kaldırmayın.
  5. Uzantıyı tekrar paketleyin ama bu kez pem dosyasını ikinci girişe ekleyin.
    Uzantı paketlenirken Pem dosyası eklendi
    Şekil 8: pem dosyasının eklendiği paket uzantısı iletişim kutusu.
  6. Pakete eklenen yeni uzantıyı Uzantı Yönetimi sayfasına sürükleyin.
  7. Kullanıcının yeni izinleri kabul etmesini isteyen bir iletişim kutusu göreceksiniz.

    Uzantı devre dışı bırakıldı

    Şekil 9: Devre dışı bırakılan uzantı uyarısı

    İzinleri kabul edin
    Şekil 10: Yeni izin isteme iletişim kutusu