Starter

---

 

Motivation

Maintaining multiple multi-module Android project often requires copying project configuration across different projects. Even when project reaches more advanced stage it is still required to put non-minimal effort to maintain its configuration.
Starting a new project, from the scratch, takes more than a day to configure every tool you usually want to use. Sometimes people create template project or another way of keeping your project configuration in a good shape is using buildSrc plugins. Less code written, ease of sharing between projects but still some part of the code needed to be copied.

This project goes further and addresses that issue by exposing set of plugins useful when approaching multi-module setup with Gradle build system.

Content

Repository consists of several plugins that makes initial project configuration effortless and easily extensible. Each module consists of configuration code most commonly used in Android project configuration.

Module plugins

Kotlin Library Plugin

Plugin configures code style tasks, hooks for common tasks and manages versioning of the artifact

Apply plugin to project level build.gradle

plugins {
    id("com.starter.library.kotlin") version("x.y.z")
}

Multiplatform Library Plugin

For kotlin multiplatform libraries apply plugin to project level build.gradle

plugins {
    id("com.starter.library.multiplatform") version("x.y.z")
}

Android Application/Library Plugin

In addition to customizations made to Kotlin Library Plugin Android plugins tweaks default Android Gradle Plugin setup by disabling BuildConfig file generation or recognizing src/main/kotlin (and similar) path as a valid source set.

Android Library plugin requires adding to project level build.gradle:

plugins {
    id("com.starter.library.android") version("x.y.z") 
    // or id("com.starter.application.android") version("x.y.z") 
}

// overridden settings for single project
android {
    defaultConfig {
        minSdkVersion 21
    }
}

Day-to-day use

After applying Library/Application plugin following tasks become available:

• ./gradlew projectTest
  Runs tests for all modules using either predefined tasks (i.e. test for kotlin modules or testDebugUnitTest for android libraries) or use customized values.
• ./gradlew projectLint
  Runs Android lint checks against all modules (if custom lint checks are applied then for Kotlin modules too)
• ./gradlew projectCodeStyle
  Verifies if code style matches modern standards using tools such as ktlint, Detekt with predefined config.

Those tasks allow you to run tests efficiently for all modules by typing just a single task.

Standalone plugins

Quality Plugin

To only configure codestyle tools apply plugin to project level build.gradle

plugins {
    id("com.starter.quality") version("x.y.z") 
}

which applies and configures code style tasks for the project automatically.

Tasks available:

• ./gradlew projectCodeStyle - checks codestyle using all tools
• ./gradlew issueLinksReport - finds and check state of all issuetracker links linked in code comments

Quality Plugin gets applied automatically when using any of module Application/Library plugins above.

Versioning Plugin

Uses simple tag-based versioning, in a Configuration Cache compatible way.

To enable it as a standalone plugin, apply plugin to root project build.gradle

 apply plugin: 'com.starter.versioning'

Versioning plugin gets applied automatically when using any of module Application/Library plugins above and can be disabled using Global Configuration

Advanced usage

See Advanced usage

Sample project

Sample Github Browser project - a customized, buildSrc based plugin application.

License

The library is available under MIT License and highly benefits from binary dependencies:

• Kotlinter Gradle - License
• axion-relese-plugin - License
• Kotlin Gradle Plugin - License
• Android Gradle Plugin - License
• Detekt - License