Android Sample App using Github API and Jetpack Component.
What's JetHub?
🚀
JetHub is a sample app using Github API and Jetpack components.
The purpose of this project is to try new Android technologies and learn how it works in an app.
Used Libraries
- Jetpack Compose (Decleartive UI)
- Navigation (Fragment transitions)
- View Binding (Bind views)
- ViewModel (Store and manage UI-related data)
- LiveData (Observable data)
- Jetpack Compose (Declarative UI)
- Kotlin Coroutine (Light-weight threads)
- Dagger2 (Dependency Injection)
- Hilt (Dependency Injection for Android)
- Room (Abstraction layer over SQLite)
- Retrofit (HTTP client)
- Mockk (Unit testing)
Multi Module / Dynamic Feature Module
This project consists of multiple modules and some of them are provided as Dynamic Feature Module.
Feature Module
:feed, :search, :pin are feature modules. These are included in base.apk and does not require user to download one later.
Dynamic Feature Module
:repo, :developer are dynamic feature modules. These are not included in base.apk and require user to download one on demand.
Architecture
This app is a single-activity application and uses MVVM architecture and follows the guildline shown here.
//--- Activity / Fragments / Compose ---//
lifecycleScope.launch {
viewModel.uiState
.flowWithLifecycle(lifecycle, Lifecycle.State.STARTED)
.collect { data -> /* do something */ }
}
val uiState by repoViewModel.uiState.collectAsState()
//--- ViewModel ---//
val uiState: StateFlow<UiState>
repository.getData() // get data from API and/or DB
//--- Repository ---//
api.getData() // get data from API
db.getData() // get data from DB
Dark Theme
Dark Theme is supported. You can toggle theme by tapping the theme icon on the top right corner. The selected theme would be retained in application scope for the sake of demo application.
Github API Token
This project is based on GitHub API. You can set your own token in local.properties and JetHub will use the token for every single request to Github. In order to generate a token, you can do so from your settings page.
This app works without a token, but the number of API call is very limited by Github. You can see the details from this link.
// local.properties
api_token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Author
- Taku Semba
- Github - (https://github.com/takusemba)
- Twitter - (https://twitter.com/takusemba)
- Facebook - (https://www.facebook.com/takusemba)
Licence
Copyright 2017 Taku Semba.
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.
4 Jul 15, 2022
12 Nov 1, 2022
0 Jul 16, 2022
89 Dec 23, 2022
638 Jan 2, 2023
4 Aug 26, 2022
199 Dec 26, 2022
18 May 25, 2022
0 Oct 12, 2021
840 Jan 2, 2023
86 Dec 20, 2022
0 Jan 1, 2022
2 Apr 23, 2022
15 Dec 10, 2022
1 Dec 26, 2021
4 Nov 29, 2022
82 Dec 23, 2022
0 Nov 24, 2021