Advanced Extension Reloader 1.7.0 CRX for Chrome

Advanced Extension Reloader is an extension that reloads unpacked extensions you develop for you. By installing this extension you will be able to reload all your unpacked extensions at once with a click on browser action icon. You will also be able to:

★ Limit reload only to extension with a specific id.

★ Reload extension(s) with a hotkey.

★ Set up an automatic reload on your extension's files change with the help of supplementary packages Advanced Extension Reloader Watch 1 (if you develop extension without a bundler) or Advanced Extension Reloader Watch 2 (if you use Webpack).

★ Make Advanced Extension Reloader play a sound when your extension(s) is reloaded.

★ Make Advanced Extension Reloader reload the current tab or all tabs after your extension(s) is reloaded (useful for content script).

After reloading your extension(s) Advanced Extension Reloader will reopen all closed during reload tabs (for example, options page of your extension(s)).

Below is a detailed description on how to use the Advanced Extension Reloader and its supplementary packages.
----------------------------------------------------------------
Manual reload
To reload extension(s), click on the extension icon in the toolbar or hit "Reload extension main" hotkey specified at chrome://extensions/shortcuts. You can change how your extension reloaded by editing the "Extension's icon click action" field in the settings page.

The field accepts an object that has the following properties (all properties are optional):

hard: boolean
default: true
Whether to reload an extension as opposed to just reloading the current tab. If set to false, the background page will not reload. The changes in manifest.json will not be reflected even if this option is true unless you use listen() function from the Advanced Extension Reloader Watch 2 supplementary package in the background script of the target extension (read below). Can be combined with "all_tabs".

all_tabs: boolean
default: false
Whether to reload all tabs as opposed to just reloading the current tab.

ext_id: string
default: undefined
An id of an extension to reload in "hard" mode. If unspecified, all extensions will be reloaded.

play_sound: boolean
default: false
Whether to play notification sound upon reload completion.

after_reload_delay: number
default: 1000
The amount of time in milliseconds to wait after an extension was reloaded before reloading closed tabs. If you experiencing any errors in your extension after its pages reloaded or extension's pages reload blank, you may try to increase this value.

Example:

{
"all_tabs": false,
"hard": true,
"ext_id": "ffhljpfecjcfjdaneehmhdgplkaafnbb",
"play_sound": true
}

Right-clicking on the extension icon will bring additional reload actions which can be changed by editing the "Extension's icon context menu actions" field in the settings page.

The field accepts an array of objects with the same schema as seen in "Extension's icon click action". Keep in mind that there is a limit on how many items can appear there. You can also use reload actions defined here by hitting one of the "Reload extension X" hotkeys specified at chrome://extensions/shortcuts, where X is a position in the array.
----------------------------------------------------------------
Automatic reload
To automatically reload your extension you will need two supplementary packages: Advanced Extension Reloader Watch 1 and Advanced Extension Reloader Watch 2. You will need to install Node JS and npm package manager to use them.
----------------------------------------------------------------
If you develop an extension without a bundler you will need Advanced Extension Reloader Watch 1. It will watch your files for changes and send a message to Advanced Extension Reloader, so it could reload your extension.

Here is how to use it:

1. Install the package globally using:
npm install advanced-extension-reloader-watch-1 --global

2. Create a config.json with the following properties (all properties except "watch_dir" are optional):

*any property described in the "Manual reload" section*

port: number
default: 7220
Port, that should expect messages to reload extensions. You will need multiple ports if you develop multiple extensions. Important: the port defined here should be duplicated in the Advanced Extension Reloader's settings page.

watch_dir: string
default: src
A path to the directory to watch for file changes. Should be your extension's directory path.

manifest_path: boolean | string
default: false
A path to the extension's manifest.json. Can be a boolean, if true Advanced Extension Reloader Watch 1 will look for manifest.json in the watch_dir directory. Advanced Extension Reloader Watch 1 needs this option to check the validity of manifest.json before reloading an extension. If the manifest.json is not valid, reload will be canceled so your extension doesn't crash.

hard_paths: string[]
default: []
An array of paths or partial paths (like file name). If an extension reload is triggered by a change in files/directories with one of these paths, it will reload with hard: true even if hard: false is specified in this config.

soft_paths: string[]
default: []
An array of paths or partial paths (like file name). If an extension reload is triggered by a change in files/directories with one of these paths, it will reload with hard: false even if hard: true is specified in this config.

all_tabs_paths: string[]
default: []
An array of paths or partial paths (like file name). If an extension reload is triggered by a change in files/directories with one of these paths, it will reload with all_tabs: true even if all_tabs: false is specified in this config.

one_tab_paths: string[]
default: []
An array of paths or partial paths (like file name). If an extension reload is triggered by a change in files/directories with one of these paths, it will reload with all_tabs: false even if all_tabs: true is specified in this config.

Example:

{
"port": 6220,
"watch_dir": "D:/Cloud/Projects/Advanced Extension Reloader Examples/advanced-extension-reloader-examples/no_bundler/extensions/manifest_3",
"ext_id": "jepkffhnnekngedhempoflhcmoogpkph",
"hard_paths": [
"background",
"manifest.json"
],
"hard": false,
"all_tabs": false,
"play_sound": true
}

3. Open command prompt/terminal and execute the following command: watch-ext --config path_to_your_config.json

If you want changes to your extension's manifest to be reflected you would need to use listen() function from Advanced Extension Reloader Watch 2 supplementary package.

Here's how to use it:

1. Download listener.js from here (https://bit.ly/2UI90jO) if your background script is an ES module, or here (https://bit.ly/3sCWH4R) otherwise.

2. Import listener.js in the background script and call listen() function like so:

new Listener().listen();
----------------------------------------------------------------
If you develop an extension with a bundler you will need Advanced Extension Reloader Watch 2.

Install Advanced Extension Reloader Watch 2 using:
npm install advanced-extension-reloader-watch-2 --save-dev

See example Webpack config: https://bit.ly/2XKcbIN

The new Reloader() constructor accepts an object with port and watch_dir properties.

The reloader.reload() function accepts object with hard, all_tab, ext_id, play_sound, after_reload_delay, hard_paths, soft_paths, all_tab_paths, and one_tab_paths properties. All these properties are covered above.

The reloader.play_error_notification() function allows you to play error notification sound on bundling failure.

You can also use listen() function like so:

import Listener from 'advanced-extension-reloader-watch-2/umd/listener';

new Listener().listen();
----------------------------------------------------------------
Sample extensions can be found here: https://bit.ly/3y9GTI2
----------------------------------------------------------------
Permissions:
Read your browsing history
Allows the extension to reopen tabs closed during the reload.

Manage your apps, extensions, and themes
Allows the extension to reload extensions.
----------------------------------------------------------------
GitHub: https://bit.ly/advanced-extension-reloader-github

Follow my Facebook page (more extensions): https://bit.ly/browservery