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.

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ń.

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.

   

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.

   

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.

   

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.

   

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

   

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.

   

6. Przeciągnij nowe rozszerzenie w pakiecie na stronę Zarządzanie rozszerzeniami.

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