Актуализированный репринт авторской статьи с форума Ru-Board • [веб-архив] Дата публикации: 13.06.2014. Последнее изменение на форуме: 15.06.2019 ★ Материал репринта обновлён, дополнен и исправлен по состоянию на 08.09.2025.
Ниже рассмотрены отдельные типичные проблемы, которые могут возникать при установке или загрузке аддонов из Chrome Web Store (далее – CWS), со сторонних сайтов и/или из локальных файлов/папок.
В этой статье:
Одна из основных причин – несоответствие расширения и версии браузера (в самом широком смысле, причин достаточно много). Причём, даже самые свежие версии браузеров и/или расширений не всегда гарантированы от ошибок установки.
Кроме того, в современных браузерах достаточно часто проблемы могут возникать из‑за текущих изменений политики безопасности, устанавливаемых разработчиками браузеров и ужесточающих ограничения на исполняемый код аддонов. Также часть "нестыковок" может быть связана с текущими изменениями функций API расширений в конкретных версиях браузеров (вплоть до полного запрета отдельных API).
Во многих случаях для решения проблемы придётся воспользоваться установкой в режиме разработчика (способ № 3, далее по тексту – РР), включается на странице расширений (chrome://extensions/) – галочка "Режим разработчика" в самом верху страницы:
Основной "минус" бо́льшей части "шаманских" действий – установленное расширение после этого не будет обновляться* автоматически. Причины – потеря/смена ID либо (с июня 2014) некорректная обработка CWS запросов от "устаревших" и/или "чужих" (не‑гугло‑хром) браузеров.
* С другой стороны, в этом есть и большой плюс – расширение не будет автоматически удалено или отключено по прихоти "корпорации бобра", по тем же самым причинам… =)
Второй "минус" – отсутствие переносимости, распакованное расширение получает жёсткую привязку по пути распаковки. Если в дальнейшем вы удалите, переименуете или переместите папку, расширение перестанет* работать в браузере.
* Если потом папку вернуть на место, под тем же именем и по тому же пути, после перезагрузки браузера оно снова автоматически подключится и будет работать, настройки аддона в вашем профиле при этом сохранятся.
Кроме того, распакованные расширение НЕ синхронизируются между вашими устройствами, при необходимости работы с таким аддоном его придётся устанавливать и настраивать "с нуля" во всех ваших профилях на всех устройствах.
Для решения части проблем требуется не только распаковка оригинальных CRX‑файлов, но и ручная правка отдельных файлов расширений (в частности, файла манифеста, если ошибка установки связана с ним). При этом необходимо помнить, что в большинстве случаев исправленные файлы всегда должны сохраняться в формате UTF–8 (особенно это касается файла манифеста и файлов, содержащих символы, отличные от латиницы). Если это условие не выполнено, при попытке установки снова возникнут ошибки и исправленное расширение работать не будет!
После внесения изменений в код аддона его можно установить либо в режиме разработчика (как сказано выше), либо всю папку с исправленным расширением упаковать в новый CRX‑файл, который затем можно установить в вашем браузере методом перетаскивания на страницу расширений (chrome://extensions/, способ № 2).
Известны следующие варианты этой ошибки:
[Копия скриншота ошибки]
Самая старая и известная проблема, эта "пугающая" надпись выдаётся при попытке установки:
Связана с несоответствием формата упакованного расширения стандартам хром‑браузера.
Общее решение: использовать способы установки расширений НЕ из CWS. Выбор конкретного метода установки зависит от вашего браузера и его версии.
Проблема достаточно новая, "нарисовалась" в версиях браузеров до 63 и только1 при установке не из CWS.
Это сообщение выдаётся при попытке установки и связано с изменением формата CRX‑файлов (с версии 2 на 3).
Результат: браузер "не принимает" установочный пакет с новой версией формата, установка не выполняется.
Такая ситуация возникает, если CRX‑файл был упакован автором аддона в версии браузера 64+ (пояснение).
С версии 73+ при установке не из CWS есть проблема обратной совместимости – НЕ принимаются2 CRX версии 2. При этом попытка установки таких файлов может приводить к полному закрытию браузера.
* Начиная с 2022 года CWS отдаёт файлы только в формате CRXv3 независимо от версии клиентского браузера.
Решение 1: во всех случаях самое простое – ручная установка в РР. Минусы: расширение не будет обновляться автоматически.
Решение 2: только для второго случая (браузер версии до 63) и если аддон не из CWS: можно связаться с автором и попросить* перепаковать CRX‑файл в версии браузера с ядром до 62 (включительно). При этом аддон можно установить в любых версиях браузеров до 73+ (совместимых с CRX версии 2).
* Вы можете сделать это и самостоятельно, используя любой из стандартных методов упаковки.
Решение 3: только для третьего случая (браузер версии 73+) и если аддон не из CWS: можно связаться с автором и попросить* перепаковать CRX‑файл в версии браузера с ядром 64+ (CRX версии 3). При этом аддон можно установить в любых версиях браузеров от 63 и новее.
Проблема достаточно известная, связана с встроенными ограничениями браузера, действующими при установке расширений не из CWS.
Это сообщение выдаётся при попытке установки "немагазинного" аддона, если не используется режим разработчика и расширение в формате CRX устанавливается из любых сторонних источников (в том числе – из локальных файлов).
Результат: браузер "не принимает" установочный пакет, не имеющий "подписи CWS".
Такая же ситуация также возникает, если CRX‑файл имеет подпись, но загружается, к примеру, из какого‑то архива.
Кроме того, эта ошибка возможна, если "оригинальный" установщик повреждён или изменён (сбой при загрузке, ручная правка "умельцами" и т.п.).
Решение 1: как и во всех других случаях, самое простое – ручная установка в РР. Минусы: расширение не будет обновляться* автоматически.
* В данном случае это не особо важно, большинство сторонних аддонов так или иначе приходится обновлять вручную.
Решение 2: использование настроек групповой политики, разрешающих установку сторонних расширений. Можно использовать политики установки собственных допустимых источников (авторских сайтов и др.) или ключи принудительной установки расширений из "белого списка" (список ID требуемых сторонних аддонов).
При установке об этом сообщается прямым текстом – например, что-то типа "бла-бла ...версия 31". Связано со значением строки "minimum_chrome_version" в файле manifest.json.
Возможны следующие варианты:
Реально же аддон может работать и на более старых версиях.
Решение: скачать/распаковать CRX‑файл расширения, вручную исправить эту строку и установить аддон в РР. Минусы: расширение не будет обновляться автоматически.
Расширение использует функции, не поддерживаемые в старых браузерах.
Решение: можно попробовать установить аналогично и убедиться в работоспособности нужных функций. Минусы: часть функций может не работать или работать неправильно, расширение не будет обновляться автоматически.
При установке из CWS будет выдано соответствующее сообщение “Invalid manifest”, установка не произойдёт. При ручной установке в этом случае у расширения будет "висеть" предупреждение (на странице chrome://extensions/).
Связано со значением1 строки "manifest_version" в файле manifest.json (см. справку).
Решение: скачать/распаковать CRX‑файл расширения, вручную исправить эту строку и установить аддон в РР. Минусы: расширение не будет обновляться автоматически, на разных версиях браузеров может совсем не работать. Расширения с манифестом 2: не будут работать в браузерах версий CR139+ (ручная замена на "3" может "не прокатить"). Расширения с манифестом 3: не работают в браузерах версий старше CR88 (ручная замена на "2" может "не прокатить").
Костыль 1: можно использовать запуск браузера с ключом --allow-legacy-extension-manifests. Минусы: если после установки "старого аддона" запускать браузер без этого ключа, аддон "слетит" (пример).
Костыль 2: для разрешения работы с манифестом версии 2 в браузерах CR110+ можно использовать запуск с ключом: --disable-features=ExtensionManifestV2Unsupported,ExtensionManifestV2Disabled. Также можно попробовать ВЫКЛючить соответствующие* ограничивающие флаги на странице chrome://flags/ (искать по вхождению "manifest‑v2") и/или, наоборот, ВКЛючить разрешающие (искать по "allow‑mv2" или как‑то так). Минусы: если после установки "старого аддона" запускать браузер без этого ключа (или флагов), аддон "слетит".
* Список конкретных флагов не приводится в связи с постоянной сменой и добавлением/удалением таких параметров в разных версиях (и даже билдах) современных браузеров. Кроме того, наличие и обработка "разрешительных" флагов также зависит и от конкретного разработчика (не относится к Google Chrome, там "всё плохо" и отлом "старого" манифеста идёт полным ходом).
Некоторые флаги, работающие в версиях CR137+ можно найти здесь (актуально на июль 2025 года). Подобная "подкрутка" для версий CR140+ рассмотрена здесь (актуально на август 2025 года), а также вот здесь (или на примере расширения Imagus).
Костыль 3: для разрешения работы с манифестом версии 2 можно использовать групповую политику: ExtensionManifestV2Availability, установив значение равным 2 (актуально на июль 2025 года для CR110+). Минусы: как только эту политику "отломают" (а её обязательно* отломают в CR139+)), аддон "слетит".
* …но не во всех браузерах, в частности – в MS Edge она введена без ограничения "срока годности".
Предупреждение: в любом случае – не факт, что "старое" расширение после этих действий будет нормально работать, т.к. в его коде могут быть и другие "проблемы" (напр., JS‑скрипты внутри HTML‑файла, "устаревшие" API и пр.).
После установки любым способом у аддона "висят" предупреждение (на странице chrome://extensions/), которые начинаются строкой: "При установке расширения возникли предупреждения:"
Пример сообщения: Unrecognized manifest key 'short_name'.
В общем случае связано с некорректными параметрами в файле manifest.json. Часто характерно для расширений, портированных с других браузеров (в частности, поле "developer_name" и др.). На работоспособность не влияет, но – неприятно. Поэтому устраняем так:
Решение 1: скачать/распаковать CRX‑файл расширения, вручную удалить проблемную строку и установить аддон в РР. Минусы: расширение не будет обновляться автоматически, на старых версиях может совсем не работать.
Решение 2: найти папку расширения в своём профиле и вручную удалить проблемную строку в файле manifest.json. После внесения исправлений следует перезагрузить расширение, выключив/включив его, либо нажав ссылку "Обновить", если оно устанавливалось вручную из локальной папки. В редких случаях может потребоваться перезагрузка браузера. Минусы: после обновления аддона, возможно, придётся повторить "выгрызание".
Пример сообщения: Permission 'fileSystem.directory' is unknown or URL pattern is malformed.
Связано с параметрами ключа "permissions" в файле manifest.json ("правильные" значения см. здесь). Означает, что ваша версия браузера "не понимает" одно (или несколько) заданных значений.
Решение: если в манифесте есть ошибка синтаксиса, действуем по аналогии с предыдущим случаем – устраняем путём исправления на корректное значение и перезапускаем расширение. Если же ошибок синтаксиса нет, то в общем случае расширение в целом либо часть его функций на вашей версии браузера работать не будет.
Эта ошибка выглядит примерно так:
И далее пояснение "Filenames starting with "_" are reserved for use by the system."
Возникает при попытке установки расширения любым способом. Связано с наличием в аддоне папок/файлов с именами, начинающимися с символа подчёркивания.
Основная причина: за исключением папки _locales браузеры версий ниже 31 не поддерживают такие имена.
Известна следующая причина ошибки:
Проблема, искусственно созданная Google для пользователей "старых" версий браузера и не‑гуглохромов. Направлена на "выдавливание" старых версий и не‑гугло‑хром‑браузеров путём отказа от их поддержки.
Появилась в конце мая 2014 года, характерна для новых версий аддонов, скачиваемых из CWS. Исправлять её "корпорация добра", вероятнее всего, не будет, о чём явно сказано здесь (см. также тут).
Решение: предложил камрад KloneBADGuY, подробнее можно прочитать здесь. Порядок действий: скачать расширение (способы указаны здесь), распаковать CRX‑файл и удалить папку _metadata, установить расширение в РР. Минусы: расширение не будет обновляться автоматически.
Возникает при попытке установить расширение либо при скачивании его crx/zip-файла. В общем случае причин может быть много, вплоть до некорректной работы сети и т.д.
Решение: в простейшем случае достаточно перегрузить страницу и повторить процесс установки/загрузки. Если после этого "всё получилось", значит, это был "временный глюк" и причин для волнений нет.. =)
Подобные ситуации стали наблюдаться с начала июня 2014 года (читать отсюда и далее).
Связаны с "закручиванием гаек" на гуглозине и сменой механизма отдачи файлов при проверке версии браузера. Характерны для новых1 версий аддонов (обновлённых после 01.06.20142), скачиваемых из CWS.
Для таких "обновлённых" расширений не работает часть средств загрузки CRX-файлов. Также для них неработоспособны отдельные инструменты просмотра содержимого CRX‑файлов (их старые версии).
Решение 1: закачка CRX/ZIP-файлов расширений с помощью аддона Get CRX RU (или аналогичных расширений) и их последующая ручная установка. Порядок действий: установить подходящий аддон, скачать с его помощью CRX/ZIP-файл нужного расширения, распаковать и установить вручную в РР. Минусы: расширение не будет обновляться автоматически (теряется идентификатор гуглозина).
Решение 2: использование "промежуточного" браузера для создания CRX-файлов [пост1], [пост2]. Порядок действий: установить свежую портабельную версию Chrome/Chromium, установить с её помощью нужное расширение, запаковать расширение, получив на выходе CRX-файл, установить в рабочем браузере любым способом из полученного CRX-файла. Минусы: расширение не будет обновляться автоматически (теряется идентификатор гуглозина).
Решение 3: использование прямой загрузки CRX-файлов (метод + упрощённо + букмарклет + качалка‑воровайка). Порядок действий: внимательно прочитать обсуждение отсюда и далее, в любом браузере и любым из предложенных в теме способов скачать оригинальный CRX‑файл, после чего установить расширение любым способом из полученного CRX‑файла. Минусы: зависят только от способа установки расширения.
Решение 4: использование архива расширений для прямой загрузки CRX-файлов. Порядок действий: перейти в архив расширений, найти нужное расширение по имени или по ID и скачать нужную вам версию в виде crx‑файла. После этого просто установить расширение любым способом из полученного CRX‑файла. Минусы: зависят только от способа установки расширения.
Дополнительно: для уменьшения проблем и отключения раздражающих надписей – также помним об этом… :·)
Относится к расширениям, устанавливаемым из CWS, на старых версиях браузеров (до 63). На более новых браузерах проблема полностью отсутствует, расширения устанавливаются нормально.
Ошибка стала устойчиво выдаваться с начала 2021 года, независимо от того, насколько старое расширение вы пытаетесь установить и поддерживается ли оно вашей версией браузера. В частности, проблема имеется для всех достаточно старых расширений, которые до этого спокойно устанавливались из CWS.
При этом на странице таких расширений по-прежнему присутствует отметка "Совместимо с вашим устройством" и доступна сама кнопка установки. Ошибка появляется в момент начала загрузки установочного файла после нажатия на эту кнопку и при подтверждении установки.
Это связано с удалением в гуглозине поддержки формата CRX v.2 (и соответствующих CRX‑файлов расширений). Принудительно скачать файлы в этом формате с помощью расширений‑загрузчиков теперь также невозможно (при попытке загрузки выдаётся аналогичная ошибка об отсутствии файла на сервере).
Решение 1: скачать файл в формате CRX v.3 любым из доступных способов, распаковать и установить в РР. Минусы: расширение не будет обновляться автоматически (теряется идентификатор гуглозина).
Решение 2: попытаться найти в архивах необходимый оригинальный файл в формате CRX v.2 и установить как обычно (перетаскиванием на страницу chrome://extensions). Минусы: зависят только от способа установки расширения. …и, конечно же, от того, сможете ли вы вообще найти нужную копию в формате CRX v.2…
Решение 3: самое простое решение – обновить браузер до версии 63+, поддерживающей новый формат crx‑файлов. Минусы: зависят от вашей системы и решаемых задач, новое – не всегда значит лучшее…
При этом расширение кнопка установки расширения недоступна (меняется на "Доступно в Chrome").
Ситуации наблюдаются с мая 2014 года (на не‑гугло‑браузерах, на версиях старше 32, и на Windows XP). Направлены на "выдавливание" старых версий и не‑гугло‑хром‑браузеров путём отказа от их поддержки. Связаны с изменение политики Google и с "закручиванием гаек" на гуглозине.
Решение: подмена строки User-Agent'а браузера, подробно см. здесь. Подходящие "правильные" строки UA можно посмотреть тут.
Относится к расширениям, установленным из CWS, на версиях браузера 31+ (?).
Ситуация, в частности, возникает при ручной правке отдельных файлов расширения (после правки/перезапуска). При этом расширение автоматически отключается и появляется кнопка (ссылка) "Восстановить". При нажатии на эту кнопку (ссылку) проблемное расширение переустанавливается из CWS.
Это связано с проверкой браузером исходного хэша расширения (хранится в папке _metadata). Проверка повышает безопасность использования аддонов и отслеживает их неконтролируемые изменения.
Решение: предложил камрад Tilks:
После правки надо удалить папку _metadata, и вместо её создать пустой файл _metadata ... Можно и по другому как нибудь, например, запретить запись в эту папку правкой прав, главное не разрешать создавать файл computed_hashes.json
Кроме описанных выше проблем, вы можете столкнуться и с другими. Если вы хотите научиться решать их самостоятельно, рекомендуем ознакомиться со следующими материалами:
* Метод срабатывает не на всех версиях/браузерах!
