{"id":13774078,"url":"https://github.com/gs-ts/TrackMyPath","last_synced_at":"2025-05-11T06:32:10.095Z","repository":{"id":55018654,"uuid":"196276242","full_name":"gs-ts/TrackMyPath","owner":"gs-ts","description":"An Android app written in Kotlin that demonstrates a clean architecture with MVVM, Fused Location Provider, LifecycleService, and Coroutines. It is used as lab to test new Android features.","archived":false,"fork":false,"pushed_at":"2021-01-14T20:47:08.000Z","size":3885,"stargazers_count":70,"open_issues_count":1,"forks_count":13,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-08-03T17:10:52.710Z","etag":null,"topics":["android","android-location","clean-architecture","coroutines","flickr","flickr-api","foreground-service","fusedlocationproviderclient","hilt","hilt-android","koin","kotlin","kotlin-coroutines","lifecycle-service","livedata-viewmodel","moshi","mvvm","retrofit2","room","viewbinding"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gs-ts.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-07-10T21:18:17.000Z","updated_at":"2024-08-03T16:58:42.000Z","dependencies_parsed_at":"2022-08-14T09:10:49.510Z","dependency_job_id":null,"html_url":"https://github.com/gs-ts/TrackMyPath","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gs-ts%2FTrackMyPath","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gs-ts%2FTrackMyPath/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gs-ts%2FTrackMyPath/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gs-ts%2FTrackMyPath/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gs-ts","download_url":"https://codeload.github.com/gs-ts/TrackMyPath/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225021976,"owners_count":17408525,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-location","clean-architecture","coroutines","flickr","flickr-api","foreground-service","fusedlocationproviderclient","hilt","hilt-android","koin","kotlin","kotlin-coroutines","lifecycle-service","livedata-viewmodel","moshi","mvvm","retrofit2","room","viewbinding"],"created_at":"2024-08-03T17:01:23.501Z","updated_at":"2024-11-17T09:30:31.620Z","avatar_url":"https://github.com/gs-ts.png","language":"Kotlin","readme":"\u003cimg src=\"/screenshots/summary.png\" width=\"900\"\u003e\n\n# Track my path\n\nAn android app that tracks your walk with images every 100 meters: \n- images fetched from Flickr based on location \n- pictures are shown in a list, and user can scroll through the stream\n- one button start/stop, on each start the previous stream of photos gets wiped\n- when the app is removed from background and user has not stopped the tracking, the tracking continues in a service\n\n*Please create a Flickr account and use your own api key. Add it in the FlickrApi file.*\n\n---\n\n### MVVM pattern with Clean architecture developed with Kotlin.\nClean architecture consists of three layers:\n- **Data**, includes data objects, databases, network clients, repositories.\n- **Domain**, includes use cases of business logic. This layer orchestrates the flow of data from Data Layer to Presentation and the other way.\n- **Presentation**, includes UI related components, such as ViewModels, Fragments, Activities.\n\n##### Android Jetpack Components used:\n- Fragment\n- ViewModel\n- [LifecycleService](https://developer.android.com/reference/androidx/lifecycle/LifecycleService)\n- View Binding\n- LiveData \n- Room\n- [Location](https://github.com/googlesamples/android-play-location/tree/master/LocationUpdatesForegroundService)\n- [ActivityScenario](https://developer.android.com/guide/components/activities/testing), instrumentation testing (part of AndroidX Test) \n- Espresso (UI tests)\n\n##### Libraries:\n- [Koin](https://insert-koin.io/), (in master branch) an easy-to-use DI framework. [Nice comparison with Dagger](https://medium.com/@farshidabazari/android-koin-with-mvvm-and-retrofit-e040e4e15f9d)\n- [Hilt](https://developer.android.com/training/dependency-injection/hilt-android) (in [feature-hilt-di branch](https://github.com/gs-ts/TrackMyPath/tree/feature-hilt-di)) a DI library for Android based on Dagger\n- [Kotlin Coroutines](https://developer.android.com/kotlin/coroutines)\n- [fresco](https://github.com/facebook/fresco), an Android library for managing images and the memory they use\n- [Retrofit](https://square.github.io/retrofit/)\n- [OkHttp](https://square.github.io/okhttp/)\n- [moshi](https://github.com/square/moshi), JSON library for Kotlin and Java \n- [Timber](https://github.com/JakeWharton/timber), a logger which provides utility on top of Android’s Log class\n- [detekt](https://github.com/detekt/detekt), Static code analysis for Kotlin\n\n##### Flickr API:\n- [flickr.photos.search](https://www.flickr.com/services/api/flickr.photos.search.html)\n\nSources:\n- [Google I/O 2018 app — Architecture and Testing](https://medium.com/androiddevelopers/google-i-o-2018-app-architecture-and-testing-f546e37fc7eb)\n- [Clean Architecture of Android Apps with Practical Examples](https://rubygarage.org/blog/clean-android-architecture)\n- [Clean Architecture Guide (with tested examples): Data Flow != Dependency Rule](https://proandroiddev.com/clean-architecture-data-flow-dependency-rule-615ffdd79e29)\n\n----\n\n### Screenshots\n\n\u003cimg src=\"/screenshots/scrn1.png\" width=\"260\"\u003e\n","funding_links":[],"categories":[":art: Pattern"],"sub_categories":["MVVM"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgs-ts%2FTrackMyPath","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgs-ts%2FTrackMyPath","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgs-ts%2FTrackMyPath/lists"}