Android scheme 跳轉(zhuǎn)的設計與實現(xiàn)詳解
緣起
隨著 App 的成長,我們難免會遇到以下這些需求:
- H5 跳原生界面
- Notification 點擊調(diào)相關(guān)界面
- 根據(jù)后臺返回數(shù)據(jù)跳轉(zhuǎn)界面,例如登錄成功后跳不同界面或者根據(jù)運營需求跳不同界面
- 實現(xiàn) AppLink 的跳轉(zhuǎn)
為了解決這些問題,App 一般都會自定義一個 scheme 跳轉(zhuǎn)協(xié)議,多端都實現(xiàn)這個協(xié)議,以此來解決各種運營需求。今天就來解析下QMUI最新版QMUISchemeHandler
的設計與實現(xiàn)。
一個 scheme 的格式大概是這樣子:
schemeName://action?param1=value1¶m2=value2
例如:
qmui://home?tab=2
從技術(shù)角度來講,實現(xiàn) scheme 的跳轉(zhuǎn)并不是件很難的事情,就是下面兩個步驟:
- 解析 scheme
- 根據(jù)解析結(jié)果跳轉(zhuǎn)指定界面
但是寫代碼時如果不加以設計,就容易是堆一堆的 if else。例如:
if(action=="action1"){ doAction1(params) }else if(action=="action2"){ doAction2(params) }else { ... }
每當有新的 scheme 添加時,就去添加一個 if,直到它逐漸變成一段巨長的爛代碼,改都改不動。因而我們要勤思考、多重構(gòu),盡早通過設計出優(yōu)良的框架來解放自己的雙手。
對于 if else 這類的重構(gòu),一個基本的方式就是用查表法,將所有的條件以及其所要執(zhí)行的行為放在一個 map 里,然后使用時通過去查詢這個 map 而獲取要執(zhí)行的行為。而我們可以通過注解配合代碼生成的方式構(gòu)建這個 map,從而減少我們代碼的編寫量。除此之外,我們還需要考慮各種功能性需求:
- 可以設置攔截器 interceptor,例如跳某些界面,如果是非登錄的狀態(tài),可能需要跳轉(zhuǎn)到登錄界面
- 參數(shù)可以指定一些基礎類型, scheme 所攜帶的參數(shù)的值都是字符串,但我們希望它可以方便的轉(zhuǎn)換成我們需要的基礎類型
- 同一個 action 可以根據(jù)參數(shù)的不同而有不同的跳轉(zhuǎn)行為,例如都是跳轉(zhuǎn)書籍詳情,漫畫書籍和普通書籍要跳轉(zhuǎn)的界面可能不一樣
- 如果當前界面已經(jīng)是目標界面,可以選擇刷新當前界面或者啟動一個新界面
- 對于 QMUI,是同時支持 Activity 和 Fragment 的,因而 scheme 也要同時支持這兩者
- 可以自定義新界面的實例化方法
接口設計
任何一個庫的開發(fā),為了讓業(yè)務使用方足夠舒心,既要保證庫的功能足夠強大,也要保證使用的方便性,QMUI Scheme 對外主要是QMUISchemeHandler
這個入口類, 以及ActivityScheme
和FragmentScheme
兩個注解。
QMUISchemeHandler
QMUISchemeHandler
通過 Builder 模式實例化:
// 設置schemeName val instance = QMUISchemeHandler.Builder("qmui://") // 防止短時間類觸發(fā)多次相同的scheme跳轉(zhuǎn) .blockSameSchemeTimeout(1000) // scheme 參數(shù) decode .addInterpolator(new QMUISchemeParamValueDecoder()) .addInterpolator(...) // 默認 fragment 實例化 factory .defaultFragmentFactory(...) // 默認 activity 實例化 factory .defaultIntentFactory(...) // 默認 scheme 匹配器 .defaultSchemeMatcher(...) .build(); if(!instance.handle("qmui://xxx")){ // scheme 未被 handle,日志記錄? }
大多數(shù)場景,QMUISchemeHandler
采用單例模式即可。 其可以設置多個攔截器、設置 fragment、activity 的默認實例化工廠、以及默認的匹配器。實例工廠和匹配器都是提供了默認實現(xiàn)的,大多數(shù)場景是不需要調(diào)用者關(guān)心的。而且這里都只是設置全局默認值,到了 scheme 注解那一層,還可以為每個 scheme 指定不同的值,以滿足可能的自定義需求。
ActivityScheme 與 FragmentScheme 注解
這兩個注解是非常相似的,但是因為 Fragment 有一些更多的配置項,因為獨立出來了。
@Retention(RetentionPolicy.CLASS) @Target(ElementType.TYPE) public @interface ActivityScheme { // scheme action 名 String name(); // 必須的參數(shù)列表,用于支持同一個 action 對應多個 scheme 的場景,每一項可以是"type=4" 來指定值,或者只傳"type"來匹配任意值 String[] required() default {}; // 如果當前界面就是 scheme 跳轉(zhuǎn)的目標值,可以選擇刷新當前界面,當然當前界面必須實現(xiàn) ActivitySchemeRefreshable boolean useRefreshIfCurrentMatched() default false; // 自定義當前 scheme 的匹配實現(xiàn)方法, 傳值為 QMUISchemeMatcher 的實現(xiàn) Class<?> customMatcher() default void.class; // 自定義當前 Activity 實例工廠,傳值為 QMUISchemeIntentFactory Class<?> customFactory() default void.class; // 指定參數(shù)的類型,支持 int/bool/long/float/double 這些基礎類型,不指定則為 string 類型 String[] keysWithIntValue() default {}; String[] keysWithBoolValue() default {}; String[] keysWithLongValue() default {}; String[] keysWithFloatValue() default {}; String[] keysWithDoubleValue() default {}; } @Retention(RetentionPolicy.CLASS) @Target(ElementType.TYPE) public @interface FragmentScheme { // 這些參數(shù)都同 ActivityScheme String name(); String[] required() default {}; Class<?> customMatcher() default void.class; String[] keysWithIntValue() default {}; String[] keysWithBoolValue() default {}; String[] keysWithLongValue() default {}; String[] keysWithFloatValue() default {}; String[] keysWithDoubleValue() default {}; //同 ActivityScheme,但當前UI必須實現(xiàn) FragmentSchemeRefreshable boolean useRefreshIfCurrentMatched() default false; // 同 ActivityScheme, 但傳值是 QMUISchemeFragmentFactory 的實現(xiàn)類 Class<?> customFactory() default void.class; // 可以承載目標 Fragment 的 activity 列表,如果當前 activity 不在列表里,則用 activities 的第一項啟動新的 activity Class<?>[] activities(); // 是否強制啟動新的 Activity boolean forceNewActivity() default false; // 可以通過 scheme 里的參數(shù)來控制是否強制啟動新的 Activity String forceNewActivityKey() default ""; }
可以看出,我們前面所羅列的各種需求,都在 SchemeHandler 以及兩個 scheme 里體現(xiàn)出來了。
使用
對于業(yè)務使用者,我們只需要在Activity
或者Fragment
上加上注解。QMUISchemeHandler
默認會將參數(shù)解析出來并放到Activity
的 intent 里或者Fragment
的 arguments 里,因而我們可以在onCreate
里將我們關(guān)心的值取出來:
@ActivityScheme(name="activity1") class Activity1: QMUIActivity{ override fun onCreate(...){ ... if(isStartedByScheme()){ // 通過 intent extra 獲取參數(shù)的值 val param1 = getIntent().getStringExtra(paramName) } } } @FragmentScheme(name="activity1", activities = {QDMainActivity.class}) class Fragment1: QMUIFragment{ override fun onCreate(...){ ... if(isStartedByScheme()){ // 通過 arguments 獲取參數(shù)的值 val param1 = getArguments().getString(paramName) } } }
這種傳值方法很符合 Android 官方設計的做法了,這也要求Fragment
遵循無參構(gòu)造器的使用方式。
對于 WebView, 我們可以通過重寫WebViewClient#shouldOverrideUrlLoading
來處理 scheme 跳轉(zhuǎn):
class MyWebViewClient: WebViewClient{ override fun shouldOverrideUrlLoading(view: WebView, url: String){ if(schemeHandler.handle(url)){ return true; } return super.shouldOverrideUrlLoading(view, url); } override fun shouldOverrideUrlLoading(view: WebView, request: WebResourceRequest){ if(schemeHandler.handle(request.getUrl().toString())){ return true; } return super.shouldOverrideUrlLoading(view, request); } }
實現(xiàn)
QMUISchemeHandler
采用代碼生成的方式,在編譯期生成一個SchemeMapImpl
類,其實現(xiàn)了SchemeMap
類
public interface SchemeMap { // 通過 action 和參數(shù)尋找 SchemeItem SchemeItem findScheme(QMUISchemeHandler handler, String schemeAction, Map<String, String> params); // 判斷 schemeAction 是否存在 boolean exists(QMUISchemeHandler handler, String schemeAction); }
而每個 scheme 的注解對應一個SchemeItem
:
ActivityScheme
對應實例化一個ActivitySchemeItem
類,并加入到 map 中FragmentScheme
對應實例化一個FragmentSchemeItem
類,并加入到 map 中
在編譯期通過SchemeProcessor
生成的SchemeMapImpl
大概是這樣子的:
public class SchemeMapImpl implements SchemeMap { private Map<String, List<SchemeItem>> mSchemeMap; public SchemeMapImpl() { mSchemeMap = new HashMap<>(); List<SchemeItem> elements; ArrayMap<String, String> required = null; elements = new ArrayList<>(); required =null; elements.add(new FragmentSchemeItem(QDSliderFragment.class,false,new Class[]{QDMainActivity.class},null,false,"",required,null,null,null,null,null,SliderSchemeMatcher.class)); mSchemeMap.put("slider", elements); elements = new ArrayList<>(); required = new ArrayMap<>(); required.put("aa", null); required.put("bb", "3"); elements.add(new ActivitySchemeItem(ArchTestActivity.class,true,null,required,null,new String[]{"aa"},null,null,null,null)); mSchemeMap.put("arch", elements); } @Override public SchemeItem findScheme(QMUISchemeHandler arg0, String arg1, Map<String, String> arg2) { List<SchemeItem> list = mSchemeMap.get(arg1); if(list == null || list.isEmpty()) { return null; } for (int i = 0; i < list.size(); i++) { SchemeItem item = list.get(i); if(item.match(arg0, arg2)) { return item; } } return null; } @Override public boolean exists(QMUISchemeHandler arg0, String arg1) { return mSchemeMap.containsKey(arg1); } }
整體的設計以及實現(xiàn)思路就是這樣,剩下的就是各種編碼細節(jié)了。有興趣的可以通過QMUISchemeHandler#handle()
進行追蹤下,或者看看SchemeProcessor
是如何做代碼生成的。這個功能看上去簡單,其實也包括了 Builder 模式、責任鏈模式、工廠方法等設計模式的運用,還有 SchemeMatcher、 SchemeItem 等對面向?qū)ο蟮慕涌?、繼承、多態(tài)等的運用。讀一讀或許對你有所啟迪,或許你也能幫我發(fā)現(xiàn)某些潛在的 Bug。
總結(jié)
到此這篇關(guān)于Android scheme 跳轉(zhuǎn)的設計與實現(xiàn)的文章就介紹到這了,更多相關(guān)Android scheme 跳轉(zhuǎn)的設計與實現(xiàn)內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Android RecycleView 實現(xiàn)左滑上下分層示例代碼(自定義功能)
這篇文章主要介紹了Android RecycleView 實現(xiàn)左滑上下分層示例代碼(自定義功能),具有一定的參考價值,感興趣的小伙伴們可以參考一下。2017-03-03Android學習教程之下拉刷新實現(xiàn)代碼(11)
這篇文章主要為大家詳細介紹了Android學習教程之下拉刷新實現(xiàn)代碼,具有一定的參考價值,感興趣的小伙伴們可以參考一下2016-11-11詳解Android 基于TCP和UDP協(xié)議的Socket通信
這篇文章主要介紹了詳解Android 基于TCP和UDP協(xié)議的Socket通信,小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2017-11-11Android編程實現(xiàn)ActionBar的home圖標動畫切換效果
這篇文章主要介紹了Android編程實現(xiàn)ActionBar的home圖標動畫切換效果,涉及Android布局、樣式、Activity及菜單相關(guān)操作技巧,需要的朋友可以參考下2017-01-01Jetpack Compose實現(xiàn)對話框和進度條實例解析
對話框和進度條其實并無多大聯(lián)系,放在一起寫是因為兩者的內(nèi)容都不多,所以湊到一起,對話框是我們平時開發(fā)使用得比較多的組件,進度條的使用頻率也很高,比如下載文件,上傳文件,處理任務時都可以使用進度條2023-04-04Android編程實現(xiàn)點擊鏈接打開APP功能示例
這篇文章主要介紹了Android編程實現(xiàn)點擊鏈接打開APP功能,結(jié)合實例形式較為詳細的分析了Android實現(xiàn)點擊鏈接打開APP功能的具體步驟與相關(guān)注意事項,需要的朋友可以參考下2017-01-01Android簡單實現(xiàn)無限滾動自動滾動的ViewPager
這篇文章主要介紹了Android簡單實現(xiàn)無限滾動自動滾動的ViewPager,百度谷歌上面也有很多關(guān)于這方面的教程,但是感覺都略顯麻煩,而且封裝的都不是很徹底。所以試著封裝一個比較好用的ViewPager,實現(xiàn)思路一起通過本文學習吧2016-12-12