This repository is compatible with Android Studio.

About

open311-android is a reference client for the Open311 API. open311-android should work for any organizations with an Open311 GeoReport v2 compliant endpoint server.

Tested on API 19, API 22 and API 23

Open311 - http://open311.org

Open311 GeoReport v2 is an open standard for sharing non-emergency issues in public spaces. Common issues include potholes, broken streetlights, garbage, vandalism, and other problems that compromise public spaces and infrastructure.

The current version of the specification is documented at http://wiki.open311.org/GeoReport_v2

Getting started

• Clone this repository (recursive as it depends on open311_java)

git clone --recursive https://github.com/CodeForEindhoven/open311-android.git

• Start Android Studio
• Select import project and point the dialog to the directory containing the created github repository

When Android Studio is started, you should be good to go!

Running tests

The org.codeforamerica.open311 subproject contains tests. There is an issue with the servers.json resource, sometimes I cannot load or refresh it. I found that invalidating/restarting Android Studio most of the times clears this issue. Another method is to force a Gradle sync by simply adding and deleting a space which will make the IDE ask you to sync.

Contributing

Online documentation is in the Wiki here on GitHub. Questions not addressed in the wiki should be sent to the Google Group.

If you find the app not behaving as expected, please create an issue in our Github issue tracker

License

The files in this repository are released under the GPL 3 license.