Gaug.es Android App
This repository contains the source code for the Gaug.es Android app available from Google Play.
Please see the issues section to report any bugs or feature requests and to see the list of known issues.
License
Building
The build requires Maven
v3.0.3+ and the Android SDK
to be installed in your development environment. In addition you'll need to set
the ANDROID_HOME
environment variable to the location of your SDK:
export ANDROID_HOME=/home/roberto/tools/android-sdk
After satisfying those requirements, the build is pretty simple:
- Run
mvn clean package
from theapp
directory to build the APK only - Run
mvn clean install
from the root directory to build the app and also run the integration tests, this requires a connected Android device or running emulator
You might find that your device doesn't let you install your build if you already have the version from the Android Market installed. This is standard Android security as it it won't let you directly replace an app that's been signed with a different key. Manually uninstall Gauges from your device and you will then be able to install your own built version.
Acknowledgements
Gaug.es for Android is built on the awesome Gauges API and uses many great open-source libraries from the Android dev community:
- ActionBarSherlock for a consistent, great looking header across all Android platforms, ViewPagerIndicator for swiping between content, traffic, & referrer pages, and NineOldAndroids for the AirTraffic view animations - all from the prolific Jake Wharton.
- RoboGuice for dependency-injection.
- Robotium for driving our app during integration tests.
- android-maven-plugin for automating our build and producing release-ready APKs.
Contributing
Please fork this repository and contribute back using pull requests.
Any contributions, large or small, major features, bug fixes, additional language translations, unit/integration tests are welcomed and appreciated but will be thoroughly reviewed and discussed.