How to Install a Development version of the DuckieTV Chrome Browser Extension
###References### In this guide, I will be using:
PROD to refer to the Production DuckieTV Browser Extension version (from the Chrome Google Webstore), and
DEV to refer to the Development DuckieTV Browser Extension version (from GitHub), to save my aching fingers some work ;-)
###Installation### So you are keen to try out the greatest and latest version of DuckieTV. Terrific.
Fair warning: DEV is a work in progress. You may find incomplete features and/or come across unexpected errors or surprises.
This is a step by step guide on how to install the latest DEV version for Chrome Browsers.
###Pre requisites:### DuckieTV Development version. Get the latest version at the official download site here
OR
DuckieTV Nightly Build version Get the latest version at the official download site here
###Backup### If you have been using a PROD version, you may want to clone it's Database for use with DEV. To do this you need to
- start DuckieTV and click on the Settings Icon
- click on the Backup button
- and then on the Create Database Backup button
- and now click on the Backup Ready! Click to Download button
- and then click on the Save button to store your backup.
###Extracting the archive###
- Extract the DuckieTV-angular.zip archive (or one of the nightly build archives) to your favourite development directory/folder.
If you have chosen to use a Nightly build archive, you can skip to the Load the Browser Extension section below.
Choose to ###Set up for DuckieTV in TAB mode### TAB mode allows you to launch DuckieTV by clicking on a new Chrome Browser TAB
- TAB mode is the default configuration, no additional set up is required.
OR to ###Set up for DuckieTV in Button mode### Button mode allows you to launch DuckieTV by clicking on the DuckieTV Icon placed near the right side of the Chrome Browser Address bar.
- Find and rename the file called manifest.json to manifest-tab.json.
- Find and rename the file called manifest-app.json to manifest.json.
Now we can ###Load the Browser Extension###
- Start by clicking on the Chrome Browser Customize menu button (also know as the Hamburger button)
- And scroll down the list to More Tools and select the Extensions menu entry
- now click on the Developer Mode check box
- next we click on the Load Unpacked Extension button
- and find where you saved the unpacked archive and click on the OK button
###Note:### You may wish to disable PROD to prevent confusion with TABs or Buttons, so
- find your PROD entry in the extensions list, and click on the Enable check box so that it is no longer ticked
Now you can ###Start up DEV###
- Click on your new TAB, or Button to launch it. You are now running the DEV version!!
###Additional Notes### (1) To Import your backup to populate the new DEV Database
- at the You have not Series Yet! page click on the You can Also Import a Backup button
- and then click on the Choose a Backup to Load button
-
Select your backup and click on the Open button
- and wait until the import is complete.
(2) DEV does not Auto-Update its code as PROD can, so if you want to continue using the latest DEV version you will need to regularly fetch it again from here. After unpacking the archive, you need to let Chrome know of the change. ###Refresh Browser Extension###
- from your Chrome Browser, access the Extensions page and find the existing DEV extension
- and click on the Reload link to update the Browser.
###Problems?###