Popularity
7.3
Growing
Activity
7.4
-
1,399
35
198

Description

A simple Github template that lets you create an Android/Kotlin project and be up and running in a few seconds.

This template is focused on delivering a project with static analysis and continuous integration already in place.

Programming language: Kotlin
License: MIT License
Tags: Kotlin     Android     Gradle     Template     Github     Dsl     App Development     Kotlin For Android    

kotlin-android-template alternatives and similar packages

Based on the "Kotlin" category.
Alternatively, view kotlin-android-template alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of kotlin-android-template or a related project?

Add another 'Kotlin' Package

README

kotlin-android-template 🤖

Use this template Pre Merge Checks License Language

A simple Github template that lets you create an Android/Kotlin project and be up and running in a few seconds.

This template is focused on delivering a project with static analysis and continuous integration already in place.

How to use 👣

Just click on Use this template button to create a new repo starting from this template.

Once created don't forget to update the:

  • [App ID](buildSrc/src/main/java/Coordinates.kt)
  • AndroidManifest ([here](app/src/main/AndroidManifest.xml) and [here](library-android/src/main/AndroidManifest.xml))
  • Package of the source files

Features 🎨

  • 100% Kotlin-only template.
  • 3 Sample modules (Android app, Android library, Kotlin library).
  • Sample Espresso, Instrumentation & JUnit tests.
  • 100% Gradle Kotlin DSL setup.
  • CI Setup with GitHub Actions.
  • Publish to Maven Central with Github Actions.
  • Dependency versions managed via buildSrc.
  • Kotlin Static Analysis via detekt and ktlint.
  • Issues Template (bug report + feature request).
  • Pull Request Template.

Gradle Setup 🐘

This template is using Gradle Kotlin DSL as well as the Plugin DSL to setup the build.

Dependencies are centralized inside the Gradle Version Catalog in the [libs.versions.toml](gradle/libs.versions.toml) file in the gradle folder.

Static Analysis 🔍

This template is using detekt to analyze the source code, with the configuration that is stored in the [detekt.yml](config/detekt/detekt.yml) file (the file has been generated with the detektGenerateConfig task). It also uses the detekt-formatting plugin which includes the ktlint rules (see https://detekt.dev/docs/rules/formatting/).

CI ⚙️

This template is using GitHub Actions as CI. You don't need to setup any external service and you should have a running CI once you start using this template.

There are currently the following workflows available:

  • [Validate Gradle Wrapper](.github/workflows/gradle-wrapper-validation.yml) - Will check that the gradle wrapper has a valid checksum
  • [Pre Merge Checks](.github/workflows/pre-merge.yaml) - Will run the build, check and publishToMavenLocal tasks.
  • [Publish Snapshot](.github/workflows/publish-snapshot.yaml) - Will publish a -SNAPSHOT of the libraries to Sonatype.
  • [Publish Release](.github/workflows/publish-release.yaml) - Will publish a new release version of the libraries to Maven Central on tag pushes.

Publishing 🚀

The template is setup to be ready to publish a library/artifact on a Maven Repository.

For every module you want to publish you simply have to add the publish plugin:

plugins {
    publish
}

To Maven Central

In order to use this template to publish on Maven Central, you need to configure some secrets on your repository:

Secret name Value
ORG_GRADLE_PROJECT_NEXUS_USERNAME The username you use to access Sonatype's services (such as Nexus and Jira)
ORG_GRADLE_PROJECT_NEXUS_PASSWORD The password you use to access Sonatype's services (such as Nexus and Jira)
ORG_GRADLE_PROJECT_SIGNING_KEY The GPG Private key to sign your artifacts. You can obtain it with gpg --armor --export-secret-keys <[email protected]> or you can create one key online on pgpkeygen.com. The key starts with a -----BEGIN PGP PRIVATE KEY BLOCK-----.
ORG_GRADLE_PROJECT_SIGNING_PWD The passphrase to unlock your private key (you picked it when creating the key).

The template already sets up Dokka for project documentation and attaches -sources.jar to your publications, via the new AGP publishing DSL.

Once set up, the following workflows will take care of publishing:

  • [Publish Snapshot](.github/workflows/publish-snapshot.yaml) - To publish -SNAPSHOT versions to Sonatype. The workflow is setup to run either manually (with workflow_dispatch) or on every merge.
  • [Publish Release](.github/workflows/publish-release.yaml) - Will publish a new release version of the libraries to Maven Central on tag pushes. You can trigger the workflow also manually if needed.

To Jitpack

If you're using JitPack, you don't need any further configuration and you can just configure the repo on JitPack.

You probably want to disable the [Publish Snapshot] and [Publish Release](.github/workflows/publish-release.yaml) workflows (delete the files), as Jitpack will take care of that for you.

Project Structure

The project includes three sub-projects, each in their own subdirectories:

  • app: The source for the final Android application.
  • library-android: The source for an Android library including UI.
  • library-kotlin: The source for a UI-less Kotlin library.

The following additional top-level directories configure & support building the app & projects:

Finally, the following hidden top-level directories provide functionality for specific development systems:

Contributing 🤝

Feel free to open a issue or submit a pull request for any bugs/improvements.


*Note that all licence references and agreements mentioned in the kotlin-android-template README section above are relevant to that project's source code only.