Wytyczne dotyczące ostrzeżeń o uprawnieniach

Rozszerzenia do Chrome zwiększają wygodę korzystania z przeglądarki. Aby to zrobić, użyj interfejsów API Chrome, które wymagają określonych uprawnień. Niektóre uprawnienia są mniej uciążliwe i nie wyświetlają się ostrzeżenia. Inne uprawnienia aktywują ostrzeżenie, na które użytkownicy muszą zezwolić. Ta strona zawiera wytyczne na temat pracy z ostrzeżeniami o uprawnieniach. Konkretne ostrzeżenia są wymienione w sekcji Uprawnienia w uprawnieniach, do których mają zastosowanie.

Przykładowe ostrzeżenia o uprawnieniach są wyświetlane, gdy użytkownik dodaje nowe rozszerzenie
Rysunek 1. Okno z ostrzeżeniami o uprawnieniach wyświetlane podczas instalacji.

Po dodaniu nowego uprawnienia, które wywołuje ostrzeżenie, rozszerzenie zostanie wyłączone do czasu, aż użytkownik je zaakceptuje. Aby dowiedzieć się, jak przetestować takie działanie, przeczytaj sekcję Aktualizowanie uprawnień.

Przykład rozszerzenia, które jest wyłączone, dopóki użytkownik nie zaakceptuje nowych uprawnień.
Rysunek 2. Rozszerzenie, które jest wyłączone, dopóki użytkownik nie zaakceptuje nowych uprawnień.

Niektóre uprawnienia mogą nie wyświetlać ostrzeżeń, jeśli są sparowane z innymi uprawnieniami. Na przykład ostrzeżenie "tabs" nie pojawi się, jeśli rozszerzenie wyśle też żądanie "<all_urls>".

Sprawdzone metody

Ostrzeżenia dotyczące uprawnień opisują możliwości zapewniane przez interfejs API, ale niektóre ostrzeżenia są trudniejsze do zrozumienia niż inne. Użytkownicy chętniej zainstalują rozszerzenia zgodne z tymi wytycznymi:

Poproś o odpowiednie uprawnienia
Rozszerzenia są wymagane do realizowania jednego przeznaczenia i zapewniania zgodności z zasadami korzystania z uprawnień. Pamiętaj, aby prosić tylko o uprawnienia, które są zgodne z główną funkcją rozszerzenia.
Użyj opcjonalnych uprawnień
Usprawnij proces wdrożenia, prosząc o uprawnienia w czasie działania. Dzięki temu możesz dać więcej informacji o konkretnych uprawnieniach i umożliwić użytkownikom wybór funkcji, które chcą włączyć. Szczegóły implementacji znajdziesz w artykule Permissions API.
Używanie uprawnienia „activeTab”
To uprawnienie nie wyświetla ostrzeżenia o uprawnieniach. Przyznaje tymczasowe uprawnienia hosta w witrynie, w której znajduje się użytkownik. Więcej informacji znajdziesz w sekcji z informacjami o uprawnieniach ActiveTab.

Wyświetl ostrzeżenia

Ostrzeżenia o uprawnieniach rozszerzenia możesz wyświetlić na 2 sposoby:

Używanie narzędzia do testowania aktualizacji rozszerzeń

Zanim zaczniesz

  1. Zainstaluj Node.js i NPM.
  2. Zainstaluj Chromium.
  3. Sklonuj repozytorium extension-update-testing-tool.
  4. Uruchom polecenie npm install w katalogu głównym repozytorium.

Korzystanie z narzędzia

  1. Uruchom npm start.
  2. Otwórz serwer lokalny pod adresem http://localhost:8080 w Chromium.
  3. Przeciągnij na stronę rozszerzenie bez pakietu (folder lub plik ZIP).
  4. Aby pobrać i zainstalować rozszerzenie, postępuj zgodnie z instrukcjami podanymi w sekcji „Zainstaluj ręcznie”.

Ręczne pakowanie rozszerzenia

  1. Przejdź do: chrome://extensions
  2. Włącz tryb programisty
  3. Kliknij Umieść rozszerzenie w pakiecie.
    Spakuj rozszerzenie
    Rysunek 3. Tryb programisty włączony na stronie zarządzania rozszerzeniami
  4. Podaj ścieżkę do folderu rozszerzenia w polu katalogu głównego rozszerzenia. W przypadku pakietu tworzonego po raz pierwszy zignoruj pole Klucz prywatny.

  5. Kliknij przycisk Umieść rozszerzenie w pakiecie.

    Podaj ścieżkę rozszerzenia, a następnie kliknij Dodaj rozszerzenie
    Rysunek 4. Określanie ścieżki rozszerzenia

  6. Chrome utworzy 2 pliki: .crx i .pem. Plik .pem zawiera klucz prywatny używany do podpisania rozszerzenia. Upewnij się, że pamiętasz, w którym katalogu zostały zapisane te pliki.

    Spakowane pliki rozszerzeń
    Rysunek 5. Spakowane pliki rozszerzeń

  7. Przechowuj plik .pem w tajnym i bezpiecznym miejscu. Będzie on potrzebny do zaktualizowania rozszerzenia.

  8. Zainstaluj plik .crx, upuszczając go na stronę zarządzania rozszerzeniem.

    Upuść plik, by zainstalować
    Rysunek 6. Upuść plik, aby go zainstalować

  9. Po upuszczeniu pliku .crx przeglądarka zapyta, czy można dodać rozszerzenie, i wyświetli ostrzeżenia.

    Ostrzeżenie dotyczące rozszerzenia nowej karty
    Rysunek 7. Ostrzeżenie dotyczące rozszerzenia nowej karty

Aktualizuj uprawnienia

Gdy rozszerzenie doda nowe uprawnienie, które wywołuje ostrzeżenie, może je tymczasowo wyłączyć. Rozszerzenie zostanie włączone ponownie dopiero wtedy, gdy użytkownik wyrazi zgodę na nowe uprawnienia.

Jeśli chcesz sprawdzić, czy rozszerzenie zostanie wyłączone po dodaniu nowego uprawnienia, możesz to zrobić na 2 sposoby:

Aktualizowanie za pomocą narzędzia do testowania aktualizacji rozszerzeń

W tych krokach przyjęto, że serwer został uruchomiony zgodnie z instrukcjami za pomocą narzędzia do testowania aktualizacji rozszerzeń.

Korzystanie z narzędzia

  1. Dodaj nowe uprawnienie z ostrzeżeniem.
  2. Zwiększ numer wersji rozszerzenia.
  3. Przeciągnij rozpakowane rozszerzenie (folder lub plik ZIP) na stronę.
  4. Otwórz: chrome://extensions.
  5. Kliknij przycisk Aktualizuj.

Ręczna aktualizacja rozszerzenia

  1. Znajdź utworzony przed chwilą plik .crx w sekcji Wyświetl ostrzeżenia.
  2. Zmień ją lub usuń.
  3. Otwórz manifest.json i dodaj dowolne uprawnienia, które powodują wyświetlenie ostrzeżenia.
  4. Otwórz: chrome://extensions. Nie usuwaj pakietu, który został wcześniej zainstalowany.
  5. Ponownie spakuj rozszerzenie, ale tym razem w drugim polece wejściowej dodaj plik pem.
    Plik Pem został dodany podczas pakowania rozszerzenia
    Rysunek 8.: Okno z rozszerzeniem pakowania z dołączonym plikiem pem.
  6. Przeciągnij nowe rozszerzenie w pakiecie na stronę Zarządzanie rozszerzeniami.

  7. Wyświetli się okno z prośbą o zaakceptowanie nowych uprawnień.

    Rozszerzenie zostało wyłączone

    Rysunek 9. Ostrzeżenie o wyłączonym rozszerzeniu

    Zaakceptuj uprawnienia
    Rysunek 10. Prośba o nowe uprawnienia