The Open Event Android project consists of two components. The App Generator is a web application that is hosted on a server and generates an event Android app from a zip with JSON and binary files (examples here) or through an API. The second component we are developing in the project is a generic Android app - the output of the app generator. The mobile app can be installed on any Android device for browsing information about the event. Updates can be made automatically through API endpoint connections from an online source (e.g. server), which needs to defined in the provided event zip with the JSON files. The Android app has a standard configuration file, that sets the details of the app (e.g. color scheme, logo of event, link to JSON app data).
Have an issue? Create one using these:
Please join our mailing list to discuss questions regarding the project: https://groups.google.com/forum/#!forum/open-event
Our chat channel is on gitter here: https://gitter.im/fossasia/open-event-android
This is a generic app that has two parts:
A) A standard configuration file, that sets the details of the app (e.g. color scheme, logo of event, link to JSON app data). A sample of the JSON format is maintained in the Open Event Repository.
B) A JSON API provided by open-event-orga-servers server (Code maintained here).
A sample app for testing purposes is automatically built after commits in the repository. Please download and test the app that is using the code from the dev branch here and the code from the master branch here.
Please find info about the set up of the Android app in your development environment here.
Device | Android Version | Skin/ROM |
---|---|---|
OnePlus 3 | Android 6.0 | OxygenOS |
Nexus 5X | Android 7.0 | AOSP |
Nexus 5X | Android 6.0 | CyanogenMod 13 |
Nexus 5 | Android 4.4 | AOSP |
Redmi Note 3 | Android 5.0 | MIUI |
Moto G4 Plus | Android 7.0 | Stock Android |
Installation instructions for generic servers are here.
Installation instructions for Google Cloud Kubernetes are here.
Installation instructions for AWS servers are here.
Installation instructions for Digital Ocean servers are here.
Installation instructions for docker are here.
Note: You will need to install Lombok Plugin in Android Studio in order to properly access generated methods of data classes
This is an Open Source project and we would be happy to see contributors who report bugs and file feature requests submitting pull requests as well. Please report issues here https://github.com/fossasia/open-event-droidgen/issues
We have the following branches
For contributions please read the CODESTYLE carefully. Pull requests that do not match the style will be rejected.
For writing commit messages please read the COMMITSTYLE carefully. Kindly adhere to the guidelines. Pull requests not matching the style will be rejected.
This project is licensed under the GNU General Public License v3. A copy of LICENSE is to be present along with the source code. To obtain the software under a different license, please contact FOSSASIA.
The project is maintained by