itsandreramon / compose-maps-app

Android app that has been built as part of the Mobile User Experience course at the University of Applied Sciences Brandenburg.

Disclaimer

This application is a proof-of-concept that showcases the design of an app that connects to different services to combine the current Covid restrictions in a given federal state in Germany. The application has been built as part of the "Mobile User Experience" course at the University of Applied Sciences Brandenburg and is used for educational purposes only and not meant to be distributed in any form.

Stack

What	How
User Interface	Compose
Concurrency	Coroutines
Dependency Injection	Koin
State Management	Mavericks
Caching	Room
Networking	Retrofit

Instructions

This project uses Jetpack Compose and should be opened using Android Studio 2020.3.1 Arctic Fox or newer.

Decrypt secrets

$ export ENCRYPT_KEY=
$ ./scripts/decrypt_secrets.sh

Add Signing Config

// keystore.properties
debugKeyPassword=
debugStorePassword=

Add Google Maps API keys

// local.properties
MAPS_API_KEY=
MAPS_SERVICES_API_KEY=

compose-maps-app's Issues

Wait for Compose Beta 08 support in Koin

InsertKoinIO/koin#1098

Fix place details search state flicker

2021-07-24 12:45:58.065 21626-21626/? E/RouteViewModel: new state: SearchUiState(query=b, location=lat/lng: (52.2,13.4), searchedPlaces=[PlaceEntity(id=BAR, name=Barnim, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=EE, name=Elbe-Elster, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=2021-07-23T13:34:02.254Z), PlaceEntity(id=OHV, name=Oberhavel, type=landkreis, incidence=15.5, trend=0, website=https://www.oberhavel.de/, example=false, isBookmarked=true, searchedAtUtc=2021-07-21T17:07:05.156Z), PlaceEntity(id=OSL, name=Oberspreewald-Lausitz, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=BRB, name=Brandenburg an der Havel, type=landkreis, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=CB, name=Cottbus, type=landkreis, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BE, name=Berlin, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=BZ, name=Bautzen, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=ERZ, name=Erzgebirgskreis, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=PIR, name=Sächsische Schweiz-Osterzgebirge, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BB, name=Brandenburg, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null)])
2021-07-24 12:45:58.065 21626-21626/? E/RouteViewModel: old state: RouteState(uiState=SearchUiState(query=ber, location=lat/lng: (52.2,13.4), searchedPlaces=[PlaceEntity(id=OHV, name=Oberhavel, type=landkreis, incidence=15.5, trend=0, website=https://www.oberhavel.de/, example=false, isBookmarked=true, searchedAtUtc=2021-07-21T17:07:05.156Z), PlaceEntity(id=OSL, name=Oberspreewald-Lausitz, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BE, name=Berlin, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null)]))
2021-07-24 12:45:58.065 21626-21626/? E/RouteViewModel: new state: SearchUiState(query=ber, location=lat/lng: (52.2,13.4), searchedPlaces=[PlaceEntity(id=OHV, name=Oberhavel, type=landkreis, incidence=15.5, trend=0, website=https://www.oberhavel.de/, example=false, isBookmarked=true, searchedAtUtc=2021-07-21T17:07:05.156Z), PlaceEntity(id=OSL, name=Oberspreewald-Lausitz, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BE, name=Berlin, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null)])
2021-07-24 12:45:58.066 21626-21626/? E/RouteViewModel: old state: RouteState(uiState=SearchUiState(query=b, location=lat/lng: (52.2,13.4), searchedPlaces=[PlaceEntity(id=BAR, name=Barnim, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=EE, name=Elbe-Elster, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=2021-07-23T13:34:02.254Z), PlaceEntity(id=OHV, name=Oberhavel, type=landkreis, incidence=15.5, trend=0, website=https://www.oberhavel.de/, example=false, isBookmarked=true, searchedAtUtc=2021-07-21T17:07:05.156Z), PlaceEntity(id=OSL, name=Oberspreewald-Lausitz, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=BRB, name=Brandenburg an der Havel, type=landkreis, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=CB, name=Cottbus, type=landkreis, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BE, name=Berlin, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=BZ, name=Bautzen, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=ERZ, name=Erzgebirgskreis, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=PIR, name=Sächsische Schweiz-Osterzgebirge, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BB, name=Brandenburg, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null)]))
2021-07-24 12:45:58.066 21626-21626/? E/RouteViewModel: new state: SearchUiState(query=b, location=lat/lng: (52.2,13.4), searchedPlaces=[PlaceEntity(id=BAR, name=Barnim, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=EE, name=Elbe-Elster, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=2021-07-23T13:34:02.254Z), PlaceEntity(id=OHV, name=Oberhavel, type=landkreis, incidence=15.5, trend=0, website=https://www.oberhavel.de/, example=false, isBookmarked=true, searchedAtUtc=2021-07-21T17:07:05.156Z), PlaceEntity(id=OSL, name=Oberspreewald-Lausitz, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=BRB, name=Brandenburg an der Havel, type=landkreis, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=CB, name=Cottbus, type=landkreis, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BE, name=Berlin, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=BZ, name=Bautzen, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=ERZ, name=Erzgebirgskreis, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=PIR, name=Sächsische Schweiz-Osterzgebirge, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BB, name=Brandenburg, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null)])
2021-07-24 12:45:58.066 21626-21626/? E/RouteViewModel: old state: RouteState(uiState=SearchUiState(query=ber, location=lat/lng: (52.2,13.4), searchedPlaces=[PlaceEntity(id=OHV, name=Oberhavel, type=landkreis, incidence=15.5, trend=0, website=https://www.oberhavel.de/, example=false, isBookmarked=true, searchedAtUtc=2021-07-21T17:07:05.156Z), PlaceEntity(id=OSL, name=Oberspreewald-Lausitz, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BE, name=Berlin, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null)]))
2021-07-24 12:45:58.066 21626-21626/? E/RouteViewModel: new state: SearchUiState(query=ber, location=lat/lng: (52.2,13.4), searchedPlaces=[PlaceEntity(id=OHV, name=Oberhavel, type=landkreis, incidence=15.5, trend=0, website=https://www.oberhavel.de/, example=false, isBookmarked=true, searchedAtUtc=2021-07-21T17:07:05.156Z), PlaceEntity(id=OSL, name=Oberspreewald-Lausitz, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BE, name=Berlin, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null)])
2021-07-24 12:45:58.066 21626-21626/? E/RouteViewModel: old state: RouteState(uiState=SearchUiState(query=b, location=lat/lng: (52.2,13.4), searchedPlaces=[PlaceEntity(id=BAR, name=Barnim, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=EE, name=Elbe-Elster, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=2021-07-23T13:34:02.254Z), PlaceEntity(id=OHV, name=Oberhavel, type=landkreis, incidence=15.5, trend=0, website=https://www.oberhavel.de/, example=false, isBookmarked=true, searchedAtUtc=2021-07-21T17:07:05.156Z), PlaceEntity(id=OSL, name=Oberspreewald-Lausitz, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=BRB, name=Brandenburg an der Havel, type=landkreis, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=CB, name=Cottbus, type=landkreis, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BE, name=Berlin, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=BZ, name=Bautzen, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=ERZ, name=Erzgebirgskreis, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=PIR, name=Sächsische Schweiz-Osterzgebirge, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BB, name=Brandenburg, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null)]))
2021-07-24 12:45:58.066 21626-21626/? E/RouteViewModel: new state: SearchUiState(query=b, location=lat/lng: (52.2,13.4), searchedPlaces=[PlaceEntity(id=BAR, name=Barnim, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=EE, name=Elbe-Elster, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=2021-07-23T13:34:02.254Z), PlaceEntity(id=OHV, name=Oberhavel, type=landkreis, incidence=15.5, trend=0, website=https://www.oberhavel.de/, example=false, isBookmarked=true, searchedAtUtc=2021-07-21T17:07:05.156Z), PlaceEntity(id=OSL, name=Oberspreewald-Lausitz, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=BRB, name=Brandenburg an der Havel, type=landkreis, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=CB, name=Cottbus, type=landkreis, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BE, name=Berlin, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=BZ, name=Bautzen, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=ERZ, name=Erzgebirgskreis, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=PIR, name=Sächsische Schweiz-Osterzgebirge, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BB, name=Brandenburg, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null)])
2021-07-24 12:45:58.066 21626-21626/? E/RouteViewModel: old state: RouteState(uiState=SearchUiState(query=ber, location=lat/lng: (52.2,13.4), searchedPlaces=[PlaceEntity(id=OHV, name=Oberhavel, type=landkreis, incidence=15.5, trend=0, website=https://www.oberhavel.de/, example=false, isBookmarked=true, searchedAtUtc=2021-07-21T17:07:05.156Z), PlaceEntity(id=OSL, name=Oberspreewald-Lausitz, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BE, name=Berlin, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null)]))
2021-07-24 12:45:58.066 21626-21626/? E/RouteViewModel: new state: SearchUiState(query=ber, location=lat/lng: (52.2,13.4), searchedPlaces=[PlaceEntity(id=OHV, name=Oberhavel, type=landkreis, incidence=15.5, trend=0, website=https://www.oberhavel.de/, example=false, isBookmarked=true, searchedAtUtc=2021-07-21T17:07:05.156Z), PlaceEntity(id=OSL, name=Oberspreewald-Lausitz, type=landkreis, incidence=0.0, trend=0, website=, example=false, isBookmarked=false, searchedAtUtc=null), PlaceEntity(id=DE-BE, name=Berlin, type=bundesland, incidence=0.0, trend=0, website=, example=true, isBookmarked=false, searchedAtUtc=null)])

improve handling in view models when place is null

Review overview UI state not null check

https://github.com/itsandreramon/mux-rulona/blob/4d41fd48e5295ce64993fa770e7adb1757362c3b/ui/src/main/java/de/thb/ui/screens/places/PlaceDetailScreen.kt#L88

Move EditState callbacks into EditState class

Use Nested Navigation

disable Google Map view reload when navigating back and forth

Use Constructor Injection inside ViewModels for better testing

Use Mavericks async support

https://airbnb.io/mavericks/#/async

fix PlaceDetails back-navigation

improve caching

Make PlaceDetails in Route separate screen

align with PlacesScreen

Use Robolectric on CI

Compose Beta 09 can support Robolectric: android/compose-samples#556

Handle network errors

App Intro

Bei einigen App gibt es am Anfang 2-5 Slides, die man durch gehen kann. Alternativ gibt es unten rechts immer ein "überspringen"

Das zum Thema Anleitung vielleicht.

State gets corrupted after setting focus in search bar

Fix wrong usage of applicationScope inside repositories

applicationScope should only be used when altering the database.

override suspend fun getByIdOnce(id: String): PlaceEntity? {
    return withContext(dispatcherProvider.database()) {
        applicationScope.async {
            placesRoomDao.getByIdOnce(id)
        }.await()
    }
}

Use new Permissions API in Accompanist

https://google.github.io/accompanist/permissions/
https://github.com/android/compose-samples/pull/568/files

Use unmerged tree in ui tests