Skip to content

Devsoc-BPGC/ARD

Repository files navigation

ARD Android Companion

Build Status Codacy Badge codebeat badge codecov Dependency Status GitHub pull requests label

GitHub contributors Slack

This app runs on Android OS version above and including Lollipop (API 21).

Project uses the following CIs

Travis CI for testing. Travis CI reports can be found here.

Codecov for coverage. Reports here.

VersionEye to keep track of dependencies.

Project follows the naming convention mentioned here and here. Before starting contributions please make sure you are thorough with this convention. If you have any suggestions that you would like to share or want to report a bug, use the Issues tab.

For any issues faced during installations, head over to Slack.

Project hosted under Mobile Applications Club, BITS Goa

Project Setup and Build Instructions

Requirements

  • Android Studio 2.3 or above
  • Android SDK Tools 26.0.0 or above
  • Android SDK Platform-tools 26.0.2 or above
  • Android SDK Build-tools 26.0.0 or above
  • Extras (in SDK Manager)

Installation

  1. Fork this repository to your account on GitHub

  2. Clone to your local storage using git. Open a terminal and paste

git clone https://github.com/yourusername/ARD.git
  1. Open Android Studio and click Open > Navigate to ARD folder > Press Select

  2. In android studio console execute

git remote add upstream https://github.com/MobileApplicationsClub/ARD

Contributing

See .github/CONTRIBUTING.md.

If you're not proficient with git, it'll be better if you follow .github/git-workflow.md.

Build and Test

While normal (manual) testing, you can run the app using app configuration in Android Studio.

However, we consider code coverage data to assess PR. Which means you will have to write tests that cover as much portion of your patch as possible. To evaluate the tests and see the coverage stats locally, do following:

./gradlew clean build coverage

If all goes well, reports will be generated at app/build/reports directory.