android-trinity

Introduction: android-trinity is tiny proactive framework with much of the scaffolding code required to start a new Android Application.
More: Author   ReportBugs   OfficialWebsite   
Tags:

This is tiny framework with much of the scaffolding code (with some nice utilities and prepared source code) required to start a new Android Application.

Background

Yes, android studio might create a project for you, but there are missing parts, which I ALWAYS end up adding to every single project I create. This tiny Framework (I would say still scaffolding code) aims to solve this by making easy and fast to create an android project with the fundamental building blocks. Check the TODO section below for more information on the evolution and progress.

What does android-trinity provide?

Freedom. It uses standard tools but organized in such a way that facilitates android development. You can refactor or change anything but the idea is to have a robust starting point. All the wiring is done for you with the flexibility of being modified according to your needs.

What does android-trinity NOT INCLUDE? (likely to change if necessary in future versions)

  • DI. You should choose your Dependency Injection Framework.
  • N0 Navigation Framework.
  • NO LiveData and ViewModel libraries since some Engineers might use other approaches at UI level like MVI, MVP, etc.
  • NO Kotlin Flow.
  • NO UI Layouts for Tablet or Android TV support.

Pre-defined Gradle Tasks

  • ./gradlew runStaticAnalysis
  • ./gradlew runTestCoverage
  • ./gradlew runUnitTests
  • ./gradlew runAcceptanceTests
  • ./gradlew compileApp
  • ./gradlew runApp

How to use it

At the time being there are a couple of manual steps involved since we are at a very early stage. But we believe in sofware evolution right? So stay tuned and check both the How to Contribute and TODO List sections.

  • STEP 1: Clone this repo.
  • STEP 2: Delete the .git folder so you can add your files to any repo of your own.
  • STEP 3: Import the project in Android Studio
  • STEP 4: Rename packages if you need. com.fernandocejas.sample by default.

Using Test Helpers

Let's say you want to write tests (and you should ALWAYS do), As mentioned there are 3 classes which come into play and here examples of their usage:

  • UnitTest.kt: Unit Test base class which setup mocks for you (You only use the @Mockk annotation)
class FeatureFlagTest : UnitTest() {

    @Mockk prival val yourMock

    @Test
    fun `given a feature flag, when it is activated, then executes given logic block`() {
        val activeFlag = ActiveFeatureFlag()
        val fakeNavigator = mockk<Navigator>(relaxed = true)

        activeFlag whenActivated {
            fakeNavigator.doSomething()
            fakeNavigator.navigateToActiveFeature()
            fakeNavigator.doSomething()
        }

        verify(exactly = 1) { fakeNavigator.navigateToActiveFeature() }
        verify(exactly = 2) { fakeNavigator.doSomething() }
    }
  • AndroidTest.kt: Integration Test base class which setup mocks for you (You only use the @Mockk annotation). You might use this classes when they are Android Components involved. It is backed up by Robolectric.
class YourTestClass : AndroidTest() {

    @Mockk prival val yourMock

    @Test
    fun `given something, when something happens, then do something`() {
        TODO()
    }
  • AcceptanceTest.kt: UI Test base class which setup Espresso for you
class MainActivityTest: AcceptanceTest(MainActivity::class.java) {

    @Test
    fun checkToolBarTest() {
        onView(withId(R.id.toolbar)).check(matches(isDisplayed()))
    }
}

Feature Flags

Android-trinity includes a simple offline feature flags framework with a very simple api generated at compile time. If you want more information, refer to the introduced pull request. (TODO: Add more documentation)

Example of its usage:

Flag.Hello whenActivated { displayGreeting(R.string.hello) }

Quality Reports: Static Analysis

Quality Reports: Code Coverage

  • The tool chosen here is Jacoco due to its nature and popularity in the community.

TODO List

  • [ ] Gradle Tasks for Publishing to Google Play: App Bundles.
  • [ ] Automate the process from How to Use section: Idea: ./gradlew setupProject
  • [X] Local Feature Flags.
  • [ ] Rename default packages to io.android-trinity or io.android.trinity.
  • [ ] ???
  • [ ] ???

How to Contribute

Nothing is set in stone here and things can change and evolve based on the community work and requirements. So if you want to contribute, feel free to open an issue and label it properly: Bug, Enhancement, etc.. or send a PR. Please both with a good descriptions of the intention, in order to facilitate review

License

Copyright 2018 Fernando Cejas

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.

http://www.fernandocejas.com

Buy Me A Coffee

Apps
About Me
GitHub: Trinea
Facebook: Dev Tools