DRUG App

Heavy development

License

• Apache Version 2.0

Copyright 2013 Piotr Niełacny Copyright 2012 Donn Felker Copyright 2012 GitHub Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the 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/donnfelker/tools/android-sdk

After satisfying those requirements, the build is pretty simple:

• Run mvn clean package from the app 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 DRUG from your device and you will then be able to install your own built version.

Acknowledgements

DRUG is a result of a template project I've developed over the years as well as a combination of a lot of great work that the GitHub Gaug.es app and GitHub Android app showcased. Some fo the code in this project is based on the GitHub Gaug.es and GitHub Android app.

DRUG 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 fragments and NineOldAndroids for view animations - all from 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.
• http-request for interacting with remote HTTP resources (API's in this case).
• google-gson for consuming JSON and hydrating POJO's for use in the app.

Contributing

Please fork this repository and contribute back using

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.

I hope this helps you in building your next android app.