GitHub链接:GitHub - savelove123/AwesomeNavigation: 基于Hilt的Android页面导航框架
在使用清洁架构+MVVM+组件化重构现有的项目的时候,为了实现跨模块页面导航,需要使用一个支持跨模块的页面导航组件。原本使用的是阿里巴巴的ARouter路由框架,但是ARouter这两年并没有更新,没有适配新版本的AGP,最主要原因是使用kapt的时候使用ARouter无法编译AndroidTest下的代码。
基于URI的路由框架,确实很便利,但是其实和目前的项目的实践理念不太合适,基于URI的导航框架,每一个导航都像一次RPC的调用,像一次GET请求,好处是简单、易用,但是它的表现行为更像胶水,好比各种Bus.这些工具没有提供一个规范为页面行为进行封装。同时我也希望能支持协程来获取导航后的结果,并且能和ViewModel结合使用,方便编写测试代码的路由框架。所以Bus和URI的框架,相对而言缺少一些规范和设计,决定弃用。
目前有很多基于URI的框架,入门简单,易使用,但是带来的问题也是存在不规范性的隐患,测试比较困难,在建立APP质量体系的时候,编写测试代码是代码质量和App质量的可靠保障,考虑到开源项目可能更新慢而自己没那么大精力维护的情况,因此后面选用的工具优先用官方和轻量级的工具且不考虑基于URI的路由框架。
所以目标很明确,足够轻量、可测试、支持封装、依赖解耦,这样的代码容易改动,毕竟一个活跃的项目一定是不断调整的项目,响应需求的变化和技术的迭代,且能支持不断地持续重构才是好的架构的目标。
在长期的项目实践中,基于软件的扩展性、健壮性、复用性的选择上,我更喜欢软件的业务代码的扩展性、健壮性大于复用性,简而言之,我更倾向于敏捷的软件架构,基于此我采用了清洁架构的思想,其实这也是目前一些大牛们推荐的最佳实践,在MVVM的基础上对业务逻辑再一次分层,并且使用Hilt来做依赖注入实践依赖注入和依赖反转。
使用Hilt而不是使用Koin的原因是Hilt更注重类之间的关联关系,并且在编译期就可以检查错误、运行效率高、官方支持且对Android系统的生命周期的支持非常好。
而Koin的话,它是运行时使用一种服务定位器模式,优点是它简单,并且更灵活,可以在运行时委托一些代理,便捷实现一些功能,但是它不是谷歌官方的,其次,它性能和类型安全检查都不如Hilt.所以我最终选择Hilt作为依赖注入的工具。
Hilt是一个基于Dagger(依赖注入框架)的扩展库,在项目原本的组件化实践中,我已经将各个Feature模块分离为Interface和Implemation,组件之间的关联关系都引用到Interface,而Implemation都使用Hilt注入到对应的依赖中。而原本的路由框架使用的ARouter,我也封装了ARouter的相关路由表结构到Interface模块。那么只需要继续这个思路,把导航的声明和实现逻辑分开,再通过实现获取具体的导航行为就可以更清晰地完成导航逻辑。
除了一些URI的Router框架、Navigation框架,还有一些方案是采用Deep Link的方案来做,但是在这个实践中可能会存在由于项目越来越庞大,那么各个模块之间的DeepLink也越来越多,要维护许多DeepLink( 比如 path,intent-filter,action等等),但是这些DeepLink的意义比较难读,而且,往往不适用于对外提供。
首先导航应该是简单、便捷的,其实Googlde 的Navigation的设计就挺好的,但是Navigation对跨模块的Activity支持得不是很好,第二个要编写额外的XML文件,但是这里面的NavGraph的思想非常值得借鉴。
基于上面所说和实际项目的情况,我们希望页面导航框架是下面这样的:
基于导航的概念,我定义了框架中的四个基本元素
首先,我们希望,我们能通过依赖注入获取到导航节点对应的实际节点,比如我们要去上海,那么在我们填写目的地为上海后输入我们的条件,能得到一个去上海的具体路线。
所以我们这个过程就是,在导航的组件(NavComponent)中通过依赖注入获取一个包含我们目标节点和条件的导航(NavDestination)的实现(NavDestination Implementation),然后在导航的组件中,通过导航的载体(Navigable)得到具体的导航(NavDestination)的结果(Screen),最终在导航的载体处理导航的结果。
导航节点就是一组接口,声明与实现分开,然后返回一个目标点如下
interface ScreenDestination : NavDestination {
val navContext: NavDestinationContext
get() = EmptyNavContext
fun toScreen(params:Parcelable?,
navigable: Navigable): Screen
}
因此我们期待的导航组件(NavComponent)执行的代码如下:
@Inject
lateinit var anyDestination :NavDestination
...
//没有参数的时候去导航
anyDestination.navigateTo()
//如果有参数的时候去导航
anyDestination.injectParams( someParams ).navigateTo()
在执行完navigateTo()后,我们期望得到一个导航的具体目标,可能是一个Intent,可能是一个Fragment等
那么我们在得到导航的目标以后,我们还需要使用这个导航目标,可能是跳转,也可能是把某个Fragment添加到容器中,这个时候,Navigable就承载了使用导航目标的功能。
所以Navigable中我们需要有这么个函数:
fun navigateTo(direction: NavDirection){
isFragment{
...
}
isIntent{
...
}
isDialog{
...
}
other{
...
}
}
也就是说,NavComponent得到导航目标后,Navigable要能自动观察导航目标,然后处理导航目标。导航一般可以分为,页面导航和其他的导航,这里,我们先实现页面的导航。
页面的导航的行为可以分为下面几个:
fun navigate()
suspend fun navigateForResult():NavResult?
fun navigateToPrevious( naviDestination:NaviDestination)
fun back()
fun finish( result:Any?=null )
而在导航的目标页面,比如Activity,Fragment,我们可以通过如下的函数获取到导航的参数
class SampleActivity:AppCompatActivity{
//在onCreate函数或者之后调用
val params = requireNavParam()
}
然后我们获取到参数后,可以注入到ViewModel,那么我们可以得到目标的代码如下:
class SampleActivity:AppCompatActivity{
private val sampleViewModel :SampleViewModel by lazyNavViewModel {
injectVMParams(requireNavParam())
}
}
而在我们的页面的viewModel,我们希望快捷获取到参数,那么我们的目标代码如下:
class SampleViewModel:NavViewModel{
fun onAttach( saveInstanceState:Bundle?){
//要在viewModel初始化后调用
requireVMParams()
}
}
比如我们有一个登录模块和一个用户模块,登录模块,有个简单的逻辑是,登录模块包含登录、注册、手机号验证,注册后,需要前往设置用户信息页面,而用户模块在修改用户信息的时候需要跳转到登录模块验证然后获取验证的结果。
那么我们首先把登录模块拆分为接口和实现2个模块:
然后用户模块也拆分为接口与实现:
然后我们编写登录模块的导航节点在auth模块中:
interface AuthDestination:ScreenDestination{
@Parcelize
data class Params(private val authType:AuthType, val phone:String?=null):Parcelable{
val type :AuthType get() = run {
if (authType != AuthType.Login && authType != AuthType.Register && phone.isNullOrEmpty()) {
AuthType.Login
} else {
authType
}
}
}
}
然后再在auth_impl模块中编写登录模块导航节点的实现:
class AuthDestinationImpl: AuthDestination{
override fun toScreen( params: Parcelable?, navigable: Navigable): Screen {
return Intent(navigable.toContext(), AuthActivity::class.java)
}
}
然后我们再编写用户信息页面和修改手机号码的导航节点:
interface UserInfoDestination:ScreenDestination{
@Parcelize
data class Params( val requireFragment:Boolean=false): Parcelable
}
interface ChangePhoneDestination:ScreenDestination, Parameterized {
@Parcelize
data class Params(val phone:String,val token:String ): Parcelable
}
以及这两个导航节点的实现,我们可以尝试把导航节点的实现和业务逻辑相关联,实现一个页面统一的拦截的功能,比如UserInfoDestinationImpl所做的,但是我不推荐这样做,一个是这样编写出来的粒度加大了,页面跳转与业务逻辑不应该关联。
class UserInfoDestinationImpl constructor(
private val authRepository: AuthRepository,
private val userRepository: UserRepository,
private val authDestination: AuthDestination,
) : UserInfoDestination,
Parameterized {
override val navContext: NavDestinationContext
get() = run {
authNavContext?:super.navContext
}
var authNavContext:NavDestinationContext? = null
override fun toScreen(params: Parcelable?, navigable:Navigable): Screen {
if( !authRepository.isAuthorized() ){
val loginParams = AuthDestination.Params( if( userRepository.userInfo().value!= null ) AuthType.Login else AuthType.Register)
authNavContext = NavDestinationContext( loginParams)
return authDestination.injectParams(loginParams )
.toScreen( navigable )
}
return if( params.reifiedOrNull()?.requireFragment == true ){
UserInfoFragment()
}else {
Intent( navigable.toContext(), UserInfoActivity::class.java )
}
}
}
像下面这样,根据参数来判断页面的导航,我个人比较推荐。
class ChangePhoneDestinationImpl @Inject constructor(): ChangePhoneDestination {
override fun toScreen( params: Parcelable?, navigable: Navigable): Screen {
requireNotNull(params)
return Intent( navigable.toContext(), ChangePhoneActivity::class.java )
}
}
然后我们在Hilt增加相关的Provides函数
@Module
@InstallIn(SingletonComponent::class)
object AuthModule {
@Provides
@Singleton
fun provideAuthRepository( @AppScope appScope: CoroutineScope):AuthRepository = AuthRepositoryImpl(appScope)
@Provides
fun provideAuthDestination( ): AuthDestination = AuthDestinationImpl()
}
@Module
@InstallIn(SingletonComponent::class)
object UserModule {
@Provides
@Singleton
fun provideUserRepository(): UserRepository = UserRepositoryImpl(authRepository, scope)
@Provides
fun provideChangePhoneDestination(
userRepository: UserRepository,
authDestination: AuthDestination,
): ChangePhoneDestination = ChangePhoneDestinationImpl()
@Provides
fun provideUserInfoDestination(
authRepository: AuthRepository,
userRepository: UserRepository,
authDestination: AuthDestination,
): UserInfoDestination = UserInfoDestinationImpl( authRepository,userRepository,authDestination)
}
然后我们就实现了页面节点支持自动注入了。
接下来我们编写Activity和ViewModel的代码:
@AndroidEntryPoint
class AuthActivity: BaseActivity() ,Navigable{
private val authViewModel :AuthViewModel by lazyNavViewModel {
observeNavigation()
injectVMParams(requireNavParam())
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
viewDataBinding.title.setTitle( when( requireNavParam().type){
AuthType.Register->"注册"
AuthType.Login->"登录"
AuthType.ResetPassword->"重置密码"
AuthType.ChangePhone->"修改手机号"
})
}
override fun getLayoutId() = R.layout.activity_auth
override fun getBindingVM() = authViewModel
override fun getVariableId() = BR.vm
}
sealed class AuthNextDestination:NavDestination
@HiltViewModel
class AuthViewModel @Inject constructor(
application: Application,
private val authRepository: AuthRepository,
val setPasswordDestination: SetPasswordDestination,
val setUserInfoDestination: SetUserInfoDestination,
val privacyDestination: PrivacyDestination,
val homeDestination: HomeDestination
):NavViewModel( application = application ),Parameterized{
val phone = MutableLiveData("")
val verifyCode = MutableLiveData("")
override fun attachViewModel(savedInstanceState: Bundle?) {
super.attachViewModel(savedInstanceState)
if( requireVMParams().type == AuthType.Register ){
viewModelScope.launch {
val results :PrivacyDestination.Results? = privacyDestination.injectParams(PrivacyDestination.Params( PrivacyDestination.Action.CONFIRM ))
.navigateForResult().let {
NavigationResult( it.code,it.data)
}.getParcelable()
if(results?.accepted != true ){
navigateBack()
}
}
}
}
fun observePhone() = createTextWatcher {
phone.value = it?.toString() ?: ""
}
fun observeVerifyCode() = createTextWatcher {
verifyCode.value = it?.toString() ?: ""
}
fun verify() = createActionDoneListener{
viewModelScope.launch {
authRepository.verifyPhone( phone.value!! , verifyCode.value!! , requireVMParams().type )
.fold( onSuccess = {
when( requireVMParams().type ){
AuthType.Register->{
authRepository.setAuthState( it as AuthResult.AuthState)
SetUserInfo().navigate()
}
AuthType.ResetPassword->{
SetPassword()
.injectParams( SetPasswordDestination.Params(( it as AuthResult.CheckOperation).token))
.navigate()
}
AuthType.ChangePhone->{
finish( it )
}
AuthType.Login->{
authRepository.setAuthState( it as AuthResult.AuthState)
navigateToPrevious( Home() )
}
}
navigateBack()
}, onFailure = {
Toast.makeText( getApplication() , it.message , Toast.LENGTH_SHORT ).show()
})
}
}
inner class SetPassword : AuthNextDestination(),SetPasswordDestination by setPasswordDestination
inner class SetUserInfo : AuthNextDestination(),SetUserInfoDestination by setUserInfoDestination
inner class Home:AuthNextDestination(),HomeDestination by homeDestination
}
可以注意到,我这边使用了AuthNextDestination这个密封类,用户定义AuthViewModel这个导航组件可以导航的节点类型,同时我对AuthViewModel使用了Parametrized接口标记,表示AuthViewModel是可以注入参数的,如果AuthViewModel不需要外部参数,则不必实现这个接口。
设置密码和设置手机号码使用了不同的逻辑,设置密码是耦合了后面的业务功能,这个我个人不推荐这样的做法,而修改手机号使用了finish把结果返回给上一个页面,上一个页面可以通过协程获取,代码如下:
fun changePhone(){
viewModelScope.launch {
val result :AuthResult.CheckOperation? = authDestination.injectParams( AuthDestination.Params(
AuthType.ChangePhone,
authRepository.authState().value.phoneNumber) ).navigateForResult().getParcelable()
result?.let {
changePhoneDestination.injectParams(it )
.navigate()
}
}
}
上面这种做法我们可以结构化地异步获取结果,个人推荐这样使用。
基于此我们得到的相关导航相关的架构和流程图如下:
优点:契合清洁架构的理念,实现了导航的依赖注入以及依赖反转,轻量级,编写的代码更具备规范性、由于使用了依赖注入因此易于编写测试代码。
缺点:目前默认只实现了页面导航、只支持kotlin,扩展功能需要掌握kotlin,由于代码粒度低需要编写额外的类。