diff options
| author | Romain Hunault <romain.hunault@e.email> | 2021-05-12 14:25:46 +0000 |
|---|---|---|
| committer | Romain Hunault <romain.hunault@e.email> | 2021-05-12 14:25:46 +0000 |
| commit | dd0b6fc70913ec3bfa65a7e8651e3272ebe9eb3b (patch) | |
| tree | f645721e005595c23227834b42acbc05c708eb7e | |
| parent | 15ffe05f62ad72883ad7269efaa395887c83d810 (diff) | |
Few install doc additions
| -rw-r--r-- | README.md | 39 |
1 files changed, 25 insertions, 14 deletions
@@ -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 <platform-key> --cert <platform-cert> --out PrivacyCentral.apk <downloaded-apk-path>` -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. |