Hybrid混合开发知识点(一)

Hybrid是半Native半Web开发模式，充分利用H5的跨平台、快速迭代能力以及Native的流畅性、系统API调用能力，具有可复用性高、开发成本低、跨平台开发的特点。

在阐述Hybrid混合开发知识点之前，我们先梳理下WebView加载H5页面及H5与Android的交互等方面的知识点。

WebView常用API及属性配置

WebViewClient类：处理各种通知&请求事件。常用方法如下：

• shouldOverrideUrlLoading()：在本WebView中打开网页，只在重定向和点击网页内链接时触发，且先于onPageStarted()。
  返回false表示默认由webview加载URL，返回true表示不加载URL，用户自行处理。
• onPageStarted()：载入页面时调用，加载页面、点击链接、返回上一个网页都会触发。
• onLoadResource()：加载页面资源时回调，如每张图片加载都会调用。
• onReceivedSslError()：webview默认不处理https请求，此方法针对https请求做处理。如handler.proceed();
• onReceivedError()：页面加载异常时会触发，可根据errorCode替换assets目录下预配置的对应加载反馈页面。

WebChromeClient类：辅助webview处理javaScript对话框，加载进度，网站图标，网站标题等。

WebSettings常用属性：

• setJavaScriptEnabled(true):设置允许执行javaScript脚本，默认false.
• setSupportZoom(true):设置是否支持缩放，默认true.
• setBlockNetworkImage(false):把图片加载放在最后来加载渲染.
• setAllowFileAccess(true):设置可以访问文件.
• setLayoutAlgorithm(WebSettings.LayoutAlgorithm.SINGLE_COLUMN):支持内容重新布局.
• setUseWideViewPort(true):扩大比例的缩放.
• setLoadWithOverviewMode(true):自适应屏幕，配合setUseWideViewPort一起使用.
• setLoadsImagesAutomatically(true):是否下载图片资源，默认true.
• setCacheMode：设置浏览器缓存模式：
  • LOAD_DEFAULT：默认值。当存在缓存且未过期时加载缓存数据，否则通过网络加载数据。
  • LOAD_NO_CACHE：不使用缓存。仅通过网络加载数据。
  • LOAD_CACHE_ONLY：只使用缓存。仅加载缓存数据，不通过网络加载数据。
  • LOAD_CACHE_ELSE_NETWORK：只要有缓存，是否过期都加载缓存，否则加载网络数据。

WebView常用API调用：

• getOriginalUrl：获取当前网页的原始url，针对某些执行重定向操作的网页。
• loadData：以字符串形式加载html片段(若包含中文，会乱码，须设置mimeType类型)。
• postUrl：以post请求加载url(post携带的数据须是application/x-www-form-urlencoded编码)。
• reload：刷新页面，重载资源。
• stopLoading：停止加载。
• pageUp：向上翻页至页面顶部。
• clearCache(includeDiskFiles)：清除缓存，传参false仅清除内存缓存，传参true同时清除内存和磁盘缓存
• clearFormData：清除表单自动填充数据(不含已存储本地的表单数据)。
• onPause：尽可能暂停webview行为，如动画、定位，不暂停js脚本执行。onResume恢复被暂停的行为。
• pauseTimers：暂停所有webview全部行为，resumeTimers恢复被pauseTimers暂停的行为。
• destroy：销毁webview，须先从viewGroup中移除webview才有效。
• getContentHight：获取网页内容高度。
• loadUrl：加载远程或本地的url。
  • assets资源：file:///android_asset/
  • res资源：file:///android_res/
  • raw资源：file:///android_res/raw/
  • sdcard资源：file:///sdcard/

Android调用H5

WebView需要设置setJavaScriptEnabled(true);使WebView支持执行JavaScript脚本。

//支持Android 4.4以前的版本，支持页面刷新，但无返回值。
webview.post(new Runnable()){
    @Override
    public void run(){
        webview.loadUrl("javaScript:callJs('params')");
    }   
}

//支持Android 4.4+版本，能接收返回值，不支持页面刷新，调用及回调均在UI线程中。
webview.evaluateJavascipt("javascript:callJS('params')",
    new ValueCallback<String>(){
        @Override
        public void onReceiveValue(String value){
            //处理从js返回的值value
        }   
    });

以上两种Android调用H5方法，均在onPageFinished()方法回调后执行，即页面加载完毕后。

H5调用Android

//为js添加Java映射对象。
webview.addJavascriptInterface(new JsCallAndroid(),"jscallandroid");

public class JsCallAndroid {
    //需添加@JavascriptInterface注解，避免webview漏洞。
    @JavascriptInterface
    public void hello(String msg) {
         System.out.println("JS调用了Android的hello方法");
    }
}

js通过脚本映射addJavascriptInterface()中的Object对象，实现H5调用Android方法。前提须设置settings.setJavaScriptEnabled(true)。

Scheme协议

Android中的Scheme是一种页面跳转协议，常处理以下场景交互：

• App端不同页面跳转；
• 通过shouldOverrideUrlLoading()回调拦截URL，实现H5页面跳转App页面；
• 根据URI跳转到另一个App指定页面；
• 接收服务端下发URI跳转App对应页面；

在使用Scheme前，须在AndroidManifest.xml中对Activity添加< intent-filter/>过滤器注册。

<activity
    android:name=".ui.activity.TestActvity"
    android:screenOrientation="portrait"
    android:windowSoftInputMode="stateAlwaysHidden|adjustPan">
        <!--Scheme协议配置,intent-filter过滤器支持页面跳转-->
        <intent-filter>
        <!--协议部分，path前须加/，除了sheme外其他选填-->
            <data
                android:host="book"
                android:path="/bookDetail"
                android:port="8888"
                android:scheme="app" />

            <!--下面也要设置-->
            <category android:name="android.intent.category.DEFAULT" />
            <category android:name="android.intent.category.BROWSABLE" />

            <action android:name="android.intent.action.VIEW" />
        </intent-filter>
</activity>

常规的URL Scheme格式为：[scheme]://[host]/[path]?[query]，如 app://book:8888/bookDetail?bookId=10011002

app代表Scheme协议名称，book代表作用域，8888代表端口号(如Http协议的默认端口号为80)，bookDetail代表页面路径，bookId代表拼接参数。

App内页面跳转，示例1：

• 页面A跳转及结果回调；

String uri = "app://book:8888/bookDetail?bookId=10011002";
schemeToActivity(uri, 100);

/**
 * 采用Scheme协议页面跳转，校验scheme协议是否有效
 * @param uri
 * @param requestCode
 */
private void schemeToActivity(String uri, int requestCode) {
    if (TextUtils.isEmpty(uri)) return;
    Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(uri));
    List<ResolveInfo> activities = getPackageManager().queryIntentActivities(intent, 0);
    if (activities != null && !activities.isEmpty()) {
        if (requestCode > 0) {
            startActivityForResult(intent, requestCode);
        } else {
            startActivity(intent);
        }
    } else {
        throw new RuntimeException("can not find the activity's URL Scheme");
    }
}

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    String string = data.getStringExtra("result");
    if (requestCode == 100) {
        Log.d("test", string);
    }
}

• 页面B解析Scheme及setResult；

/**
 * 解析Scheme协议的uri数据
 */
private void getSchemeIntent() {
    Intent intent = getIntent();
    Uri uri = intent.getData();
    if (uri == null)return;
    String scheme = uri.getScheme();
    String host = uri.getHost();
    int port = uri.getPort();
    String path = uri.getPath();
    List<String> pathSegments = uri.getPathSegments();
    String query = uri.getQuery();
    String bookId = uri.getQueryParameter("bookId");
    Log.d("test",bookId);
}


//退回页面A回传值
Intent intent = new Intent();
intent.putExtra("result","hello world!");
setResult(RESULT_OK,intent);
finish();

通过debug模式，可获得从Scheme中解析出的参数值，如下：

H5页面跳转App页面，示例2：

若要跳转AndroidManifest.xml中定义Scheme的Activity，H5端配置如下：

<a href="app://book:8888/bookDetail?bookId=10011002">图书详情页</a>

在App内点击该WebView页面链接会触发WebViewClient#shouldOverrideUrlLoading()方法，解析如下：

@Override
public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
       if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.LOLLIPOP) {
                //判定重定向
                WebView.HitTestResult testResult = view.getHitTestResult();
                if (testResult == null ||
                        testResult.getType() == WebView.HitTestResult.UNKNOWN_TYPE) {
                    return false;
                }

                //解析URL Scheme
                Uri uri = request.getUrl();
                //根据schemeToActivity(uri.toString(),0);方案处理跳转
                return true;
        }
        return false;
}

如上所示，和常规的URL Scheme解析同理，注意shouldOverrideUrlLoading()的版本兼容。

重定向问题的处理方案：WebView的getHitTestResult()的函数可以获取点击页面元素的类型，若获取的HitTestResult为null或UNKNOWN_TYPE，则认定为重定向URL，对此情况直接return false。

shouldOverrideUrlLoading()处理H5与Android交互的存在的问题：

• 重定向在低版本上返回问题，成熟方案不多；
• 拦截URI处理页面跳转或点击事件，硬编码导致的臃肿问题；
• shouldOverrideUrlLoading()本身调用时机的局限性；

硬编码问题虽然借鉴了ARouter路由跳转思想能缓解页面跳转，但是在交互方面addJavascriptInterface映射对象的方案更优。

URL Scheme更适合处理App页面之间的跳转。