MuchContact / tarcle-tdd

Android Bootstrap App build with unit test, integration test and functional test.

TarcleTDD

Tarcle is a personal project which tries to develop modern android app using the traditional TDD practice. The app itself is build based on Android Lollipop using many popular Library, such as Retrofit, ButterKnife, Picasso, since we try to build a agile android project and has a fast iteration.

With the effort from Google and a lot of open source project contributors, Android itself finally begin to use TDD way to develop. Continuous Iteration, Test Driven Development, Unit Test, Integration Test, Functional Test. Android is more friendly to its developer.

In this app, we use Robolectric for unit test, and Espresso for integration test, moreover we use Calabash Android for functional test.

To make Roblectric coexist with Espresso, thanks the effort of Android Unit Test Support and Deckard Gradle.

Welcome to begin your Android Development Tour.

Provision

1. Upgrade your AndroidStudio, currently the new working version is 1.1.0.
2. Use the latest Android Build Tools, make sure the version is no smaller than 1.1.0.
3. Integration Test need to install the app in device, If your Genymotion didn't work, maybe install Android Emulator is your new choice, which is faster with the support of Intel HAXM.
4. To enable calabash-android, Ruby is needed. See more details.

Run Test

• Run unit test, which is located in app/src/test directory, mainly written with features of Robolectric.

./gradlew test

• Run integration test, which is located in app/src/androidTest directory, mainly written by Espresso.

./gradlew connectedAndroidTest

Reference

• Retrofit Document
• Picasso Document
• ButterKnife Document
• Robolectric Document
• Espresso Document
• Calabash README
• AssertJ Document

Copyright

The MIT License (MIT)

Copyright (c) 2015 gongmingqm10

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.