Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit a279c136 authored by Nishith Khanna's avatar Nishith Khanna
Browse files

Merge branch '1168-main-pvc' into 'main' 

Change privacy central to advanced privacy in readme

See merge request !124
parents 15a91b8c 9ab21116

README.md

+10 −10
Original line number Diff line number Diff line 
# PrivacyCentralApp

# AdvancedPrivacy

An app to let you control and protect your privacy.



Forked to https://github.com/LedgerProject/e_privacycentralapp, embending all /e/ submodules.



# Features

The following features are currently part of PrivacyCentral app.

The following features are currently part of AdvancedPrivacy app.

1. Centralized overview dashboard.

2. Fake location.

3. Hiding IP address.
@@ -89,7 +89,7 @@ with this repo [android_system_netd](../../../e_privacycentral_android_system_ne 


then run the build as usual



This won't include privacy central, you still need to build the app.

This won't include advanced privacy, you still need to build the app.
@@ -106,32 +106,32 @@ modules must be build and deployed in the following order: 
- [app]



## Build

If you'd like to build PrivacyCentral locally, you should be able to just clone and build with no issues.

If you'd like to build AdvancedPrivacy locally, you should be able to just clone and build with no issues.



For building from CLI, you can execute this command:

```bash

./gradlew build

```



## How to use PrivacyCentral apk

## How to use AdvancedPrivacy apk

You can build the apk locally by using above instructions or you can download the latest stable apk from `master` branch pipeline.



### 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

AdvancedPrivacy 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. 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

    apksigner sign --key platform.pk8 --cert platform.x509.pem AdvancedPrivacy.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

    adb shell mkdir system/priv-app/AdvancedPrivacy

    adb push AdvancedPrivacy.apk system/priv-app/AdvancedPrivacy

    ```



1. Push permissions whitelist.
@@ -151,7 +151,7 @@ PrivacyCentral needs to be installed as system app and whitelisting in order to 
### 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.



> Voila !!!, PrivacyCentral is installed successfully in your device.

> Voila !!!, AdvancedPrivacy is installed successfully in your device.



# Distribution

This project can be distributed as prebuilt apk with /e/OS or it can be published on other app stores for non /e/OS devices.