UOITDCLibraryBooking

Build Healthcheck 🚑

branch	tests	deployment	coverage
master(beta):
prod:

Join Beta(Android)

Have a question? join our

Description

UOIDCLibraryBooking is an android app published to the Google Play Store.

It aims to streamline the booking of study rooms at the University of Ontario Institute of Technology/Durham College's library located in Oshawa, Ontario

History

Started as a pet project to learn Android Development in my spare time and was inspired by the frustration of using the current room booking system

https://rooms.library.dc-uoit.ca/uoit_studyrooms/calendar.aspx

It now has 350+ Installs with an average 4.9 ⭐ review score.

I decided to Open Source the project to see if anyone wants to contribute and learn some Android Development while they're at it

If you're interested in reading the frustrations/adventures of getting the project completed you can check out all the old articles on my blog

http://www.objectivetruth.ca

Happy Coding!

-Miguel

RoadMap/Milestones:page_with_curl:

View the Milestones here

Branch Map 🚨

prod = Code for the live Google Play Store App

master = Code for the Beta version.

To Opt-in to view the beta version on android click here

Warning: Beta may be unstable and crash at any time, but you can see latest changes

Architectural Design

See the wiki - architecture

Development Environment Setup

Existing IntelliJ installation (MacOSX)

IntelliJ is free for students. 📚

1. Install Android SDK

   Follow the instructions for Installing Android SDK choosing Stand-Alone SDK Tools

2. From the unzip directory, run /tools/android to launch the Android SDK Manager

   Ensure the following are installed to the latest:

   • Android SDK-Platform-tools (latest)

   • Android SDK Build-tools (latest)

   • Android N (API 24)

     SDK Platform (required)

     Rest of components (recommended)

   • Extras/Android Support Repository

   • Extras/Google Play Services

   • Extras/Google Repository

   • Extras/Intel x86 Emulator Accelerator (HAXM)

     If your OS supports it

3. Import the project to IntelliJ

   Select import project:

   

   Select the directory where you cloned the project:

   Learn how to clone a git project

   

   Select Gradle project:

   If you don't see Gradle, you may need to install the IntelliJ Gradle Plugin

   

   Select the following Gradle import settings (default Global Gradle Settings):

   You may need to set your Gradle JVM by pointing it to where Java is installed on your system. Run echo $(/usr/libexec/java_home) to find it

   

   Import all modules:

   

4. ❓❓❓❓

5. Profit 💥

Tests

Unit Tests with test Reports

./gradlew jacocoTestDebugUnitTestReport

Instrumentation Tests

Requires device or emulator running

./gradlew spoon

Code Pipeline

License

---

GNU General Public License v3.0