https://github.com/ghostery/user-agent-android
Ghostery Android Browser
https://github.com/ghostery/user-agent-android
android-browser ghostery ghostery-browser
Last synced: about 1 year ago
JSON representation
Ghostery Android Browser
- Host: GitHub
- URL: https://github.com/ghostery/user-agent-android
- Owner: ghostery
- License: mpl-2.0
- Archived: true
- Created: 2020-06-04T15:33:27.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-12-02T11:42:10.000Z (over 1 year ago)
- Last Synced: 2025-03-16T12:51:17.160Z (over 1 year ago)
- Topics: android-browser, ghostery, ghostery-browser
- Language: Shell
- Homepage: https://play.google.com/store/apps/details?id=com.ghostery.android.ghostery
- Size: 43.6 MB
- Stars: 37
- Watchers: 10
- Forks: 8
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# This project is discontinued.
We recommend to use [Ghostery Tracker and Ad Blocker](https://www.ghostery.com/ghostery-ad-blocker) in [Firefox](https://play.google.com/store/apps/details?id=org.mozilla.firefox&hl=pl&gl=US&pli=1).
---
# Ghostery Browser for Android
This is the next generation Ghostery Browser for Android based on Firefox Fenix.
The project uses a specific tag of the upstream Fenix project as a submodule and then applies a set of patches to add the Ghostery extension and branding.
## Build Instructions
Note: Both Android SDK and NDK are required.
```shell
# Checkout the repo
git clone https://github.com/ghostery/user-agent-android
# Pull Fenix code
git submodule init
git submodule update --force
# Apply patches
./import.sh
# the browser directory contains the app project
cd browser/
./gradlew clean app:assembleGhostery
```
## Dev workflow
We use git to import and export patches. Having initially imported patches via `import.sh` you can modify and edit patches in the browser folder.
Once finished, you can export your changes with the following command:
```bash
cd browser/
git format-patch ${TAG} --minimal --no-numbered --keep-subject --output-directory ../patches/
```
Where `${TAG}` is a ref to the tip of the Fenix branch you originally applied the patches onto. The command will update the patches in the `patches` folder
to match your git commit history.
### Merging upstream
To update the browser to a newer version of Fenix, first update the Fenix submodule branch, then apply and fix the patches.
To update Fenix version:
* change `FENIX_TAG` in `./config.sh`
* change `.gitmodule` to specify new version
* `git submodule sync --recursive`
* `git submodule foreach --recursive git fetch`
* `git submodule update --init --recursive`
* in browser folder `git checkout TAG`
* commit changes