1、前言：

首先借用阿里云棲社區(qū)的一段話：我們所使用的原生路由方案一般是通過(guò)顯式intent和隱式intent兩種方式實(shí)現(xiàn)的（這里主要是指跳轉(zhuǎn)Activity or Fragment）。在顯式intent的情況下，因?yàn)闀?huì)存在直接的類依賴的問(wèn)題，導(dǎo)致耦合非常嚴(yán)重；而在隱式intent情況下，則會(huì)出現(xiàn)規(guī)則集中式管理，導(dǎo)致協(xié)作變得非常困難。一般而言配置規(guī)則都是在Manifest中的，這就導(dǎo)致了擴(kuò)展性較差。除此之外，使用原生的路由方案會(huì)出現(xiàn)跳轉(zhuǎn)過(guò)程無(wú)法控制的問(wèn)題，因?yàn)橐坏┦褂昧薙tartActivity()就無(wú)法插手其中任何環(huán)節(jié)了，只能交給系統(tǒng)管理，這就導(dǎo)致了在跳轉(zhuǎn)失敗的情況下無(wú)法降級(jí)，而是會(huì)直接拋出運(yùn)營(yíng)級(jí)的異常。這時(shí)候如果考慮使用自定義的路由組件就可以解決以上問(wèn)題，比如通過(guò)URL索引就可以解決類依賴的問(wèn)題；通過(guò)分布式管理頁(yè)面配置可以解決隱式intent中集中式管理Path的問(wèn)題；自己實(shí)現(xiàn)整個(gè)路由過(guò)程也可以擁有良好的擴(kuò)展性，還可以通過(guò)AOP的方式解決跳轉(zhuǎn)過(guò)程無(wú)法控制的問(wèn)題，與此同時(shí)也能夠提供非常靈活的降級(jí)方式。
ARouter官方項(xiàng)目地址

二、基本使用：

1、添加依賴

android {
    defaultConfig {
        //必須添加的
        javaCompileOptions {
            annotationProcessorOptions {
                arguments = [AROUTER_MODULE_NAME: project.getName()]
            }
        }
    }
}

dependencies {
    // Replace with the latest version
   //版本依賴
   compile'com.alibaba:arouter-api:1.3.1'
   annotationProcessor'com.alibaba:arouter-compiler:1.1.4'
}

// --Kotlin如下使用--
implementation "com.alibaba:arouter-api:1.5.1"
kapt "com.alibaba:arouter-compiler:1.5.1"
kapt "com.alibaba:arouter-annotation:1.0.6"

圖片.png

2、初始化

官方建議我們?cè)贏pplication里面進(jìn)行ARouter初始化，于是乎就有了以下代碼：

if (isDebug()) {        
    ARouter.openLog();     // Print log
    ARouter.openDebug();   
}
ARouter.init(this);

圖片.png

然后別忘記了在清單文件里面配置自定義的Application和我們的Activity。

項(xiàng)目依賴導(dǎo)入和初始化就已經(jīng)完成了，下面就開(kāi)始正式的功能使用以及簡(jiǎn)單的封裝。

3、開(kāi)始使用：

1）首先：在Activity/Fragment類上面寫(xiě)上 Route path 注解。

注意：這里的路徑需要注意的是至少需要有兩級(jí)，/xx/xx

2）然后：在Activity/Fragment類里面進(jìn)入Arouter 注入，也就是：ARouter.getInstance().inject(this);

3）接著：目標(biāo)的Activity類上面需要聲明Route path 注解，以此對(duì)應(yīng)（跳轉(zhuǎn)如果不對(duì)應(yīng)路徑，框架會(huì)Toast說(shuō)路徑不匹配）

上述說(shuō)明的簡(jiǎn)單使用如下圖：

圖片.png

理論上來(lái)說(shuō)，如果只是進(jìn)行簡(jiǎn)單的跳轉(zhuǎn)頁(yè)面，

ARouter.getInstance().build(“目標(biāo)界面對(duì)應(yīng)的路徑”).navigation(); 就這樣一行代碼即可完成跳轉(zhuǎn)界面。

好了，看到這里我們就會(huì)發(fā)現(xiàn)，路徑的標(biāo)簽如果多了就不是很好管理，（所以更好的選擇是寫(xiě)一個(gè)類，在這個(gè)類里面統(tǒng)一管理和維護(hù)路徑標(biāo)簽，不僅利于維護(hù)也方便后期拓展，看到路徑就一目了然，哇~這個(gè)路徑對(duì)應(yīng)的是登錄界面，這個(gè)路徑對(duì)應(yīng)的是詳情界面）；其次，每個(gè)頁(yè)面的注入，也就是ARouter.getInstance().inject(this);這句代碼出現(xiàn)的幾率會(huì)寫(xiě)的很多，（而且一般的常規(guī)邏輯是有注入就有解綁或者釋放資源）所以我們應(yīng)該簡(jiǎn)單封裝起來(lái)提高效率

4、簡(jiǎn)單封裝

首先是路徑管理：

圖片.png

然后是注入封裝：

這里多提一嘴，優(yōu)秀的第三方框架如果一般有注入或者綁定的API，那與之對(duì)應(yīng)的一般就會(huì)有釋放或者解綁資源的API。（這樣做的本質(zhì)是優(yōu)化內(nèi)存）其中， ARouter.getInstance().destroy( ) ; 這個(gè)API一目了然，就是釋放資源的API。下面就是開(kāi)始注入和釋放資源的封裝：

圖片.png

筆者在Activity的基類里面通過(guò)生命周期進(jìn)行了注入和解綁，但是項(xiàng)目運(yùn)行后發(fā)現(xiàn)了一個(gè)問(wèn)題，就是如果在onDestroy（）里面調(diào)用了 ARouter.getInstance().destroy( ) ; 在進(jìn)入目標(biāo)Activity之后，然后按back鍵返回原界面的時(shí)候，APP會(huì)報(bào)錯(cuò)崩潰，下面是崩潰日志：

圖片.png

仔細(xì)一看，初始化有問(wèn)題？在前面我們說(shuō)到在自定義Application里面已經(jīng)初始化了ARouter，且在清單文件里面配置了自定義的Application，但是依舊提示沒(méi)有初始化，這就納了個(gè)悶？然后想了想，可能是 ARouter.getInstance().destroy( )；這行代碼的使用位置可能用錯(cuò)了。然后既然是在Application里面進(jìn)行的初始化，那么就可以將這行釋放資源的代碼，寫(xiě)在Application生命周期的onTerminate( )里面，果不其然，項(xiàng)目運(yùn)行后就沒(méi)什么問(wèn)題了。當(dāng)然，這是我自己的思路，有更好的意見(jiàn)和想法請(qǐng)?jiān)谠u(píng)論區(qū)指出，謝謝。

圖片.png

封裝完畢了路徑標(biāo)識(shí)以及注入釋放等基本功能，我們回到ARouter的基本使用：

5、簡(jiǎn)單頁(yè)面跳轉(zhuǎn)

如果只是簡(jiǎn)單的頁(yè)面跳轉(zhuǎn)，一行代碼即可完成，如下圖

圖片.png

其中，build里面是頁(yè)面的標(biāo)簽路徑，對(duì)應(yīng)的就是目標(biāo)Activity的這里，也就是類注釋標(biāo)簽路徑要一致：

圖片.png

注意：不要忘了在清單文件里面配置Activity。

6、帶參數(shù)的界面跳轉(zhuǎn)

• 帶參數(shù)的跳轉(zhuǎn)是很常見(jiàn)的功能，Android可以通過(guò)Bundle去傳遞參數(shù)，如果使用ARouter框架，它傳遞參數(shù)通過(guò)以下去操作：
• ARouter傳遞對(duì)象的時(shí)候，首先該對(duì)象需要Parcelable或者Serializable序列化，可能Parcelable這個(gè)序列化大家覺(jué)得手寫(xiě)起來(lái)比較麻煩，但是Android Studio已經(jīng)有一些插件幫我們自動(dòng)生成Parcelable序列化了（因?yàn)锳ndroid用Parcelable序列化優(yōu)勢(shì)會(huì)更加明顯一些）
• 字符串、char、int等基本數(shù)據(jù)類型當(dāng)然都是可以傳遞的
• 當(dāng)然，它也可以直接傳Bundle、數(shù)組、列表等很多對(duì)象，傳遞類型如下圖

圖片.png

攜帶參數(shù)的界面跳轉(zhuǎn)，簡(jiǎn)單使用如下圖

圖片.png

其中，第一個(gè)參數(shù)代表的是參數(shù)的key,第二個(gè)參數(shù)對(duì)應(yīng)的是我們要傳遞的屬性值，也就是value

那么目標(biāo)界面如何獲取傳遞過(guò)來(lái)的值？

這個(gè)時(shí)候，我們需要在目標(biāo)界面，使用Autowired注解，

圖片.png

這樣就可以獲取到傳遞過(guò)來(lái)的值了

圖片.png

值得注意的是，只有當(dāng) @Autowired(name = "test")，也就是key標(biāo)簽一致的情況下，才可以獲取到對(duì)象的值，如果不寫(xiě)標(biāo)簽名，結(jié)果會(huì)為null，

圖片.png

所以為了規(guī)避每一個(gè)可能會(huì)遇到的風(fēng)險(xiǎn)，建議在@Autowired里面 都寫(xiě)上與之對(duì)應(yīng)具體的key名。

7、界面跳轉(zhuǎn)動(dòng)畫(huà)

直接調(diào)用withTransition，里面?zhèn)魅雰蓚€(gè)動(dòng)畫(huà)即可（R.anim.xxx）

圖片.png

8、使用URI進(jìn)行跳轉(zhuǎn)

ARouter框架也可以使用URI進(jìn)行匹配跳轉(zhuǎn)，代碼也很少，只需匹配路徑一致即可完成跳轉(zhuǎn)：

圖片.png

9、Fragment跳轉(zhuǎn)

Fragment的跳轉(zhuǎn)也可以參照Activity跳轉(zhuǎn)，第一步依舊是先寫(xiě)上類注釋，然后是強(qiáng)轉(zhuǎn)，代碼如下

圖片.png

10、進(jìn)階用法之?dāng)r截器：

• 攔截器是ARouter這一款框架的亮點(diǎn)。說(shuō)起攔截器這個(gè)概念，可能印象更加深刻的是OkHttp的攔截器，OkHttp的攔截器主要是用來(lái)攔截請(qǐng)求體（比如添加請(qǐng)求Cookie）和攔截響應(yīng)體（判斷Token是否過(guò)期），在真正的請(qǐng)求和響應(yīng)前做一些判斷和修改然后在去進(jìn)行操作，大抵這就是攔截器的簡(jiǎn)單概念。那么，ARouter框架的攔截器是怎么實(shí)現(xiàn)的？
• ARouter的攔截器，是通過(guò)實(shí)現(xiàn) IInterceptor接口，重寫(xiě)init（）和process（）方法去完成攔截器內(nèi)部操作的。

首先我們定義兩個(gè)攔截器：

圖片.png

圖片.png

首先，定義ARouter攔截器必須要使用Interceptor類注解。注解里面的 priority（也就是紅色框） 這個(gè)是聲明攔截器的優(yōu)先級(jí)、里面的屬性值是int類型。既然是定義優(yōu)先級(jí)，我們這里定義2個(gè)攔截器來(lái)測(cè)試看看優(yōu)先級(jí)是如何區(qū)分誰(shuí)先誰(shuí)后的？?jī)蓚€(gè)攔截器寫(xiě)完之后，運(yùn)行下項(xiàng)目看下效果：

圖片.png

結(jié)論 1：根據(jù)實(shí)驗(yàn)得知，使用Interceptor類注解的priority數(shù)值越小，越先執(zhí)行，優(yōu)先級(jí)越高。（四大組件中的廣播，優(yōu)先級(jí)的取值是 -1000到1000，數(shù)值越大優(yōu)先級(jí)越高）

• 那么，還有一種情況，如果兩個(gè)攔截器定義的優(yōu)先級(jí)都是一樣的，那么誰(shuí)的優(yōu)先級(jí)會(huì)高？是根據(jù)類的字符串長(zhǎng)度來(lái)判斷嘛還是別的條件來(lái)判斷的？？
• 首先，將上面的攔截器的優(yōu)先級(jí)改成一樣（都改成1），項(xiàng)目編譯試試，結(jié)果發(fā)現(xiàn)項(xiàng)目就會(huì)直接報(bào)錯(cuò)！

圖片.png

看下具體的錯(cuò)誤原因：

圖片.png

翻譯過(guò)來(lái)就是他們使用了相同的優(yōu)先級(jí)，所以：

結(jié)論 2：如果兩個(gè)攔截器的優(yōu)先級(jí)一樣，項(xiàng)目編譯就會(huì)報(bào)錯(cuò)。所以，不同攔截器定義的優(yōu)先級(jí)屬性值不能相同

我們到這兩個(gè)攔截器里面加一點(diǎn)篩選條件的代碼：

圖片.png

將這段代碼加進(jìn)去之后，重新運(yùn)行App，打印日志結(jié)果如下：

圖片.png

為了方便看清運(yùn)行的日志，我用三種顏色的箭頭去對(duì)應(yīng)。首先是兩個(gè)攔截器的初始化，然后，調(diào)用了NavigationCallback這個(gè)回調(diào)函數(shù)里面的onFound（），然后執(zhí)行了攔截器里面的process（）方法；當(dāng)攔截器的process（）方法執(zhí)行完畢以后，最終回調(diào)了NavigationCallback里面的onArrival（）方法。攔截器的工作流程大抵就是這樣。那么，NavigationCallback這個(gè)又是什么？實(shí)際上，NavigationCallback這個(gè)簡(jiǎn)單理解就是ARouter在路由跳轉(zhuǎn)的過(guò)程中，我們可以監(jiān)聽(tīng)路由的一個(gè)具體過(guò)程。它一共有四個(gè)方法：

圖片.png

那么，這個(gè)回調(diào)里面的 Postcard 又是什么意思？點(diǎn)進(jìn)去源碼看看，類注釋寫(xiě)的一目了然：

圖片.png

紅色框翻譯過(guò)來(lái)的類注釋就是：一個(gè)包含路線圖的容器。
既然是路線圖的容器，那肯定有些API會(huì)獲取到相應(yīng)的信息，

圖片.png

通過(guò)Postcard可以獲取到路徑的組以及全路徑，那么，路徑的組（Group）又是什么？是這樣，一般來(lái)說(shuō)，ARouter在編譯期框架掃描了所有的注冊(cè)頁(yè)面／字段／攔截器等，那么很明顯運(yùn)行期不可能一股腦全部加載進(jìn)來(lái)，這樣就太不和諧了。所以就使用分組來(lái)管理，我們的類標(biāo)簽里面的注釋，對(duì)于group默認(rèn)是 “ ”（空字符串）如下圖：

圖片.png

在 Group簡(jiǎn)單使用 這張圖上面，根據(jù)日志，打印了分組的信息，可以發(fā)現(xiàn)Group的值默認(rèn)就是第一個(gè) / /（兩個(gè)分隔符） 之間的內(nèi)容。

那么，我們也可以自定義分組，來(lái)進(jìn)行界面跳轉(zhuǎn)，所以ARouter又提供了一種解決方案：

11、自定義分組 實(shí)現(xiàn)跳轉(zhuǎn)界面

如果使用自定義分組來(lái)跳轉(zhuǎn)界面，只需要在源代碼改動(dòng)以下三個(gè)位置：

1：類注解新增 group，賦值我們自定義的組名，（依舊統(tǒng)一寫(xiě)在一個(gè)類里面這樣便于管理）

圖片.png

2：在build方法里面（這是一個(gè)方法重載），添加我們的與之對(duì)應(yīng)的組名

圖片.png

3：在被跳轉(zhuǎn)的Activity里面的類注釋，加上同樣的組名

圖片.png

通過(guò)上面三個(gè)步驟即可完成 自定義分組 來(lái)完成界面跳轉(zhuǎn)

圖片.png

通過(guò)日志顯示，這里的組名已經(jīng)被我們更改成自定義分組且成功完成了跳轉(zhuǎn)。

2、ARouter如何實(shí)現(xiàn)類似startActivityForResult（）？

這種應(yīng)用場(chǎng)景也是很常見(jiàn)的，那ARouter該如何實(shí)現(xiàn)？

第一步：為了方便看效果，我們?cè)诘谝粋€(gè)Activity設(shè)置requestCode 為123，

圖片.png

第二步：需要在跳轉(zhuǎn)的navigation方法（這是一個(gè)方法重載）里面的第二個(gè)參數(shù)，設(shè)置我們定義的requestCode，（通過(guò)匹配requestCode 來(lái)實(shí)現(xiàn)該功能）

圖片.png

第三步：在第二個(gè)界面的setResult方法里面，寫(xiě)上對(duì)應(yīng)的resultCode，這里就不展示Intent數(shù)據(jù)了

圖片.png

綜合上面三個(gè)步驟，項(xiàng)目編譯運(yùn)行，跳轉(zhuǎn)到第二個(gè)界面然后返回上一個(gè)界面，日志成功打?。?/p>

圖片.png

ARouter路由框架的基本使用就介紹到這里，源碼分析請(qǐng)看第二篇。

探索Android路由框架-ARouter之深挖源碼

參考：http://m.itdecent.cn/p/6021f3f61fa6