前言
前文中就有提到,Hybrid模式的核心就是在原生,而本文就以此專案的Android部分為例介紹Android部分的實現。
提示,由於各種各樣的原因,本專案中的Android容器確保核心互動以及部分重要API實現,關於底層容器優化等機制後續再考慮完善。
大致內容如下:
-
JSBridge核心互動部分
-
ui
、page
、navigator
等部分常用API的實現 -
元件(自定義)API擴充的實現
-
容器h5支撐的部分完善(如支援fileinput檔案選擇,地理定位等-預設不生效的)
-
API的許可權校驗僅預留了一個入口,模擬最簡單的實現
-
其它如離線資源載入更新,底層優化等機制暫時不提供
專案的結構
基於AndroidStudio的專案,為了便於管理,稍微分成了幾個模組,
而且由於主要精力已經偏移到了JS前端,已經不想再花大力氣重構Android程式碼了,
因此僅僅是將程式碼從業務中抽取出來,留下了一些稍微精簡的程式碼(也不是特別精簡)。
所以如果發現程式碼風格,規範等不太合適,請先將就著。
整體目錄結構如下:
quickhybrid-android
|- app // application,應用主程式
| |- api/PayApi // 擴充了一個元件API
| |- MainActivity // 入口頁面
|- core // library,核心工具類模組,放一些通用工具類
| |- baseapp
| |- net
| |- ui
| |- util
|- jsbridge // library,JSBridge模組,混合開發的核心實現
| |- api
| |- bean
| |- bridge
| |- control
| |- view
複製程式碼
程式碼架構
簡單的三次架構:底層核心工具類->JSBridge橋接實現->app應用實現
core
|- application // 應用流程控制,Activity管理,崩潰日誌等
|- baseapp // 一些基礎Activity,Fragment的定義
|- net // 網路請求相關
|- ui // 一些UI效果的定義與實現
|- util // 通用工具類
jsbridge
|- api // 定義API,開放原生功能給H5
|- bean // 放一些實體類
|- bridge // 橋接的定義以及核心實現
|- control // 控制類,包括回撥控制,頁面載入控制,檔案選擇控制等
|- view // 定義混合開發需要的webview和fragment實現
app
|- api // 擴充專案需要的自定義元件API
|- AppApplication.java // 應用的控制
|- MainActivity.java // 入口介面的控制
複製程式碼
許可權配置
原生應用中,不可逃避的就是打包後的許可權問題,沒有許可權,很多功能都使用不了,
簡單起見,這裡將應用中用的許可權都列了出來(基於多種考慮,並沒有遵循最小原則)
<!-- ===============================許可權配置宣告=============================== -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.CALL_PHONE" />
<uses-permission android:name="android.permission.READ_CALL_LOG" />
<uses-permission android:name="android.permission.SEND_SMS" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.READ_LOGS" />
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.READ_OWNER_DATA" />
<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.DISABLE_KEYGUARD" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />
<uses-permission android:name="android.permission.GET_ACCOUNTS" />
<uses-permission android:name="android.permission.READ_PROFILE" />
複製程式碼
注意,6.0
之上需要動態許可權,請確保已經給應用開了對應的許可權
Gradle配置
AndroidStudio中專案要正確執行起來,需要有一個正確的Gradle配置。
這裡也就幾個關鍵性的配置作說明,其餘的可以參考原始碼
gradle-wrapper.properties
distributionUrl=https://services.gradle.org/distributions/gradle-4.2.1-all.zip
複製程式碼
如果遇到gradle編譯不動,可以像上述一樣,把這個檔案的gradle版本修改為本地用的版本
(否則的話,沒有科學上網就很有可能卡住)
setting.gradle
include `:app`, `:jsbridge`, `:core`
複製程式碼
裡面很簡單,就是一行程式碼,將三個用到的模組都引用進來
build.gradle(core)
僅挑選了部分進行說明
apply plugin: `com.android.library`
android {
compileSdkVersion 25
defaultConfig {
minSdkVersion 16
targetSdkVersion 22
versionCode 1
versionName "1.0"
...
}
...
}
dependencies {
compile fileTree(dir: `libs`, include: [`*.jar`])
compile `com.android.support:appcompat-v7:25.3.1`
compile `com.android.support:support-v4:25.3.1`
compile `com.android.support:design:25.3.1`
compile `com.android.support:recyclerview-v7:25.3.1`
compile `com.android.support.constraint:constraint-layout:1.0.2`
compile `com.jakewharton:butterknife:8.6.0`
compile `com.google.code.gson:gson:2.8.0`
compile `com.journeyapps:zxing-android-embedded:3.5.0`
compile `com.liulishuo.filedownloader:library:1.5.5`
compile `com.nostra13.universalimageloader:universal-image-loader:1.9.5`
compile `me.iwf.photopicker:PhotoPicker:0.9.10@aar`
compile `com.github.bumptech.glide:glide:4.1.1`
...
}
複製程式碼
上述的關鍵資訊有幾點:
-
apply plugin: `com.android.library`
代表是模組而不是主應用 -
minSdkVersion 16
代表最低相容4.1
的版本 -
targetSdkVersion 25
是編譯版本,targetSdkVersion 22
提供向前相容的作用,22時不需要動態許可權,
主要作用是某些API在不同版本中使用不一樣,或者根本就在低版本中沒有。 -
versionName
和versionCode
進行版本控制 -
dependencies
中是依賴資訊,首先compile fileTree
新增了libs
下的所有離線依賴(裡面有離線依賴包),
然後compile
一些必須的依賴(譬如用到了gson,自動註解,檔案下載等等)
為什麼這裡沒用implementation新增依賴,而是用compile?因為implementation不具有傳遞性,這樣引用core的jsbridge就用不到了,
而我們需要確保jsbridge中也用到,所以就用了compile。
build.gradle(jsbridge)
一部分類似的程式碼就沒有貼出來了
apply plugin: `com.android.library`
...
dependencies {
implementation project(`:core`)
...
}
複製程式碼
這裡和core
不同之處在於,內部依賴於core模組,使用了implementation project
,
這樣在jsbridge
內部就能使用core的原始碼了。
需要注意的是,implementation不具有傳遞性(core只會暴露給jsbridge,不會傳遞下去)
build.gradle(app)
一部分類似的程式碼就沒有貼出來了
apply plugin: `com.android.application`
android {
defaultConfig {
applicationId "com.quick.quickhybrid"
versionCode 1
versionName "1.0"
}
...
}
dependencies {
implementation project(`:core`)
implementation project(`:jsbridge`)
implementation fileTree(dir: `libs`, include: [`*.jar`])
// butterknife8.0+版本支援控制元件註解必須在可執行的model加上
annotationProcessor `com.jakewharton:butterknife-compiler:8.6.0`
...
}
複製程式碼
與之前相比,有幾點關鍵資訊
-
apply plugin: `com.android.application`
代表是主應用而不是模組 -
applicationId
定義了應用id -
同樣有自己的版本控制,但是注意,這裡是容器版本號,前面的如jsbridge中是quick的版本號,有區別的
-
implementation
依賴了前面兩個模組,同時,後面引入了應用中可能需要的依賴 -
annotationProcessor `com.jakewharton:butterknife-compiler:8.6.0`
,這行程式碼是為了使得butterknife自動註解生效的配置
targetSdkVersion說明
配置中使用的版本是22
,因為在這個版本以上會有動態許可權問題,比較麻煩,需要更改部分邏輯。因此就暫時未修改了。
譬如操作私有檔案的許可權問題等等
一些關鍵程式碼
程式碼方面,也無法一一全部說明,這裡僅列舉一些比較重要的步驟實現,其餘可參考原始碼
UA約定
前面的JS專案中就已經有提到UA約定,就是在載入對於webview時,統一在webview中加上如下UA標識
WebSettings settings = getSettings();
String ua = settings.getUserAgentString();
// 設定瀏覽器UA,JS端通過UA判斷是否屬於Quick環境
settings.setUserAgentString(ua + " QuickHybridJs/" + BuildConfig.VERSION_NAME);
複製程式碼
一些關鍵的webview設定
// 設定支援JS
settings.setJavaScriptEnabled(true);
// 設定是否支援meta標籤來控制縮放
settings.setUseWideViewPort(true);
// 縮放至螢幕的大小
settings.setLoadWithOverviewMode(true);
// 設定內建的縮放控制元件(若SupportZoom為false,該設定項無效)
settings.setBuiltInZoomControls(true);
// 設定快取模式
// LOAD_DEFAULT 根據HTTP協議header中設定的cache-control屬性來執行載入策略
// LOAD_CACHE_ELSE_NETWORK 只要本地有無論是否過期都從本地獲取
settings.setCacheMode(WebSettings.LOAD_DEFAULT);
settings.setDomStorageEnabled(true);
// 設定AppCache 需要H5頁面配置manifest檔案(官方已不推介使用)
String appCachePath = getContext().getCacheDir().getAbsolutePath();
settings.setAppCachePath(appCachePath);
settings.setAppCacheEnabled(true);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
// 強制開啟android webview debug模式使用Chrome inspect(https://developers.google.com/web/tools/chrome-devtools/remote-debugging/)
WebView.setWebContentsDebuggingEnabled(true);
}
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
CookieManager.getInstance().setAcceptThirdPartyCookies(this, true);
}
複製程式碼
上述的一系列配置下去才能讓H5頁面的大部分功能正常開啟,如localstorage,cookie,viewport,javascript等
支援H5地理定位
在繼承WebChromeClient的QuickWebChromeClient
中
@Override
public void onGeolocationPermissionsShowPrompt(String origin, GeolocationPermissions.Callback callback) {
callback.invoke(origin, true, false);
super.onGeolocationPermissionsShowPrompt(origin, callback);
}
複製程式碼
需要重新才支援地理定位,否則純h5定位無法獲取地理位置(或者被迫使用了網路定位)
支援檔案選擇
同樣在繼承WebChromeClient的QuickWebChromeClient
中
/**
* Android 4.1+適用
*
* @param uploadMsg
* @param acceptType
* @param capture
*/
public void openFileChooser(ValueCallback<Uri> uploadMsg, String acceptType, String capture) {
loadPage.getFileChooser().showFileChooser(uploadMsg, acceptType, capture);
}
/**
* Android 5.0+適用
*
* @param webView
* @param filePathCallback
* @param fileChooserParams
* @return
*/
@RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
@Override
public boolean onShowFileChooser(WebView webView, ValueCallback<Uri[]> filePathCallback, FileChooserParams fileChooserParams) {
loadPage.getFileChooser().showFileChooser(webView, filePathCallback, fileChooserParams);
return true;
}
複製程式碼
上述的操作是主動監聽檔案的選擇,然後自動呼叫原生中的處理方案,譬如彈出一個通用的選擇框,進行選擇等。
如果不實現,無法正常通過FileInput選擇檔案,而實際上,FileInput又是一個很常用的功能。
監聽JSBridge的觸發
同樣在繼承WebChromeClient的QuickWebChromeClient
中
@Override
public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result) {
result.confirm(JSBridge.callJava(loadPage.getFragment(), message,loadPage.hasConfig()));
return true;
}
複製程式碼
為了方便,直接使用onJsPrompt來作為互動通道,前文中也相應提到過
其它
在直接提供API前,還有很多需要做的基礎工作,譬如瀏覽歷史記錄管理,監聽附件下載,頁面載入報錯處理等等,這裡不再贅述,可以直接參考原始碼
最後,關於一些JSBridge實現,API實現,由於本系列的其它文中或多或少都已經提到,這裡就不再贅述了,可以直接參考原始碼
另外,後續如果繼續有容器優化等操作,也會單獨整理,加入本系列。
前端頁面示例
為了方便,直接整合到了app/assets/
中,入口頁面預設會載入它,也可以直接看原始碼
返回根目錄
原始碼
github
上這個框架的實現