Skip to content

oppia/oppia-android

Repository files navigation

Mailing List Twitter Follow GitHub issues by-label

Unit Tests (Robolectric -- Gradle) Unit Tests (Robolectric - Bazel) Build Tests Static Checks

Oppia is an online learning tool that enables anyone to easily create and share interactive activities (called 'explorations'). These activities simulate a one-on-one conversation with a tutor, making it possible for students to learn by doing while getting feedback.

The Android app is a frontend for Oppia that provides access to Oppia's curated numeracy lessons for users who may not have regular access to internet connectivity, and in a way that can be easily shared across multiple members of the same household. The app is now available in beta and can be installed from the Play Store.

Oppia Android is written using Kotlin and Java, and leverages Bazel, databinding, Dagger 2, and AndroidX. See also:

You can also sign up to our email newsletter for news and updates about the overall Oppia project.

Installation

Please refer to the Installing Oppia Android page for full instructions on how to install Oppia-Android on your local machine.

Contributing

The Oppia project is built by the community for the community. We welcome contributions from everyone, especially new contributors.

You can help with Oppia's development in many ways, including

Mobile developers: please see this wiki page for instructions on setting things up and committing changes.

Other developers: see this wiki page for instructions on setting things up for development on Oppia's frontend or backend.

All other contributors: please see our general contributor guidelines.

Development

The Oppia Android codebase is specifically designed to streamline development by utilizing design patterns that reduce the likelihood of making mistakes, and by leveraging powerful libraries and technologies to reduce the amount of code that needs to be written. See the Overview of the Oppia Android codebase wiki page for more specifics on the architecture. A brief list of libraries & technologies that the team makes significant use of:

The team puts special emphasis on writing high-quality, readable, maintainable, and well-tested code.

Support

If you have any feature requests or bug reports, please log them on our issue tracker.

Please report security issues directly to admin@oppia.org.

License

The Oppia Android code is released under the Apache v2 license.

Keeping in touch

Social Media