julianxhokaxhiu/lineage-ota

A simple OTA REST Server for LineageOS OTA Updater System Application

2.3.1 2017-06-24 22:09 UTC

README

A simple OTA REST Server for LineageOS OTA Updater System Application

How to use

  1. cd /var/www/ && composer create-project julianxhokaxhiu/lineage-ota LineageOTA
  2. Follow the rest of the tutorial on my personal blog post where I explain how to override the build server on your ROM.
  3. Optional. If just want to test if the REST Server is working, if you go to http://localhost/LineageOTA you'll be redirected to the builds directory listing.

or

docker run \
    --restart=always \
    -d \
    -p 80:80 \
    -v "/home/user/builds:/var/www/html/builds/full" \
    julianxhokaxhiu/lineageota

Where do I have to upload the ZIPs that I obtain after the compilation?

  • Full builds should be uploaded to builds/full directory.
  • Delta builds will be automatically built on the builds/delta directory.

Can I Debug my REST Server somehow?

Yes, you can! I've implemented a simple script made for NodeJS that you clone and use it.

Changelog

v2.3.1

  • Fix for "Fix for the timestamp value. Now it inherits the one from the ROM". The order to read this value was before the OTA server was aware of the content of the build.prop. ( thanks to @syphyr )

v2.3.0

  • Added support for latest LineageOS ROMs that are using the version field ( see #29 )
  • Fix for the timestamp value. Now it inherits the one from the ROM ( see #30 )

v2.2.0

  • Honor ro.build.ota.url if present ( thanks to @ontherunvaro )
  • Add support for recursive subdirectories for full builds ( thanks to @corna )
  • Fix changelog URL generation ( thanks to @corna )
  • Add support for HTTPS OTA Url ( thanks to @corna )
  • Fix tutorial URL inside the README.md ( thanks to @visi0nary )

v2.1.1

  • Extend the legacy updater channel support to any Lineage ROM < 14.1

v2.1.0

  • Add support for LineageOS unofficial keyword on API requests
  • Drop memcached in favor of APCu. Nothing to configure, it just works :)

v2.0.9

v2.0.8

  • Adding support for LineageOS CMUpdater ( this should not break current CM ROMs support, if yes please create an issue! )

v2.0.7

  • Renamed the whole project from CyanogenMod to LineageOS
  • Added support for LineageOS ( and kept support for current CyanogenMod ROMs, until they will transition to LineageOS)

v2.0.6

  • Loop only between .ZIP files! Before even .TXT files were "parsed" which wasted some memory. Avoid this and make the REST server memory friendly :)
  • HTML Changelogs! If you will now create a changelog file next to your ZIP file with an HTML extension ( eg. lineage-14.0-20161230-NIGHTLY-hammerhead.html ) this will be preferred over .TXT ones! Otherwise fallback to the classic TXT extension ( eg. lineage-14.0-20161230-NIGHTLY-hammerhead.txt )

v2.0.5

  • Fix the parsing of SNAPSHOT builds

v2.0.4

  • Final Fix for TXT and ZIP files in the same directory
  • Automatic URL detection for basePath ( no real need to touch it again )
  • Delta builds array is now returned correctly

v2.0.3

  • Memcached support
  • UNOFFICIAL builds support ( they will be set as channel = NIGHTLY )
  • Fix Delta Builds path
  • Fix internal crash when *.txt files were present inside /builds/full path

v2.0.2

  • Fix some breaking changes that will not enable the REST server to work correctly.

v2.0.1

  • Excluded hiddens files and autogenerated ones by the OS (for example .something or Thumbs.db).

v2.0

  • Refactored the whole code.
  • Now everything is PSR4 compliant.
  • Introduced composer.json to make easier the installation of the project.

Drawbacks

  • Delta updates may or may not work. It's using Deltax3 to create them but it's just experimental. Use it at your own risk.

License

See LICENSE.

Enjoy :)