From dd0b6fc70913ec3bfa65a7e8651e3272ebe9eb3b Mon Sep 17 00:00:00 2001 From: Romain Hunault Date: Wed, 12 May 2021 14:25:46 +0000 Subject: Few install doc additions --- README.md | 39 +++++++++++++++++++++++++-------------- 1 file changed, 25 insertions(+), 14 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 0416190..0e8ca66 100644 --- a/README.md +++ b/README.md @@ -81,21 +81,32 @@ You can build the apk locally by using above instructions or you can download th ### To run apk on /e/OS devices PrivacyCentral needs to be installed as system app and whitelisting in order to grant some system specific permissions. Follow these steps to make it work properly on /e/OS -1. Sign the apk with platform certificate. You can use this command to do that -> `apksigner sign --key --cert --out PrivacyCentral.apk ` -2. Install apk as system app and push permissions whitelist with following commands: -```bash -adb root && adb remount -adb shell mkdir system/priv-app/PrivacyCentral -adb push PrivacyCentral.apk system/priv-app/PrivacyCentral -``` -3. To push permissions whitelist, you can use the following command. It requires the whitelisting [privapp-permissions-foundation.e.privacycentralapp.xml](privapp-permissions-foundation.e.privacycentralapp.xml) file that can be found in the project repository. -```bash -adb push privapp-permissions-foundation.e.privacycentralapp.xml /system/etc/permissions/ - -# Now reboot the device -adb reboot -``` +1. From `Developer options`, enable `Android debugging` and `Rooted debugging` +1. Sign the apk with platform certificate. You can use this command to do that + + ```shell + apksigner sign --key platform.pk8 --cert platform.x509.pem PrivacyCentral.apk app-e-release-unsigned.apk + ``` + + If you are running your tests on an `/test` build, you can find keys at https://gitlab.e.foundation/e/os/android_build/-/tree/v1-q/target/product/security +1. Install apk as system app and push permissions whitelist with following commands: + ```shell + adb root && adb remount + adb shell mkdir system/priv-app/PrivacyCentral + adb push PrivacyCentral.apk system/priv-app/PrivacyCentral + ``` + +1. Push permissions whitelist. + - it requires the whitelisting [privapp-permissions-foundation.e.privacycentralapp.xml](privapp-permissions-foundation.e.privacycentralapp.xml) file that can be found in the project repository. + - then use the following command + ```bash + adb push privapp-permissions-foundation.e.privacycentralapp.xml /system/etc/permissions/ + ``` +1. Reboot the device + ```shell + adb reboot + ``` ### To run apk on stock android devices You can simply install the apk. Keep in that mind all features won't be available on stock android devices. -- cgit v1.2.1