PlantScan Android Project Repository 🤖

Lets identify Orchid flower around you! ~ A final project by Andi Irham

How to use 👣

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

Once created don't forget to update the:

• App ID
• AndroidManifest (here and here)
• Package of the source files

Features 🎨

• 100% Kotlin-only template.
• 4 Sample modules (Android app, Android library, Kotlin library, Jetpack Compose Activity).
• Jetpack Compose setup ready to use.
• 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.

Troubleshooting

For help with issues which you might encounter when using this template, please refer to TROUBLESHOOTING.md

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 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 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, just make sure that you turn on the "Read and Write permissions" on the Action Settings of your repository.

There are currently the following workflows available:

• Validate Gradle Wrapper - Will check that the gradle wrapper has a valid checksum
• Pre Merge Checks - Will run the build, check and publishToMavenLocal tasks.
• Publish Snapshot - Will publish a -SNAPSHOT of the libraries to Sonatype.
• Publish Release - Will publish a new release version of the libraries to Maven Central on tag pushes.

Project Structure

This project structure was inspired from Now in Android repository. 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.
• library-compose: The source for a UI library with Jetpack Compose library.

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

• buildSrc: Contains shared Gradle logic as precompiled script plugins
• config: Contains the Detekt configuration file.
• gradle: Contains Gradle Configuration files such as the Gradle Version Catalog and the Gradle Wrapper.

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

• .github: Defines the Github Actions CI tasks and templates for new pull requests, issues, etc.
• .idea: Sets common initial project settings when the project is opened in Android Studio or IntelliJ IDEA.

Contributing 🤝

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