JeopardyApp

This repository and website will house all of the code for our group’s Jeopardy android project, as well as some content for marketing the application.

This app is an Android game featuring mechanics from the popular TV show Jeopardy!

It will feature 3 distinct modes:

• Solo: A player will choose from 3 different difficulty CPU oppenents, and play a standard game of Jeopardy against them.
• Multiplayer: Players can play against friends or others online using mathmaking through Firebase.
• Endless: Random clues are shown to the player, and their aim is to get as many answers correct in a row as possible.

External Requirements

In order to run this on your laptop, you must have some form of Android emulator, preferably via Android Studio.

To run on an Android device, you will simply need an up to date Android OS and a way to install the APK.

Running

To run the app, simply install the application on your android device or emulator, either through the repository or the provided APKs.

Deployment

To run on an emulator, you can simply clone the repo locally, build the project using the top toolbar, and run using the toolbar as well.

To run on a local device, enable USB debugging on your device and then connect via USB. Once connected, run via the top toolbar.

Testing

For our behavioral/instrumental tests, they can be found in the following destination: JeopardyGroup/app/src/androidTest/java/com/example/jeopardy/

The behavioral test checks the functionality of the MainActivity screen, which is our home/landing page. This test launches the app, then tests that the home screen is shown, and that each button for navigation is correctly displayed.

As far as unit tests, they are stored here: JeopardyGroup/app/src/androidTest/java/com/example/jeopardy/MainActivityTest.kt

The unit tests for the application test that the constructors for each element of the Clue object/class work properly. Each getter and setter is tested with a test value to ensure everything is functional.

Testing Technology

All testing was developed in Android Studio IDE. TestProject was experimented with, but implementation was not completed. The tests can be ran in most IDEs, but Android Studio is preferred.

Running Tests

To run Unit tests, simply load the project into your IDE and run the unit tests through the ClueTest Java class.

To run Behavioral tests, simply load the project into your IDE with a paired emulator, and run the tests through the IDE via the MainActivityTest kotlin class.

Authors

Josh Caney - jcaney@email.sc.edu / josh.caney2000@gmail.com

Caitlynn Jones - caj16@email.sc.edu / carrotcait99@outlook.com

John Schlotterbeck - schlottj@email.sc.edu

Juan Mariscal - mariscal@email.sc.edu

Screenshots

Demo Video

https://user-images.githubusercontent.com/80352010/165214396-64662f62-6a5e-4d58-ae5d-e438cf162b98.mp4

https://www.youtube.com/watch?v=_q565gIuKS0