summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md39
1 files changed, 25 insertions, 14 deletions
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 <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.