Hydra (Android) 
The Android version of the Hydra app, available for Android 5.0 (Lollipop) and up. Available on Google Play, on F-Droid or as a download in the release section (as an APK file).
Contributing
Quickstart
If you don't have Android Studio or Intellij already, download and install it.
- Clone the repo, i.e.
git clone git@github.com:ZeusWPI/hydra-android.git - Choose 'Import Project (gradle etc.)'
- Choose the folder you just cloned
- Have fun :)
Alternatively, you can checkout the repo directly from within Android Studio or Intellij.
People who use Nix(OS) can use the flake.nix file in the repo for a dev shell.
Note that we don't build the app using flakes; it's only used for a dev shell.
Additionally, the flake is very flaky, since Android development in Nixpkgs currently isn't the best.
Keys
If you want to use the Google Maps integration, you will need the API keys. You can contact us for more information and to obtain the keys. This is not required to compile and build the app.
After you've obtained the keys, you will need to copy the file app/secrets.properties.example to app/secrets.properties and insert the correct keys.
Build variants
Hydra comes in two build variants: store and open.
The store variant is the main variant, and used for the Play Store and is the recommended version for most people. The open variant only uses open-source software (e.g. OpenStreetMaps instead of Google Maps). Since the open variant contains no crash reporting functionality, crashes from that version not accompanied by a stack trace will not be considered.
Useful links
- How to Write a Git Commit Message
- Android Developer Guides
- Android API Reference
- Gradle User Manual (probably not needed for normal work on the app)
- Hydra on Mattermost
Other repos
Credits
- Sandwich by icon 54 from the Noun Project
-
Megaphone by Daniel Bruce from flaticon
Google Play and the Google Play logo are trademarks of Google Inc.
License
All code is licensed under the MIT license, unless otherwise noted.