背景

大家如果經歷過Hybrid項目的開發，即項目中涉及到H5與Native之間的交互，那么很有可能會遇到各種各樣的H5容器。為什么會有那么多各種各樣的容器呢...這也是輪子多的通病了，輪子多到業務方不知道選哪個。當然，也有可能大家壓根就不會使用到H5容器，直接用系統WebView就完事兒了，比如我的前東家就是這樣做的。那這篇文章的主題就是與前者相關的：當項目中擁有很多個H5容器時，怎樣封裝才能讓業務側用得爽呢？?

下面按慣例，拋出這篇文章要解決的三個問題：

• 如何優雅地提供接口調用？
• 怎樣封裝多個不同類型的H5容器？
• 這樣的架構能帶來什么樣的好處？

術語對齊

探索

如何優雅地提供接口調用？

業務側調用的接口其實很有限，可以說90%的業務都只是打開一個網頁而已。

我們根據業務需要新建一個接口類：

/**
 * WebPage服務接口類
 */
public interface IWebPageService {
    /**
     * 打開url
     * @param url
     */
    void openUrl(String url);

    /**
     * 創建Fragment內置到某頁面中使用
     * @return
     */
    Fragment buildFragment(String url, Context context);

    /**
     * 獲取當前Url
     * @return
     */
    String getCurrentUrl();

    /**
     * 給h5發通知
     * @param eventData
     * @param eventName
     */
    void postNotificationToJS(String eventName, String eventData);
}

以上列舉了4個非常常見的接口。如果有需要，還可以擴展其它的，比如設置容器生命周期相關的監聽、設置H5發通知來時的監聽等等。拿openUrl的實現舉例，實現類通過url中的參數判斷需要打開A容器還是B容器。

@Override
public void openUrl(String url) {
     // 若url中含有A參數，則用A容器打開
     // if (urlParamHasA) {
        // startAContainer();
     // } else {
        // 否則用B容器打開
        // startBContainer();
     //}
}

這就從接口層這一層面屏蔽了內部框架容器。其它接口也是類似，原則就是不讓業務側感知到具體的實現細節，而不是跳個頁面還需要知道這個url是要用A容器打開還是B容器打開。在應用啟動時，可以將實現類注入到公共依賴中去，也可以通過ARouter等框架實現依賴注入，方便業務側的調用。

怎樣封裝多個不同類型的H5容器容器？

整體架構

先上一張圖：

接口層上面已經講過了，這里我們直接看容器層。

通用容器

第一層就是我們抽出來的通用容器，WebPageActivity與WebPageFragement。項目中，不管是哪個H5框架容器，勢必都是用Activity或者Fragment來承載的，所以我們相應的也需要有這兩者作為父類去進行封裝。而通用容器中，最重要的職責就是去執行通用邏輯，即每個框架容器都需要執行的邏輯。

通用職責可以有以下幾點：

• 設置頁面屬性，包括window flag、activity的主題等。
• 解析url，將url中的關鍵參數記錄下來，從而決定以哪種策略渲染UI。比如可以通過disableNav參數決定是否顯示導航欄，通過statusBarStyle參數決定狀態欄的風格等。
• 控制通用UI的渲染，包括何時改變TitleBar、何時加載/隱藏Loading，何時渲染異常態UI等。
• 決定框架容器加載時的邏輯順序，如setContentView()->loadUrl()。
• 接收生命周期事件與系統回調事件，并且分發回調。生命周期就不用說了，系統回調這里特指onActivityResult、onRequestPermissionResult這類事件，然后將結果分發給各listener。

拿WebPageActivity#onCreate舉例：

@Override
protected void onCreate(Bundle savedInstanceState) {
    // setWindowFlags(); 設置window屬性
    // setTheme(); 設置主題
    // setTransition(); 設置轉場動畫
    
    super.onCreate(savedInstanceState);

    // parseUrl(); 解析url
    // initCommonUI(); 渲染通用UI 比如TitleBar、底部導航欄等
    
    setContentView();
    loadUrl();
}

protected abstract void setContentView();

protected abstract void loadUrl();

我們可以將設置window屬性、設置主題這些通用行為放在通用容器中執行，而setContentView與loadUrl交由框架容器去執行。setContentView是因為不同的容器，layout xml可能是不一樣的。loadUrl是因為每個容器用WebView去加載url的方式也可能不同，無法統一。類似的行為，若執行時機可統一，則由通用容器統一執行時機，比如setContentView與loadUrl。若時機也沒法確定，甚至邏輯只會存在于某個框架容器中，那么就要寫到子類中去了。

框架容器

圖中第二層的容器A、容器B、容器C指的就是框架容器。有了通用容器承載共同的邏輯后，框架容器需要做的事情就比較少了。只需要加載各自的布局，初始化WebView，然后將url加載到WebView中就可以了（除非有某個框架容器需要特殊適配，那就得寫些額外的代碼）。具體的實現需要根據項目中框架容器的使用方式來確定。

基礎組件

第三層表示基礎組件。這里只列一些常見的基礎組件。

• Components：各類UI組件，比如TitleBar與異常態控件。
• JS Bridge：JS Bridge可以單獨放到一個類中做收口，然后分發給各個listener。listenr通過接口層進行注入。
• WebViewClient：WebViewClient在日常開發中算是維護的非常頻繁的一個類，職責主要是在shouldOverrideUrlLoading重定向時對url進行攔截，以及根據相應的生命周期回調（onPageStarted、onPageFinished、onReceviedError等）進行loading或異常態UI的渲染時。若每個框架容器可以設置同一個WebViewClient，那就非常方便了，只要改一處地方，所有容器就都生效了。
• Interceptors：即用于WebView重定向時的攔截器。像我的項目中會有很多攔截相關的邏輯，比如將A頁面攔截跳轉到原生頁面，就需要在重定向時進行攔截。但邏輯堆疊太多會提高維護的成本，因此建議用責任鏈模式（沒用過的同學可以百度一下，很簡單滴~）去處理攔截的這塊邏輯。
• Managers、Listeners：容器中總是需要很多輔助類去來幫助我們去管理一些東西，比如WebView的管理，url的管理。這里就不延伸了，根據實際需要去加。Listener也一樣，關于容器生命周期的Listener，與JS Bridge交互相關的Listener，都可以通過接口層去實現注入與銷毀。

當然，除此之外，根據每個項目的完整度與負責度，還會衍生出很多基礎組件。比如H5的監控體系，H5的預加載體系，以及WebView預創建相關的緩存體系等。他們作為框架容器共同的底座承擔相應的職責。

這樣的架構能帶來什么樣的好處？

• 對業務側而言，接口統一收口到IWebPageService中去，調用方式更加簡單明了，不需要再關注容器的具體類型。
• 對容器側而言，代碼邏輯性清晰的同時，有效降低了日后的維護成本與開發成本。Loading、異常態不需要再在各類容器中重復寫N遍，各種url params都統一收口到通用容器中去，重定向攔截邏輯也不再需要重復寫N遍...總而言之，通用邏輯統一給通用容器與基礎組件去承擔，框架容器的代碼，都是各框架容器所“獨有”的。