UBports Installer 0.8.0-beta

A snap package can be installed by running snap install ubports-installer --beta on any Linux distribution.

You can help us test this release on UBports OPEN-CUTS.

Release notes

Where the previous couple releases of the UBports Installer looked at refactoring, polishing, and improving the maintainability and stability of our libraries, this iteration finally tackles the installer's own back-end code. All JavaScript files have been documented, partially re-written, and broken up into properly testable modules:

This effort will continue in subsequent releases of the 0.8.x-beta series of the UBports Installer.

Community members interested in contributing to the development of the UBports Installer are welcome to join us on the road to 100% coverage. Writing unit-tests is a great way of getting to know the code while helping to improve the UBports Installer's stability down the road.

Changelog

• @NeoTheThird Backend code cleanup and modularization #1540 #1559 #1567
• @NeoTheThird Unit-Tests based on Jest, ~40% coverage #958 #1553
• @NeoTheThird JSdoc documentation for all functions #956
• @NeoTheThird Fix an issue where the release script failed for no reason #1554
• @NeoTheThird Deprecate old checksum-string-style in favor of new checksum objects #1562

Thank you to the countless testers, bug reporters, and contributors who made these improvements possible! Special thanks to @Flohack74 for his tireless reviewing of pull requests!

Notes for Developers

• The transition period for the legacy checksum string has lapsed. You now need to specify an object with an algorithm. All live configurations have already been updated. Example:

{
  "url": "https://gitlab.com/ubports/community-ports/android9/fxtec-pro1/fxtec-pro1/-/jobs/865239242/artifacts/raw/out/boot.img",
  "checksum": {
    "sum": "2204c2478854d4dfd1bb16fae2651f80ae07f4af4452eb4c0ff9bbc6ee3f6414",
    "algorithm": "sha256"
  }
}

• The command-line interface has changed. Consult ubports-installer -h for more information:

$ ubports-installer --help
Usage: ubports-installer [-f <file>] [-v[v] [-d]

UBports Installer (0.8.0-beta) source for linux
GPL-3.0 UBports Foundation <[email protected]>
The easy way to install Ubuntu Touch on UBports devices. A friendly cross-platform Installer for Ubuntu Touch. Just connect a supported device to your PC, follow the on-screen instructions and watch this awesome tool do all the rest.
https://devices.ubuntu-touch.io

Options:
  -V, --version      output the version number
  -f, --file <file>  Override the official config by loading a local file
  -v, --verbose      Print debugging information. Multiple -v options increase the verbosity
  -d, --debug        Enable electron's web debugger to inspect the frontend
  -h, --help         output usage information