1.路由介紹
什么是路由框架啥纸？
說簡單點(diǎn)就是映射頁面跳轉(zhuǎn)關(guān)系的，當(dāng)然它也包含跳轉(zhuǎn)相關(guān)的一切功能
為什么使用ARouter?
我們先從適用場景來分析：
動(dòng)態(tài)跳轉(zhuǎn)：一般來說復(fù)雜的電商跳轉(zhuǎn)多頁面需要很強(qiáng)的靈活性婴氮，很多情況下是運(yùn)營人員動(dòng)態(tài)配置的下發(fā)活動(dòng)頁面斯棒，需要靈活的進(jìn)行跳轉(zhuǎn)。
組件化：隨著業(yè)務(wù)量的不斷增長主经，app也會(huì)不斷的膨脹荣暮，開發(fā)團(tuán)隊(duì)的規(guī)模和工作量也會(huì)逐漸增大，面對所衍生的64K問題旨怠、協(xié)作開發(fā)問題等渠驼，app一般都會(huì)走向組件化。組件化就是將APP按照一定的功能和業(yè)務(wù)拆分成多個(gè)組件module，不同的組件獨(dú)立開發(fā)迷扇，組件化不僅能夠提供團(tuán)隊(duì)的工作效率百揭，還能夠提高應(yīng)用性能。而組件化的前提就是解耦蜓席，那么我們首先要做的就是解耦頁面之間的依賴關(guān)系
Native與H5的問題：現(xiàn)在的APP很少是純Native的器一，也很少會(huì)有純H5的，一般情況下都是將兩者進(jìn)行結(jié)合厨内。這時(shí)候就需要非常便捷并且統(tǒng)一的跳轉(zhuǎn)方案祈秕，因?yàn)樵贖5中是無法使用StartActivity()跳轉(zhuǎn)到Native頁面的，而從Native跳轉(zhuǎn)到H5頁面也只能通過配置瀏覽器的方式實(shí)現(xiàn)
其他等場景
原生跳轉(zhuǎn)方式的不足
- 顯式跳轉(zhuǎn)雏胃， Intent intent = new Intent(activity, XXActivity.class);
由于需要直接持有對應(yīng)class请毛，從而導(dǎo)致了強(qiáng)依賴關(guān)系，提高了耦合度
- 隱式跳轉(zhuǎn)瞭亮，譬如 Intent intent = new Intent(); intent.setAction(“com.android.activity.MY_ACTION”);
action等屬性的定義在Manifest方仿，導(dǎo)致了擴(kuò)展性較差
規(guī)則集中式管理，導(dǎo)致協(xié)作變得非常困難统翩。
- 原生的路由方案會(huì)出現(xiàn)跳轉(zhuǎn)過程無法控制的問題仙蚜，因?yàn)橐坏┦褂昧薙tartActivity()就無法插手其中任何環(huán)節(jié)了，只能交給系統(tǒng)管理厂汗，這就導(dǎo)致了在跳轉(zhuǎn)失敗的情況下無法降級委粉，而是會(huì)直接拋出運(yùn)行時(shí)的異常。
2.ARouter的使用
1.添加框架的依賴和配置
在各個(gè)模塊的build.gradle中添加編譯參數(shù)和依賴的框架
android {
defaultConfig {
...
javaCompileOptions {
annotationProcessorOptions {
arguments = [ moduleName : project.getName() ]
}
}
}
}
dependencies {
// 替換成最新版本, 需要注意的是api
// 要與compiler匹配使用娶桦，均使用最新版可以保證兼容
compile 'com.alibaba:arouter-api:1.2.2'
annotationProcessor 'com.alibaba:arouter-compiler:1.1.3'
...
}
// 舊版本gradle插件(< 2.2)贾节，可以使用apt插件，在根build.gradle中配置方法
apply plugin: 'com.neenbedankt.android-apt'
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.4'
}
}
2.添加注解
// 在支持路由的頁面上添加注解(必選)
// 這里的路徑需要注意的是至少需要有兩級趟紊，/xx/xx
@Route(path = "/test/activity")
public class YourActivity extend Activity {
...
}
3.初始化SDK
if (isDebug()) { // 這兩行必須寫在init之前氮双，否則這些配置在init過程中將無效
ARouter.openLog(); // 打印日志
ARouter.openDebug(); // 開啟調(diào)試模式(如果在InstantRun模式下運(yùn)行，必須開啟調(diào)試模式霎匈！線上版本需要關(guān)閉,否則有安全風(fēng)險(xiǎn))
}
ARouter.init(mApplication); // 盡可能早戴差，推薦在Application中初始化
4.路由操作
// 1.普通跳轉(zhuǎn)
ARouter.getInstance().build("/test/activity").navigation();
// 2.跳轉(zhuǎn)并攜帶參數(shù)
ARouter.getInstance().build("/test/activity2").navigation();
// 3.跳轉(zhuǎn)并攜帶請求碼
ARouter.getInstance().build("/test/activity2").navigation(this, requestCode);
// 4.URI跳轉(zhuǎn)
/*這種使用URi的方式中，URi的Scheme 和 host不影響結(jié)果铛嘱，可以隨便設(shè)暖释，關(guān)鍵的是path
* - build(URI)會(huì)把URI解析為path，并把當(dāng)前URI存入PostCard
* - build(String)構(gòu)造的PostCard不存儲(chǔ)URI*/
Uri testUriMix = Uri.parse("xx://xxx/test/activity2");
ARouter.getInstance().build(testUriMix)
.withString("name", "老王")
.withInt("age", 18)
.withBoolean("boy", true)
.withLong("high", 180)
.withString("url", "https://a.b.c")
.withParcelable("pac", testParcelable)
.withObject("obj", testObj)
.navigation();
// 5.跳轉(zhuǎn)包含回調(diào) 單次降級策略可以在這里使用
ARouter.getInstance().build("/test/activity2").navigation(Context mContext, int requestCode, NavigationCallback callback);
5.配置自定義序列化方式
上訴的代碼中有withObject進(jìn)行傳參墨吓，沒有定義序列化方式是無法進(jìn)行解析因此需要定義一個(gè)序列化方式,以下采用FastJson進(jìn)行序列化
// 如果需要傳遞自定義對象球匕，需要實(shí)現(xiàn) SerializationService,并使用@Route注解標(biāo)注(方便用戶自行選擇序列化方式)，例如：
@Route(path = "/service/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);
}
}
6.聲明攔截器(攔截跳轉(zhuǎn)過程帖烘，面向切面編程)
// 比較經(jīng)典的應(yīng)用就是在跳轉(zhuǎn)過程中處理登陸事件亮曹，這樣就不需要在目標(biāo)頁重復(fù)做登陸檢查
// 攔截器會(huì)在跳轉(zhuǎn)之間執(zhí)行，多個(gè)攔截器會(huì)按優(yōu)先級順序依次執(zhí)行
@Interceptor(priority = 8, name = "測試用攔截器")
public class TestInterceptor implements IInterceptor {
@Override
public void process(Postcard postcard, InterceptorCallback callback) {
...
callback.onContinue(postcard); // 處理完成，交還控制權(quán)
// callback.onInterrupt(new RuntimeException("我覺得有點(diǎn)異常")); // 覺得有問題照卦，中斷路由流程
// 以上兩種至少需要調(diào)用其中一種式矫，否則不會(huì)繼續(xù)路由
}
@Override
public void init(Context context) {
// 攔截器的初始化，會(huì)在sdk初始化的時(shí)候調(diào)用該方法役耕，僅會(huì)調(diào)用一次
}
}
// 我們經(jīng)常需要在目標(biāo)頁面中配置一些屬性采转，比方說"是否需要登陸"之類的
// 可以通過 Route 注解中的 extras 屬性進(jìn)行擴(kuò)展，這個(gè)屬性是一個(gè) int值瞬痘，換句話說故慈，單個(gè)int有4字節(jié)，也就是32位框全，可以配置32個(gè)開關(guān)
// 剩下的可以自行發(fā)揮察绷，通過字節(jié)操作可以標(biāo)識32個(gè)開關(guān)，通過開關(guān)標(biāo)記目標(biāo)頁面的一些屬性津辩，在攔截器中可以拿到這個(gè)標(biāo)記進(jìn)行業(yè)務(wù)邏輯判斷
@Route(path = "/test/activity", extras = Consts.XXXX)
7.通過依賴注入解耦:服務(wù)管理(一) 暴露服務(wù)
// 聲明接口,其他組件通過接口來調(diào)用服務(wù)
public interface HelloService extends IProvider {
String sayHello(String name);
}
// 實(shí)現(xiàn)接口
@Route(path = "/service/hello", name = "測試服務(wù)")
public class HelloServiceImpl implements HelloService {
@Override
public String sayHello(String name) {
return "hello, " + name;
}
@Override
public void init(Context context) {
}
}
8.通過依賴注入解耦:服務(wù)管理(二) 發(fā)現(xiàn)服務(wù)
public class Test {
@Autowired
HelloService helloService;
@Autowired(name = "/service/hello")
HelloService helloService2;
HelloService helloService3;
HelloService helloService4;
public Test() {
ARouter.getInstance().inject(this);
}
public void testService() {
// 1. (推薦)使用依賴注入的方式發(fā)現(xiàn)服務(wù),通過注解標(biāo)注字段,即可使用克婶，無需主動(dòng)獲取
// Autowired注解中標(biāo)注name之后，將會(huì)使用byName的方式注入對應(yīng)的字段丹泉，不設(shè)置name屬性，會(huì)默認(rèn)使用byType的方式發(fā)現(xiàn)服務(wù)(當(dāng)同一接口有多個(gè)實(shí)現(xiàn)的時(shí)候鸭蛙，必須使用byName的方式發(fā)現(xiàn)服務(wù))
helloService.sayHello("Vergil");
helloService2.sayHello("Vergil");
// 2. 使用依賴查找的方式發(fā)現(xiàn)服務(wù)摹恨，主動(dòng)去發(fā)現(xiàn)服務(wù)并使用，下面兩種方式分別是byName和byType
helloService3 = ARouter.getInstance().navigation(HelloService.class);
helloService4 = (HelloService) ARouter.getInstance().build("/service/hello").navigation();
helloService3.sayHello("Vergil");
helloService4.sayHello("Vergil");
}
小結(jié)
官方的文檔Github很詳細(xì)可以去看看
以上方式可以進(jìn)行簡單的入門使用了娶视，下一步我們從源碼分析晒哄。
