Install and Configure Update Factory Client packages for Embedded Android¶
Kynetics provides the "UF Android Client Service" and "UF Service API Reference Implementation" as Android Package files (
.apk) for side-load installation.
The UF Android Client Service must be installed as a SYSTEM application to work correctly, which is guaranteed by signing it with the platform key.
The platform key can either be:
- the test version included in the Android build system
- a custom one created for production purposes
For a successful installation, this guide assumes that you've powered on your device, have debug/developer mode enabled in Android,
and have connected your device to your computer so that the
adb utility can be used to side-load (install) APKs
and copy the
ufConf.conf file to your device.
Download the APKs¶
We've pre-signed the UF Android Client Service APK with the:
Signing the UF Android Client Service APK¶
In the case that you need to sign the UF Android Client Service APK with a different platform key, you will need the following standard key files that were also used to sign your Android OS image:
You also will need the
signapk.jar utility, which can be found in the Android OS build system (
Once you have all the required files, run the following command to sign the UF Android Client Service (adapt paths and file names as needed):
java -jar signapk.jar platform.x509.pem platform.pk8 uf-client-service-v1.0.0.apk uf-client-service-signed-v1.0.0.apk
Preparing the ufConf.conf configuration files¶
If you have the ufConf.conf file defined, the UF Service API Reference Implementation will automatically obtain the configuration and not require user input for configuration in the app.
Learn more about the parameters in the
ufConf.conf configuration file and its installation path in the Client configuration page.
Proceed to side-load the signed UF Android Client Service APK.
In this example, it is called:
adb install uf-client-service-signed-v1.0.0.apk
After installation of the UF Android Client Service, you will need to run the following once to enable the background service:
adb shell am startservice -a com.kynetics.action.BIND_UF_SERVICE
Optionally, you can also install the UF Service API Reference Implementation APK:
adb install uf-service-api-reference-implementation-kynetics_key.apk
Once installed successfully, you can find the Update Factory app in the Android launcher.
SELinux Security Framework may block operations like installation of updates or read access to configuration files. Please set SELinux to permissive mode or configure it in your Android OS to grant the required permissions to the UF Android Client Service.
For more information about SELinux on Android see the official documentation.