diff --git a/ar/markdown/docs/getting-started/installing.md b/ar/markdown/docs/getting-started/installing.md index 1e90c6e2..32b577a9 100644 --- a/ar/markdown/docs/getting-started/installing.md +++ b/ar/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: يتم التحميل Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | ثبيت | Supported browsers | System requirements | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/ca/markdown/docs/getting-started/installing.md b/ca/markdown/docs/getting-started/installing.md index feed6348..38c27c09 100644 --- a/ca/markdown/docs/getting-started/installing.md +++ b/ca/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Instal·lació Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | Instal·la | Supported browsers | System requirements | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/de/markdown/docs/getting-started/installing.md b/de/markdown/docs/getting-started/installing.md index b15a31e5..39a461cc 100644 --- a/de/markdown/docs/getting-started/installing.md +++ b/de/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Installation Scratch Addons ist in diesen Stores verfügbar. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | Installieren | Unterstützte Browser | Systemanforderungen | | - | - | - | - | | Chrome Web Store | [![Aus Chrome Web Store installieren](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ Um die Erweiterung beim Testen zu aktualisieren, klicke auf das Aktualisieren-Sy Laden der Erweiterung in Mozilla Firefox: {{< admonition info >}} - Auf diese Weise in Firefox geladene Addons sind nur temporär und müssen bei jedem Neustart des Browsers erneut geladen werden. Deshalb ist Chrome für die Entwicklung eher empfohlen, aber alles andere sollte auf Firefox genauso gut funktionieren. + 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. {{< /admonition >}} -1. Gehe zu [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Klicke auf "Dieses Firefox" in der Seitenleiste @@ -88,11 +91,51 @@ Laden der Erweiterung in Mozilla Firefox: 1. Wähle die Datei `manifest.json` im Ordner `ScratchAddons`. -1. Wenn ein Tab mit Berechtigungen erscheint, klicke auf "Aktivieren". - Um die Erweiterung beim Testen zu aktualisieren, klicke auf die "Neu laden"-Schaltfläche in der Karte der Erweiterung. {{< admonition info >}} Die Warnungen "Unerwartete WebExtension Manifest-Eigenschaft" können problemlos ignoriert werden, da sie von Chrome benötigt werden. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/es/markdown/docs/getting-started/installing.md b/es/markdown/docs/getting-started/installing.md index e975487b..ccced1ca 100644 --- a/es/markdown/docs/getting-started/installing.md +++ b/es/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Installing Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | Instalar | Supported browsers | Requerimientos del sistema | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/fi/markdown/docs/getting-started/installing.md b/fi/markdown/docs/getting-started/installing.md index cbeaaa44..c6019825 100644 --- a/fi/markdown/docs/getting-started/installing.md +++ b/fi/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Installing Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | Asenna | Supported browsers | System requirements | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/fr/markdown/docs/getting-started/installing.md b/fr/markdown/docs/getting-started/installing.md index 4555ef38..0bc53013 100644 --- a/fr/markdown/docs/getting-started/installing.md +++ b/fr/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Installation Srcratch Addons est disponible dans ces boutiques. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Boutique | Installer | Navigateurs pris en charge | Prérequis système | | - | - | - | - | | Boutique Chrome | [![Installer pour Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/hu/markdown/docs/getting-started/installing.md b/hu/markdown/docs/getting-started/installing.md index ef5ed1e1..7cfef853 100644 --- a/hu/markdown/docs/getting-started/installing.md +++ b/hu/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Telepítés Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | Telepítés | Supported browsers | Rendszerkövetelmények | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/id/markdown/docs/getting-started/installing.md b/id/markdown/docs/getting-started/installing.md index c3075e9d..ee53900f 100644 --- a/id/markdown/docs/getting-started/installing.md +++ b/id/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Installing Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | Pasang | Supported browsers | System requirements | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/it/markdown/docs/getting-started/installing.md b/it/markdown/docs/getting-started/installing.md index 5063680c..7f31080d 100644 --- a/it/markdown/docs/getting-started/installing.md +++ b/it/markdown/docs/getting-started/installing.md @@ -6,10 +6,13 @@ title: Installazione Scratch Addons è disponibile in questi store. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | Installa | Browser supportati | Requisiti di sistema | | - | - | - | - | | Web Store di Chrome | [![Installa da Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ -| Add-on di Firefox | [![Installa negli Add-ons di Firefox](https://img.shields.io/amo/v/scratch-messaging-extension?style=flat-square&logo=firefox-browser&logoColor=white&label=install&color=FF7139)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) | Mozilla Firefox 109+ | Windows 7+
OS X / MacOS 10.12+ +| Addon per Firefox | [![Installa negli Add-ons di Firefox](https://img.shields.io/amo/v/scratch-messaging-extension?style=flat-square&logo=firefox-browser&logoColor=white&label=install&color=FF7139)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) | Mozilla Firefox 109+ | Windows 7+
OS X / MacOS 10.12+ | Componenti aggiuntivi di Microsoft Edge | [![Installa negli Addon di Microsoft Edge](https://img.shields.io/badge/dynamic/json?style=flat-square&logo=microsoftedge&logoColor=white&label=install&color=0078D7&prefix=v&query=%24.version&url=https%3A%2F%2Fmicrosoftedge.microsoft.com%2Faddons%2Fgetproductdetailsbycrxid%2Filiepgjnemckemgnledoipfiilhajdjj)](https://microsoftedge.microsoft.com/addons/detail/iliepgjnemckemgnledoipfiilhajdjj) | Microsoft Edge 96+ | Windows 7+
OS X / MacOS 10.11+ ## Dal codice sorgente @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/ja/markdown/docs/getting-started/installing.md b/ja/markdown/docs/getting-started/installing.md index e1741456..80424d9c 100644 --- a/ja/markdown/docs/getting-started/installing.md +++ b/ja/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: インストール Scratch Addons は次のストアで入手できます。 +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | ストア | インストール | 対応ブラウザー | システム要件 | | - | - | - | - | | Chrome Web Store | [![Chrome Web Storeでインストール](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/ko/markdown/docs/getting-started/installing.md b/ko/markdown/docs/getting-started/installing.md index cd77f996..52fb140a 100644 --- a/ko/markdown/docs/getting-started/installing.md +++ b/ko/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: 설치 스크래치 애드온은 이 스토어들에서 설치할 수 있습니다. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | 스토어 | 설치 | 지원되는 브라우저 | 시스템 사양 | | - | - | - | - | | 크롬 웹 스토어 | [![크롬 웹 스토어에서 설치](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | 윈도우 7+
OS X / 맥 OS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/nb/markdown/docs/getting-started/installing.md b/nb/markdown/docs/getting-started/installing.md index eb9f4a09..77d894be 100644 --- a/nb/markdown/docs/getting-started/installing.md +++ b/nb/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Installerer Scratch Addons er tilgjengelig i disse butikkene. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Butikk | Installer | Støttede nettlesere | Systemkrav | | - | - | - | - | | Chrome Web Store | [![Installer for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/nl/markdown/docs/getting-started/installing.md b/nl/markdown/docs/getting-started/installing.md index 59216a65..72ea9fe9 100644 --- a/nl/markdown/docs/getting-started/installing.md +++ b/nl/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Installeren Scratch Addons is beschikbaar in deze stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | Installeren | Ondersteunde browsers | Systeemvereisten | | - | - | - | - | | Chrome Web Store | [![Installeren voor Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/pl/markdown/docs/getting-started/installing.md b/pl/markdown/docs/getting-started/installing.md index 4edc3618..f1b96749 100644 --- a/pl/markdown/docs/getting-started/installing.md +++ b/pl/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Instalacja Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | Instalacja | Supported browsers | System requirements | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/pt_BR/markdown/docs/getting-started/installing.md b/pt_BR/markdown/docs/getting-started/installing.md index 2410b357..4fb5a197 100644 --- a/pt_BR/markdown/docs/getting-started/installing.md +++ b/pt_BR/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Como instalar Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | Instalar | Supported browsers | Requisitos do sistema | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/ro/markdown/docs/getting-started/installing.md b/ro/markdown/docs/getting-started/installing.md index 044ebaac..8b6aef72 100644 --- a/ro/markdown/docs/getting-started/installing.md +++ b/ro/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Installing Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | Instalează | Supported browsers | System requirements | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/ru/markdown/docs/getting-started/installing.md b/ru/markdown/docs/getting-started/installing.md index c9f97501..397893f2 100644 --- a/ru/markdown/docs/getting-started/installing.md +++ b/ru/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Установка Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | Установить | Supported browsers | Системные требования | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/sl/markdown/docs/getting-started/installing.md b/sl/markdown/docs/getting-started/installing.md index 294d7a1b..df7e2357 100644 --- a/sl/markdown/docs/getting-started/installing.md +++ b/sl/markdown/docs/getting-started/installing.md @@ -6,7 +6,10 @@ title: Namestitev Scratch Addons je na voljo v teh trgovinah. -| Trgovina | Namesti | Podprti brskalniki | Sistemske zahteve | +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + +| Trgovina | Namestitev | Podprti brskalniki | Sistemske zahteve | | - | - | - | - | | Spletna trgovina Chrome | [![Namestitev v Spletni trgovini Chrome](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / macOS 10.11+ | Dodatki za Firefox | [![Namestitev v Dodatkih za Firefox](https://img.shields.io/amo/v/scratch-messaging-extension?style=flat-square&logo=firefox-browser&logoColor=white&label=install&color=FF7139)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) | Mozilla Firefox 109+ | Windows 7+
OS X / macOS 10.12+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/th/markdown/docs/getting-started/installing.md b/th/markdown/docs/getting-started/installing.md index 262f3d37..e2d80de8 100644 --- a/th/markdown/docs/getting-started/installing.md +++ b/th/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Installing Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | ติดตั้ง | Supported browsers | ความต้องการของระบบ | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/tr/markdown/docs/getting-started/installing.md b/tr/markdown/docs/getting-started/installing.md index bad84fce..d08da429 100644 --- a/tr/markdown/docs/getting-started/installing.md +++ b/tr/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Yüklemek Scratch Eklentileri bu mağazalarda mevcuttur +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Mağaza | İndir | Desteklenen tarayıcılar | Sistem gereksinimleri | | - | - | - | - | | Chrome Web Mağazası | [![Chrome Web Mağazası için İndir](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/vi/markdown/docs/getting-started/installing.md b/vi/markdown/docs/getting-started/installing.md index 28c00fcf..918be52d 100644 --- a/vi/markdown/docs/getting-started/installing.md +++ b/vi/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Installing Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | Tải xuống | Supported browsers | System requirements | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/zh_CN/markdown/docs/getting-started/installing.md b/zh_CN/markdown/docs/getting-started/installing.md index 33c757be..351d2b85 100644 --- a/zh_CN/markdown/docs/getting-started/installing.md +++ b/zh_CN/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: Installing Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | 下载 | Supported browsers | System requirements | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again. diff --git a/zh_TW/markdown/docs/getting-started/installing.md b/zh_TW/markdown/docs/getting-started/installing.md index e7efdc83..2e5c25bc 100644 --- a/zh_TW/markdown/docs/getting-started/installing.md +++ b/zh_TW/markdown/docs/getting-started/installing.md @@ -6,6 +6,9 @@ title: 下载中 Scratch Addons is available in these stores. +[![Chrome Web Store](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/cws-badge.png)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) +[![Firefox Add-ons](https://raw.githubusercontent.com/ScratchAddons/ScratchAddons/master/.github/readme-images/ff-addon-badge.png)](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) + | Store | 安裝 | Supported browsers | System requirements | | - | - | - | - | | Chrome Web Store | [![Install for Chrome Web Store](https://img.shields.io/chrome-web-store/v/fbeffbjdlemaoicjdapfpikkikjoneco?style=flat-square&logo=google-chrome&logoColor=white&label=install&color=4285F4)](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) | Google Chrome 96+
Microsoft Edge 96+
Opera 82+
Brave 1.33+
Vivaldi 5.0+
*Chromium 96+* | Windows 7+
OS X / MacOS 10.11+ @@ -77,10 +80,10 @@ To update the extension when testing, click the refresh icon on the extension's To load the extension into Mozilla Firefox: {{< admonition info >}} - Addons 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. + 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. {{< /admonition >}} -1. Go to [about:debugging](about:debugging) +1. Type `about:debugging` into the address bar. 1. Click "This Firefox" on the sidebar @@ -88,11 +91,51 @@ To load the extension into Mozilla Firefox: 1. Select the `manifest.json` file in the `ScratchAddons` folder. -1. If a permission tab opens, click the "Enable" button. - To reload the extension when testing, click the "Reload" button on the extension's card. {{< admonition info >}} The unexpected WebExtension manifest property warnings may safely be ignored, since they are required by Chrome. {{< /admonition >}} + +### Installing on Firefox for Android + +{{< admonition info >}} + 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. +{{< /admonition >}} + +#### One time setup + +##### Desktop + +1. Download and extract the Android SDK Platform Tools ([Windows](https://dl.google.com/android/repository/platform-tools-latest-windows.zip), [MacOS](https://dl.google.com/android/repository/platform-tools-latest-darwin.zip), [Linux](https://dl.google.com/android/repository/platform-tools-latest-linux.zip)). +1. Add the folder to the PATH environment variable. +1. 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. +1. Navigate to the "Developer options" page and enable "USB debugging". +1. Install the standard Firefox app from the [Google Play store](https://play.google.com/store/apps/details?id=org.mozilla.firefox). +1. 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. +1. Click "Enable USB Devices". +1. Click connect on the device in the sidebar. If none appear, restart desktop Firefox. +1. Click on the device again.