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(){
        @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/>过滤器注册。


        
        
        
            

            
            
            

            
        

常规的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 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 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中解析出的参数值,如下:


Hybrid混合开发知识点(一)_第1张图片

H5页面跳转App页面,示例2:

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

图书详情页

在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页面之间的跳转。

你可能感兴趣的:(Hybrid混合开发知识点(一))