Перейти к содержимому

База знаний

Расширение не загружено

Уведомление приходит при запуске профиля и называет расширение и профиль. Профиль открыт, а расширения в нём нет, и причин у этого две: старый стандарт или испорченный файл описания.

Профиль открыт без расширения

Отказ касается только расширения. Окно профиля поднимается как обычно, с теми расширениями, которые прошли проверку, и работа не останавливается.

Уведомление привязано к паре «расширение и причина»: пока вы не прочитали прежнее, повторный запуск обновляет его, а не добавляет второе.

Не больше трёх за запуск

Если отказ получили несколько расширений, программа называет первые три. Остальные видны на экране расширений.

Старый стандарт

В описании расширения стоит номер стандарта. ARMANOS Browser запускает только третий, а расширение на втором стандарте получает отказ со словами «по старому стандарту (Manifest V2)».

Ищите у автора версию на третьем стандарте: переделать старое расширение на месте нельзя.

Испорченный файл описания

Файл описания обязан читаться как JSON. Лишняя запятая, обрезанный при копировании файл или кодировка не в UTF-8 дают отказ со словами «испорчен manifest.json».

Папки нет вовсе

Расширение без файла описания в своей папке пропускается без уведомления, а на экране расширений у него стоит «Файлы не найдены». Так бывает, когда папку убрали или переименовали руками.

Имя папки ограничено

Имя папки расширения это латинские буквы, цифры, точка, дефис и подчёркивание, до 64 знаков. Папка с другим именем не считается расширением, и путь за пределы папки расширений не принимается.

Экран расширений: строка над списком просит класть распакованные файлы в папку с именем точно как на карточке, и это имя стоит на самой карточке.
Имя, которое обязана носить папка, напечатано на самой карточке, под именем расширения.

Как собрать улики

Откройте папку расширений кнопкой на экране расширений, найдите папку с именем из уведомления и откройте в ней manifest.json. Номер стандарта стоит в первых строках.

Напишите через «Помощь» → «Написать в поддержку» и назовите имя расширения из уведомления: отчёт, который едет с письмом, несёт последние уведомления программы.

Чего эта статья не разбирает

  • Установку расширения из каталога. Об этом статья про то, как положить расширение на место.
  • Встроенный движок, где расширение грузится, но своей кнопки и окна у него нет. Об этом сказано на странице расширений.
  • Расширения из чужих магазинов. Программа читает только папки в своей папке расширений.

Где это решается

Каждое утверждение выше это одно место в коде и один стенд.

Старый стандарт и испорченный файл описания дают два разных отказа
apps/desktop/src/main/main.js
Путь расширения не выходит за пределы папки расширений
apps/desktop/test/extension-paths.js
Расширение из каталога ставится и проходит проверку
apps/desktop/test/catalog-installable.js
Встроенный движок честно называет, чего расширение на нём не может
apps/desktop/test/extension-limits-honest.js

Вопросы

Можно ли включить расширение на старом стандарте?
Нет. Движок его не запускает, и переключателя для этого нет. Нужна версия на третьем стандарте.
Загрузится ли оно после исправления?
Да, при следующем запуске профиля. Перезапускать программу не нужно.
Почему отказ не показали при установке?
Карточки каталога проверяются скачиванием и распаковкой, и старого стандарта среди них нет. Отказ при запуске обычно означает папку, положенную или изменённую руками.

Так и не вышло

Поддержка отвечает причиной, а не списком советов.