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](https://developer.chrome.google.cn/static/docs/extensions/develop/concepts/permission-warnings/image/example-permission-warni-8d794fb2f9274.png?authuser=6&hl=pl)
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ń.](https://developer.chrome.google.cn/static/docs/extensions/develop/concepts/permission-warnings/image/example-an-extension-is-6772580db51de.gif?authuser=6&hl=pl)
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
- Zainstaluj Node.js i NPM.
- Zainstaluj Chromium.
- Sklonuj repozytorium extension-update-testing-tool.
- Uruchom polecenie
npm install
w katalogu głównym repozytorium.
Korzystanie z narzędzia
- Uruchom
npm start
. - Otwórz serwer lokalny pod adresem http://localhost:8080 w Chromium.
- Przeciągnij na stronę rozszerzenie bez pakietu (folder lub plik ZIP).
- Aby pobrać i zainstalować rozszerzenie, postępuj zgodnie z instrukcjami podanymi w sekcji „Zainstaluj ręcznie”.
Ręczne pakowanie rozszerzenia
- Przejdź do:
chrome://extensions
- Włącz tryb programisty
- Kliknij Umieść rozszerzenie w pakiecie.
Rysunek 3. Tryb programisty włączony na stronie zarządzania rozszerzeniami - Podaj ścieżkę do folderu rozszerzenia w polu katalogu głównego rozszerzenia. W przypadku pakietu tworzonego po raz pierwszy zignoruj pole Klucz prywatny.
Kliknij przycisk Umieść rozszerzenie w pakiecie.
Rysunek 4. Określanie ścieżki rozszerzenia 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.Rysunek 5. Spakowane pliki rozszerzeń Przechowuj plik
.pem
w tajnym i bezpiecznym miejscu. Będzie on potrzebny do zaktualizowania rozszerzenia.Zainstaluj plik
.crx
, upuszczając go na stronę zarządzania rozszerzeniem.Rysunek 6. Upuść plik, aby go zainstalować Po upuszczeniu pliku
.crx
przeglądarka zapyta, czy można dodać rozszerzenie, i wyświetli ostrzeżenia.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
- Dodaj nowe uprawnienie z ostrzeżeniem.
- Zwiększ numer wersji rozszerzenia.
- Przeciągnij rozpakowane rozszerzenie (folder lub plik ZIP) na stronę.
- Otwórz:
chrome://extensions
. - Kliknij przycisk Aktualizuj.
Ręczna aktualizacja rozszerzenia
- Znajdź utworzony przed chwilą plik
.crx
w sekcji Wyświetl ostrzeżenia. - Zmień ją lub usuń.
- Otwórz
manifest.json
i dodaj dowolne uprawnienia, które powodują wyświetlenie ostrzeżenia. - Otwórz:
chrome://extensions
. Nie usuwaj pakietu, który został wcześniej zainstalowany. - Ponownie spakuj rozszerzenie, ale tym razem w drugim polece wejściowej dodaj plik pem.
Rysunek 8.: Okno z rozszerzeniem pakowania z dołączonym plikiem pem. - Przeciągnij nowe rozszerzenie w pakiecie na stronę Zarządzanie rozszerzeniami.
Wyświetli się okno z prośbą o zaakceptowanie nowych uprawnień.
Rysunek 9. Ostrzeżenie o wyłączonym rozszerzeniu Rysunek 10. Prośba o nowe uprawnienia