Wszystkie rozszerzenia do Chrome muszą być dystrybuowane bezpośrednio z Chrome Web Store lub za pomocą opisane poniżej. Niezastosowanie się do jednej z tych metod dystrybucji powoduje narusza zasady dotyczące rozszerzeń do Chrome i może spowodować, że rozszerzenie lub oprogramowanie w celu oznaczenia go jako niechcianego oprogramowania.
Zazwyczaj użytkownicy instalują rozszerzenia ze sklepu Chrome Web Store, ale czasami warto które należy zainstalować w inny sposób. Oto 2 typowe przypadki:
- Rozszerzenie jest powiązane z innym oprogramowaniem i powinno ono zostać zainstalowane za każdym razem, gdy użytkownik zainstaluje to oprogramowanie.
- Administrator sieci chce zainstalować te same rozszerzenia w całej organizacji.
Rozszerzenie, które nie pochodzi z Chrome Web Store, jest nazywane rozszerzeniem zewnętrznym. Dla deweloperów, którzy chcą udostępniać rozszerzenie w ramach procesu instalacji na innych oprogramowania lub dla administratorów sieci, którzy chcą dystrybuować rozszerzenie w całej organizacji, Google Chrome obsługuje następujące metody instalacji rozszerzeń:
- Za pomocą pliku JSON ustawień (tylko w systemach Mac OS X i Linux)
- Za pomocą rejestru systemu Windows (tylko w systemie Windows)
Oba sposoby pozwalają na instalowanie rozszerzenia hostowanego w update_URL. W systemach Windows i Mac
update_URL musi wskazywać Chrome Web Store, w którym musi być hostowane rozszerzenie.
Plik ustawień w Linuksie może wskazywać Twój serwer, na którym przechowujesz rozszerzenie.
Plik JSON ustawień obsługuje też instalowanie rozszerzenia z pliku rozszerzenia .crx w
na komputerze z systemem Linux.
Zanim zaczniesz
Najpierw opublikuj rozszerzenie w Chrome Web Store lub spakuj plik .crx i upewnij się, że
, aby upewnić się, że instalacja przebiegnie pomyślnie.
Jeśli instalujesz rozszerzenie z adresu URL aktualizacji, upewnij się, że jest ono odpowiednio hostowane.
Zanim zmodyfikujesz plik ustawień lub rejestr, zwróć uwagę na te kwestie:
- Zamierzona lokalizacja pliku
.crxrozszerzenia lub adres URL aktualizacji, z którego pochodzi. obsłużony - Wersja rozszerzenia (z pliku manifestu lub strony chrome://extensions).
- identyfikator rozszerzenia (ze strony chrome://extensions po wczytaniu pakietu rozszerzenie)
W podanych niżej przykładach zakładamy, że wersja to 1.0, a identyfikator to aaaaaaaaaabbbbbbbbbbcccccccccc.
Za pomocą pliku ustawień
- Jeśli instalujesz system z pliku w systemie Linux, udostępnij plik rozszerzenia
.crxna komputerze, na którym chcesz zainstalować to rozszerzenie. (Skopiuj do katalogu lokalnego lub sieci na przykład\\server\share\extension.crxlub/home/share/extension.crx). Utwórz plik o podanej nazwie w jednym z folderów wymienionych poniżej:
aaaaaaaaaabbbbbbbbbbcccccccccc.json, gdzie nazwa pliku (bez rozszerzenia) odpowiada identyfikator rozszerzenia. Lokalizacja zależy od systemu operacyjnego.- Mac OS X:
W przypadku konkretnego użytkownika:
~USERNAME/Library/Application Support/Google/Chrome/External Extensions/Wszyscy użytkownicy:/Library/Application Support/Google/Chrome/External Extensions/Plik rozszerzenia zewnętrznego dla wszystkich użytkowników jest dostępny tylko do odczytu, jeśli każdy katalog w ścieżce należy do niego przez użytkownika
root, ma grupęadminlubwheeli nie jest dostępny do zapisu na całym świecie. Ścieżka musi nie mogą zawierać dowiązań symbolicznych. Te ograniczenia uniemożliwiają użytkownikowi bez uprawnień dla wszystkich użytkowników. Szczegółowe informacje znajdziesz w sekcji Rozwiązywanie problemów.- Linux:
/opt/google/chrome/extensions//usr/share/google-chrome/extensions/Uwaga: w razie potrzeby użyj
chmod, aby mieć pewność, żeaaaaaaaaaabbbbbbbbbbcccccccccc.jsonsą dostępne do odczytu na całym świecie.
Tylko Linux: jeśli instalujesz z pliku, określ lokalizację i wersję rozszerzenia, używając parametru pola o nazwie „external_crx” i „external_version” w utworzonym wyżej pliku.
- Przykład:
json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" }- Uwaga: musisz zmienić znaczenie każdego parametru
\` character in the location. For example,\server\share\extension.crxwould be"\\server\share\extension.crx"`. - Jeśli przeprowadzasz instalację z adresu URL aktualizacji, podaj URL aktualizacji rozszerzenia za pomocą nazwy pola „external_update_url”.
- Przykład instalacji z lokalnego pliku .crx (tylko Linux):
json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }- Przykład instalacji z Chrome Web Store (Mac i Linux):
json { "external_update_url": "https://clients2.google.com/service/update2/crx" }- Jeśli chcesz zainstalować rozszerzenia tylko w niektórych językach, możesz wymienić obsługiwane języki w polu o nazwie „supported_locale”. Ustawienia regionalne mogą określać język nadrzędny, taki jak „en”, w tym Rozszerzenie zostanie zainstalowane dla wszystkich języków angielskiego, takich jak „en-US”, „en-GB” itd. Jeśli wybrano inny język, który nie jest obsługiwany przez to rozszerzenie, rozszerzenia zostaną odinstalowane. Jeśli „supported_locales” brakuje listy, rozszerzenie będzie jest zainstalowana dla dowolnego języka.
- Przykład:
json { "external_update_url": "https://clients2.google.com/service/update2/crx", "supported_locales": [ "en", "fr", "de" ] }
Zapisz plik JSON.
Uruchom Google Chrome i otwórz chrome://extensions. powinno być widoczne na liście.
Rozwiązywanie problemów z uprawnieniami w systemie macOS
W Mac OS pliki rozszerzeń zewnętrznych wszystkich użytkowników są odczytywane tylko wtedy, gdy mają uprawnienia systemu plików nie zezwalaj użytkownikom bez uprawnień na jego zmianę. Jeśli nie widzisz rozszerzeń zewnętrznych zainstalowanych, gdy Uruchamiamy Chrome. Być może wystąpił problem z uprawnieniami w ustawieniach rozszerzeń zewnętrznych. . Aby sprawdzić, czy na tym polega problem, wykonaj te czynności:
- Uruchom program Konsola. Znajdziesz go w katalogu /Applications/Utilities/Console.
- Jeśli przy ikonie po lewej stronie w konsoli wyświetla się komunikat „Pokaż listę logów”, kliknij ją. Druga kolumna po lewej.
- Kliknij „Komunikaty w konsoli”. w panelu po lewej stronie.
- Wyszukaj ciąg Nie można odczytać rozszerzeń zewnętrznych. Jeśli wystąpi problem z odczytem
plików rozszerzeń zewnętrznych, pojawi się komunikat o błędzie. Poszukaj innego komunikatu o błędzie
bezpośrednio nad nią, co powinno wyjaśniać problem. Jeśli na przykład zobaczysz ten błąd:
„Ścieżka /Library/Application Support/Google/Chrome należy do niewłaściwej grupy”, musisz użyć
chgrplub okna Pobierz informacje w programie Finder, aby zmienić właściciela grupy katalogu na Grupa administratorów. - Po rozwiązaniu problemu uruchom ponownie Chrome. Sprawdź, czy rozszerzenie zewnętrzne jest zainstalowane. it może się zdarzyć, że jeden błąd uprawnień uniemożliwia Chrome wykrycie drugiego. Jeśli nie zostało zainstalowane rozszerzenie zewnętrzne, powtarzaj te kroki, aż nie pojawi się błąd Aplikacja konsoli.
Korzystanie z rejestru systemu Windows
- Znajdź lub utwórz w rejestrze następujący klucz:
- 32-bitowy Windows:
HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions - 64-bitowy Windows:
HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions
- 32-bitowy Windows:
- W kluczu Extensions utwórz nowy klucz (folder) o tej samej nazwie co identyfikator klucza
rozszerzenie (np.
aaaaaaaaaabbbbbbbbbbcccccccccc). W kluczu rozszerzenia utwórz właściwość „update_url” i ustaw jej wartość: "https://clients2.google.com/service/update2/crx" (wskazuje to plik CRX rozszerzenia w pliku Chrome Web Store):
{ "update_url": "https://clients2.google.com/service/update2/crx" }Uruchom przeglądarkę i otwórz chrome://extensions. powinno być widoczne na liście.
Aktualizowanie i odinstalowywanie
Google Chrome skanuje wpisy metadanych w preferencjach i rejestrze za każdym razem, gdy przeglądarka jest używana uruchamia się i wprowadza niezbędne zmiany w zainstalowanych rozszerzeniach zewnętrznych.
Aby zaktualizować rozszerzenie do nowej wersji, zaktualizuj plik, a następnie zaktualizuj wersję w preferencji lub rejestru.
Aby odinstalować rozszerzenie (np. jeśli zostało ono odinstalowane), usuń swoje preferencje (aaaaaaaaabbbbbbbbcccccccccc.json) lub metadane z rejestru.
Najczęstsze pytania
W tej sekcji znajdziesz odpowiedzi na najczęstsze pytania dotyczące rozszerzeń zewnętrznych.
Czy metodologia umożliwiająca dopuszczenie „wstępnej instalacji” będą nadal obsługiwane przez Google Chrome od wersji M33
Tak, ale tylko jako instalacja z Chrome Web Store update_URL, a nie z lokalnej ścieżki pliku.
Czy mogę podać adres URL jako ścieżkę do rozszerzenia zewnętrznego?
Tak, użyj pliku preferences JSON dla systemów Mac OS X i Linux. w rejestrze systemu Windows. rozszerzenie musi być hostowane w sposób opisany w artykule hosting. W pliku ustawień użyj funkcji „external_update_url” wskazuje plik manifestu aktualizacji z adresem URL . W rejestrze systemu Windows użyj parametru „update_url”. usłudze.
Jakie są typowe błędy podczas instalacji za pomocą pliku ustawień?
- Nie określono tego samego identyfikatora lub wersji co w dokumencie
.crx. - Plik .json (
aaaaaaaaaabbbbbbbbbbcccccccccc.json) znajduje się w nieprawidłowej lokalizacji lub ma niewłaściwy identyfikator nie pasuje do identyfikatora rozszerzenia. - Błąd składni w pliku JSON (zapomnienie oddzielenie wpisów przecinkiem lub pozostawienie przecinka na końcu) w dowolnym miejscu)
- Wejście pliku JSON wskazuje nieprawidłową ścieżkę do elementu
.crx(lub podana ścieżka, ale bez nazwy pliku) - Ukośnik lewy w ścieżce UNC bez zmiany znaczenia (np.
"\\server\share\file"jest błędny; to powinien być"\\\\server\\share\\extension"). - Problemy z uprawnieniami w udziale sieciowym
Jakie są typowe błędy podczas instalacji za pomocą rejestru?
- Nie określono identyfikatora lub wersji, które są wymienione w Chrome Web Store.
- Klucz został utworzony w niewłaściwej lokalizacji w rejestrze
- Wpis rejestru wskazuje niewłaściwą ścieżkę do pliku
.crxw Chrome Web Store - Problemy z uprawnieniami w udziale sieciowym
Jak w kroku zaktualizować natywne pliki binarne i rozszerzenie?
Wcześniej, gdy obsługiwane były rozszerzenia spoza sklepu, można było używać natywnych plików binarnych rozszerzenie zostało zaktualizowane na etapie blokowania. Jednak rozszerzenia hostowane w Chrome Web Store są aktualizowane przy użyciu mechanizmu aktualizacji Chrome, nad którym programiści nie mają kontroli. Programiści rozszerzeń powinni zachowaj ostrożność podczas aktualizowania rozszerzeń zależnych od natywnego pliku binarnego (np. starszego typu rozszerzeń za pomocą interfejsu NPAPI).
Co się stanie, jeśli użytkownik odinstaluje rozszerzenie?
Jeśli użytkownik odinstaluje rozszerzenie za pomocą interfejsu użytkownika, nie zostanie ono zainstalowane ani zaktualizowane każdego startupu. Oznacza to, że rozszerzenie zewnętrzne jest na liście zablokowanych.
Jak usunąć treści z listy zablokowanych?
Gdy użytkownik odinstaluje rozszerzenie, należy uszanować tę decyzję. Jeśli jednak deweloper), przypadkowo odinstalował rozszerzenie przy użyciu interfejsu użytkownika, możesz usunąć tag listy zablokowanych instalując rozszerzenie w zwykły sposób za pomocą interfejsu użytkownika, a następnie je odinstaluj.