Skip to content

Repository for the final project of CS522 @ UIC Fall '23

Notifications You must be signed in to change notification settings

utsavns96/campus_cruise

Repository files navigation

Campus Cruise

Repository for the final project of CS522 @ UIC Fall '23

A ridesharing application for university students

Installing the Application

This app is currently deployed for Android 13 and up, and thus requires a device that meets those specifications.
To install the application on an android device:

  1. Download the apk file from the repository to the device.
  2. Navigate to the location with the .apk file and tap on it.
  3. If the user has not installed an application from an 'Unknown Source' before this, the device will pop up an alert that asks the user to enable Install from Unknown Sources. The exact mechanism of performing this action varies by manufacturer.
    On Samsung devices (the device used during development), if the user navigates to the .apk from the My Files application, the device asks the user to enable the option for Install from Unknown Sources for the My Files application.
  4. Once the user has given the required permission, the app will install and be available to launch from the app drawer.

Launching the application for debugging

To use the application in debugging mode, the user needs to have Android Studio installed, with Android SDK 33, and the plugins for Flutter and Dart.

  1. Clone the git repo.
  2. Launch Android Studio and open the project.
  3. Either create a virtual device or connect an android device. Please note - a physical device being used for debugging must have it's developer settings enabled, and needs USB Debugging to be turned on.
  4. Launch the application from login.

A note about live tracking:

Since we are only focussing on the user side of the application, the backend required to monitor a driver does not exist yet. Therefore, to simulate tracking of the van when viewing the Shuttle Locator and Book A Ride screens, we use a GPS Emulator application. These are freely available on the playstore, and allow users to create routes along which they can simulate the movement of a gps signal. The app that we use is available here: https://play.google.com/store/apps/details?id=com.rosteam.gpsemulator&hl=en&gl=US

About

Repository for the final project of CS522 @ UIC Fall '23

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published