PokeManager
An Android application to function as a Pokedex using the PokeApi and the paging library to load the data by pages.
How to use
First you need to clone the project and run it on Android Studio. The first time you open the app it shows some configuration screens that allows you to choose the names to show for each species of Pokemon and the way two handle data. There are two modes for this:
Consult when need it and not save the data:
It only requests the data when it is needed and doesn’t persist it. Including error screens when failing to get the data on the first try and retry option.
1.VIDEO.ONLY.REQUEST.mp4
After that it lists the species and when it’s getting to the end loads more species.
2.VIDEO.LIST.MORE.SUCCESS.mp4
When it tries to load the next page of species, if it fails then it shows you a button to retry.
3.VIDEO.LIST.MORE.ERROR.mp4
It also shows the loading or retry button if you’re scrolling to the top of the list.
4.VIDEO.LIST.MORE.SUCCESS.ABOVE.mp4
When tapping on a specie it shows you the retry screen or the screen with its details if it is successful.
5.VIDEO.DETAIL.ERROR.mp4
Among the details shows tabs with different information like stats, moves and evolution stages (by clicking on them you can see the details for that species). It has buttons to the previous/next species and if the current one has any alternative forms it shows a button to switch between them.
6.VIDEO.DETAIL.SUCCESS.mp4
It displays differently each specific evolution case according to how many members and which one evolves into which.
7.VIDEO.DETAIL.EVOLUTION.1.mp4
8.VIDEO.DETAIL.EVOLUTION.2.mp4
Download all the data now:
When the app starts use a service and custom notification to download all the data from the api and persist it with Room to use it later. It works exactly like the previous mode but it takes longer to start because it needs to download all the information then when it will use it, everything loads faster and without failures for connection.
9.VIDEO.DOWNLOAD.ALL.1.mp4
10.VIDEO.DOWNLOAD.ALL.2.mp4
Built with
- MVVM: architecture pattern the app is built with.
- Single Activity with a fragment per screen.
- View Binding: for accessing the xml views from the code.
- Viewmodels: to retrieve and keep the data shown on the screen.
- Paging: library used to show reduced amounts of items on the list of species.
- Service (LifecycleService) and Notifications: used to download the data even if the app is closed.
- Clean Architecture: used when separating the entities between db, network or model.
- Use cases: some specific logic related to retrieving data is keeped within some use cases.
- Repositories: there’s a main repository used to fetch data whether it’s from web or database requests.
- ROOM: library used to manage the access to the local sql database.
- Sharedpreferences: used for saving the configuration values selected when running the app for the first time.
- Retrofit: library used to make the request to the api.
- Gson: library used to convert strings in json format to objects and vice versa.
- Glide: library used to load the different images for the app.
- Hilt: library used to apply the dependency injection at the time of instantiating some objects.
- Coroutines: used on suspend functions to access the database or the network.
- MutableStateFlow/MutableLiveData: used on the viewmodels to keep the data that it’s observed for the views and it’ll change.
- Navigation: library used to handle the navigation between fragments.
- SplashScreen: library used to show the app icon on a screen when it is starting.
- JUnit: library used for Unit Testing from utils functions.
- ViewPager: view used to show the different tabs on the detail screen.
- Flow: view used to show the moves as a list distributed according to how many fits on a row.
- Bitrise: service used to run the tests and validate that they’re still working when merging a feature to develop.
App design
The app’s design is show on the next figma: https://www.figma.com/file/hxENKtri9sFeEjMjH2D4yh/PokeManager?type=design&node-id=305%3A117&t=iwDoQJ2nC3E0ki91-1