Skip to content

greatfire/apps-android-wikipedia-envoy

 
 

Repository files navigation

Wikipedia Android app

This repository is a fork of the official Wikipedia Android app that has been integrated with the Envoy library.

Building the App

  1. Configuration parameters must be specified to enable Envoy services. If these parameters need to be changed, create a file called credentials.properties in the root project directory. The following options are supported:
  • defProxy: comma separated list of Envoy URLs to proxies
  • hystCert: If using a Hysteria server with a self-signed certificate, this is the root certificate PEM file, with newlines replaced with commas

Example:

hystCert=MIIEtjCCAx6gAwIBAgIRAK8VbNIfz8BrRYM1uWDRoGowDQYJKoZIhvcNAQELBQAw,czEeMBwGA1UEChMVbWtjZXJ0IGRldmVsb3BtZW50IENB...
defProxy=https://wiki.example.com/wikipedia/,https://proxy.example.org/wiki/

After creating this file, run the following gradle command in the root project directory:

./gradlew hideSecretFromPropertiesFile -PpropertiesFileName=credentials.properties -Ppackage=org.greatfire.wikiunblocked

More information on Envoy URLs can be found in the Envoy Documentation

  1. Specify the greatfire flavor when building the application, eiither on the command line or in Android Studio, e.g. ./gradlew assembleGreatfireDebug or:

variant

  1. When running the application, click on the "More" icon a the bottom and look for the "Anonymous" icon. A check indicates that Envoy is running, an X indicates that Envoy is not running. (note that Envoy will not run if a direct connection can be made)

screen_mark

Documentation

Documentation for the Wikipedia app is kept on the wiki.

Issues

Please file issues with the Wiki Unblocked app in the bug tracker.

Packages

No packages published

Languages

  • Kotlin 95.8%
  • Java 2.2%
  • C++ 1.2%
  • Python 0.8%
  • CMake 0.0%
  • Jinja 0.0%