Monthly(?) build and release process

Steps for building and releasing WebToEpub

1. Confirm Firefox for Android works.
2. Merge experimental branch into master.
3. Execute the workflow https://github.com/dteviot/WebToEpub/actions/workflows/AutoRelease.yml with the parameter "minor" for a monthly release. See https://github.com/dteviot/WebToEpub/issues/1410 for more details
4. Copy files generated by workflow from https://github.com/dteviot/WebToEpub/releases/tag/xxxxxx
5. Rename files:

• WebToEpub?.?.?.?.Chrome.zip => WebToEpub?.?.?.?.zip
• WebToEpub1.0.1.0.Firefox.zip => WebToEpub?.?.?.?.xpi

6. Post respective files to Post to Google and Mozilla.
7. Wait for confirmation email that Mozilla has updated store.
8. Notify and close issues in GitHub that are now done.

Notes

1. Try to release on last weekend of each month

Major/Minor/Dev

The difference between Major and Minor are that changes are "big" and "not backwards-compatible" i would focus on "not backwards-compatible" The only not "not backwards-compatible" updates i can think of are if the min_browser_version gets increased. Tldr.: milestone.majore.minor.dev

milestone: Maybe if the UI completely changes. majore: if the min_browser_version gets increased or other permissions are needed. minore: normal updates (i.e. Monthly) dev: after each push to experimental

Test Firefox-Android with Bluestacks

Here is general documentation for Firefox-Android extension development https://extensionworkshop.com/documentation/develop/developing-extensions-for-firefox-for-android/

Download and install Bluestacks Install F-Droid in BlueStacks

Install FFUpdater from F-Droid Install Firefox Browser via FFUpdater

In the BlueStacks App Player go to Settings (CTR+Shift+I) -> Advanced

• Enable Android Debug Bridge (ADB)

Open Firefox-Android -> Settings -> About Firefox

• Click the Firefox symbol 5 times to activate the debug menu
• Go back to Settings and enable "Remote debugging via USB"

Open Firefox (Not Firefox-Android) and go to "about:debugging"

• Enable USB Devices
• On the left side should be a Smartphone with the Option to Connect
• Click "Connect"
• Click the smartphone

Go to the WebToEpub folder and run "npm run lint"

• unzipp the newest WebToEpub.X.X.X.X.xpi build in the eslint folder
• Go in the unzipped folder and run the following commands
• adb devices

Than run the following command and change XXX to the name returned by "adb devices"

• web-ext run -t firefox-android --adb-device XXX

WebToEpub is now loaded on the Firefox-Android browser and can be used.

In Firefox (Not Firefox-Android) and go to "about:debugging" and click Inspect on WebToEpub to debug problems.