整体结构分析
UI
Theme
ui/theme
Navigation
导航
SwipeToRefresh
上拉加载下拉刷新封装
AppDrawer
抽屉效果的封装model 数据模型封装
Post.kt
帖子封装
PostFeed
数据流modeldata 数据模型实现
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
/变量被延迟初始化,同一个实例在整个应用程序中共享/
技术点分析学习
- sealed ,泛型,data
参考 Result.kt 和 我kotlin的相关文章技术点 - 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
- 声明 navController
val navController = rememberNavController() - 传入navaController 自定义JetnewsNavigationActions 负责记录Controller的逻辑
JetnewsDestinations 单利枚举router的所有值(JetnewsDestination.kt)
val coroutineScope = rememberCoroutineScope()
使用 getContext 提供的可选 CoroutineContext 返回一个绑定到组合中该点的 CoroutineScope。 getContext 只会被调用一次,并且相同的 CoroutineScope 实例将在重新组合中返回。当此调用离开组合时,此范围将被取消。 getContext 返回的 CoroutineContext 可能不包含 Job,因为此范围被认为是组合的子级。
如果 getContext 返回的上下文未提供此范围的默认调度程序,则该调度程序将是组合的 Recomposer 的应用调度程序。
使用此范围启动作业以响应回调事件,例如单击或其他用户交互,其中对该事件的响应需要随着时间的推移展开,并且如果管理该进程的可组合项离开组合,则取消该响应。作为组合本身的副作用,不应将作业启动到任何协程范围内。对于由组合启动的范围内正在进行的作业,请参阅 LaunchedEffect。
如果不满足先决条件,此函数将不会抛出,因为可组合函数尚不完全支持异常。相反,返回的范围的 CoroutineScope.coroutineContext 将包含一个失败的 Job 以及相关的异常,并且无法启动子作业。
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()
- 获取window的像素(Get the size (in pixels) of the window)
- 转换size为dp(Convert the window size to [Dp])
- 计算window的大小区分类型(Calculate the window size class)
Compact, Medium, Expanded