5步教你快速寫一個(gè)android Router路由框架
Router路由框架
什么是路由?說簡單點(diǎn)就是映射頁面跳轉(zhuǎn)關(guān)系的,當(dāng)然它也包含跳轉(zhuǎn)相關(guān)的一切功能。
前言
網(wǎng)上大片的路由框架實(shí)在太多了,實(shí)現(xiàn)的方式都大同小異,通過注解實(shí)現(xiàn)路由表;但是在多module開發(fā)的時(shí)候怎么合并路由表,不同的框架有著自己的解決方案。
ARouter:通過類查找進(jìn)行合并路由表。
ActivityRouter:通過注解進(jìn)行路由表合并。
路由框架的意義
Android系統(tǒng)已經(jīng)給我們提供了api來做頁面跳轉(zhuǎn),比如startActivity,為什么還需要路由框架呢?我們來簡單分析下路由框架存在的意義:
- 在一些復(fù)雜的業(yè)務(wù)場景下,靈活性比較強(qiáng),很多功能都是動態(tài)配置的,比如下發(fā)一個(gè)活動頁面,我們事先并不知道具體的目標(biāo)頁面,但如果事先做了約定,提前做好頁面映射,便可以自由配置。
- 隨著業(yè)務(wù)量的增長,客戶端必然隨之膨脹,開發(fā)人員的工作量越來越大,比如64K問題,比如協(xié)作開發(fā)問題。App一般都會走向組件化的道路,而組件化的前提就是解耦,那么我們首先要做的就是解耦頁面之間的依賴關(guān)系。
- 簡化代碼。數(shù)行跳轉(zhuǎn)代碼精簡成一行代碼。
特性
Router有哪些特性或者優(yōu)點(diǎn)呢?
- 基于注解,使用方便,源碼簡潔
- 鏈?zhǔn)秸{(diào)用,api友好
- 多路徑支持
- 結(jié)果回調(diào),每次跳轉(zhuǎn)都會回調(diào)跳轉(zhuǎn)結(jié)果
- 編譯期處理注解,不影響運(yùn)行時(shí)性能
- 除了可以使用注解定義路由,還支持手動分配路由
- 自定義攔截器,可以對路由進(jìn)行攔截,比如登錄判斷和埋點(diǎn)處理
- 自定義路由匹配規(guī)則,相比較其他路由框架,該項(xiàng)目并沒有限制路由的寫法,除了內(nèi)置的幾個(gè)匹配器,用戶完全可以定義自己的規(guī)則
- 支持隱式Intent跳轉(zhuǎn)
- 支持多模塊使用,支持組件化開發(fā)
- 不僅支持注解Activity,還支持注解Fragment
- 支持Kotlin
開始
對于路由表的合并我采用了ActivityRouter的方案,進(jìn)行注解合并路由表。
1.源碼:
if (!hasModules && !hasModule){ //普通app createrAppRouterHelper(); } if (hasModule){ //保存每個(gè)module中的路由表 createrModuleHelper(moduleName); } if (hasModules){ //合并每個(gè)module中的路由表 createrRouterHelper(moduleNames); }
2.用法:
app:
@Module("app") @Modules({"app","module"}) public class App extends Application{ ... }
module:
@Module("module") @Path("module") public class ModuleActivity extends AppCompatActivity { ... }
3.備注:非多module開發(fā)以上直接省略直接初始化路由即可
初始化
Router.init(this.getApplicationContext());//bixu Router.debug(true);//開啟debug模式
頁面跳轉(zhuǎn)
程序內(nèi)部界面之間跳轉(zhuǎn) 通過 path 查找路由表中 對應(yīng)的Activity 進(jìn)行頁面跳轉(zhuǎn)。
外部跳轉(zhuǎn)程序內(nèi)部 通過 uri 攔截 Activity 對uri進(jìn)行攔截處理并最終通過路由表查找 path進(jìn)行跳轉(zhuǎn)。
1.用法
基本用法
Router.getInstance().path("second"); Router.getInstance().action(MediaStore.ACTION_IMAGE_CAPTURE); Router.getInstance().uri("https://www.waws.top/module?id=2&name=haha");
okhttp式用法
//同步Request request = new Request.Builder(this).path("second").build(); Response response = Router.getInstance().newCall(request).execute(); //異步request = new Request.Builder(this) .path("second") .responseCode(100) .resultCallBack(new ResultCallBack() { @Override public void next(int resultCode, Intent data) { RouterLog.d("resultCode:"+resultCode+"\ndata:"+data.getStringExtra("tag")); } }) .addOption(ActivityOptions.makeSceneTransitionAnimation(this,bt,"share").toBundle()) .build(); Router.getInstance().skipIntecepter().newCall(request) .enqueue(new RouterCallBack() { @Override public void next(Response response) { RouterLog.d(response.toString()); } });
攔截Activity onActivityResult 使用了代理Fragment進(jìn)行動態(tài)攔截,有興趣的可以看源碼,地址在下邊
攔截器
支持全局?jǐn)r截并支持降級操作
Router.addIntecepter(new RouterIntecepter() { @Override public Request chain(Request request) { //TODO: return request; } @Override public void onLost(String msg) { //TODO: Log.d("App", "onLost: "+msg); } @Override public void onSuccess() { //TODO: Log.d("App", "onSuccess: "); } });
外部跳轉(zhuǎn)app內(nèi)部進(jìn)行如下配置
<activity android:name=".DispatcherActivity"> <intent-filter> <action android:name="android.intent.action.VIEW"/> <category android:name="android.intent.category.BROWSABLE"/> <category android:name="android.intent.category.DEFAULT"/> <!-- start --> <!-- 修改如下data信息即可 --> <data android:scheme="http" android:host="www.waws.top"/> <data android:scheme="https" android:host="www.waws.top"/> <data android:scheme="router" android:host="www.waws.top"/> <!-- end --> </intent-filter></activity>
源碼地址:https://github.com/waws80/Router
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
android自定義控件ImageView實(shí)現(xiàn)圓形圖片
這篇文章主要為大家詳細(xì)介紹了android自定義控件ImageView實(shí)現(xiàn)圓形圖片,適用于用戶頭像,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2017-12-12Android中微信搶紅包助手的實(shí)現(xiàn)詳解
本篇文章主要介紹了Android中微信搶紅包助手的實(shí)現(xiàn)詳解,通過利用AccessibilityService輔助服務(wù),監(jiān)測屏幕內(nèi)容,如監(jiān)聽狀態(tài)欄的信息,屏幕跳轉(zhuǎn)等,以此來實(shí)現(xiàn)自動拆紅包的功能,有興趣的可以了解一下。2017-02-02Android自定義view實(shí)現(xiàn)滾動選擇控件詳解
最近在開發(fā)中需要實(shí)現(xiàn)滾動進(jìn)行類別的選擇,也就是我們所說的滾動選擇器,這里我們自定義來實(shí)現(xiàn)這個(gè)功能,這篇文章主要介紹了Android自定義view實(shí)現(xiàn)滾動選擇控件2022-11-11Android、iOS和Windows Phone中的推送技術(shù)詳解
這篇文章主要介紹了Android、iOS和Windows Phone中的推送技術(shù)詳解,推送技術(shù)的實(shí)現(xiàn)通常會使用服務(wù)端向客戶端推送消息的方式,也就是說客戶端通過用戶名、Key等ID注冊到服務(wù)端后,在服務(wù)端就可以將消息向所有活動的客戶端發(fā)送,需要的朋友可以參考下2015-01-01Android中實(shí)現(xiàn)密碼的隱藏和顯示的示例
本篇文章主要介紹了Android中實(shí)現(xiàn)密碼的隱藏和顯示的示例,非常具有實(shí)用價(jià)值,需要的朋友可以參考下2017-09-09Android開發(fā)中計(jì)算器的sin、cos及tan值計(jì)算問題分析
這篇文章主要介紹了Android開發(fā)中計(jì)算器的sin、cos及tan值計(jì)算問題,結(jié)合實(shí)例形式分析了Android三角函數(shù)運(yùn)算中的弧度與角度計(jì)算問題與相關(guān)解決方法,需要的朋友可以參考下2017-11-11Android實(shí)現(xiàn)動態(tài)顯示或隱藏密碼輸入框的內(nèi)容
這篇文章主要介紹了Android實(shí)現(xiàn)動態(tài)顯示或隱藏密碼輸入框的內(nèi)容,主要通過設(shè)置EditText的setTransformationMethod()方法來實(shí)現(xiàn),需要的朋友可以參考下2014-09-09Compose開發(fā)之動畫藝術(shù)探索及實(shí)現(xiàn)示例
這篇文章主要為大家介紹了Compose開發(fā)之動畫藝術(shù)探索及實(shí)現(xiàn)示例,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-09-09