WebView的坑别嫌多

码个蛋(codeegg)第 723 次推文

作者: 骑着蜗牛闯红灯

原文: https://juejin.cn/post/6844903863619682311

先简单介绍一下，Android在4.4之后采用了Chrome内核，所以我们在开发web页面的时候，es6的语法，css3的样式等大可放心使用。

我将分下面几个模块去介绍Android上面WebView。

WebView自身的一些方法
//方式1. 加载一个网页： webView.loadUrl("http://www.google.com/"); //方式2：加载apk包中的html页面 webView.loadUrl("file:///android_asset/test.html"); //方式3：加载手机本地的html页面 webView.loadUrl("content://com.android.htmlfileprovider/sdcard/test.html");
 
    

    

正常情况下，在WebView界面，用户点击返回键是直接退出该页面的，着当然不是我们想要的，我们想要的是网页自己的前进和后退，所以下面介绍网页前进和后退的一些API

//判断是否可以后退Webview.canGoBack()//后退网页Webview.goBack()//判断是否可以前进Webview.canGoForward()//前进网页Webview.goForward()// 参数传负的话表示后退，传正值的话表示的是前进Webview.goBackOrForward(int steps)

对返回键的监听，来实现网页的后退public boolean onKeyDown(int keyCode, KeyEvent event) { if ((keyCode == KEYCODE_BACK) && mWebView.canGoBack()) { mWebView.goBack(); return true; } return super.onKeyDown(keyCode, event);}

如何防止WebView内存泄漏

防止内存泄漏的一个原则就是：生命周期长的不要跟生命周期短的玩。

为了防止WebView不造成内存泄漏，

• 不要在xml里面定义WebView，而是在Activity选中使用代码去构建，并且Context使用ApplicationContext

• 在Activity销毁的时候，先让WebView加载空内容，然后重rootView中移除WebView,再销毁WebView,最后置空

override fun onDestroy() { if (webView != null) { webView!!.loadDataWithBaseURL(null, "", "text/html", "utf-8", null) webView!!.clearHistory() (webView!!.parent as ViewGroup).removeView(webView) webView!!.destroy() webView = null } super.onDestroy() }

WebSetting和WebViewClient，WebChromeClien

• WebSetting

作用：对WebView进行配置和管理

WebSettings webSettings = webView.getSettings();// 设置可以与js交互，为了防止资源浪费，我们可以在Activity// 的onResume中设置为true，在onStop中设置为falsewebSettings.setJavaScriptEnabled(true);//设置自适应屏幕，两者合用//将图片调整到适合webview的大小webSettings.setUseWideViewPort(true); // 缩放至屏幕的大小webSettings.setLoadWithOverviewMode(true);//设置编码格式webSettings.setDefaultTextEncodingName("utf-8");// 设置允许JS弹窗webSettings.setJavaScriptCanOpenWindowsAutomatically(true);//设置缓存的模式webSettings.setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK);

关于缓存的设置：

当加载 html 页面时，WebView会在/data/data/包名目录下生成 database 与 cache 两个文件夹，请求的 URL记录保存在 WebViewCache.db，而 URL的内容是保存在 WebViewCache 文件夹下

缓存模式如下：

//LOAD_CACHE_ONLY: 不使用网络，只读取本地缓存数据//LOAD_DEFAULT: （默认）根据cache-control决定是否从网络上取据。//LOAD_NO_CACHE: 不使用缓存，只从网络获取数据.//LOAD_CACHE_ELSE_NETWORK，只要本地有，无论是否过期，或no-cache，都使用缓存中的数据。

离线加载

if (NetStatusUtil.isConnected(getApplicationContext())) { webSettings.setCacheMode(WebSettings.LOAD_DEFAULT);//根据cache-control决定是否从网络上取数据。} else { webSettings.setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK);//没网，则从本地获取，即离线加载}webSettings.setDomStorageEnabled(true); // 开启 DOM storage API 功能webSettings.setDatabaseEnabled(true); //开启 database storage API 功能webSettings.setAppCacheEnabled(true);//开启 Application Caches 功能String cacheDirPath = getFilesDir().getAbsolutePath() + APP_CACAHE_DIRNAME;webSettings.setAppCachePath(cacheDirPath); //设置 Application Caches 缓存目录

• WebViewClient 作用

处理各种通知，请求事件，主要有，网页开始加载，记载结束，加载错误(如404)，处理https请求，具体使用请看下面代码，注释清晰。

webView!!.webViewClient = object : WebViewClient() { // 启用WebView，而不是系统自带的浏览器 override fun shouldOverrideUrlLoading(view: WebView, url: String): Boolean { view.loadUrl(url) return true }// 页面开始加载，我们可以在这里设置loading override fun onPageStarted(view: WebView?, url: String?, favicon: Bitmap?) { super.onPageStarted(view, url, favicon) tv_start.text = "开始加载了..." }// 页面加载结束，关闭loading override fun onPageFinished(view: WebView?, url: String?) { super.onPageFinished(view, url) tv_end.text = "加载结束了..." } // 只要加载html,js,css的资源，每次都会回调到这里 override fun onLoadResource(view: WebView?, url: String?) { loge("onLoadResource invoked") }// 在这里我们可以加载我们自己的404页面 override fun onReceivedError(view: WebView?, request: WebResourceRequest?, error: WebResourceError?) { loge("加载错误：${error.toString()}") }// webview默认设计是不开启https的，下面的设置是允许使用https override fun onReceivedSslError(view: WebView?, handler: SslErrorHandler?, error: SslError?) { handler?.proceed() } // js调用Android的方法，在这里可以，该方法不存在通过注解的方式的内存泄漏，但是想拿到Android的返回值的话很难， // 可以通过Android调用js的代码的形式来传递返回值，例如下面的方式 // Android：MainActivity.java // mWebView.loadUrl("javascript:returnResult(" + result + ")"); // JS：javascript.html // function returnResult(result){ // alert("result is" + result); // } override fun shouldOverrideUrlLoading(view: WebView?, request: WebResourceRequest?): Boolean { val uri = Uri.parse(request?.url.toString()) // 一般根据scheme（协议格式） & authority（协议名）判断（前两个参数） //假定传入进来的 url = "js://webview?arg1=111&arg2=222"（同时也是约定好的需要拦截的） if (uri.scheme == "js") { if (uri.authority == "webview") { toast_custom("js调用了Android的方法") val queryParameterNames = uri.queryParameterNames queryParameterNames.forEach { loge(it + ":" + uri.getQueryParameter(it)) } } return true } return super.shouldOverrideUrlLoading(view, request) } // 拦截资源 通常用于h5的首页页面，将常用的一些资源，放到本地 override fun shouldInterceptRequest(view: WebView?, request: WebResourceRequest?): WebResourceResponse? { if(request?.url.toString().contains("logo.gif")){ var inputStream: InputStream? = null inputStream = applicationContext.assets.open("images/test.png") return WebResourceResponse("image/png","utf-8", inputStream) } return super.shouldInterceptRequest(view, request) } }

注意：

5.1 以上默认禁止了https和http的混用，下面的设置是开启：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {    webView.getSettings().setMixedContentMode(WebSettings.MIXED_CONTENT_ALWAYS_ALLOW);}

• WebChromeClient 作用

  辅助webview的一下回调方法，可以得到网页加载的进度，网页的标题，网页的icon,js的一些弹框，直接看代码，注释清晰。

webView!!.webChromeClient = object : WebChromeClient() { // 网页加载的进度 override fun onProgressChanged(view: WebView?, newProgress: Int) { tv_progress.text = "$newProgress%" }// 获得网页的标题 override fun onReceivedTitle(view: WebView?, title: String?) { tv_title.text = title }//js Alert override fun onJsAlert(view: WebView?, url: String?, message: String?, result: JsResult?): Boolean { AlertDialog.Builder(this@WebActivity) .setTitle("JsAlert") .setMessage(message) .setPositiveButton("OK") { _, _ -> result?.confirm() } .setCancelable(false) .show() return true }// js Confirm override fun onJsConfirm(view: WebView?, url: String?, message: String?, result: JsResult?): Boolean { return super.onJsConfirm(view, url, message, result) }//js Prompt override fun onJsPrompt( view: WebView?, url: String?, message: String?, defaultValue: String?, result: JsPromptResult? ): Boolean { return super.onJsPrompt(view, url, message, defaultValue, result) } }

Android和js的交互

Android调用js

1. 通过webview的loadUrl

注意：该方式必须在webview加载完毕之后才能调用，也就是webviewClient的onPageFinished()方法回调之后，而且该方法的执行 会刷新界面，效率较低

js代码：function callJs(){    alert("Android 调用了 js代码)}

kotlin代码：webView?.loadUrl("javascript:callJs()")

2. 通过webview的evaluateJavaScript

比起第一种方法，效率更高，但是要在4.4之后才能使用

js代码：function callJs(){ // alert("Android 调用了 js代码)     return {name:'wfq',age:25}}kotlin代码：webView?.evaluateJavascript("javascript:callJs()") { // 这里直接拿到的是js代码的返回值     toast(it) // {name:'wfq',age:25} }
 
    

js调用Android

1. 通过webview的addJavaScriptInterface进行对象映射

我们可以单独定义一个类，所有需要交互的方法可以全部写在这个类里面，当然也可以直接写在Activity里面，下面以直接定义在Activity里面为例,优点：使用方便，缺点：存在漏洞（4.2之前），请看下面的“WebView的一些漏洞以及如何防止”

kotlin中定义被js调用的方法 @JavascriptInterfacefun hello(name: String) { toast("你好，我是来自js的消息：$msg")}js代码function callAndroid(){ android.hello("我是js的，我来调用你了")}kotlin中们在webview里面设置Android与js的代码的映射webView?.addJavascriptInterface(this, "android")

2. 通过webviewClient的shouldOverrideUrlLoading的回调来拦截url

具体使用：解析该url的协议，如果监测到是预先约定好的协议，那么就调用相应的方法。比较安全，但是使用麻烦，js获取Android的返回值的话很麻烦,只能通过上面介绍的通过loadurl()去执行js代码把返回值通过参数传递回去

首先在js中约定号协议function callAndroid(){ // 约定的url协议为：js://webview?name=wfq&age=24 document.location = "js://webview?name=wfq&age=24" }在kotlin里面，当loadurl的时候就会回调到shouldOverrideUrlLoading()里面override fun shouldOverrideUrlLoading(view: WebView?, request: WebResourceRequest?): Boolean { val uri = Uri.parse(request?.url.toString()) // 一般根据scheme（协议格式） & authority（协议名）判断（前两个参数） //假定传入进来的 js://webview?name=wfq&age=24 if (uri.scheme == "js") { if (uri.authority == "webview") { toast_custom("js调用了Android的方法") val queryParameterNames = uri.queryParameterNames queryParameterNames.forEach { loge(it + ":" + uri.getQueryParameter(it)) } } return true } return super.shouldOverrideUrlLoading(view, request) }

3.通过webChromeClient的onJsAlert,onJsConfirm,onJsPrompt回调来拦截对话框

通过拦截js对话框，得到他们的消息，然后解析即可，为了安全，建议内容采用上面介绍的url协议， 常用的拦截的话就是拦截prompt,因为它可以返回任意值，alert没有返回值，confirm只能返回两种类型，确定和取消

js代码function clickprompt(){ var result=prompt("wfq://demo?arg1=111&arg2=222"); alert("demo " + result);}kotlin代码override fun onJsPrompt( view: WebView?, url: String?, message: String?, defaultValue: String?, result: JsPromptResult? ): Boolean { val uri = Uri.parse(message) if (uri.scheme == "wfq") { if (uri.authority == "demo") { toast_custom("js调用了Android的方法") val queryParameterNames = uri.queryParameterNames queryParameterNames.forEach { loge(it + ":" + uri.getQueryParameter(it)) } // 将需要返回的值通过该方式返回 result?.confirm("js调用了Android的方法成功啦啦啦啦啦") } return true } return super.onJsPrompt(view, url, message, defaultValue, result) }由于拦截了弹框，所以js代码的alert需要处理 这里的message便是上面代码的返回值通过alert显示出来的信息override fun onJsAlert(view: WebView?, url: String?, message: String?, result: JsResult?): Boolean { AlertDialog.Builder(this@WebActivity) .setTitle("JsAlert") .setMessage(message) .setPositiveButton("OK") { _, _ -> result?.confirm() } .setCancelable(false) .show() return true }

上面三种方式的区别：

addJavascriptInterface() 方便简洁，4.0以下存在漏洞，4.0以上通过@JavascriptInterface注解修复漏洞。

WebViewClient.shouldOverrideUrlLoading()回调，不存在漏洞，使用复杂，需要定义协议的约束，但是返回值的话有些麻烦，在不需要返回值的情况下可以使用这个方式。

通过WebChromeClient的onJsAlerta，onJsConfirm,onJsPrompt，不存在漏洞问题，使用复杂，需要进行协议的约束，可以返回值，能满足大多数情况下的互调通信。

WebView的一些漏洞以及如何防止

密码明文存储漏洞

webview默认开启了密码保存功能，在用户输入密码后会弹出提示框询问用户是否保存密码，保存后密码会被明文保存在 /data/data/com.package.name/databases/webview.db 下面，手机root后可以查看，那么如何解决？

WebSettings.setSavePassword(false) // 关闭密码保存提醒功能

WebView 任意代码执行漏洞

addJavascriptInterface漏洞，首先先明白一点，js调用Android代码的时候，我们经常使用的是addJavascriptInterface， JS调用Android的其中一个方式是通过addJavascriptInterface接口进行对象映射，那么Android4.2之前，既然拿到了这个对象，那么这个对象中的所有方法都是可以调用的，4.2之后，需要被js调用的函数加上@JavascriptInterface注解后来避免该漏洞

所以怎么解决

对于Android 4.2以前，需要采用拦截prompt() 方式进行漏洞修复
对于Android 4.2以后，则只需要对被调用的函数以 @JavascriptInterface进行注解

域控制不严格漏洞

• 原因分析 当我们在Applilcation里面，android:exported="true"的时候，A 应用可以通过 B 应用导出的 Activity 让 B 应用加载一个恶意的 file 协议的 url，从而可以获取 B 应用的内部私有文件，从而带来数据泄露威胁，

下面来看下WebView中getSettings类的方法对 WebView 安全性的影响 setAllowFileAccess（）

// 设置是否允许 WebView 使用 File 协议
// 默认设置为true，即允许在 File 域下执行任意 JavaScript 代码webView.getSettings().setAllowFileAccess(true);如果设置为false的话，便不会存在威胁，但是，webview也无法使用本地的html文件

setAllowFileAccessFromFileURLs()

// 设置是否允许通过 file url 加载的 Js代码读取其他的本地文件// 在Android 4.1前默认允许// 在Android 4.1后默认禁止webView.getSettings().setAllowFileAccessFromFileURLs(true);我们应该明确的设置为false，禁止读取其他文件

setAllowUniversalAccessFromFileURLs()

// 设置是否允许通过 file url 加载的 Javascript 可以访问其他的源(包括http、https等源)// 在Android 4.1前默认允许（setAllowFileAccessFromFileURLs（）不起作用）// 在Android 4.1后默认禁止webView.getSettings().setAllowUniversalAccessFromFileURLs(true);

WebView预加载以及资源预加载

为什么需要预加载

h5页面加载慢，慢的原因：页面渲染慢，资源加载慢

如何优化？

h5的缓存，资源预加载，资源拦截

h5的缓存 Android WebView自带的缓存 

1. 浏览器缓存

根据 HTTP 协议头里的 Cache-Control（或 Expires）和 Last-Modified（或Etag）
等字段来控制文件缓存的机制浏览器自己实现，我需我们处理

2. App Cache

方便构建Web App的缓存，存储静态文件（如JS、CSS、字体文件）
WebSettings settings = getSettings(); String cacheDirPath = context.getFilesDir().getAbsolutePath()+"cache/"; settings.setAppCachePath(cacheDirPath); settings.setAppCacheMaxSize(20*1024*1024); settings.setAppCacheEnabled(true);
 
    
 
    
    

3. Dom Storage

WebSettings settings = getSettings(); settings.setDomStorageEnabled(true);

4. Indexed Database

// 只需设置支持JS就自动打开IndexedDB存储机制 // Android 在4.4开始加入对 IndexedDB 的支持，只需打开允许 JS 执行的开关就好了。WebSettings settings = getSettings();settings.setJavaScriptEnabled(true);

• 资源预加载 预加载webview对象，首次初始化WebView会比第二次慢很多的原因：初始化后，即使webview已经释放，但是WebView的一些共享的对象依然是存在的，我们可以在Application里面提前初始化一个Webview的对象，然后可以直接loadurl加载资源

• 资源拦截 可以将跟新频率低的一些资源静态文件放在本地，拦截h5的资源网络请求并进行检测，如果检测到，就直接拿本地的资源进行替换即可

// 拦截资源 通常用于h5的首页页面，将常用的一些资源，放到本地 override fun shouldInterceptRequest(view: WebView?, request: WebResourceRequest?): WebResourceResponse? { if(request?.url.toString().contains("logo.jpg")){ var inputStream: InputStream? = null inputStream = applicationContext.assets.open("images/test.jpg") return WebResourceResponse("image/png","utf-8", inputStream) } return super.shouldInterceptRequest(view, request) }

常见的使用注意事项

1. Android9.0 已经禁止了webview使用http,怎么解决？

在manifest Application标签下面使用：

android:usesCleartextTraffic="true"

2. 开启混淆之后，Android无法与h5交互？

#保留annotation， 例如 @JavascriptInterface 等 annotation-keepattributes *Annotation*#保留跟 javascript相关的属性-keepattributes JavascriptInterface#保留JavascriptInterface中的方法-keepclassmembers class * { @android.webkit.JavascriptInterface <methods>;}#这个类是用来与js交互，所以这个类中的 字段 ，方法， 不能被混淆、全路径名称.类名-keepclassmembers public class com.youpackgename.xxx.H5CallBackAndroid{ <fields>; <methods>; public *; private *;}

3. 如何调试？

3.1 在WebViewActivity里面，开启调试

// 开启调试WebView.setWebContentsDebuggingEnabled(true)

3.2 chrome浏览器地址栏输入 chrome://inspect

3.3 手机打开USB调试，打开webview页面，点击chrome页面的最下面的inspect，这样，便可以进入了web开发，看控制台，网络请求等

近期文章：

• Android 更新：新图标，新命名

• 腾讯Android插件库，技压群雄实现零反射全动态

• 五分钟搞懂"Hello World" 是怎么显示到手机上的！

今日问题：

看到WebView是不是很头疼？

专属升级社区：《这件事情，我终于想明白了》