This is the android version of ooniprobe.
This application requires Android Studio. We use gradle and, as part of the initial gradle sync, Android studio will download all the required dependencies. The most important dependency is measurement-kit which is fetched from our Bintray jcenter repository.
Building an apk
Ensure you have Android Studio and gradle installed.
On macOS you can do:
brew cask install android-studio
Then you should open the project in Android Studio and click on build.
The built apk will end up inside of
If you wish to test the apk inside of an emulator this can be done with
(assuming you have created an emulator named
~/Library/Android/sdk/tools/emulator -avd Nexus_5_API_23_marshmallow_6.0 ~/Library/Android/sdk/platform-tools/adb install app/build/outputs/apk/app-debug.apk
The app should then be installed inside of the emulator
Building the app for f-droid
Just use the
f-droid branch rather than the
master branch. We periodically merge
f-droid and tag releases with the
f-droid branch contains small tweaks required to have
the app accepted by f-droid.
To manage translations ensure you have installed the transifex command line tools.
Pushing source text
To push the source of the translation run:
tx push -s
To pull in translations run:
tx pull -l [lang_code]
to pull only a specific language
Generating descriptions for market
To generate translated descriptions for the markets run:
python scripts/gen-descriptions.py [lang_code]
lang_code is the language code for the description you want to
This will print to standard output the translated text that you can then copy and paste into the market descriptions.
If a string is not translated it will print the source for the text.