Genos

👊 Genos makes it very easy to build better mobile apps more quickly and with less code. For more information please see the website.

• Genos for iOS

• Genos Samples

---

Installation

root build.gradle

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

implementation 'com.nyssance.genos:genos:2.0.2'

root build.gradle.kts

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://jitpack.io") }
    }
}

dependencies {
    implementation("com.nyssance.genos:genos:2.0.2")
}

Features

Genos integrate google architecture. just use. if your need learn more info about how genos work, and mvvm, repository , viewmodel etc., see link

1.Rules

• Activity just as an container, include app bar and drawer/bottom navigation, and one fragment or more.
• Fragment have two type: list and detail.
  • list for REST list api, like https://www.yourdomain.com/api/v1/users/, list include default listView, adapter
  • detail for REST detail api, like https://www.yourdomain,com/api/v1/users/{:id}/
  • call in fragment is a call of it, it's a Retrofit call
• Repository is for load data.
• ViewModel is for bind data and view.

2.How to use

Create a list fragment, override three methods, 15 lines code, that's all you need to do.

import genos.ui.fragment.generic.List
import genos.ui.viewholder.Holder

class UserList : List<User, Holder>() {
    override fun onCreate() {
        call = API.userList(page) // A retrofit call of this fragment.
    }

    override fun onDisplayItem(item: User, viewHolder: Holder, viewType: Int) {
        with(viewHoloder) {
            icon?.setImage(item.avatarUrl)
            title?.text = item.username
        }
    }

    override fun onOpenItem(item: User) {
        // StartActivity or do anything when click item.
    }
}

class UserListActivity : AppBarActivity() {
    override fun onCreateFragment() = UserList()
}

Create a bottom navigation with four buttons, 10 lines.

// If you need a drawer navigation, use `MainActivity : DrawerActivity`
class MainActivity : TabBarActivity(mapOf(
        R.id.navigation_1 to UserList(),
        R.id.navigation_2 to PlaceholderFragment.instance("2"),
        R.id.navigation_3 to PlaceholderFragment.instance("3"),
        R.id.navigation_4 to PlaceholderFragment.instance("4")
)) {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        with(Global) { // Config
            APP_SCHEME = "genos-sample"
        }
        router() // Set router
    }
}

Tutorial

Develop an app in 10 minutes.

Architecture

genos
├── Global.kt                               Global config.
├── Helper.kt
├── extension
│         ├── Fragment+Extension.kt
│         ├── ImageView+Extension.kt
│         └── String+Extension.kt
├── model
│         ├── BaseItem.kt
│         └── Item.kt
├── repository
│         ├── HttpRepository.kt                   Default http repository.
│         ├── HttpUtil.kt
│         ├── IRepository.kt
│         ├── NetworkState.kt
│         └── Status.kt
├── ui
│         ├── BaseAdapter.kt                      Default Adapter for list fragment.
│         ├── BaseViewModel.kt                    Default ViewModel for list and detail fragment.
│         ├── activity
│         │         ├── AppBarActivity.kt               Activity with an app bar.
│         │         ├── CollapsingActivity.kt           Activity with a collapsing app bar.
│         │         ├── DrawerActivity.kt               Activity with drawer.
│         │         ├── TabBarActivity.kt               Activity with bottom navigation.
│         │         ├── WebActivity.kt
│         │         ├── base                            Design your activity by extends activity in base.
│         │         │      ├── BaseActivity.kt
│         │         │      ├── ContainerActivity.kt
│         │         │      └── NavigationActivity.kt
│         ├── fragment
│         │         ├── ActionSheet.kt
│         │         ├── Dialog.kt
│         │         ├── PlaceholderFragment.kt
│         │         ├── ViewPagerFragment.kt            Fragment with a view pager.
│         │         ├── base                            Design your fragment by extends fragment in base.
│         │         │         ├── BaseFragment.kt
│         │         │         ├── ListFragment.kt
│         │         │         ├── LoaderFragment.kt
│         │         │         ├── ObjectFragment.kt
│         │         │         └── RecyclerViewFragment.kt
│         │         └── generic
│         │             ├── Detail.kt                   Fragment for detail.
│         │             ├── GridViewList.kt             Fragment with a grid layout, user for grid list.
│         │             ├── List.kt                     Fragment with a linear layout, use for stand list, one item per line.
│         │             ├── StaggeredGridViewList.kt    Fragment with a staggered grid layout, use for waterfall list.
│         │             └── TableViewDetail.kt
│         └── viewholder
│             ├── BaseHolder.kt                   Base holder.
│             └── Holder.kt                       A holder with icon, title, subtitle, accessory.
└── vendor
          └── Retrofit.kt

Syntactic sugar

ifBlank, orEmpty

Vendor

• Android Jetpack
• Glide
• Logger
• Retrofit
• AgentWeb

License

Genos is released under the GPLv3 license. See LICENSE for details.