Установка

Из магазинов расширений

Scratch Addons доступно в этих магазинах.

Веб-магазин Chrome Firefox Add-ons

Магазин Установить Поддерживаемые браузеры Системные требования
Веб-магазин Chrome Установить для Веб-магазина Chrome Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
Chromium 96+
Windows 7+
OS X / MacOS 10.11+
Дополнения для Firefox Скачать для Дополнений для Firefox Mozilla Firefox 109+ Windows 7+
OS X / MacOS 10.12+
Дополнения Microsoft Edge Скачать для Дополнений Microsoft Edge Microsoft Edge 96+ Windows 7+
OS X / MacOS 10.11+

Из исходного кода

В отличии от магазинных выпусков, установка с помощью исходного кода требует браузера, основанного на Chromium 121+ или Firefox 121+.

Клонирование репозитории

Это рекомендуемый способ установить Scratch Addons для целей разработки, предполагая у Вас установлен Git.

Если Вы планируете жертвовать, то сначала создайте вилку репозитория на GitHub и потом клонируйте вилку, заменяя <username> Вашим пользовательским именем Github.

$ git clone https://github.com/<username>/ScratchAddons.git

Чтобы обновить Scratch Addons, сначала сделайте cd в папку Scratch Addons, а затем запустите следующие команды.

$ git fetch
$ git pull

Не забудьте также обновить Scratch Addons из браузера.

О релизах в GitHub

Страница релизов включает в себя код для Всех выпущенных версий Scratch Addons, а также зеркала магазинных сборок.

Скачивание Zip-архива

Этот метод не рекомендуем для разработки, за исключением случаев, в которых Git не может быть скачан на системе, ведь всё надо будет вручную повторять, каждый раз когда Вы обновляете Scratch Addons.

Если у Вас не имеется Git, то используйте этот метод

  1. Зайдите в репозиторию и найдите кнопку для скачивания кода.

  2. Нажмите её и выберите «Download ZIP».

  3. Разархивируйте архив в папку.

Скачивание на Google Chrome или Microsoft Edge

Для загрузки расширения в Google Chrome и в большинство браузеров, основанных на Chromium, как Microsoft Edge, Opera, Brave или Vivaldi:

  1. Перейдите по chrome://extensions

  2. Включите “Режим разработчика” в верхнем правом углу.

  3. Щёлкните “Загрузить распакованное” и выберите папку ScratchAddons.

Для обновления расширения при тестировании, щёлкните иконку перезагрузки на карточке расширения.

Предупреждения “Нераспознанный ключ манифеста” можно безопасно игнорировать, ведь они требуются Firefox.

Установка на Mozilla Firefox

Для загрузки расширения в Mozilla Firefox:

Расширения, загруженные в Firefox этим способом недолговременны и должны быть перезагружены каждый раз браузер перезапущен. Из-за этого Chrome более рекомендован для разработки, но ожидается, что всё будет работать корректно на Firefox.
  1. Напечатайте about:debugging в адресную строку.

  2. Нажмите на “Этот Firefox” на боковой панели

  3. Щёлкните “Загрузить временное дополнение…”

  4. Выберите файл manifest.json в папке ScratchAddons.

Для обновления расширения при тестировках, щёлкните кнопку “Перезагрузить” на карте расширения.

Неожиданные предупреждения свойств манифеста WebExtension можно со спокойствием игнорировать, ведь они требуются Chrome.

Установка на Firefox для Android

Это рекомендовано только если есть проблема, специфичная именно для мобильных устройств, которую трудно воспроизвести с помощью инструментов разработчика браузера, ведь расширения, загруженные этим методом временны, и должны быть переустановлены через USB каждую перезагрузку приложения.

Одноразовая установка

Рабочий сто
  1. Скачайте и распакуйте Платформенные Инструменты Android SDK (Windows, MacOS, Linux).
  2. Добавьте папку в переменную PATH среды
  3. Установите web-ext с помощью NPM воспроизведением npm install --global web-ext.
Android
  1. В приложении настроек Android, откройте страницу О телефоне и нажмите число сборки 7 раз.
  2. Перейдите на страницу “Опции разработчика” и включите “Отладка USB”.
  3. Установите стандартное приложение Firefox из магазина Google Play.
  4. Откройте приложение Firefox и активируйте “Отдалённая отладка при помощи USB” в настройках.

Загрузка расширения

  1. Подключите устройство Android и нажмите разрешить.
  2. Переместитесь в папку ScratchAddons.
  3. Воспроизведите команду adb devices для нахождения серийного номера устройства и уверьтесь в том, что ADB работает.
  4. Run the following command replacing [serial number] with the one from adb devices:
web-ext run -t firefox-android --adb-device [serial number] --firefox-apk org.mozilla.firefox

The extension should install and automatically reload when changes are made, otherwise close the Firefox app and re-run the command.

Inspecting

Desktop Firefox can inspect extensions and active tabs running in the Firefox app over USB:

  1. On desktop Firefox type about:debugging into the address bar.
  2. Click “Enable USB Devices”.
  3. Click connect on the device in the sidebar. If none appear, restart desktop Firefox.
  4. Click on the device again.