整理:ARouter进阶

本文详细介绍了ARouter库在Android开发中的应用,包括通过URL进行页面跳转,携带intent参数,使用startActivityForResult,设置转场动画,获取Fragment,拦截器的使用,服务的调用以及拦截器和服务的区别。同时,讲解了自动注入、参数传递的注意事项和获取携带参数的方法,提供了多种实际应用场景的示例。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

通过URL跳转

 //亲测:可以直接打开其他APP的页面,前提是这个“其他APP”是已经存活在系统中
 "ARouter 路由跳转:使用URL的方式1 (携带intent参数)" -> {
     val bundle = Bundle()
     bundle.putString("bundleStringKey", "bundleStringValue")
     ARouter.getInstance()
         .build(ARouterConstant.App.WEBVIEW_ACTIVITY)
         .withString("url", "file:///android_asset/www/arouter-test.html")
         .withInt("intKey", 100)
         .withBoolean("booleanKey", true)
         .withBundle("bundle", bundle)
         .navigation()
 }
<!DOCTYPE html>
<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title></title>
</head>

<body>
<center>
    <h2>ARouter 测试</h2>
</center>
<p><a href="arouter://m.knowledge.com/app/test01">arouter://m.knowledge.com/app/test01</a></p>
<p><a href="arouter://m.knowledge.com/app/webview?url=https%3a%2f%2fm.abc.com%3fa%3db%26c%3dd">测试URL Encode情况</a></p>
<p><a href="arouter://m.knowledge.com/app/test02?name=alex&age=18&obj=%7b%22sex%22%3a%22jack%22%2c%22id%22%3a666%7d">"ARouter 路由跳转:使用URL的方式2 (携带intent参数):通过注解的方式获取参数":arouter:/m.knowledge.com/app/test02?name=alex&age=18&obj={"sex":"jack","id":"666"}</a></p>
<p><a href="http://m.knowledge.com/app/test01">http://m.knowledge.com/app/test01</a></p>

</body>
</html>

startActivityForResult

 "ARouter 路由跳转:startActivityForResult" -> {
                        ARouter.getInstance()
                            .build(ARouterConstant.App.TEST_01_SCHEME_FILTER_ACTIVITY)
                            .navigation(mContext as Activity, 666)
                    }

动画

  //转场动画(常规方式)
 "ARouter 路由:旧版本转场动画" -> {
     ARouter.getInstance()
         .build(ARouterConstant.App.TEST_01_SCHEME_FILTER_ACTIVITY)
         .withTransition(R.anim.slide_in_bottom, R.anim.slide_out_bottom)
         .navigation(this.mContext)
 }
 //转场动画(API16+)
 "ARouter 路由:新版本转场动画" -> {
     if (Build.VERSION.SDK_INT >= 16) {
         val compat: ActivityOptionsCompat =
             ActivityOptionsCompat.makeScaleUpAnimation(
                 it,
                 it.width / 2,
                 it.height / 2,
                 0,
                 0
             )
         ARouter.getInstance()
             .build(ARouterConstant.App.TEST_01_SCHEME_FILTER_ACTIVITY)
             .withOptionsCompat(compat)
             .navigation()
     } else {
         Toast.makeText(
             this.mContext,
             "API < 16,不支持新版本动画",
             Toast.LENGTH_SHORT
         ).show()
     }
 }

获取Fragment

 "ARouter 路由:获取Fragment" -> {
                        val fragment: Fragment = ARouter.getInstance().build(ARouterConstant.App.TEST_03_SIMPLE_FRAGMENT)
                            .withString("name", "老王")
                            .withInt("age", 18)
                            .withBoolean("boy", true)
                            .withLong("high", 180)
                            .withString("url", "https://a.b.c")
                            .navigation() as Fragment
                        Toast.makeText(
                            this.mContext,
                            "找到Fragment:$fragment",
                            Toast.LENGTH_SHORT
                        ).show()
                    }

拦截器

//注意:只要有一处地方对这个路径设置了拦截器,其他地方调用的时候也会受到影响
//对于拦截器的 priority 属性,值越小,优先级越高,并且需要注意,该属性的值不能设置为相同的,否则编译时会直接报错。
 "ARouter 路由:拦截器测试"-> {
     ARouter.getInstance()
         .build(ARouterConstant.App.TEST_02_SCHEME_FILTER_ACTIVITY)
         .navigation(this.mContext, object : NavCallback() {
             override fun onArrival(postcard: Postcard) {
                 Log.d("ARouter", "到达终点,欧耶!")
             }
             override fun onInterrupt(postcard: Postcard) {
                 Log.d("ARouter", "被拦截了")
             }
         })
 }

ARouter拦截器的用途举例:实现登录拦截

NavCallback回调

"ARouter 路由:跳转失败,单独降级" -> {
     ARouter.getInstance().build("/xxx/xxx")
         .navigation(this.mContext, object : NavCallback() {
             override fun onFound(postcard: Postcard) {
                 Log.d("ARouter", "找到了")
             }

             override fun onLost(postcard: Postcard) {
                 Log.d("ARouter", "找不到了")
             }

             override fun onArrival(postcard: Postcard) {
                 Log.d("ARouter", "跳转完了")
             }

             override fun onInterrupt(postcard: Postcard) {
                 Log.d("ARouter", "被拦截了")
             }
         })
 }

服务单类方法的调用的几种方式:

 "ARouter 路由:调用单类" -> {
                        ARouter.getInstance().navigation(SingleService::class.java).sayHello("Knowledge Pooling")
                    }
                    "ARouter 路由:ByName调用服务" -> {
                        (ARouter.getInstance().build("/yourservicegroupname/hello")
                            .navigation() as HelloService).sayHello("Knowledge Pooling")
                    }
                    "ARouter 路由:ByType调用服务" -> {
                        ARouter.getInstance().navigation(HelloService::class.java).sayHello("Knowledge Pooling")
                    }

拦截器和服务的异同:

拦截器和服务所需要实现的接口不同,但是结构类似,都存在 init(Context context) 方法,但是两者的调用时机不同
拦截器因为其特殊性,会被任何一次路由所触发,拦截器会在ARouter初始化的时候异步初始化,如果第一次路由的时候拦截器还没有初始化结束,路由会等待,直到初始化完成。
服务没有该限制,某一服务可能在App整个生命周期中都不会用到,所以服务只有被调用的时候才会触发初始化操作

为目标页面声明更多信息

// 我们经常需要在目标页面中配置一些属性,比方说"是否需要登陆"之类的
// 可以通过 Route 注解中的 extras
属性进行扩展,这个属性是一个 int值,换句话说,单个int有4字节,也就是32位,可以配置32个开关
// 剩下的可以自行发挥,通过字节操作可以标识32个开关,通过开关标记目标页面的一些属性,在拦截器中可以拿到这个标记进行业务逻辑判断
@Route(path = “/test/activity”, extras = Consts.XXXX)

自动注入 @Autowired(name = “name”)遇到的坑:

注意:需要设置访问权限为public 否则编译的时候会报这个错误:ARouter::Compiler An exception is
encountered, [The inject fields CAN NOT BE ‘private’!!! please check
field [name] in class … 意思是:编译器遇到异常, 注入字段不能为“私有”!!!请在课堂上检查字段[name]
目前是直接换成使用java。而找到了一种解决方法是:

Kotlin类中的字段无法注入如何解决?
首先,Kotlin中的字段是可以自动注入的,但是注入代码为了减少反射,使用的字段赋值的方式来注入的,Kotlin默认会生成set/get方法,并把属性设置为private
所以只要保证Kotlin中字段可见性不是private即可,简单解决可以在字段上添加 @JvmField。

 //如果需要自动装配参数,需要进行Arouter 注入
   // 之后,ARouter会自动对字段进行赋值,无需主动获取
  ARouter.getInstance().inject(this);

参数细节:

使用 withObject 传递 List 和 Map 的实现了Serializable 接口的实现类(ArrayList/HashMap)的时候,接收该对象的地方不能标注具体的实现类类型应仅标注为 List 或 Map,否则会影响序列化中类型的判断, 其他类似情况需要同样处理。

 // 如果需要传递自定义对象,新建一个类(并非自定义对象类),然后实现 SerializationService,并使用@Route注解标注(方便用户自行选择序列化方式),例如:
    @Route(path = "/yourservicegroupname/json")
    public class JsonServiceImpl implements SerializationService {
        @Override
        public void init(Context context) {

        }

        @Override
        public <T> T json2Object(String text, Class<T> clazz) {
            return JSON.parseObject(text, clazz);
        }

        @Override
        public String object2Json(Object instance) {
            return JSON.toJSONString(instance);
        }

        @Override
        public <T> T parseObject(String input, Type clazz) {
            return null;
        }
    }

传递自定义对象

// 如果需要传递自定义对象,新建一个类(并非自定义对象类),然后实现 SerializationService,并使用@Route注解标注(方便用户自行选择序列化方式),例如:
    @Route(path = "/yourservicegroupname/json")
    public class JsonServiceImpl implements SerializationService {
        @Override
        public void init(Context context) {

        }

        @Override
        public <T> T json2Object(String text, Class<T> clazz) {
            return JSON.parseObject(text, clazz);
        }

        @Override
        public String object2Json(Object instance) {
            return JSON.toJSONString(instance);
        }

        @Override
        public <T> T parseObject(String input, Type clazz) {
            return null;
        }
    }

获取携带的参数的方法

方法一:intent.getStringExtra()诸如此类(因此,也可以传递Parcelable或者Serializable序列化的参数)。
方法二:使用注解。
注意: URL中不能传递Parcelable类型数据,通过ARouter api可以传递Parcelable对象

<think>好的,我现在需要帮助用户理解他们提供的这些依赖项的作用。用户给出的代码片段是关于ARouter的依赖配置,包括api、kapt和annotationProcessor。首先,我得回忆一下ARouter的基本信息。 ARouter是阿里巴巴开源的一个Android路由框架,用于帮助应用内各模块之间的跳转和解耦。用户添加这些依赖可能是为了在项目中使用ARouter。接下来,我需要逐一分析每个依赖项的作用。 第一个依赖是`api 'com.alibaba:arouter-api:1.5.2'`。这里使用`api`关键字,意味着这个依赖会被传递到所有模块,其他模块无需重复声明。这应该包含ARouter的核心接口和类,比如路由跳转的方法。 第二个和第三个都是关于`arouter-compiler`的,但使用了不同的配置:`kapt`和`annotationProcessor`。KAPT是Kotlin注解处理工具,而annotationProcessor是Java的注解处理器。ARouter使用注解处理来在编译时生成路由表,因此需要这两个配置。如果项目中有Kotlin代码,必须使用kapt;如果是纯Java项目,用annotationProcessor即可。不过用户同时添加了这两个,可能是因为项目混合了Java和Kotlin,或者用户不确定应该用哪个,所以都加上确保兼容性。 需要确认用户是否了解KAPT和annotationProcessor的区别,以及他们的项目是否使用了Kotlin。如果用户的项目是纯Java,那么只需要annotationProcessor;如果有Kotlin代码,则需要kapt。同时,版本号1.5.2可能存在更新版本,可能需要提醒用户检查最新版本。 另外,ARouter的配置还需要在模块的build.gradle中启用注解处理器,并可能需要在Application中初始化ARouter。用户可能还需要在Application类里调用`ARouter.init(this)`,以及在manifest中配置相关的Activity。 用户可能遇到的问题包括依赖冲突、版本不匹配,或者忘记初始化ARouter。需要提醒用户添加这些依赖后,进行同步,并在代码中正确使用注解,比如`@Route(path = "/path/activity")`。 总结来说,用户的问题是关于ARouter依赖项的用途,需要解释每个依赖的作用,并给出配置建议和可能遇到的问题提示。</think>这些依赖项与阿里巴巴开源的 **ARouter** 框架相关,主要用于实现 Android 应用内的模块化路由和组件间通信。以下是逐步解释: --- ### 1. **`api 'com.alibaba:arouter-api:1.5.2'`** - **作用**:这是 ARouter 的核心库,提供路由跳转、参数注入、拦截器等基础功能。 - **细节**: - `api` 表示该依赖会传递给其他模块(若项目是多模块结构),其他模块可直接使用 ARouter 的 API。 - 包含 `ARouter` 类、`@Route` 注解等关键接口。 --- ### 2. **`kapt 'com.alibaba:arouter-compiler:1.5.2'`** - **作用**:用于 **Kotlin 项目**的注解处理器,在编译时生成路由表。 - **细节**: - `kapt` 是 Kotlin 的注解处理工具(Kotlin Annotation Processing Tool)。 - 当你在代码中使用 `@Route(path = "/test/activity")` 注解时,`arouter-compiler` 会扫描这些注解,并自动生成映射路由路径与目标类的代码(如 `ARouter$$Group$$test.java`)。 --- ### 3. **`annotationProcessor 'com.alibaba:arouter-compiler:1.5.2'`** - **作用**:用于 **Java 项目**的注解处理器,功能与 `kapt` 相同。 - **细节**: - `annotationProcessor` 是 Java 的注解处理器配置。 - 如果项目是纯 Java 的,只需使用此配置;如果是 Kotlin,则需要同时添加 `kapt`。 --- ### 为什么需要同时配置 `kapt` 和 `annotationProcessor`? - **混合项目**:如果项目中同时包含 Java 和 Kotlin 代码,需两者都配置。 - **兼容性**:确保无论模块是 Java 还是 Kotlin,注解处理器都能生效。 --- ### 完整配置步骤 1. **添加依赖**: ```gradle dependencies { api 'com.alibaba:arouter-api:1.5.2' kapt 'com.alibaba:arouter-compiler:1.5.2' // Kotlin annotationProcessor 'com.alibaba:arouter-compiler:1.5.2' // Java } ``` 2. **启用注解处理器**(Kotlin): ```gradle plugins { id 'kotlin-kapt' } ``` 3. **初始化 ARouter**(在 `Application` 中): ```kotlin class MyApp : Application() { override fun onCreate() { super.onCreate() if (BuildConfig.DEBUG) { ARouter.openLog() ARouter.openDebug() } ARouter.init(this) } } ``` --- ### 注意事项 - **版本一致性**:确保 `arouter-api` 和 `arouter-compiler` 版本一致(此处均为 `1.5.2`)。 - **ProGuard 规则**:需在混淆文件中添加 ARouter 的保留规则。 - **最新版本**:当前回答基于 `1.5.2`,建议检查 [ARouter GitHub](https://github.com/alibaba/ARouter) 获取最新版本。 如果有其他问题(如初始化失败、路由表未生成),可进一步排查依赖配置或注解使用是否正确。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值