Android scheme 跳轉(zhuǎn)的設(shè)計(jì)與實(shí)現(xiàn)詳解
緣起
隨著 App 的成長,我們難免會遇到以下這些需求:
- H5 跳原生界面
- Notification 點(diǎn)擊調(diào)相關(guān)界面
- 根據(jù)后臺返回?cái)?shù)據(jù)跳轉(zhuǎn)界面,例如登錄成功后跳不同界面或者根據(jù)運(yùn)營需求跳不同界面
- 實(shí)現(xiàn) AppLink 的跳轉(zhuǎn)
為了解決這些問題,App 一般都會自定義一個 scheme 跳轉(zhuǎn)協(xié)議,多端都實(shí)現(xiàn)這個協(xié)議,以此來解決各種運(yùn)營需求。今天就來解析下QMUI最新版QMUISchemeHandler的設(shè)計(jì)與實(shí)現(xiàn)。
一個 scheme 的格式大概是這樣子:
schemeName://action?param1=value1¶m2=value2
例如:
qmui://home?tab=2
從技術(shù)角度來講,實(shí)現(xiàn) scheme 的跳轉(zhuǎn)并不是件很難的事情,就是下面兩個步驟:
- 解析 scheme
- 根據(jù)解析結(jié)果跳轉(zhuǎn)指定界面
但是寫代碼時如果不加以設(shè)計(jì),就容易是堆一堆的 if else。例如:
if(action=="action1"){
doAction1(params)
}else if(action=="action2"){
doAction2(params)
}else {
...
}
每當(dāng)有新的 scheme 添加時,就去添加一個 if,直到它逐漸變成一段巨長的爛代碼,改都改不動。因而我們要勤思考、多重構(gòu),盡早通過設(shè)計(jì)出優(yōu)良的框架來解放自己的雙手。
對于 if else 這類的重構(gòu),一個基本的方式就是用查表法,將所有的條件以及其所要執(zhí)行的行為放在一個 map 里,然后使用時通過去查詢這個 map 而獲取要執(zhí)行的行為。而我們可以通過注解配合代碼生成的方式構(gòu)建這個 map,從而減少我們代碼的編寫量。除此之外,我們還需要考慮各種功能性需求:
- 可以設(shè)置攔截器 interceptor,例如跳某些界面,如果是非登錄的狀態(tài),可能需要跳轉(zhuǎn)到登錄界面
- 參數(shù)可以指定一些基礎(chǔ)類型, scheme 所攜帶的參數(shù)的值都是字符串,但我們希望它可以方便的轉(zhuǎn)換成我們需要的基礎(chǔ)類型
- 同一個 action 可以根據(jù)參數(shù)的不同而有不同的跳轉(zhuǎn)行為,例如都是跳轉(zhuǎn)書籍詳情,漫畫書籍和普通書籍要跳轉(zhuǎn)的界面可能不一樣
- 如果當(dāng)前界面已經(jīng)是目標(biāo)界面,可以選擇刷新當(dāng)前界面或者啟動一個新界面
- 對于 QMUI,是同時支持 Activity 和 Fragment 的,因而 scheme 也要同時支持這兩者
- 可以自定義新界面的實(shí)例化方法
接口設(shè)計(jì)
任何一個庫的開發(fā),為了讓業(yè)務(wù)使用方足夠舒心,既要保證庫的功能足夠強(qiáng)大,也要保證使用的方便性,QMUI Scheme 對外主要是QMUISchemeHandler這個入口類, 以及ActivityScheme和FragmentScheme兩個注解。
QMUISchemeHandler
QMUISchemeHandler通過 Builder 模式實(shí)例化:
// 設(shè)置schemeName
val instance = QMUISchemeHandler.Builder("qmui://")
// 防止短時間類觸發(fā)多次相同的scheme跳轉(zhuǎn)
.blockSameSchemeTimeout(1000)
// scheme 參數(shù) decode
.addInterpolator(new QMUISchemeParamValueDecoder())
.addInterpolator(...)
// 默認(rèn) fragment 實(shí)例化 factory
.defaultFragmentFactory(...)
// 默認(rèn) activity 實(shí)例化 factory
.defaultIntentFactory(...)
// 默認(rèn) scheme 匹配器
.defaultSchemeMatcher(...)
.build();
if(!instance.handle("qmui://xxx")){
// scheme 未被 handle,日志記錄?
}
大多數(shù)場景,QMUISchemeHandler采用單例模式即可。 其可以設(shè)置多個攔截器、設(shè)置 fragment、activity 的默認(rèn)實(shí)例化工廠、以及默認(rèn)的匹配器。實(shí)例工廠和匹配器都是提供了默認(rèn)實(shí)現(xiàn)的,大多數(shù)場景是不需要調(diào)用者關(guān)心的。而且這里都只是設(shè)置全局默認(rèn)值,到了 scheme 注解那一層,還可以為每個 scheme 指定不同的值,以滿足可能的自定義需求。
ActivityScheme 與 FragmentScheme 注解
這兩個注解是非常相似的,但是因?yàn)?Fragment 有一些更多的配置項(xiàng),因?yàn)楠?dú)立出來了。
@Retention(RetentionPolicy.CLASS)
@Target(ElementType.TYPE)
public @interface ActivityScheme {
// scheme action 名
String name();
// 必須的參數(shù)列表,用于支持同一個 action 對應(yīng)多個 scheme 的場景,每一項(xiàng)可以是"type=4" 來指定值,或者只傳"type"來匹配任意值
String[] required() default {};
// 如果當(dāng)前界面就是 scheme 跳轉(zhuǎn)的目標(biāo)值,可以選擇刷新當(dāng)前界面,當(dāng)然當(dāng)前界面必須實(shí)現(xiàn) ActivitySchemeRefreshable
boolean useRefreshIfCurrentMatched() default false;
// 自定義當(dāng)前 scheme 的匹配實(shí)現(xiàn)方法, 傳值為 QMUISchemeMatcher 的實(shí)現(xiàn)
Class<?> customMatcher() default void.class;
// 自定義當(dāng)前 Activity 實(shí)例工廠,傳值為 QMUISchemeIntentFactory
Class<?> customFactory() default void.class;
// 指定參數(shù)的類型,支持 int/bool/long/float/double 這些基礎(chǔ)類型,不指定則為 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,但當(dāng)前UI必須實(shí)現(xiàn) FragmentSchemeRefreshable
boolean useRefreshIfCurrentMatched() default false;
// 同 ActivityScheme, 但傳值是 QMUISchemeFragmentFactory 的實(shí)現(xiàn)類
Class<?> customFactory() default void.class;
// 可以承載目標(biāo) Fragment 的 activity 列表,如果當(dāng)前 activity 不在列表里,則用 activities 的第一項(xiàng)啟動新的 activity
Class<?>[] activities();
// 是否強(qiáng)制啟動新的 Activity
boolean forceNewActivity() default false;
// 可以通過 scheme 里的參數(shù)來控制是否強(qiáng)制啟動新的 Activity
String forceNewActivityKey() default "";
}
可以看出,我們前面所羅列的各種需求,都在 SchemeHandler 以及兩個 scheme 里體現(xiàn)出來了。
使用
對于業(yè)務(wù)使用者,我們只需要在Activity或者Fragment上加上注解。QMUISchemeHandler默認(rèn)會將參數(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 官方設(shè)計(jì)的做法了,這也要求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);
}
}
實(shí)現(xiàn)
QMUISchemeHandler采用代碼生成的方式,在編譯期生成一個SchemeMapImpl類,其實(shí)現(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 的注解對應(yīng)一個SchemeItem:
ActivityScheme對應(yīng)實(shí)例化一個ActivitySchemeItem類,并加入到 map 中FragmentScheme對應(yīng)實(shí)例化一個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);
}
}
整體的設(shè)計(jì)以及實(shí)現(xiàn)思路就是這樣,剩下的就是各種編碼細(xì)節(jié)了。有興趣的可以通過QMUISchemeHandler#handle()進(jìn)行追蹤下,或者看看SchemeProcessor是如何做代碼生成的。這個功能看上去簡單,其實(shí)也包括了 Builder 模式、責(zé)任鏈模式、工廠方法等設(shè)計(jì)模式的運(yùn)用,還有 SchemeMatcher、 SchemeItem 等對面向?qū)ο蟮慕涌?、繼承、多態(tài)等的運(yùn)用。讀一讀或許對你有所啟迪,或許你也能幫我發(fā)現(xiàn)某些潛在的 Bug。
總結(jié)
到此這篇關(guān)于Android scheme 跳轉(zhuǎn)的設(shè)計(jì)與實(shí)現(xiàn)的文章就介紹到這了,更多相關(guān)Android scheme 跳轉(zhuǎn)的設(shè)計(jì)與實(shí)現(xiàn)內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Android實(shí)現(xiàn)ImageView圖片縮放和拖動
這篇文章主要為大家詳細(xì)介紹了Android實(shí)現(xiàn)ImageView圖片縮放和拖動的相關(guān)資料,具有一定的參考價值,感興趣的小伙伴們可以參考一下2016-11-11
Android ViewDragHelper完全解析 自定義ViewGroup神器
這篇文章主要為大家詳細(xì)介紹了Android ViewDragHelper完全解析,自定義ViewGroup神器,具有一定的參考價值,感興趣的小伙伴們可以參考一下2017-03-03
Android監(jiān)聽滑動控件實(shí)現(xiàn)狀態(tài)欄顏色切換
這篇文章給大家分享一個平時在滑動頁面經(jīng)常遇到的效果:滑動過程動態(tài)修改狀態(tài)欄顏色,文中有詳細(xì)的示例代碼,對我們的學(xué)習(xí)或工作有一定的幫助,感興趣的小伙伴自己動手試試吧2023-08-08
Android ListView自動生成列表?xiàng)l目的實(shí)例
下面小編就為大家分享一篇Android ListView自動生成列表?xiàng)l目的實(shí)例,具有很好的 參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2018-01-01
Android中Retrofit 2.0直接使用JSON進(jìn)行數(shù)據(jù)交互
本篇文章主要介紹了Android中Retrofit 2.0直接使用JSON進(jìn)行數(shù)據(jù)交互,具有一定的參考價值,有興趣的可以了解一下2017-08-08
Android中FileProvider的各種場景應(yīng)用詳解
這篇文章主要為大家介紹了Android中FileProvider的各種場景應(yīng)用詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-09-09
Android中LayoutInflater.inflater()的正確打開方式
這篇文章主要給大家介紹了關(guān)于Android中LayoutInflater.inflater()的正確打開方式,文中通過示例代碼介紹的非常詳細(xì),需要的朋友可以參考借鑒,下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2018-12-12
在Android中使用SQLite數(shù)據(jù)庫及其操作詳解
在?Android?開發(fā)中,使用?SQLite?數(shù)據(jù)庫是一種常見的持久化數(shù)據(jù)存儲方式,本文將通過代碼示例詳細(xì)講解如何在?Android?中創(chuàng)建數(shù)據(jù)庫表、插入數(shù)據(jù)、執(zhí)行查詢操作以及驗(yàn)證查詢結(jié)果,需要的朋友可以參考下2024-08-08
Android通過自定義ImageView控件實(shí)現(xiàn)圖片的縮放和拖動的實(shí)現(xiàn)代碼
通過自定義ImageView控件,在xml布局里面調(diào)用自定的組件實(shí)現(xiàn)圖片的縮放。下面給大家分享實(shí)現(xiàn)代碼,感興趣的朋友一起看看吧2016-10-10

