Użytkownicy Chrome zazwyczaj instalują rozszerzenia, otwierając ich stronę w Chrome Web Store i instalując je bezpośrednio z tej strony. W niektórych przypadkach bardziej odpowiednie mogą być jednak inne procesy instalacji. Na przykład:
- Rozszerzenie jest powiązane z innym oprogramowaniem i powinno być instalowane zawsze, gdy użytkownik instaluje to inne oprogramowanie.
- Administrator sieci chce zainstalować te same rozszerzenia w całej organizacji.
W tych przypadkach Google Chrome obsługuje te metody instalacji rozszerzeń:
- za pomocą pliku preferencji JSON (tylko w przypadku systemu macOS X i Linuxa);
- za pomocą rejestru systemu Windows (tylko w systemie Windows).
Oba sposoby umożliwiają zainstalowanie rozszerzenia hostowanego na update_URL. W systemach Windows i macOS update_URL musi wskazywać Chrome Web Store. Po zainstalowaniu rozszerzenia za pomocą tych metod użytkownicy systemów Windows i macOS będą musieli włączyć je w oknie potwierdzenia:
W Linuxie plik preferencji może wskazywać na rozszerzenie z Chrome Web Store, rozszerzenie hostowane zewnętrznie lub plik rozszerzenia CRX na komputerze użytkownika. Użytkownicy systemu Linux nie będą proszeni o włączenie rozszerzenia; jest ono instalowane automatycznie.
Zanim zaczniesz
Instalowanie z Chrome Web Store
Jeśli rozpowszechniasz rozszerzenie hostowane w Chrome Web Store, musisz najpierw opublikować rozszerzenie. Następnie pamiętaj o tym:
- URL aktualizacji:
https://clients2.google.com/service/update2/crx. Ten adres URL prowadzi do Chrome Web Store. - Identyfikator rozszerzenia – możesz go znaleźć w adresie URL rozszerzenia w Chrome Web Store.
Zainstaluj z lokalnego pliku CRX
Jeśli rozpowszechniasz aplikację dla użytkowników Linuksa z pliku lokalnego, musisz przepakować plik CRX i zanotować te informacje:
Identyfikator rozszerzenia – możesz go znaleźć na stronie zarządzania rozszerzeniami
chrome://extensions.Wersja rozszerzenia – ta informacja jest widoczna na stronie zarządzania rozszerzeniem (
chrome://extensions) lub w pliku manifestu JSON.
- lokalizacja pliku CRX – może to być katalog lokalny lub zasób sieciowy; Upewnij się, że plik jest dostępny na komputerze, na którym chcesz zainstalować rozszerzenie.
Instalowanie z serwera osobistego
Jeśli rozpowszechniasz rozszerzenie hostowane na serwerze osobistym dla użytkowników Linuksa, musisz wykonać instrukcje z sekcji Instalowanie rozszerzeń w systemie Linux i zwrócić uwagę na te informacje:
Identyfikator rozszerzenia – znajdziesz go na stronie zarządzania rozszerzeniem
chrome://extensions.Ścieżka pliku XML update_url – musi być zgodna ze ścieżką pola
update_urlzadeklarowanego w pliku manifestu JSON.
W poniższych przykładach zakładamy, że wersja to 1.0, a identyfikator rozszerzenia to aaabbbcccdddeeefff.
Używanie pliku preferencji
macOS
- Utwórz plik JSON o nazwie identyfikatora rozszerzenia. Na przykład:
aaabbbcccdddeeefff.json Umieść go w jednym z tych folderów:
- Określone konto użytkownika
~USERNAME/Library/Application Support/Google/Chrome/External Extensions/- Wszyscy użytkownicy
/Library/Application Support/Google/Chrome/External Extensions/
Podaj adres URL aktualizacji w polu o nazwie „external_update_url”. Na przykład:
json { "external_update_url": "https://clients2.google.com/service/update2/crx" }Zapisz plik JSON.
Uruchom Google Chrome i otwórz chrome://extensions. Lista rozszerzeń powinna się pojawić na liście.
Rozwiązywanie problemów z uprawnieniami w systemie macOS
W systemie macOS pliki rozszerzeń zewnętrznych dla wszystkich użytkowników są tylko do odczytu, jeśli uprawnienia systemu plików uniemożliwiają ich zmianę przez użytkowników bez uprawnień. Jeśli po uruchomieniu Chrome nie widzisz zainstalowanych rozszerzeń zewnętrznych, może to oznaczać problem z uprawnieniami plików preferencji rozszerzeń zewnętrznych. Aby sprawdzić, czy to jest problem:
- Uruchom konsolę. Znajdziesz je w sekcji /Applications/Utilities/Console.
- Jeśli najbliższa lewo ikona w Konsoli ma etykietę „Pokaż listę logów”, kliknij ją. Po lewej stronie pojawi się druga kolumna.
- W panelu po lewej stronie kliknij „Wiadomości w Konsoli”.
- Wyszukaj ciąg znaków Nie można odczytać rozszerzeń zewnętrznych. Jeśli wystąpi problem z odczytaniem plików zewnętrznych rozszerzeń, pojawi się komunikat o błędzie. Bezpośrednio przed nim powinien pojawić się inny komunikat o błędzie, który powinien wyjaśniać problem. Jeśli na przykład pojawi się taki komunikat o błędzie: „Ścieżka /Library/Application Support/Google/Chrome jest własnością niewłaściwej grupy”, musisz użyć polecenia
chgrplub okna informacji w Finderze, aby zmienić właściciela grupy katalogu na grupę administratorów. - Po rozwiązaniu problemu uruchom ponownie Chrome. Sprawdź, czy rozszerzenie zewnętrzne jest teraz zainstalowane. Możliwe, że jeden błąd związany z uprawnieniami uniemożliwia Chrome wykrycie drugiego błędu. Jeśli to rozszerzenie nie zostało zainstalowane, powtarzaj te kroki, aż nie będzie pokazanego błędu w aplikacji Console.
Linux
- Utwórz plik JSON z nazwą identyfikatora rozszerzenia. Na przykład:
aaabbbcccdddeeefff.json. Umieść go w jednym z tych folderów:
/opt/google/chrome/extensions//usr/share/google-chrome/extensions/
Poniższa lista opisuje instalację rozszerzeń z Chrome Web Store, pliku CRX lub serwera osobistego:
- Aby zainstalować rozszerzenie z Chrome Web Store, podaj adres URL aktualizacji w polu o nazwie „external_update_url”. Przykład:
json { "external_update_url": "https://clients2.google.com/service/update2/crx" } - Aby zainstalować rozszerzenie z pliku CRX, określ lokalizację w polu „external_crx”, a wersję w polu „external_version”. Przykład:
json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" } - Aby zainstalować rozszerzenie hostowane na osobistym serwerze, pole „external_update_url” musi wskazywać na plik XML, jak w tym przykładzie:
json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }
- Aby zainstalować rozszerzenie z Chrome Web Store, podaj adres URL aktualizacji w polu o nazwie „external_update_url”. Przykład:
Zapisz plik JSON.
Uruchom Google Chrome i otwórz chrome://extensions. Rozszerzenie powinno się wyświetlić na liście.
Obsługiwane ustawienia regionalne
Jeśli chcesz zainstalować rozszerzenie tylko w niektórych językach przeglądarki, możesz podać listę obsługiwanych języków w polu o nazwie „supported_locales”. Lokalizacja może określać lokalizację nadrzędną, np. „en”. W takim przypadku rozszerzenie zostanie zainstalowane dla wszystkich lokalizacji języka angielskiego, np. „en-US”, „en-GB” itd. Jeśli wybierzesz inną lokalizację przeglądarki, która nie jest obsługiwana przez rozszerzenie, rozszerzenia zewnętrzne zostaną odinstalowane. Jeśli brakuje listy „supported_locales”, rozszerzenie zostanie zainstalowane dla każdego języka. Na przykład:
{
"external_update_url": "https://clients2.google.com/service/update2/crx",
"supported_locales": [ "en", "fr", "de" ]
}
Korzystanie z rejestru systemu Windows
Znajdź lub utwórz w rejestrze ten klucz:
- 32-bitowy system Windows
HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions- 64-bitowy system Windows
HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions
Utwórz nowy klucz (folder) w kluczu Extensions o tej samej nazwie co identyfikator rozszerzenia. Na przykład:
aaabbbcccdddeeefff.W kluczu rozszerzenia utwórz właściwość „update_url” i przypisz jej tę wartość:
json { "update_url": "https://clients2.google.com/service/update2/crx" }Uruchom Chrome.
Otwórz chrome://extensions. Rozszerzenie powinno się wyświetlić na liście.
Aktualizowanie i odinstalowywanie
Przy każdym uruchomieniu przeglądarki Google Chrome skanuje wpisy metadanych w ustawieniach i rejestrze oraz wprowadza niezbędne zmiany w zainstalowanych rozszerzeniach zewnętrznych hostowanych w Chrome Web Store.
Aby zaktualizować lokalny plik CRX do nowej wersji, zaktualizuj plik, a potem zaktualizuj wersję w pliku JSON z ustawieniami.
Aby odinstalować rozszerzenie (na przykład, jeśli oprogramowanie zostało odinstalowane), usuń plik preferencji (na przykład aaabbbcccdddeeefff.json) lub metadane z rejestru.
Najczęstsze pytania
W tej sekcji znajdziesz odpowiedzi na najczęstsze pytania dotyczące rozszerzeń zewnętrznych.
Czy „wstępna instalacja” jest nadal obsługiwana przez Google Chrome?
Tak, ale tylko jako instalacja ze sklepu Chrome Web Store update_url, a nie z lokalnej ścieżki pliku CRX. Więcej informacji znajdziesz w artykule Zasady dotyczące aplikacji i rozszerzeń.
Jakie są typowe błędy podczas instalacji za pomocą pliku ustawień?
- Nie podano identyfikatora ani wersji zgodnych z tymi w pliku CRX.
- Plik JSON (np.
aaabbbcccdddeeefff.json) znajduje się w niewłaściwym miejscu lub podany identyfikator nie pasuje do identyfikatora rozszerzenia. - błąd składni w pliku JSON (zapomnienie o oddzielaniu wpisów przecinkami lub pozostawienie końcowego przecinka),
- punkty wejścia w pliku JSON wskazują niewłaściwą ścieżkę do pliku CRX (lub ścieżka jest określona, ale nie podano nazwy pliku);
- W ścieżce UNC nie zmienia się ukośnik lewy. Na przykład dyrektywa
"\\server\share\file"jest nieprawidłowa. Powinno być"\\\\server\\share\\extension". - Problemy z uprawnieniami do udziału w sieci.
Jakie są typowe błędy podczas instalacji za pomocą rejestru?
- Nie podano identyfikatora zgodnego z tym, który jest podany w Chrome Web Store.
- Klucz został utworzony w niewłaściwej lokalizacji w rejestrze.
- wpis rejestru wskazuje niewłaściwą ścieżkę do pliku CRX w Chrome Web Store;
- Problemy z uprawnieniami do udziału w sieci.
- Nie wszystkie wystąpienia Chrome są zamknięte. Po skonfigurowaniu rejestru spróbuj ponownie uruchomić komputer.
Co się stanie, jeśli użytkownik odinstaluje rozszerzenie?
Jeśli użytkownik odinstaluje rozszerzenie w interfejsie, nie będzie ono już instalowane ani aktualizowane przy każdym uruchomieniu. Inaczej mówiąc, zewnętrzne rozszerzenie jest na liście zablokowanych.
Jak mogę usunąć się z listy zablokowanych?
Jeśli użytkownik odinstaluje Twoje rozszerzenie, musisz uszanować jego decyzję. Jeśli jednak (deweloper) przypadkowo odinstalujesz rozszerzenie przy użyciu interfejsu, możesz usunąć tag listy zablokowanych. W tym celu zainstaluj rozszerzenie w zwykły sposób, a potem je odinstaluj.