Installation

Aus Erweiterungen-Stores

Scratch Addons ist in diesen Stores verfügbar.

Chrome Web Store Firefox Add-ons

Store Installieren Unterstützte Browser Systemanforderungen
Chrome Web Store Aus Chrome Web Store installieren Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
Chromium 96+
Windows 7+
OS X / MacOS 10.11+
Add-ons für Firefox Aus Add-ons für Firefox installieren Mozilla Firefox 109+ Windows 7+
OS X / MacOS 10.12+
Microsoft Edge Add-ons Für Microsoft Edge Addons installieren Microsoft Edge 96+ Windows 7+
OS X / MacOS 10.11+

Aus Quelle

Im Gegensatz zu den Storeversionen benötigt die Installation aus dem Quellcode einen Browser basierend auf Chromium 121+ oder Firefox 121+.

Über GitHub-Releases

Release-Seite contains the code and installation files for all development builds of Scratch Addons, as well as the mirror of the store builds.

Repository klonen

Empfohlene Installationsmethode von Scratch Addons für Entwickler, vorausgesetzt, du hast Git installiert.

Wenn du vorhast mitzuwirken, forke zuerst das Repository auf GitHub und klone dann deinen Fork. Nutze dabei statt <username> deinen GitHub-Benutzernamen.

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

Um Scratch Addons zu aktualisieren, cd zuerst zu seinem Ordner und führe dann die folgenden Befehle aus.

$ git fetch
$ git pull

Vergiss nicht, Scratch Addons auch im Browser zu aktualisieren.

Zip herunterladen

Diese Methode ist nur dann für die Entwicklung empfohlen, wenn Git nicht am System installiert werden kann. Der Vorgang muss bei jedem Update von Scratch Addons manuell wiederholt werden.

If you do not have Git installed, use this method instead.

  1. Gehe zum Repository und finde den “Download code”-Knopf.

  2. Klicke ihn an und wähle “Download ZIP”.

  3. Extrahiere das Archiv in einen Ordner.

Installation auf Google Chrome oder Microsoft Edge

Laden der Erweiterung in Google Chrome bzw. den meisten auf Chromium basierenden Browsern wie Microsoft Edge, Opera, Brave oder Vivaldi:

  1. Gehe zu chrome://extensions

  2. Aktiviere den “Entwicklermodus” in der rechten oberen Ecke

  3. Klicke auf “Entpackte Erweiterung laden” und wähle den Ordner ScratchAddons.

Um die Erweiterung beim Testen zu aktualisieren, klicke auf das Aktualisieren-Symbol in der Karte der Erweiterung.

Die Warnungen “Manifest-Schlüssel nicht erkannt” können problemlos ignoriert werden, da sie von Firefox benötigt werden.

Auf Mozilla Firefox installieren

Laden der Erweiterung in Mozilla Firefox:

Extensions loaded into Firefox this way are temporary and must be reloaded every time the browser is restarted. Because of this Chrome is recommended for development, but everything is still expected to work on Firefox.
  1. Type about:debugging into the address bar.

  2. Klicke auf “Dieses Firefox” in der Seitenleiste

  3. Klicke auf “Temporäres Add-on laden…”

  4. Wähle die Datei manifest.json im Ordner ScratchAddons.

Um die Erweiterung beim Testen zu aktualisieren, klicke auf die “Neu laden”-Schaltfläche in der Karte der Erweiterung.

Die Warnungen “Unerwartete WebExtension Manifest-Eigenschaft” können problemlos ignoriert werden, da sie von Chrome benötigt werden.

Installing on Firefox for Android

This is only recommended if there is a mobile specific issue that cannot be easily replicated with the browser’s developer tools since extensions loaded this way are temporary and must be reinstalled over USB every time the app is restarted.

One time setup

Desktop
  1. Download and extract the Android SDK Platform Tools (Windows, MacOS, Linux).
  2. Add the folder to the PATH environment variable.
  3. Install web-ext with NPM by running npm install --global web-ext.
Android
  1. In the Android settings app, open the about page and tap the build number 7 times.
  2. Navigate to the “Developer options” page and enable “USB debugging”.
  3. Install the standard Firefox app from the Google Play store.
  4. Open the Firefox app and enable “Remote debugging via USB” in its settings.

Loading the extension

  1. Plug in the Android device and tap allow on it.
  2. Navigate to the ScratchAddons folder.
  3. Run adb devices to get the device’s serial number and ensure ADB is working.
  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.