Актуализированный репринт авторской статьи с форума Ru-Board • [веб-архив] Ошибки установки и решение некоторых проблем при установке расширенийНиже рассмотрены отдельные типичные проблемы, которые могут возникать при установке или загрузке аддонов из Chrome Web Store (далее – CWS), со сторонних сайтов и/или из локальных файлов/папок. Одна из основных причин – несоответствие расширения и версии браузера. Причём, даже самые последние версии не всегда гарантируют от ошибок установки. В этой статье:
Общие замечания по решению проблем при установке расширенийВо многих случаях для решения проблемы придётся воспользоваться установкой в режиме разработчика (способ № 3, далее по тексту – РР), включается на странице расширений (chrome://extensions/) – галочка "Режим разработчика" в самом верху страницы:
Внимание! Примечание по "Минусам": 0. Сообщение "Пакет недействителен…"Известны следующие варианты этой ошибки: "CRX_MAGIC_NUMBER_INVALID"Самая старая и известная проблема, эта "пугающая" надпись выдаётся при попытке установки:
Связана с несоответствием формата упакованного расширения стандартам хром-браузера. "CRX_VERSION_NUMBER_INVALID"Проблема достаточно новая, "нарисовалась" в версиях браузеров до 63 и только1 при установке не из CWS. Это сообщение выдаётся при попытке установки и связано с изменением формата CRX-файлов (с версии 2 на 3). Результат: браузер "не принимает" установочный пакет с новой версией формата, установка не выполняется. Такая ситуация возникает, если CRX-файл был упакован автором аддона в версии браузера 64+ (пояснение). С версии 73+ при установке не из CWS есть проблема обратной совместимости – НЕ принимаются2 CRX версии 2. При этом попытка установки таких файлов может приводить к полному закрытию браузера.
Решение 1: во всех случаях самое простое – ручная установка в РР. Решение 2: только для второго случая (браузер версии до 63) и если аддон не из CWS: можно связаться с автором и попросить перепаковать CRX-файл в версии браузера с ядром до 62 (включительно). При этом аддон можно установить в любых версиях браузеров до 73+ (совместимых с CRX версии 2). Решение 3: только для третьего случая (браузер версии 73+) и если аддон не из CWS: можно связаться с автором и попросить перепаковать CRX-файл в версии браузера с ядром 64+ (CRX версии 3). При этом аддон можно установить в любых версиях браузеров от 63 и новее. 1. Требуется версия браузера не ниже…При установке об этом сообщается прямым текстом – например, что-то типа "бла-бла ...версия 31". Возможны следующие варианты: Выставлена завышенная версия браузераРеально же аддон может работать и на более старых версиях. Решение: скачать/распаковать crx-файл расширения, вручную исправить эту строку и установить аддон в РР. Ограничение выставлено правильноРасширение использует функции, не поддерживаемые в старых браузерах. Решение: можно попробовать установить аналогично и убедиться в работоспособности нужных функций. 2. Ошибка версии файла манифестаПри установке из CWS будет выдано соответствующее сообщение “Invalid manifest”, установка не произойдёт. Связано со значением1 строки "manifest_version" в файле manifest.json (см. справку).
Решение: скачать/распаковать crx-файл расширения, вручную исправить эту строку и установить аддон в РР. Костыль: можно использовать запуск браузера с ключом --allow-legacy-extension-manifests. Предупреждение: в любом случае – не факт, что "старое" расширение после этих действий будет нормально работать, т.к. в его коде могут быть и другие "проблемы" (напр., JS-скрипты внутри HTML-файла, "устаревшие" операторы API и пр.). 3. Расширение установилось, но имеет предупрежденияПосле установки любым способом у аддона "висят" предупреждение (на странице chrome://extensions/), которые начинаются строкой: "При установке расширения возникли предупреждения:" Возможны следующие варианты: Unrecognized manifest key '...'Пример сообщения: Unrecognized manifest key 'short_name'. В общем случае связано с некорректными параметрами в файле manifest.json. Часто характерно для расширений, портированных с других браузеров (в частности, поле "developer_name" и др.). На работоспособность не влияет, но – неприятно. Поэтому устраняем так: Решение 1: скачать/распаковать crx-файл расширения, вручную удалить проблемную строку и установить аддон в РР. Решение 2: найти папку расширения в своём профиле и вручную удалить проблемную строку в файле manifest.json. После внесения исправлений следует перезагрузить расширение, выключив/включив его, либо нажав ссылку "Обновить", если оно устанавливалось вручную из локальной папки. В редких случаях может потребоваться перезагрузка браузера. Permission ... is unknown or URL pattern is malformed.Пример сообщения: Permission 'fileSystem.directory' is unknown or URL pattern is malformed. Связано с параметрами ключа "permissions" в файле manifest.json ("правильные" значения см. здесь). Означает, что ваша версия браузера "не понимает" одно (или несколько) заданных значений. Решение: если в манифесте есть ошибка синтаксиса, действуем по аналогии с предыдущим случаем – устраняем путём исправления на корректное значение и перезапускаем расширение. Если же ошибок синтаксиса нет, то в общем случае расширение в целом либо часть его функций на вашей версии браузера работать не будет. 4. Сообщение "Недопустимый пакет..."Эта ошибка выглядит примерно так: Cannot load extension with file or directory name _.И далее пояснение "Filenames starting with "_" are reserved for use by the system." Возникает при попытке установки расширения любым способом. Связано с наличием в аддоне папок/файлов с именами, начинающимися с символа подчёркивания. Основная причина: за исключением папки _locales браузеры версий ниже 31 не поддерживают такие имена. Известна следующая причина ошибки: Расширение содержит папку _metadataПроблема, искусственно созданная Google для пользователей "старых" версий браузера и не‑гуглохромов. Направлена на "выдавливание" старых версий и не‑гугло‑хром‑браузеров путём отказа от их поддержки. Появилась в конце мая 2014 года, характерна для новых версий аддонов, скачиваемых из CWS. Исправлять её "корпорация добра", вероятнее всего, не будет, о чём явно сказано здесь (см. также тут). Решение: предложил камрад KloneBADGuY, подробнее можно прочитать здесь. 5. Ошибка загрузки расширения из CWSИзвестны следующие варианты этой ошибки: Сообщение об ошибке, генерируемое CWS (типа "файл не найден" и т.п.)Возникает при попытке установить расширение либо при скачивании его crx/zip-файла. В общем случае причин может быть много, вплоть до некорректной работы сети и т.д. Решение: в простейшем случае достаточно перегрузить страницу и повторить процесс установки/загрузки. Если после этого "всё получилось", значит, это был "временный глюк" и причин для волнений нет.. =) Установка/загрузка из CWS устойчиво не проходитПодобные ситуации стали наблюдаться с начала июня 2014 года (читать отсюда и далее). Связаны с "закручиванием гаек" на гуглозине и сменой механизма отдачи файлов при проверке версии браузера. Характерны для новых1 версий аддонов (обновлённых после 01.06.20142), скачиваемых из CWS. Для таких "обновлённых" расширений не работает часть средств загрузки CRX-файлов. Также для них неработоспособны отдельные инструменты просмотра содержимого CRX-файлов (их старые версии).
Решение 1: закачка CRX/ZIP-файлов расширений с помощью аддона Get CRX RU (или аналогичных расширений) и их последующая ручная установка. Решение 2: использование "промежуточного" браузера для создания CRX-файлов [пост1], [пост2]. Решение 3: использование прямой загрузки CRX-файлов (метод + упрощённо + букмарклет + качалка‑воровайка). Решение 4: использование архива расширений для прямой загрузки CRX-файлов. Дополнительно: для уменьшения проблем и отключения раздражающих надписей – также помним об этом… :·) Сообщение "Download interrupted" или "Файлы отсутствуют"Относится к расширениям, устанавливаемым из CWS, на старых версиях браузеров (до 63). Ошибка стала устойчиво выдаваться с начала 2021 года, независимо от того, насколько старое расширение вы пытаетесь установить и поддерживается ли оно вашей версией браузера. В частности, проблема имеется для всех достаточно старых расширений, которые до этого спокойно устанавливались из CWS. При этом на странице таких расширений по-прежнему присутствует отметка "Совместимо с вашим устройством" и доступна сама кнопка установки. Ошибка появляется в момент начала загрузки установочного файла после нажатия на эту кнопку и при подтверждении установки. Это связано с удалением в гуглозине поддержки формата CRX v.2 (и соответствующих CRX‑файлов расширений). Принудительно скачать файлы в этом формате с помощью расширений‑загрузчиков теперь также невозможно (при попытке загрузки выдаётся аналогичная ошибка об отсутствии файла на сервере). Решение 1: скачать файл в формате CRX v.3 любым из доступных способов, распаковать и установить в РР. Решение 2: попытаться найти в архивах необходимый оригинальный файл в формате CRX v.2 и установить как обычно (перетаскиванием на страницу chrome://extensions). Решение 3: самое простое решение – обновить браузер до версии 63+, поддерживающей новый формат crx‑файлов. 6. Сообщение "Ваш браузер/система больше не поддерживается…"При этом расширение кнопка установки расширения недоступна (меняется на "Доступно в Chrome"). Ситуации наблюдаются с мая 2014 года (на не‑гугло‑браузерах, на версиях старше 32, и на Windows XP). Направлены на "выдавливание" старых версий и не‑гугло‑хром‑браузеров путём отказа от их поддержки. Решение: подмена строки User-Agent'а браузера, подробно см. здесь. Подходящие "правильные" строки UA можно посмотреть тут. 7. Сообщение "Это расширение могло быть повреждено"Относится к расширениям, установленным из CWS, на версиях браузера 31+ (?). Ситуация, в частности, возникает при ручной правке отдельных файлов расширения (после правки/перезапуска). При этом расширение автоматически отключается и появляется кнопка (ссылка) "Восстановить". При нажатии на эту кнопку (ссылку) проблемное расширение переустанавливается из CWS. Это связано с проверкой браузером исходного хэша расширения (хранится в папке _metadata). Проверка повышает безопасность использования аддонов и отслеживает их неконтролируемые изменения. Решение: предложил камрад Tilks:
Дополнительные ссылки для самоизученияКроме описанных выше проблем, вы можете столкнуться и с другими. Если вы хотите научиться решать их самостоятельно, рекомендуем ознакомиться со следующими материалами: Решение других проблем установки расширений
Официальная Справка |
Всего комментариев: 1 |
0
|