android

The Android App version of 5calls.org.

License

This project is released open source under the MIT License. See LICENSE for more details.

Basic structure

FiveCallsApi is used to request a list of issues from the server in MainActivity. When an issue is clicked, IssueActivity is launched for that issue, and FiveCallsApi is again used to record information back to the server. Location is set in LocationActivity and saved in SharedPreferences. A SQLite database (in DatabaseHelper) is used to store user stats, which are displayed in StatsActivity.

Development

To run the app locally, you'll need to generate your own google-services.json file from the Google website. It doesn't matter what services you enable because you won't be talking to the prod Google account, but you should include Analytics.

To test the app, set TESTING=true in FiveCallsApi.java. This makes sure that calls logged to the server are marked as test calls.

TODOs and Issues

Issues marked "up for grabs" are available for contributors. Please add a comment to the issue when you start working on it to avoid conflicts. Feel free to add new issues to the list too -- even better if new issues have some justification or background information.

Download

The app is published on Google Play and has a Beta channnel for testing. If you are interested in getting Beta releases and helping with user testing, reach out to @dektar to be added!

Get it on Google Play

The app is also available on the Amazon App Store.

Contributors

Acknowledgments

Thanks to Nick O'Neill for organizing the 5calls project.