Required since Android 14 [1]. 11-16 14:05:45.363 20623 20623 E AndroidRuntime: FATAL EXCEPTION: main 11-16 14:05:45.363 20623 20623 E AndroidRuntime: Process: org.lineageos.updater, PID: 20623 11-16 14:05:45.363 20623 20623 E AndroidRuntime: android.app.MissingForegroundServiceTypeException: Starting FGS without a type callerApp=ProcessRecord{6d14558 20623:org.lineageos.updater/u0a149} targetSDK=34 [1] https://developer.android.com/about/versions/14/changes/fgs-types-required Change-Id: Id6217424177b94d37621062fb1a55778f1dabbab
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 insystem_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
.