Jetpack Compose开源项目-JetNews分析学习

整体结构分析

  • UI
    Theme ui/theme
    Navigation 导航
    SwipeToRefresh 上拉加载下拉刷新封装
    AppDrawer 抽屉效果的封装

  • model 数据模型封装
    Post.kt 帖子封装
    PostFeed 数据流model

  • data 数据模型实现
    Result.kt 数据结果返回封装

/**
 * A generic class that holds a value or an exception
 */
sealed class Result<out R> {
    data class Success<out T>(val data: T) : Result<T>()
    data class Error(val exception: Exception) : Result<Nothing>()
}

fun <T> Result<T>.successOr(fallback: T): T {
    return (this as? Result.Success<T>)?.data ?: fallback
}

posts,interests 数据业务的处理封装,PostsRepository 的定义和实现。InterestsRepository的定义和实现
AppContainer 也是应用的入口,FakePostsRepository,FakeInterestsRepository
/变量被延迟初始化,同一个实例在整个应用程序中共享/

技术点分析学习

  1. sealed ,泛型,data
    参考 Result.kt 和 我kotlin的相关文章技术点
  2. by lazy 委托模式

在Kotlin中 延迟加载不是用 lateinit 关键字吗? 是的 但是Kotlin中还有一种延迟加载方式 by lazy 与 lateinit 不同的是 在使用lateinit 定义的变量前 一定会给他一个实例 保证他不会是空对象 而 by lazy 则是在第一次使用时 初始化对象

简单的例子

class Bean {
    val str by lazy {
        println("Init lazy")
        "Hello World"
    }
}

fun main() {
    val bean = Bean()
    println("Init Bean")
    println(bean.str)
    println(bean.str)
}

FakePostsRepository
getPostsFeed 函数,模拟请求返回,超过5次下拉刷新,提示刷新失败
getPost(postId: String?) 获取某个文章
observeFavorites()
toggleFavorite(postId: String) 设计Flow知识点
shouldRandomlyFail() 模拟失败记录刷新次数

MainActivity UI入口

几乎所有Jetpack Compose 开源demo都会有

WindowCompat.setDecorFitsSystemWindows(window, false)

/温故而知新/

fitsSystemWindows属性可以让view根据系统窗口来[调整]自己的布局;简单点说就是我们在设置应用布局时是否考虑系统窗口布局,这里系统窗口包括系统状态栏、导航栏、输入法等,包括一些手机系统带有的底部虚拟按键。

android:fitsSystemWindows=”true” (触发View的padding属性来给系统窗口留出空间)
这个属性可以给任何view设置,只要设置了这个属性此view的其他所有padding属性失效,同时该属性的生效条件是只有在设置了透明状态栏(StatusBar)或者导航栏(NavigationBar)此属性才会生效。

注意: fitsSystemWindows只作用在Android4.4及以上的系统,因为4.4以下的系统StatusBar没有透明状态。

/JetnewsApp.kt/

/ModalDrawer/

drawerContent 封装了自定义 AppDrawer

  • currentRoute
  1. 声明 navController
    val navController = rememberNavController()
  2. 传入navaController 自定义JetnewsNavigationActions 负责记录Controller的逻辑
    JetnewsDestinations 单利枚举router的所有值(JetnewsDestination.kt)
  3. val coroutineScope = rememberCoroutineScope()

使用 getContext 提供的可选 CoroutineContext 返回一个绑定到组合中该点的 CoroutineScope。 getContext 只会被调用一次,并且相同的 CoroutineScope 实例将在重新组合中返回。当此调用离开组合时,此范围将被取消。 getContext 返回的 CoroutineContext 可能不包含 Job,因为此范围被认为是组合的子级。
如果 getContext 返回的上下文未提供此范围的默认调度程序,则该调度程序将是组合的 Recomposer 的应用调度程序。
使用此范围启动作业以响应回调事件,例如单击或其他用户交互,其中对该事件的响应需要随着时间的推移展开,并且如果管理该进程的可组合项离开组合,则取消该响应。作为组合本身的副作用,不应将作业启动到任何协程范围内。对于由组合启动的范围内正在进行的作业,请参阅 LaunchedEffect。
如果不满足先决条件,此函数将不会抛出,因为可组合函数尚不完全支持异常。相反,返回的范围的 CoroutineScope.coroutineContext 将包含一个失败的 Job 以及相关的异常,并且无法启动子作业。

  1. val navBackStackEntry by navController.currentBackStackEntryAsState()

获取当前导航返回堆栈条目作为 MutableState。 当给定的 navController 由于 NavController.navigate 或 NavController.popBackStack 而更改后退堆栈时,这将触发重组并返回后退堆栈的顶部条目。
结果返回:当前返回堆栈条目的可变状态

最终默认 JetnewsDestinations.HOME_ROUTE 作为当前route

5 navigateToHome
指定为JetnewsNavigationActions 的navigateToHome 表达式(lambda)
6 navigateToInterests
指定为JetnewsNavigationActions 的navigateToInterests 表达式(lambda)
7 closeDrawer
自定义rememberSizeAwareDrawerState,确定要传递给模态抽屉的抽屉状态。

  • drawerState
    交给rememberSizeAwareDrawerState 负责
  • gesturesEnabled
    手势开关
    val isExpandedScreen = windowSize == WindowSize.Expanded

AppNavRail 自定义

封装调用了 系统的 NavigationRail

Material Design 导航栏。
Navigation Rail 是一个侧边导航组件,允许在应用程序的主要目的地之间移动。 导航栏应该用于显示三到七个应用程序目标,并且可以选择在标题内显示 FloatingActionButton 或徽标。 每个目的地通常由一个图标和一个可选的文本标签表示。

JetnewsNavGraph 定义

封装调用 NavHost

在 Compose 层次结构中提供适当的位置以实现自包含导航。
一旦调用它,给定 NavGraphBuilder 中的任何 Composable 都可以从提供的 navController 导航到。

添加NavGraphBuilder.composable
两个Composable 分别传入HomeViewModel 和 InterestsViewModel
调用AppContainer的两个 Repository获取数据执行

HomeRoute

InterestsRoute

InterestsScreen 组件(Sections,Sections)
列表等封装

工具包Utils

/WindowSize.kt/
适配

  • Compact:大多数手机处于纵向模式
  • Medium:大多数可折叠设备和平板电脑处于纵向模式
  • Expanded:大多数平板电脑处于横向模式

根据material design标准
为了获得最佳的用户体验,材料设计用户界面应根据以下断点宽度调整布局:480、600、840、960、1280、1440和1600dp。

封装扩展方法 Activity.rememberWindowSizeClass()

  1. 获取window的像素(Get the size (in pixels) of the window)
  2. 转换size为dp(Convert the window size to [Dp])
  3. 计算window的大小区分类型(Calculate the window size class)
    Compact, Medium, Expanded
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,951评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,606评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,601评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,478评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,565评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,587评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,590评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,337评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,785评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,096评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,273评论 1 344
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,935评论 5 339
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,578评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,199评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,440评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,163评论 2 366
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,133评论 2 352

推荐阅读更多精彩内容