/SuperDuo

This project makes two apps - Alaxandria and Football Scores production ready.

Primary LanguageJava

#Super Duo

##Overview

This project productionized two apps :

Alexandria: A book list and barcode scanner app which allows to manually enter or scan ISBN numbers.

Screenshot1 ![Screenshot2] (https://cloud.githubusercontent.com/assets/15085932/13896920/bab799f0-edc4-11e5-9d1e-dbc85363150e.png)

Football Scores: An app that tracks current and future football matches of popular football leagues. Widgets are provided to add to the user experiences

Screenshot1 Screenshot2

Error Cases handled were :

  • Diagnose existing issues with an app.

  • Make an app accessible to sight-impaired users.

  • Allow your app to be localized for distribution in other countries.

  • Handle error cases in app.

  • Add a widget to your app experience.

  • Leverage the functionality of a library in your app.

For further details see Guidelines

##Prerequisites

  • The app is built with compileSdkVersion 21 and requires JDK 7 or higher

  • Android Studio

Additional Requirements for Alaxandaria

  • Used libraries like Butterknife,Zxing for scanning ISBN numbers, Glide for image loading and caching, dependencies for which are added in SuperDuo/superduo/Alexandria_Code/alexandria/build.gradle like :

    compile 'com.journeyapps:zxing-android-embedded:3.0.2@aar'

    compile 'com.google.zxing:core:3.2.0'

    compile 'com.jakewharton:butterknife:7.0.1'

    compile 'com.github.bumptech.glide:glide:3.6.1'

Additional Requirements for Football Scores

  • To get football match scores/schedule, you will need API key from Football-data.org.

In your request for a key, state that your usage will be foreducational/non-commercial use. You will also need to provide some personal information to complete the request. Once you submit your request, you should receive your key via email shortly after.

  • Once you obtain your key, in your SuperDuo/superduo/Football_Scores-Starting/Football_Scores-master/app/src/main/res/values/strings.xml,

    <string name="api_key" translatable="false"></string>

  • Used Butterknife library as well.

##Instructions

###Get the source codes

Get the source code of the library and example app, by cloning git repository or downloading archives.

  • If you use git, execute the following command in your workspace directory.

    $ git clone https://github.com/Ruchita7/SuperDuo.git

  • If you are using Windows, try it on GitBash or Cygwin or something that supports git.

###Import the project to Android Studio

Once the project is cloned to disk you can import into Android Studio:

  • From the toolbar select File > Import Project, or Import Non-Android Studio project from the Welcome Quick Start.

  • Select the directory that is cloned. If you can't see your cloned directory, click "Refresh" icon and find it.

  • Android Studio will import the project and build it. This might take minutes to complete. Even when the project window is opened, wait until the Gradle tasks are finished and indexed.

  • Connect your devices to your machine and select app from the select Run/Debug Configuration drop down.Click the Run button

###Build and install using Gradle

If you just want to install the app to your device, you don't have to import project to Android Studio.

• After cloning the project, make sure ANDROID_HOME environment variable is set to point to your Android SDK. See Getting Started with Gradle.

• Connect an Android device to your computer or start an Android emulator.

• Compile the sample and install it. Run gradlew installDebug. Or if you on a Windows computer, use gradlew.bat instead.

###Contributing

Please follow the "fork-and-pull" Git workflow while contributing to this project

Fork the repo on GitHub

Commit changes to a branch in your fork

Pull request "upstream" with your changes

Merge changes in to "upstream" repo

NOTE: Be sure to merge the latest from "upstream" before making a pull request!

###FAQs

The project can no longer be compiled/imported if I move it to another directory

I typically include the dependencies in the repo and have them already linked, so if you move the project you'll need to also update the path to the dependency. To do this, modify the project.properties file of the project

I'm getting an error saying that there are multiple versions of a jar

To fix this, make sure that all the jars you are using conform to the same version. You can do this by just replacing all the problematic jars with the version you would like to use.