Android WebView

一、简介

• WebView是Android系统中的原生控件，其主要功能与前端页面进行响应交互，快捷省时地实现如期的功能，相当于增强版的内置浏览器。
• 使用时需要在配置文件里设置网络权限，定义布局大小和样式，绑定和操作控件。

manifest.xml
<uses-permission android:name="android.permission.INTERNET" />

activity_main.xml
<WebView
    android:id="@+id/web_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
</WebView>

MainActivity.java
String url = "https://www.baidu.com";
WebView webView = (WebView) findViewById(R.id.web_view);
webView.loadUrl(url);

• 网页跳转，包括前进、后退、自定义。

boolean back = webview.canGoBack(); -> 判断网页是否可以回退
webview.goBack(); -> 回退一页

boolean forward = webview.canGoForward(); -> 判断网页是否可以前进
webview.goForward(); -> 前进一页

webview.goBackOrForward(1); -> 正数为前进
webview.goBackOrForward(-1); -> 负数为后退

二、生命周期

• onResume()：活跃状态，可以正常执行网页的响应。
• onPause()：暂停状态，页面被失去焦点，暂停所有进行中的动作，如：DOM解析、CSS和JavaScript执行等。
• pauseTimers()：全局WebView暂停状态，如：layout、parsing、javascripttimer等。
• resumeTimers()：恢复到pauseTimers()执行前的状态。
• destroy()：销毁状态，释放资源。
• 注意：使用WebView不当容易引起内存泄漏，所以WebView的生命周期方法应跟随Activity的生命周期的方法来调用。

三、 WebSettings

• 控件的相关配置

WebSettings webSettings = webView.getSettings();

webSettings.setJavaScriptEnabled(true); -> 是否开启JS支持
webSettings.setPluginsEnabled(true); -> 是否开启插件支持
webSettings.setJavaScriptCanOpenWindowsAutomatically(true); -> 是否允许JS打开新窗口

webSettings.setUseWideViewPort(true); -> 缩放至屏幕大小
webSettings.setLoadWithOverviewMode(true); -> 缩放至屏幕大小
webSettings.setSupportZoom(true); -> 是否支持缩放
webSettings.setBuiltInZoomControls(true); -> 是否支持缩放变焦，前提是支持缩放
webSettings.setDisplayZoomControls(false); -> 是否隐藏缩放控件

webSettings.setAllowFileAccess(true); -> 是否允许访问文件
webSettings.setDomStorageEnabled(true); -> 是否节点缓存
webSettings.setDatabaseEnabled(true); -> 是否数据缓存
webSettings.setAppCacheEnabled(true); -> 是否应用缓存
webSettings.setAppCachePath(uri); -> 设置缓存路径

webSettings.setMediaPlaybackRequiresUserGesture(false); -> 是否要手势触发媒体
webSettings.setStandardFontFamily("sans-serif"); -> 设置字体库格式
webSettings.setFixedFontFamily("monospace"); -> 设置字体库格式
webSettings.setSansSerifFontFamily("sans-serif"); -> 设置字体库格式
webSettings.setSerifFontFamily("sans-serif"); -> 设置字体库格式
webSettings.setCursiveFontFamily("cursive"); -> 设置字体库格式
webSettings.setFantasyFontFamily("fantasy"); -> 设置字体库格式
webSettings.setTextZoom(100); -> 设置文本缩放的百分比
webSettings.setMinimumFontSize(8); -> 设置文本字体的最小值(1~72)
webSettings.setDefaultFontSize(16); -> 设置文本字体默认的大小

webSettings.setLayoutAlgorithm(LayoutAlgorithm.SINGLE_COLUMN); -> 按规则重新布局
webSettings.setLoadsImagesAutomatically(false); -> 是否自动加载图片
webSettings.setDefaultTextEncodingName("UTF-8"); -> 设置编码格式
webSettings.setNeedInitialFocus(true); -> 是否需要获取焦点
webSettings.setGeolocationEnabled(false); -> 设置开启定位功能
webSettings.setBlockNetworkLoads(false); -> 是否从网络获取资源

四、WebViewClient

• 控件客户端，用于处理各种通知和请求事件。
• onPageStarted()：页面开始加载时调用，这时候可以显示加载进度条，让用户耐心等待页面的加载。
• onPageFinished()：页面完成加载时调用，这时候可以隐藏加载进度条，提醒用户页面已经完成加载。
• onLoadResource()：页面每次加载资源时调用。
• shouldOverrideUrlLoading()：WebView加载url默认会调用系统的浏览器，通过重写该方法，实现在当前应用内完成页面加载。
• onReceivedError()：页面加载发生错误时调用，这时候可以跳转到自定义的错误提醒页面，总比系统默认的错误页面美观，优化用户体验。
• onReceivedHttpError()：页面加载请求时发生错误。
• onReceivedSslError()：页面加载资源时发生错误。
• shouldOverrideKeyEvent()：覆盖按键默认的响应事件，这时候可以根据自身的需求在点击某些按键时加入相应的逻辑。
• onScaleChanged()：页面的缩放比例发生变化时调用，这时候可以根据当前的缩放比例来重新调整WebView中显示的内容，如修改字体大小、图片大小等。
• shouldInterceptRequest()：可以根据请求携带的内容来判断是否需要拦截请求。

WebViewClient webViewClient = new WebViewClient(){
  @Override
  public void onPageStarted(WebView view, String url, Bitmap favicon) {

  }

  @Override
  public void onPageFinished(WebView view, String url) {

  }

  @Override
  public boolean onLoadResource(WebView view, String url) {

  }

  @Override
  public boolean shouldOverrideUrlLoading(WebView view, String url) {
    view.loadUrl(url);
    return true; -> 消费事件终止传递
  }

  @Override
  public void onReceivedError(WebView view, int errorCode, 
    String description, String failingUrl){
    view.loadUrl("file:///android_assets/error.html"); -> assets目录下放置文件
}

webView.setWebViewClient(webViewClient);

五、WebChromeClient

• 浏览器客户端，用于处理网站图标、网站标题、网站弹窗等。
• onProgressChanged()：页面加载进度发生变化时调用，可以通过该方法实时向用户反馈加载情况，如显示进度条等。
• onReceivedIcon()：接收Web页面的图标，可以通过该方法把图标设置在原生的控件上，如Toolbar等。
• onReceivedTitle()：接收Web页面的标题，可以通过该方法把图标设置在原生的控件上，如Toolbar等。
• onJsAlert()：处理JS的Alert对话框。
• onJsPrompt()：处理JS的Prompt对话框。
• onJsConfirm()：处理JS的Confirm对话框。
• onPermissionRequest()：Web页面请求Android权限时调用。
• onPermissionRequestCanceled()：Web页面请求Android权限被取消时调用。
• onShowFileChooser()：Web页面上传文件时调用。
• getVideoLoadingProgressView()：自定义媒体文件播放加载时的进度条。
• getDefaultVideoPoster()：设置媒体文件默认的预览图。
• onShowCustomView()：媒体文件进入全屏时调用。
• onHideCustomView()：媒体文件退出全屏时调用。

WebChromeClient webChromeClient = new WebChromeClient();

六、Android调用JS

• 语法：webView.loadUrl("javascript:method()");
• 在Web页面中定义两个Js方法，分别是有返回值和无返回值。

let name = '';

function setter(name){
    this.name = name;
}

function getter(){
    return this.name;
}

• 在Android中通过WebView调用Js方法

String setter = "javascript:setter('"+"wjx"+"');";
webView.loadUrl(setter); -> 调用有参无返回值的函数

webView.evaluateJavascript("getter()", new ValueCallback<String>() {
    @Override
    public void onReceiveValue(String s) { -> 调用无参有返回值的函数
        System.out.println("my name is "+s);
    }
});

七、Js调用Android

webView.addJavascriptInterface(this, "bridge");  -> 建立通讯桥梁
webView.removeJavascriptInterface("bridge"); -> 移除通讯桥梁

• 在Android中定义一个方法，标记为Js接口

@JavascriptInterface
public void toast(String toast){
  Toast.makeText(MainActivity.this, toast, Toast.LENGTH_SHORT).show();
}

• 在Web页面中调用Android方法

function toast(toast){
  javascript:bridge.toast(toast); -> 通过桥梁调用方法
  window.bridge.toast(toast); -> 通过桥梁调用方法
}