/android

Amahi Android App

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

Amahi Amahi Android App

Get it on Google Play

Build Status Twitter #amahi on Freenode

This repository contains the source code for the Amahi Android app.

You will need JDK 1.8+ installed to work with it. Gradle, Android SDK, and project dependencies will be downloaded automatically.

Building the app

  1. Set API information.
$ vim api.properties
url.amahi = URL
url.proxy = URL
client.id = ID
client.secret = SECRET
chromecast.app.id = APP_ID

This is something to keep private and you obtain it by sending a message to support@amahi.org.

  1. Build the application using a command line or using GUI.
$ ./gradlew clean assembleDebug
  1. Once you have built the application, you will be needing credentials to use the application. Go to Amahi website and create your account, once the account is activated, you will see the description on how to set up the Amahi server. However, this is not strictly needed, as we have a set up of a demo server called "Welcome to Amahi" which you should see even without your own server installed.

Code Style Convention

  • Set the Code Style Scheme to Default in Android Studio settings.
  • Run Reformat Code on changed files before committing.
  • Please check out the Code Style for Contributors section in AOSP and maintain as much consistency with them as possible.

Generating the documentation

  1. Install Android documentation.
$ android update sdk --no-ui --force --all --filter doc-21
  1. Generate the documentation.
$ ./gradlew clean assembleDebug generateDebugJavadoc

Debugging

  • For debugging the APIs and logging requests and responses you can either use Logcat on Android Studio or enable Chuck Interceptor (UI based) from the steps given here.

  • To debug with some special purpose server, you can find steps here.