This sample Android app presents the Giphy trending animated gifs for sharing or download. You can now also search animated gifs by keyword. It was elaborated from the work by Fahri Can in Nov 2021. I migrated the codebase from RxJava to Coroutines, and then from XML Views to Jetpack Compose. The current release is completely different from the original version after these years.
The XML View version is no longer being maintained. You can check out the XML View version branch for that. It was using XML with Data-binding, which we generally believe it to be a bad coding practice by tightly coupling the business logic with the UI.
If you want to try out the app without building it, check out the Releases section where you can find the APK and App Bundles for each major version. A working Giphy API key was applied when building the app, therefore you can test it by just installing it.
Planned enhancements are now logged as issues.
- Kotlin
- MVVM & clean architecture
- Jetpack Compose - Single Activity
- Kotlin Coroutines and Flow
- Dependency Injection using Dagger Hilt
- Material 3 dynamic colour theming supporting light and dark modes
- Dynamic screen layout support using Windows Size Class
- Gradle Kotlin DSL and Version Catalog
- Macrobenchmark and Baseline Profile
- Full unit test and UI (Journey) test suite
- Jetpack Compose - Modern toolkit for building native UI
- Jetpack Navigation for Compose - Navigation library for Jetpack Compose applications
- Jetpack Lifecycle - Lifecycle-aware components, including ViewModel support for Jetpack Compose
- Jetpack PreferencesDataStore - Data storage solution
- Kotlin Coroutines - Asynchronous programming with coroutines
- Kotlin Flow - Reactive streams for Kotlin
- Jetpack Room - Database library for local data storage
- Retrofit2 - HTTP client for Android and Java
- Moshi - Modern JSON library for Android and Java
- Splash Screen API - Official backward compatible splash screen
- Coil - Image loading library for Android, leveraging Kotlin Coroutines
- Dagger Hilt - Dependency injection framework
- Timber - Logging utility
- LeakCanary - Memory leak detection tool
JUnit 4
- Testing framework and runner- Espresso - UI testing framework for Android
- UI Automator - UI testing framework for user interaction automation
- Robolectric - Testing framework for Android-JVM tests
- kotest - We use the assertion library only, not the runner
- MockK - Mocking library for Kotlin
- Ktlint Gradle - Plugin for linting and formatting Kotlin code
- Kover - Kotlin code coverage tool
- Github Action - CI/CD
- codecov - code coverage
- Android Studio Iguana | 2023.2.1
- Android device or simulator running Android 9+ (API 28)
- To build the app by yourself, you need your own Giphy API Key
Release builds will be signed if either the keystore file or environment variables are set. Otherwise, the app will be built unsigned and without the Giphy API key installed, which will not pull any data from the endpoint.
-
Android Keystore is not being stored in this repository. You need your own Keystore to generate the apk / App Bundle
-
If your project folder is at
/app/giphy-trending/
, the Keystore file andkeystore.properties
should be placed at/app/
-
The format of
keystore.properties
is:store=/app/release-key.keystore alias=<alias> pass=<alias password> storePass=<keystore password> giphyApiKey="<your API Key here>"
-
This project has been configured to support automated CI builds.
-
The following environment variables have been set to provide the keystore:
BITRISE = true HOME = <the home directory of the bitrise environment> BITRISEIO_ANDROID_KEYSTORE_PASSWORD = <your keystore password> BITRISEIO_ANDROID_KEYSTORE_ALIAS = <your keystore alias> BITRISEIO_ANDROID_KEYSTORE_PRIVATE_KEY_PASSWORD = <your keystore private key password> GIPHYAPIKEY= <your API Key>
This app has two build variants: Debug
and Release
. The most common build commands are:
./gradlew clean installDebug
./gradlew clean instal
./gradlew clean bundleRelease
./gradlew clean assembleRelease
The generated apk(s) will be stored under app/build/outputs/
Nothing is free in this world. RW MobiMedia UK Limited, a fully tax-paying entity in the UK, sponsors the infrastructure and development costs of this project.
Copyright 2024 RW MobiMedia UK Limited
This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
Under the terms of this license, you are free to:
- Share — copy and redistribute the material in any medium or format.
- Adapt — remix, transform, and build upon the material.
The licensing terms include the following stipulations:
- Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
- NonCommercial — You may not use the material for commercial purposes. Any commercial use is strictly prohibited without prior permission from RW MobiMedia UK Limited.
This work is provided "as is" without any warranties, and the licensing coverage is only applicable as long as the distribution or use is for non-commercial purposes.
For permissions beyond the scope of this license, please contact RW MobiMedia UK Limited.