Skip to content

asuc-octo/berkeley-mobile-android

Repository files navigation

Berkeley-Mobile-Android

This is the official repository for the Berkeley Mobile Android application.

Build Status

These badges are automatically generated based on our Bitrise continuous integration (CI). Bitrise automatically builds and tests the app every time a new commit is pushed to this repo. Our Bitrise build logs are also public here.

master develop
Build Status Build Status

What is Berkeley Mobile?

Created in 2012, Berkeley Mobile has acculumated over 20,000 downloads on iOS and Android and currently has about 2,000 Monthly Active Users (MAUs). It has Bear Transit routes, library and gym information, dining hall menus, and campus resources, all in one place for the busy Berkeley student. The mission of Berkeley Mobile is to use cool technology to help students navigate Berkeley. You can download Berkeley Mobile on the Google Play Store or the App Store.

Berkeley Mobile is a product of the Associated Students of University of California (ASUC) Office of the Chief Technology Officer (OCTO) and is not affiliated with the University of California, Berkeley or the Regents of the University of California.

Documentation

For documentation, check out our wiki.

The application consists of six modules:

  • Controllers: Retrofit configuration and some legacy controllers that fetch JSON for map data.
  • Fragments: fragments populating various UI elements
  • Activity: the main screens (e.g. Open*Activity.java)
  • Models: data models including POJO for Retrofit
  • Responses: POJO for Retrofit responses with deeper structure
  • Utilities: some misc. utilities, most are deprecated

Getting set up

It is recommended you use Android Studio 3.0.0.

APIs

  • Create a new project in the Google Cloud Console
    • Under the APIs and Services tab, enable the Google Places API for Android, Google Maps Directions API, Google Maps Android API, and Google Maps Geocoding API
    • Under the Credentials tab, create an API key
    • Paste your API key into secret.xml
  • We've configured this repository so that the application pulls from our sandbox backend, which just returns test data. If you would like access to our production backend API, please contact us.

Contributing contributions welcome

Check out this repository's issues for a list of potential projects. You can also add issues to report bugs or suggest new features. If you plan to work on an issue, please assign yourself to the issue.

See CONTRIBUTING.md for more information.

Contact

You can contact the Berkeley Mobile team at octo.berkeleymobile@asuc.org with any questions.

License

This project uses the Educational Community License (ECL) 2.0. See LICENSE.md for more information.