Development

API Key

To run the application you need to supply an API key from TMBD. When you get the key please add following variable to your local environment:

API_KEY_TMDB = Your API Key

How to set an environment variable in Mac / Windows

Code style *

To maintain the style and quality of the code, are used the bellow static analysis tools. All of them use properly configuration and you find them in the project root directory config/.{toolName}.

Tools	Config file	Check command	Fix command
detekt	.detekt.yml	./gradlew detekt	-
ktlint	-	./gradlew ktlint	./gradlew ktlintFormat
spotless	-	./gradlew spotlessCheck	./gradlew spotlessApply
lint	.lint.xml	./gradlew lint	-
gradle versions plugin	-	./gradlew dependencyUpdates	-

All these tools, except Gradle Versions Plugin, are integrated in pre-commit git hook, in order ensure that all static analysis and tests passes before you can commit your changes. Gradle Versions Plugin can be run optionally. To skip them for specific commit add this option at your git command:

git commit --no-verify

It's highly recommended to fix broken code styles. There is a gradle task which execute ktlintFormat and spotlessApply for you:

./gradlew reformat

The pre-commit git hooks have exactly the same checks as CircleCI and are defined in this script. This step ensures that all commits comply with the established rules. However the continuous integration will ultimately be validated that the changes are correct.

If you want to know more about naming convention, code style and more please look at our Android guideline repository.

Architecture

• Single Activity
• MVVM Pattern

View: Renders UI and delegates user actions to ViewModel

ViewModel: Can have simple UI logic but most of the time just gets the data from UseCase

UseCase: Contains all business rules and they written in the manner of single responsibility principle

Repository: Single source of data. Responsible to get data from one or more data sources

Tech Stack

Dependencies

• Navigation Component: Consistent navigation between views
• LiveData: Lifecycle aware observable and data holder
• ViewModel: Holds UI data across configuration changes
• Databinding: Binds UI components in layouts to data sources
• Dagger: Dependency injector
• Coroutines: Asynchronous programming
• Glide: Image loading and caching
• Lottie: JSON based animations
• Retrofit: Type safe HTTP client
• Moshi: JSON serializer/deserializer
• Room: Object mapping for SQLite
• Paging3: Load and display pages of data

Plugins

• Detekt: Static code analysis for Kotlin
• Spotless: Keep your code spotless
• Ktlint: Kotlin linter
• Lint: Static program analysis tools
• Gradle Versions Plugin: Dependency version controller

License

Copyright 2020 adesso Turkey

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.