Updater: Switch to destination selector

* Let the user decide where to store the file
* That way it's not located in /storage/emulated/0/Android/data/...
  ...org.lineageos.updater/files/LineageOS updates/*.zip
  -> The user knows where the file is stored
  -> We don't have to care about WRITE_EXTERNAL_STORAGE etc
* Remove the cancel button - after closing the file stream we loose
  permission to access it, therefore can't delete it anymore
  -> Let the user handle deletion manually
* Since we don't use WRITE_EXTERNAL_STORAGE anymore, remove it from
  Manifest and also remove PermissionUtils (+calls) - we can now export
  immediately.
  -> This also solves the
  "TODO: start exporting once the permission has been granted"

Change-Id: I50afa403f2803569aa9def807ea20ee72c582284
5 files changed
tree: 0e0c4eb69d874afd4a90d9bdde29594dcfed0243
  1. res/
  2. src/
  3. .gitignore
  4. Android.bp
  5. AndroidManifest.xml
  6. build.gradle
  7. gen-keystore.sh
  8. gradle.properties
  9. keystore.properties.sample
  10. privapp_whitelist_org.lineageos.updater.xml
  11. proguard.flags
  12. push-update.sh
  13. README.md
README.md

Updater

Simple application to download and apply OTA packages.

Server requirements

The app sends GET requests to the URL defined by the updater_server_url resource (or the lineage.updater.uri system property) and expects as response a JSON with the following structure:

{
  "response": [
    {
      "datetime": 1230764400,
      "filename": "ota-package.zip",
      "id": "5eb63bbbe01eeed093cb22bb8f5acdc3",
      "romtype": "nightly",
      "size": 314572800,
      "url": "https://example.com/ota-package.zip",
      "version": "15.1"
    }
  ]
}

The datetime attribute is the build date expressed as UNIX timestamp.
The filename attribute is the name of the file to be downloaded.
The id attribute is a string that uniquely identifies the update.
The romtype attribute is the string to be compared with the ro.lineage.releasetype property.
The size attribute is the size of the update expressed in bytes.
The url attribute is the URL of the file to be downloaded.
The version attribute is the string to be compared with the ro.lineage.build.version property.

Additional attributes are ignored.

Build with Android Studio

Updater needs access to the system API, therefore it can't be built only using the public SDK. You first need to generate the libraries with all the needed classes. The application also needs elevated privileges, so you need to sign it with the right key to update the one in the system partition. To do this:

  • Place this directory anywhere in the Android source tree
  • Generate a keystore and keystore.properties using gen-keystore.sh
  • Build the dependencies running make UpdaterStudio from the root of the Android source tree. This command will add the needed libraries in system_libraries/.

You need to do the above once, unless Android Studio can't find some symbol. In this case, rebuild the system libraries with make UpdaterStudio.