Android Template Project - Eugen Martynov
Why?
The idea to have project that is ready to clone and prototype. It is buildable, testable and understandable. More beyond it is on going documentation where we share stable dependencies, common components (Licences activity), latest findings for automation, etc.
General thought about project
The project start should be matter of seconds or minutes - check out, import to studio, run gradle. The first run require internet connection and time to download and install dependencies
The central point is gradle files. Everything that you're doing should be automated, downloaded, installed and available via gradle tasks
Project should be self contained - code convection, documentation, acceptance test should be part of project
Current support tasks from gradle
Assembling (with obfuscation and signing)
Unit testing with code coverage
Uploading to hockeyapp
Localisation
Jenkins jobs manipulaions
Dependcies versions check
Additional scripts
Our branching model is Gitflow. For every feature branch we use gradle-jenkins-plugin for creating/ updating and deleting jenkins job. We use custom way of working with translators (we know about services that make you life easier). So we have own ruby script to generate strings and it is wrapped in gradle with jruby plugin (you don't need to install ruby or gems manually, it will be done by gradle plugin). We distribute build to our QA and beta community through HockyApp. We use hockeyapp plugin to automate it. We work in scrum and every iteration start we update our dependencies to have time verify them. We use gradle versions plugin to automate report about updates.
Overview
The minimal setup contains three modules - java library, android library, android application. App module depends on libraries, and android library has only dependency to java library. Java library is core functionality and should not have any notion about environment and implementation details.
Plugins definition and all depencnies versions are specified in roo project build.gradle. There also application of common plugins for projects - dependency checks and code coverage. gradle.properties is used only for gradle run parameters - daemon and parallel build for us.
Code also holds our pattern for our logic separation (Presenter, View, ModelView, wire within Activities and Fragments).
Current setup
Java 7
Gradle 2.4
Android gradle plugin 1.2.3
Dependency Injection
Dagger 2
Testing
Robolectric 3
Mockito
Android AssertJ
Other
OrmLite
EventBus
Android Annotations (we use them a lot)
License dialog (we partialy use it)
Future
Add acceptance tests (calabash, gradle tasks)
Migration to announced new android tools (android gradle plugin 1.3)
Speed imporvements over modules pre-dexing
Java 8 with RetroLambda
Idea in review
Kotlin
Groovy
Where can I get it
It is not public right now but should be soon. Please drop me email and I will update you. (available now at https://github.com/emartynov/android-template-project)
Contact
@jack_martynov
Last updated