WMRouter：美团外卖Android开源路由框架
WMRouter是一款Android路由框架，基于組件化的設計思路，功能靈活，使用也比較簡單。
WMRouter最初用于解決美團外賣C端App在業務演進過程中的實際問題，之后逐步推廣到了美團其他App，因此我們決定將其開源，希望更多技術同行一起開發，應用到更廣泛的場景里去。Github項目地址與使用文檔詳見 https://github.com/meituan/WMRouter。
本文先簡單介紹WMRouter的功能和適用場景，然后詳細介紹WMRouter的發展背景和過程。
功能簡介
WMRouter主要提供URI分發、ServiceLoader兩大功能。
URI分發功能可用于多工程之間的頁面跳轉、動態下發URI鏈接的跳轉等場景，特點如下：
基于SPI (Service Provider Interfaces) 的設計思想，WMRouter提供了ServiceLoader模塊，類似Java中的java.util.ServiceLoader，但功能更加完善。通過ServiceLoader可以在一個App的多個模塊之間通過接口調用代碼，實現模塊解耦，便于實現組件化、模塊間通信，以及和依賴注入類似的功能等。其特點如下：
其他特性：
適用場景
WMRouter適用但不限于以下場景：
Native+H5混合開發模式，需要進行頁面之間的互相跳轉，或進行靈活的運營跳轉鏈接下發?？梢岳肳MRouter統一頁面跳轉邏輯，根據不同的協議（HTTP、HTTPS、用于Native頁面的自定義協議）跳轉對應頁面，且在跳轉過程中可以使用UriInterceptor對跳轉鏈接進行修改，例如跳轉H5頁面時在URL中加參數。
統一管理來自App外部的URI跳轉。來自App外部的URI跳轉，如果使用Android原生的Manifest配置，會直接啟動匹配的Activity，而很多時候希望先正常啟動App打開首頁，完成常規初始化流程（例如登錄、定位等）后再跳轉目標頁面。此時可以使用統一的Activity接收所有外部URI跳轉，到首頁時再用WMRouter啟動目標頁面。
頁面跳轉有復雜判斷邏輯的場景。例如多個頁面都需要先登錄、先定位后才允許打開，如果使用常規方案，這些頁面都需要處理相同的業務邏輯；而利用WMRouter，只需要開發好UriInterceptor并配置到各個頁面即可。
多工程、組件化、平臺化開發。多工程開發要求各個工程之間能互相通信，也可能遇到和外賣App類似的代碼復用、依賴注入、編譯等問題，這些問題都可以利用WMRouter的URI分發和ServiceLoader模塊解決。
對業務埋點需求較強的場景。頁面跳轉作為最常見的業務邏輯之一，常常需要埋點。給每個頁面配置好URI，使用WMRouter統一進行頁面跳轉，并在全局的OnCompleteListener中埋點即可。
對App可用性要求較高的場景。一方面，可以對頁面跳轉失敗進行埋點監控上報，及時發現線上問題；另一方面，頁面跳轉時可以執行判斷邏輯，發現異常（例如服務端異常、客戶端崩潰等）則自動打開降級后的頁面，保證關鍵功能的正常工作，或給用戶友好的提示。
頁面A/B測試、動態配置等場景。在WMRouter提供的接口基礎上進行少量開發配置，就可以實現：根據下發的A/B測試策略跳轉不同的頁面實現；根據不同的需要動態下發一組路由表，相同的URI跳轉到不同的一組頁面（實現方面可以自定義UriInterceptor，對匹配的URI返回301的UriResult使跳轉重定向）。
基本概念解釋
下面開始介紹WMRouter的發展背景和過程。為了方便后文的理解，我們先簡單了解和回顧幾個基本概念。
路由
根據維基百科的解釋，路由（routing）可以理解成在互聯的網絡通過特定的協議把信息從源地址傳輸到目的地址的過程。一個典型的例子就是在互聯網中，路由器可以根據IP協議將數據發送到特定的計算機。
URI
URI（Uniform Resource Identifier，統一資源標識符）是一個用于標識某一互聯網資源名稱的字符串。URI的組成如下圖所示。
一些常見的URI舉例如下，包括平時經常用到的網址、IP地址、FTP地址、文件、打電話、發郵件的協議等。
- http://www.meituan.com
- http://127.0.0.1:8080
- ftp://example.org/resource.txt
- file:///Users/
- tel:863-1234
- mailto:chris@example.com
在Android中也提供了android.net.Uri工具類用于處理URI，Android中URI常用的幾個部分主要是scheme、host、path和query。
Android中的Intent跳轉
在Android中的Intent跳轉，分為顯式跳轉和隱式跳轉兩種。
顯式跳轉即指定ComponentName（類名）的Intent跳轉，一般通過Bundle傳參，示例代碼如下：
Intent intent = new Intent(context, TestActivity.class); intent.putExtra("param", "value") startActivity(intent);隱式跳轉即不指定ComponentName的Intent跳轉，通過IntentFilter找到匹配的組件，IntentFilter支持action、category和data的匹配，其中data就是URI。例如下面的代碼，會啟動系統默認的瀏覽器打開網頁：
Intent intent = new Intent(Intent.ACTION_VIEW); intent.setData(Uri.parse("http://www.meituan.com")) startActivity(intent);Activity通過Manifest配置IntentFilter，例如下面的配置可以匹配所有形如demo_scheme://demo_host/***的URI。
<activity android:name=".app.UriProxyActivity" android:exported="true"><intent-filter><action android:name="android.intent.action.VIEW"/><category android:name="android.intent.category.DEFAULT"/><category android:name="android.intent.category.BROWSABLE"/><data android:scheme="demo_scheme" android:host="demo_host"/></intent-filter> </activity>URI跳轉
在美團外賣C端早期開發過程中，產品希望通過后臺下發URI控制客戶端跳轉指定頁面，從而實現靈活的運營配置。外賣App采用了Native+H5的混合開發模式，Native頁面定義了專用的URI，而H5頁面則使用HTTP/HTTPS鏈接在專門的WebView容器中加載，兩種鏈接的跳轉邏輯不同，實現起來比較繁瑣。
Native頁面的URI跳轉最開始使用的是Android原生的IntentFilter，通過隱式跳轉啟動，但是這種方式存在靈活性差、功能缺失、Bug多等問題。例如：
從外部（瀏覽器、微信等）跳轉外賣的URI時，系統會直接打開相應的Activity，而沒有經過歡迎頁的正常啟動流程，一些代碼邏輯可能沒有執行，例如定位邏輯。
有很多頁面在打開前需要確保用戶先登錄或先定位，每個頁面都寫一遍判斷登錄、定位的邏輯非常麻煩，提高了開發維護成本。
運營人員可能會配錯URI，頁面跳轉失敗，有些跳轉的地方沒有做try-catch處理，會產生Crash；有些地方雖然加了try-catch，但跳轉失敗后沒有任何響應，用戶體驗差；跳轉失敗沒有監控，不能及時發現和解決線上業務異常。
為了解決上述問題，我們希望有一個Android的URI分發組件，可以根據URI中不同的scheme、host、path，進行不同的處理，同時能夠在頁面跳轉過程中進行更靈活的干預。調研發現，現有的一些Android路由組件主要都是在解決多工程之間解耦的問題，而URI往往只支持通過path分發，頁面跳轉的配置也不夠靈活，難以滿足實際需要。于是我們決定自行設計實現。
核心設計思路
下圖展示了WMRouter中URI分發機制的核心設計思路。借鑒網絡請求的機制，WMRouter中的每次URI跳轉視為發起一個UriRequest；URI跳轉請求被WMRouter逐層分發給一系列的UriHandler進行處理；每個UriHandler處理之前可以被UriInterceptor攔截，并插入一些特殊操作。
頁面跳轉來源
常見的頁面跳轉來源如下：
對于來自App內部和Web容器的跳轉，我們把所有跳轉代碼統一改成調用WMRouter處理，而來自外部和Push通知的跳轉則全部使用一個獨立的中轉Activity接收，再調用WMRouter處理。
UriRequest
UriRequest中包含Context、URI和Fields，其中Fields為HashMap ，可以通過Key存放任意數據。簡單起見，UriRequest類同時承擔了Response的功能，跳轉請求的結果，也會被保存到Fields中。Fields可以根據需要自定義，其中一些常見字段舉例如下： ,>
- Intent的Extra參數，Bundle類型
- 用于startActivityForResult的RequestCode，int類型
- 用于overridePendingTransition方法的頁面切換動畫資源，int[]類型
- 本次跳轉結果的監聽器，OnCompleteListener類型
每次URI跳轉請求會有一個ResultCode（類似HTTP請求的ResponseCode），表示跳轉結果，也存放在Fields中。常見Code如下，用戶也可以自定義Code：
- 200：跳轉成功
- 301：重定向到其他URI，會再次跳轉
- 400：請求錯誤，通常是Context或URI為空
- 403：禁止跳轉，例如跳轉白名單以外的HTTP鏈接、Activity的exported為false等
- 404：找不到目標(Activity或UriHandler)
- 500：發生錯誤
總結來說，UriRequest用于實現一次URI跳轉中所有組件之間的通信功能。
UriHandler
UriHandler用于處理URI跳轉請求，可以嵌套從而逐層分發和處理請求。UriHandler是異步結構，接收到UriRequest后處理（例如跳轉Activity等），如果處理完成，則調用callback.onComplete()并傳入ResultCode；如果沒有處理，則調用callback.onNext()繼續分發。下面的示例代碼展示了一個只處理HTTP鏈接的UriHandler的實現：
public interface UriCallback {/*** 處理完成，繼續后續流程。*/void onNext();/*** 處理完成，終止分發流程。** @param resultCode 結果*/void onComplete(int resultCode); }public class DemoUriHandler extends UriHandler {public void handle(@NonNull final UriRequest request, @NonNull final UriCallback callback) {Uri uri = request.getUri();// 處理HTTP鏈接if ("http".equalsIgnoreCase(uri.getScheme())) {try {// 調用系統瀏覽器Intent intent = new Intent();intent.setAction(Intent.ACTION_VIEW);intent.setData(uri);request.getContext().startActivity(intent);// 跳轉成功callback.onComplete(UriResult.CODE_SUCCESS);} catch (Exception e) {// 跳轉失敗callback.onComplete(UriResult.CODE_ERROR);}} else {// 非HTTP鏈接不處理，繼續分發callback.onNext();}}// ... }UriInterceptor
UriInterceptor為攔截器，不做最終的URI跳轉操作，但可以在最終的跳轉前進行各種同步/異步操作，常見操作舉例如下：
- URI跳轉攔截，禁止特定的URI跳轉，直接返回403（例如禁止跳轉非meituan域名的HTTP鏈接）
- URI參數修改（例如在HTTP鏈接末尾添加query參數）
- 各種中間處理（例如打開登錄頁登錄、獲取定位、發網絡請求）
- ……
每個UriHandler都可以添加若干UriInterceptor。在UriHandler基類中，handle()方法先調用抽象方法shouldHandle()判斷是否要處理UriRequest，如果需要處理，則逐個執行Interceptor，最后再調用handleInternal()方法進行跳轉操作。
public abstract class UriHandler {// ChainedInterceptor將多個UriInterceptor合并成一個protected ChainedInterceptor mInterceptor;public UriHandler addInterceptor(@NonNull UriInterceptor interceptor) {if (interceptor != null) {if (mInterceptor == null) {mInterceptor = new ChainedInterceptor();}mInterceptor.addInterceptor(interceptor);}return this;}public void handle(@NonNull final UriRequest request, @NonNull final UriCallback callback) {if (shouldHandle(request)) {if (mInterceptor != null) {mInterceptor.intercept(request, new UriCallback() {@Overridepublic void onNext() {handleInternal(request, callback);}@Overridepublic void onComplete(int result) {callback.onComplete(result);}});} else {handleInternal(request, callback);}} else {callback.onNext();}}/*** 是否要處理給定的uri。在Interceptor之前調用。*/protected abstract boolean shouldHandle(@NonNull UriRequest request);/*** 處理uri。在Interceptor之后調用。*/protected abstract void handleInternal(@NonNull UriRequest request, @NonNull UriCallback callback); }URI的分發與降級
在外賣C端App中的URI分發示意如下圖。所有URI跳轉都會分發到RootUriHandler，然后根據不同的scheme分發到不同的子Handler。例如waimai協議分發到WmUriHandler，然后進一步根據不同的path分發到子Handler，從而啟動相應的Activity；HTTP/HTTPS協議分發到HttpHandler，啟動WebView容器；對于其他類型URI（tel、mailto等），前面的幾個Handler都無法處理，則會分發到StartUriHandler，嘗試使用Android原生的隱式跳轉啟動系統應用。
每個UriHandler都可以根據實際需要實現降級策略，也可以不作處理繼續分發給其他UriHandler。RootUriHandler中提供了一個全局的分發完成事件監聽器，當UriHandler處理失敗返回異常ResultCode或所有子UriHandler都沒有處理時，執行全局降級策略。
平臺化與兩端復用
隨著外賣C端業務的演進，團隊成員擴充了數倍，商超生鮮等垂直品類的拆分，以及異地研發團隊的建立，客戶端的平臺化被提上日程。關于外賣平臺化更詳細的內容，可參考團隊之前已經發布的文章 美團外賣Android平臺化架構演進實踐。
為了滿足實際開發需要，在長時間的探索后，逐步形成了如圖所示的三層工程結構。
原有的單個工程拆分成多個工程，就不可避免的涉及到多工程之間的耦合問題，主要包括通信問題、復用問題、依賴注入、編譯問題，下面詳細介紹。
通信問題
當原先的一個工程拆分到各個業務庫后，業務庫之間的頁面需要進行通信，最主要的場景就是頁面跳轉并通過Intent傳遞參數。
原先的頁面跳轉使用顯式跳轉，Activity之間存在強引用，當Activity被拆分到不同的業務庫，業務庫不能直接互相依賴，因此需要進行解耦。
利用WMRouter的URI分發機制，剛好可以很容易的解決這個問題。將將所有業務庫的Activity注冊到WMRouter，各個業務庫之間就可以進行頁面跳轉了。
此時WMRouter已經承載了兩項功能：
由于后臺下發的URI是和產品、運營、H5、iOS等各端統一制定的協議，支持的頁面、格式、參數等都不能隨意改動，而內部頁面跳轉使用的URI，則需要根據實際開發需要進行配置，兩套URI協議不能兼容，因此使用了不同的scheme。
復用問題與ServiceLoader模塊
業務庫之間經常需要復用代碼。一些通用代碼邏輯可以下沉到平臺層從而復用，例如業務無關的通用View組件；而有些代碼不適合下沉到平臺層，例如業務庫A要使用業務庫B中的某個界面模塊，而這個界面模塊和業務庫B的耦合很緊密。具體到外賣實際業務場景中，商家頁在商家休息時會展示推薦商家列表，其樣式和首頁相同（如圖），而兩個頁面不在一個工程中，商家頁希望能直接從首頁業務庫中獲取商家列表的實現。
為了解決上述問題，我們調研了解到Java中SPI (Service Provider Interfaces) 的設計思想與java.util.ServiceLoader工具類，還學習到美團平臺為了解決類似問題而開發的ServiceLoader組件。
考慮到實際需求差異，我們重新開發了自己的ServiceLoader實現。相比Java中的實現，WMRouter的實現借鑒了美團平臺的設計思路，不僅支持通過接口獲取所有實現類，還支持通過接口和唯一的Key獲取特定的實現類。另外WMRouter的實現還支持直接加載實現類的Class、用Factory和Provider創建對象、單例管理、方法調用等功能。在Gradle插件的實現思路上，借鑒了美團平臺的ServiceLoader并做了性能優化，給平臺提出了改進建議。
業務庫之間代碼復用的需求示意如圖，業務庫A需要復用業務庫B中的ServiceImpl但又不能直接引用，因此通過WMRouter加載：
URI跳轉和ServiceLoader看起來似乎沒有關聯，但通信和復用需求的本質都可以理解成路由，頁面通過URI分發跳轉時的協議是Activity+URI，在這里ServiceLoader的協議是Interface+Key。
依賴注入
為了兼容外賣獨立App和美團App外賣頻道的兩端差異，平臺層的一些接口要在兩個主工程分別實現，并注入到底層。常規Java代碼注入的方式寫起來很繁瑣，而使用WMRouter的ServiceLoader功能可以更簡單的實現和依賴注入類似的效果。
對于WMRouter來說，所有依賴它的工程（包括主工程、業務庫、平臺庫）都是一樣的，任何一個庫想要調用其他庫中的代碼，都可以通過WMRouter路由轉發。前面的通信和復用問題，是同級的業務庫之間通過WMRouter調用，而依賴注入則是底層庫通過WMRouter調用上層庫，其本質和實現都是相同的。
ServiceLoader模塊在加載實現類時提供了單例管理功能，可用于管理一些全局的Service/Manager，例如用戶賬戶管理類UserManager。
編譯問題
由于歷史原因，主工程作為一個沒有業務邏輯的殼工程，對業務庫卻有較多依賴，特別是對業務庫的初始化配置繁瑣，和各業務庫耦合緊密。另一方面，WMRouter跳轉的頁面、加載的實現類，需要在Application初始化時注冊到WMRouter中，也會增加主工程和業務庫的耦合。開發過程中各業務庫頻繁更新，經常出現無法編譯的問題，嚴重影響開發。
為了解決這個問題，一方面WMRouter增加了注解支持，在Activity類、ServiceLoader實現類上配置注解，就可以在編譯期間自動生成代碼注冊到WMRouter中。
// 沒有注解時，需要在Application初始化時代碼注冊各個頁面，耦合嚴重 register("/home", HomeActivity.class); register("/order", OrderListActivity.class); register("/shop", ShopActivity.class) register("/account", MyAccountActivity.class); register("/address", MyAddressActivity.class); // ... // 增加注解后，只需要在各個Activity上通過注解配置即可 @RouterUri(path = "/shop") public class ShopActivity extends BaseActivity {}另一方面，ServiceLoader還支持指定接口加載所有實現類，主工程可以通過統一接口，加載各個業務庫中所有實現類并進行初始化，最終實現和業務庫的徹底隔離。
開發過程中，各個業務庫可以像插件一樣按需集成到主工程，能大幅減少不能編譯的問題，同時由于編譯時可以跳過不需要的業務庫，編譯速度也能得到提高。
WMRouter的推廣
在WMRouter解決了外賣C端App的各種問題后，發現公司內甚至公司外的其他App也遇到了相似的問題和需求，于是決定對WMRouter進行推廣和開源。
由于WMRouter是一個開放式組件化框架，UriRequest可以存放任意數據，UriHandler、UriInterceptor可以完全自定義，不同的UriHandler可以任意組合，具有很大的靈活性。但過于靈活容易導致易用性的下降，即使對于最常規最簡單的應用，也需要復雜的配置才能完成功能。
為了在靈活性與易用性之間平衡，一方面，WMRouter對包結構進行了合理的劃分，核心接口和實現類提供基礎通用能力，盡可能保留最大的靈活性；另一方面，封裝了一系列通用實現類，并組合成一套默認實現，從而滿足絕大多數常規使用場景，盡可能降低其他App的接入成本，方便推廣。
總結
目前業界已有的一些Android路由框架，不能滿足外賣C端App在開發過程中的實際需要，因此我們開發了WMRouter路由框架。借鑒網絡請求的思想，設計了基于UriRequest、UriHandler、UriInterceptor的URI分發機制，在保證功能靈活強大的同時，又盡可能的降低了使用難度；另一方面，借鑒SPI的設計思想、Java和美團平臺的ServiceLoader實現，開發了自己的ServiceLoader模塊，解決外賣平臺化過程中的四個問題（通信問題、復用問題、依賴注入、編譯問題）。在經過了近一年的不斷迭代完善后，WMRouter已經成為美團多個App中的核心基礎組件之一。
參考資料
作者簡介
- 子健，美團高級工程師，2015年加入美團，先后負責外賣客戶端首頁、商家容器、評價等業務模塊的開發維護，以及平臺化、性能優化等技術工作。
- 淵博，美團高級工程師，2016年加入美團，目前作為外賣商家端Android App主力開發，主要負責商家端和蜜蜂端業務技術需求開發。
- 云馳，美團高級工程師，2016年加入美團，目前負責外賣客戶端搜索、IM等業務庫，及外賣多端統一工作。
招聘信息
美團外賣誠招Android、iOS、FE高級/資深工程師和技術專家，Base北京、上海、成都，歡迎有興趣的同學投遞簡歷到wukai05@meituan.com。
總結
以上是生活随笔為你收集整理的WMRouter：美团外卖Android开源路由框架的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 科普一下人工智能领域的研究方向
- 下一篇： Android Hook技术防范漫谈