android webview 数据流,必知必会 | WebView 的一切都在这儿

原标题：必知必会 | WebView 的一切都在这儿

本文作者

作者：reezy

链接：

https://www.jianshu.com/p/a6f7b391a0b8

本文由作者授权发布。

文章较长，且大部分说明包含在注释中，建议收藏后慢慢看~

1

目录

1. 相关API

1.1. 相关类介绍

1.2. WebView

1.3. WebSettings

1.4. WebViewClient

1.5. WebChromeClient

2.回调顺序

3.视口(viewport)

4.管理 Cookies

5.缓存(Cache)

6.预加载(Preload)

6.与Java交互

8.地理位置(Geolocation)

9.弹框(alert/confirm/prompt/onbeforeunload)

10.全屏(Fullscreen)

11. 内存泄漏

12.参考

2

相关API

相关类介绍

WebResourceRequest添加于API21，封装了一个Web资源的请求信息，包含：请求地址，请求方法，请求头，是否主框架，是否用户点击，是否重定向

WebResourceResponse封装了一个Web资源的响应信息，包含：响应数据流，编码，MIME类型，API21后添加了响应头，状态码与状态描述

WebResourceError添加于API23，封装了一个Web资源的错误信息，包含错误码和描述

CookieManager管理用于WebView的cookies。。

WebViewDatabase存储与管理以下几类浏览数据：

表单自动填充的的用户名与密码

HTTP认证的用户名与密码

曾经输入过的文本(比如自动完成)

WebStorage用于管理WebView提供的JS存储API，比如Application Cache API，Web SQL Database API，HTML5 Web Storage API

GeolocationPermissions用于管理WebView的JS Geolocation API

HttpAuthHandler表示一个HTTP认证请求，提供了方法操作(proceed/cancel)请求

SslErrorHandler表示一个处理SSL错误的请求，提供了方法操作(proceed/cancel)请求

ClientCertRequest表示一个证书请求，提供了方法操作(proceed/cancel/ignore)请求

JsResult用于处理底层JS发起的请求，为客户端提供一些方法指明应进行的操作，比如确认或取消。

WebView

基本

// 获取当前页面的URL

publicString getUrl();

// 获取当前页面的原始URL(重定向后可能当前url不同)

// 就是http headers的Referer参数，loadUrl时为null

publicString getOriginalUrl();

// 获取当前页面的标题

publicString getTitle();

// 获取当前页面的favicon

publicBitmap getFavicon();

// 获取当前页面的加载进度

publicintgetProgress();

// 通知WebView内核网络状态

// 用于设置JS属性`window.navigator.isOnline`和产生HTML5事件`online/offline`

publicvoidsetNetworkAvailable(booleannetworkUp)

// 设置初始缩放比例

publicvoidsetInitialScale(intscaleInPercent)；

加载网页

// 加载URL指定的网页

public voidloadUrl( Stringurl);

// 携带http headers加载URL指定的网页

public voidloadUrl( Stringurl, Map< String, String> additionalHttpHeaders);

// 使用POST请求加载指定的网页

public voidpostUrl( Stringurl, byte[] postData);

// 重新加载当前网页

public voidreload();

// 加载内容

public voidloadData( Stringdata, StringmimeType, Stringencoding);

// 使用baseUrl加载内容

public voidloadDataWithBaseURL( StringbaseUrl, Stringdata, StringmimeType, Stringencoding, StringhistoryUrl);

Java

// 注入Java对象

publicvoidaddJavaInterface(Object object, String name);

// 移除已注入的Java对象，下次加载或刷新页面时生效

publicvoidremoveJavaInterface(String name);

// 对传入的JS表达式求值，通过resultCallback返回结果

// 此函数添加于API19，必须在UI线程中调用，回调也将在UI线程

publicvoidevaluateJava(String , ValueCallback resultCallback)

导航(前进后退)

// 复制一份BackForwardList

publicWebBackForwardList copyBackForwardList();

// 是否可后退

publicbooleancanGoBack();

// 是否可前进

publicbooleancanGoForward();

// 是否可前进/后退steps页，大于0表示前进小于0表示后退

publicbooleancanGoBackOrForward(intsteps);

// 后退一页

publicvoidgoBack();

// 前进一页

publicvoidgoForward();

// 前进/后退steps页，大于0表示前进小于0表示后退

publicvoidgoBackOrForward(intsteps);

// 清除当前webview访问的历史记录

publicvoidclearHistory();

网页查找功能

// 设置网页查找结果回调

publicvoidsetFindListener(FindListener listener);

// 异步执行查找网页内包含的字符串并设置高亮，查找结果会回调.

publicvoidfindAllAsync(String find);

// 查找下一个匹配的字符串

publicvoidfindNext(booleanforward);

// 清除网页查找的高亮匹配字符串

publicvoidclearMatches();

截屏/翻页/缩放

// 保存网页(.html)到指定文件

publicvoidsaveWebArchive(String filename);

// 保存网页(.html)到文件

publicvoidsaveWebArchive(String basename, booleanautoname, ValueCallback callback)；

// 上翻一页，即向上滚动WebView高度的一半

publicvoidpageUp(booleantop);

// 下翻一页，即向下滚动WebView高度的一半

publicvoidpageDown(booleanbottom);

// 缩放

publicvoidzoomBy(floatfactor);

// 放大

publicbooleanzoomIn();

// 缩放

publicbooleanzoomOut();

其它

// 清除网页缓存，由于内核缓存是全局的因此这个方法不仅仅针对webview而是针对整个应用程序

publicvoidclearCache(booleanincludeDiskFiles);

// 清除自动完成填充的表单数据

publicvoidclearFormData();

// 清除SSL偏好

publicvoidclearSslPreferences();

// 查询文档中是否有图片，查询结果将被发送到msg.getTarget()

// 如果包含图片，msg.arg1 为1，否则为0

publicvoiddocumentHasImages(Message msg);

// 请求最近轻叩(tapped)的 锚点/图像 元素的URL，查询结果将被发送到msg.getTarget()

// msg.getData()中的url是锚点的href属性，title是锚点的文本，src是图像的src

publicvoidrequestFocusNodeHref(Message msg);

// 请求最近触摸(touched)的 图像元素的URL，查询结果将被发送到msg.getTarget()

// msg.getData()中的url是图像链接

publicvoidrequestImageRef(Message msg)

// 清除证书请求偏好，添加于API21

// 在WebView收到`android.security.STORAGE_CHANGED` Intent时会自动清除

publicstaticvoidclearClientCertPreferences(Runnable onCleared)

// 开启网页内容(js,css,html...)调试模式，添加于API19

publicstaticvoidsetWebContentsDebuggingEnabled(booleanenabled)

WebSettings

WebSettings settings = web.getSettings();

// 存储(storage)

// 启用HTML5 DOM storage API，默认值 false

settings.setDomStorageEnabled( true);

// 启用Web SQL Database API，这个设置会影响同一进程内的所有WebView，默认值 false

// 此API已不推荐使用，参考：https://www.w3.org/TR/webdatabase/

settings.setDatabaseEnabled( true);

// 启用Application Caches API，必需设置有效的缓存路径才能生效，默认值 false

// 此API已废弃，参考：https://developer.mozilla.org/zh-CN/docs/Web/HTML/Using_the_application_cache

settings.setAppCacheEnabled( true);

settings.setAppCachePath(context.getCacheDir().getAbsolutePath());

// 定位(location)

settings.setGeolocationEnabled( true);

// 是否保存表单数据

settings.setSaveFormData( true);

// 是否当webview调用requestFocus时为页面的某个元素设置焦点，默认值 true

settings.setNeedInitialFocus( true);

// 是否支持viewport属性，默认值 false

// 页面通过``自适应手机屏幕

settings.setUseWideViewPort( true);

// 是否使用overview mode加载页面，默认值 false

// 当页面宽度大于WebView宽度时，缩小使页面宽度等于WebView宽度

settings.setLoadWithOverviewMode( true);

// 布局算法

settings.setLayoutAlgorithm(WebSettings.LayoutAlgorithm.NORMAL);

// 是否支持Java，默认值false

settings.setJavaEnabled( true);

// 是否支持多窗口，默认值false

settings.setSupportMultipleWindows( false);

// 是否可用Java(window.open)打开窗口，默认值 false

settings.setJavaCanOpenWindowsAutomatically( false);

// 资源访问

settings.setAllowContentAccess( true); // 是否可访问Content Provider的资源，默认值 true

settings.setAllowFileAccess( true); // 是否可访问本地文件，默认值 true

// 是否允许通过file url加载的Java读取本地文件，默认值 false

settings.setAllowFileAccessFromFileURLs( false);

// 是否允许通过file url加载的Java读取全部资源(包括文件,http,https)，默认值 false

settings.setAllowUniversalAccessFromFileURLs( false);

// 资源加载

settings.setLoadsImagesAutomatically( true); // 是否自动加载图片

settings.setBlockNetworkImage( false); // 禁止加载网络图片

settings.setBlockNetworkLoads( false); // 禁止加载所有网络资源

// 缩放(zoom)

settings.setSupportZoom( true); // 是否支持缩放

settings.setBuiltInZoomControls( false); // 是否使用内置缩放机制

settings.setDisplayZoomControls( true); // 是否显示内置缩放控件

// 默认文本编码，默认值 "UTF-8"

settings.setDefaultTextEncodingName( "UTF-8");

settings.setDefaultFontSize( 16); // 默认文字尺寸，默认值16，取值范围1-72

settings.setDefaultFixedFontSize( 16); // 默认等宽字体尺寸，默认值16

settings.setMinimumFontSize( 8); // 最小文字尺寸，默认值 8

settings.setMinimumLogicalFontSize( 8); // 最小文字逻辑尺寸，默认值 8

settings.setTextZoom( 100); // 文字缩放百分比，默认值 100

// 字体

settings.setStandardFontFamily( "sans-serif"); // 标准字体，默认值 "sans-serif"

settings.setSerifFontFamily( "serif"); // 衬线字体，默认值 "serif"

settings.setSansSerifFontFamily( "sans-serif"); // 无衬线字体，默认值 "sans-serif"

settings.setFixedFontFamily( "monospace"); // 等宽字体，默认值 "monospace"

settings.setCursiveFontFamily( "cursive"); // 手写体(草书)，默认值 "cursive"

settings.setFantasyFontFamily( "fantasy"); // 幻想体，默认值 "fantasy"

if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {

// 用户是否需要通过手势播放媒体(不会自动播放)，默认值 true

settings.setMediaPlaybackRequiresUserGesture( true);

}

if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {

// 5.0以上允许加载http和https混合的页面(5.0以下默认允许，5.0+默认禁止)

settings.setMixedContentMode(WebSettings.MIXED_CONTENT_ALWAYS_ALLOW);

}

if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {

// 是否在离开屏幕时光栅化(会增加内存消耗)，默认值 false

settings.setOffscreenPreRaster( false);

}

if(isNetworkConnected(context)) {

// 根据cache-control决定是否从网络上取数据

settings.setCacheMode(WebSettings.LOAD_DEFAULT);

} else{

// 没网，离线加载，优先加载缓存(即使已经过期)

settings.setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK);

}

// deprecated

settings.setRenderPriority(WebSettings.RenderPriority.HIGH);

settings.setDatabasePath(context.getDir( "database", Context.MODE_PRIVATE).getPath());

settings.setGeolocationDatabasePath(context.getFilesDir().getPath());

通常大部分保持默认值就好了

WebSettings settings = web.getSettings();

// 缓存(cache)

settings.setAppCacheEnabled( true); // 默认值 false

settings.setAppCachePath(context.getCacheDir().getAbsolutePath());

// 存储(storage)

settings.setDomStorageEnabled( true); // 默认值 false

settings.setDatabaseEnabled( true); // 默认值 false

// 是否支持viewport属性，默认值 false

// 页面通过``自适应手机屏幕

settings.setUseWideViewPort( true);

// 是否使用overview mode加载页面，默认值 false

// 当页面宽度大于WebView宽度时，缩小使页面宽度等于WebView宽度

settings.setLoadWithOverviewMode( true);

// 是否支持Java，默认值false

settings.setJavaEnabled( true);

if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {

// 5.0以上允许加载http和https混合的页面(5.0以下默认允许，5.0+默认禁止)

settings.setMixedContentMode(WebSettings.MIXED_CONTENT_ALWAYS_ALLOW);

}

if(isNetworkConnected(context)) {

// 根据cache-control决定是否从网络上取数据

settings.setCacheMode(WebSettings.LOAD_DEFAULT);

} else{

// 没网，离线加载，优先加载缓存(即使已经过期)

settings.setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK);

}

WebViewClient

// 拦截页面加载，返回true表示宿主app拦截并处理了该url，否则返回false由当前WebView处理

// 此方法在API24被废弃，不处理POST请求

publicbooleanshouldOverrideUrlLoading(WebView view, String url){

returnfalse;

}

// 拦截页面加载，返回true表示宿主app拦截并处理了该url，否则返回false由当前WebView处理

// 此方法添加于API24，不处理POST请求，可拦截处理子frame的非http请求

@TargetApi(Build.VERSION_CODES.N)

publicbooleanshouldOverrideUrlLoading(WebView view, WebResourceRequest request){

returnshouldOverrideUrlLoading(view, request.getUrl().toString());

}

// 此方法废弃于API21，调用于非UI线程

// 拦截资源请求并返回响应数据，返回null时WebView将继续加载资源

// 注意：API21以下的AJAX请求会走Resource，无法通过此方法拦截

publicWebResourceResponse shouldInterceptRequest(WebView view, String url){

returnnull;

}

// 此方法添加于API21，调用于非UI线程

// 拦截资源请求并返回数据，返回null时WebView将继续加载资源

@TargetApi(Build.VERSION_CODES.LOLLIPOP)

publicWebResourceResponse shouldInterceptRequest(WebView view, WebResourceRequest request){

returnshouldInterceptRequest(view, request.getUrl().toString());

}

// 页面(url)开始加载

publicvoidonPageStarted(WebView view, String url, Bitmap favicon){

}

// 页面(url)完成加载

publicvoidonPageFinished(WebView view, String url){

}

// 将要加载资源(url)

publicvoidResource(WebView view, String url){

}

// 这个回调添加于API23，仅用于主框架的导航

// 通知应用导航到之前页面时，其遗留的WebView内容将不再被绘制。

// 这个回调可以用来决定哪些WebView可见内容能被安全地回收，以确保不显示陈旧的内容

// 它最早被调用，以此保证WebView.onDraw不会绘制任何之前页面的内容，随后绘制背景色或需要加载的新内容。

// 当HTTP响应body已经开始加载并体现在DOM上将在随后的绘制中可见时，这个方法会被调用。

// 这个回调发生在文档加载的早期，因此它的资源(css,和图像)可能不可用。

// 如果需要更细粒度的视图更新，查看 postVisualStateCallback(long, WebView.VisualStateCallback).

// 请注意这上边的所有条件也支持 postVisualStateCallback(long ,WebView.VisualStateCallback)

publicvoidonPageCommitVisible(WebView view, String url){

}

// 此方法废弃于API23

// 主框架加载资源时出错

publicvoidonReceivedError(WebView view, interrorCode, String deion, String failingUrl){

}

// 此方法添加于API23

// 加载资源时出错，通常意味着连接不到服务器

// 由于所有资源加载错误都会调用此方法，所以此方法应尽量逻辑简单

@TargetApi(Build.VERSION_CODES.M)

publicvoidonReceivedError(WebView view, WebResourceRequest request, WebResourceError error){

if(request.isForMainFrame()) {

onReceivedError(view, error.getErrorCode(), error.getDeion().toString(), request.getUrl().toString());

}

}

// 此方法添加于API23

// 在加载资源(iframe,image,js,css,ajax...)时收到了 HTTP 错误(状态码>=400)

publicvoidonReceivedHttpError(WebView view, WebResourceRequest request, WebResourceResponse errorResponse){

}

// 是否重新提交表单，默认不重发

publicvoidonFormResubmission(WebView view, Message dontResend, Message resend){

dontResend.sendToTarget();

}

// 通知应用可以将当前的url存储在数据库中，意味着当前的访问url已经生效并被记录在内核当中。

// 此方法在网页加载过程中只会被调用一次，网页前进后退并不会回调这个函数。

publicvoiddoUpdateVisitedHistory(WebView view, String url, booleanisReload){

}

// 加载资源时发生了一个SSL错误，应用必需响应(继续请求或取消请求)

// 处理决策可能被缓存用于后续的请求，默认行为是取消请求

publicvoidonReceivedSslError(WebView view, SslErrorHandler handler, SslError error){

handler.cancel();

}

// 此方法添加于API21，在UI线程被调用

// 处理SSL客户端证书请求，必要的话可显示一个UI来提供KEY。

// 有三种响应方式：proceed()/cancel()/ignore()，默认行为是取消请求

// 如果调用proceed()或cancel()，Webview 将在内存中保存响应结果且对相同的"host:port"不会再次调用 onReceivedClientCertRequest

// 多数情况下，可通过KeyChain.choosePrivateKeyAlias启动一个Activity供用户选择合适的私钥

@TargetApi(Build.VERSION_CODES.LOLLIPOP)

publicvoidonReceivedClientCertRequest(WebView view, ClientCertRequest request){

request.cancel();

}

// 处理HTTP认证请求，默认行为是取消请求

publicvoidonReceivedHttpAuthRequest(WebView view, HttpAuthHandler handler, String host, String realm){

handler.cancel();

}

// 通知应用有个已授权账号自动登陆了

publicvoidonReceivedLoginRequest(WebView view, String realm, String account, String args){

}

// 给应用一个机会处理按键事件

// 如果返回true，WebView不处理该事件，否则WebView会一直处理，默认返回false

publicbooleanshouldOverrideKeyEvent(WebView view, KeyEvent event){

returnfalse;

}

// 处理未被WebView消费的按键事件

// WebView总是消费按键事件，除非是系统按键或shouldOverrideKeyEvent返回true

// 此方法在按键事件分派时被异步调用

publicvoidonUnhandledKeyEvent(WebView view, KeyEvent event){

super.onUnhandledKeyEvent(view, event);

}

// 通知应用页面缩放系数变化

publicvoidonScaleChanged(WebView view, floatoldScale, floatnewScale){

}

WebChromeClient

// 获得所有访问历史项目的列表，用于链接着色。

publicvoidgetVisitedHistory(ValueCallback callback){

}

// 控件在未播放时，会展示为一张海报图，HTML中可通过它的'poster'属性来指定。

// 如果未指定'poster'属性，则通过此方法提供一个默认的海报图。

publicBitmap getDefaultVideoPoster(){

returnnull;

}

// 当全屏的视频正在缓冲时，此方法返回一个占位视图(比如旋转的菊花)。

publicView getVideoLoadingProgressView(){

returnnull;

}

// 接收当前页面的加载进度

publicvoidonProgressChanged(WebView view, intnewProgress){

}

// 接收文档标题

publicvoidonReceivedTitle(WebView view, String title){

}

// 接收图标(favicon)

publicvoidonReceivedIcon(WebView view, Bitmap icon){

}

// Android中处理Touch Icon的方案

// http://droidyue.com/blog/2015/01/18/deal-with-touch-icon-in-android/index.html

publicvoidonReceivedTouchIconUrl(WebView view, String url, booleanprecomposed){

}

// 通知应用当前页进入了全屏模式，此时应用必须显示一个包含网页内容的自定义View

publicvoidonShowCustomView(View view, CustomViewCallback callback){

}

// 通知应用当前页退出了全屏模式，此时应用必须隐藏之前显示的自定义View

publicvoidonHideCustomView(){

}

// 显示一个alert对话框

publicbooleanonJsAlert(WebView view, String url, String message, JsResult result){

returnfalse;

}

// 显示一个confirm对话框

publicbooleanonJsConfirm(WebView view, String url, String message, JsResult result){

returnfalse;

}

// 显示一个prompt对话框

publicbooleanonJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result){

returnfalse;

}

// 显示一个对话框让用户选择是否离开当前页面

publicbooleanonJsBeforeUnload(WebView view, String url, String message, JsResult result){

returnfalse;

}

// 指定源的网页内容在没有设置权限状态下尝试使用地理位置API。

// 从API24开始，此方法只为安全的源(https)调用，非安全的源会被自动拒绝

publicvoidonGeolocationPermissionsShowPrompt(String origin, GeolocationPermissions.Callback callback){

}

// 当前一个调用 onGeolocationPermissionsShowPrompt() 取消时，隐藏相关的UI。

publicvoidonGeolocationPermissionsHidePrompt(){

}

// 通知应用打开新窗口

publicbooleanonCreateWindow(WebView view, booleanisDialog, booleanisUserGesture, Message resultMsg){

returnfalse;

}

// 通知应用关闭窗口

publicvoidonCloseWindow(WebView window){

}

// 请求获取取焦点

publicvoidonRequestFocus(WebView view){

}

// 通知应用网页内容申请访问指定资源的权限(该权限未被授权或拒绝)

@TargetApi(Build.VERSION_CODES.LOLLIPOP)

publicvoidonPermissionRequest(PermissionRequest request){

request.deny();

}

// 通知应用权限的申请被取消，隐藏相关的UI。

@TargetApi(Build.VERSION_CODES.LOLLIPOP)

publicvoidonPermissionRequestCanceled(PermissionRequest request){

}

// 为''显示文件选择器，返回false使用默认处理

@TargetApi(Build.VERSION_CODES.LOLLIPOP)

publicbooleanonShowFileChooser(WebView webView, ValueCallback filePathCallback, FileChooserParams fileChooserParams){

returnfalse;

}

// 接收Java控制台消息

publicbooleanonConsoleMessage(ConsoleMessage consoleMessage){

returnfalse;

}

3

回调顺序

页面加载回调顺序：

shouldOverrideUrlLoading

onProgressChanged[ 10]

shouldInterceptRequest

onProgressChanged[...]

onPageStarted

onProgressChanged[...]

onLoadResource

onProgressChanged[...]

onReceivedTitle/onPageCommitVisible

onProgressChanged[ 100]

onPageFinished

onReceivedIcon

资源加载回调：

shouldInterceptRequest() -> Resource()

发生重定向时回调：

onPageStarted() -> shouldOverrideUrlLoading()

直接loadUrl的回调：

// 无重定向

onPageStarted() -> onPageFinished()

// 有重定向，shouldOverrideUrlLoading 返回 true 时 onPageFinished 仍会执行

onPageStarted() -> redirection -> ... -> onPageFinished()

用户点击链接的回调：

// shouldOverrideUrlLoading 返回 true 时不执行onPageStarted/onPageFinished

shouldOverrideUrlLoading() -> ...

// 无重定向

shouldOverrideUrlLoading() -> onPageStarted() -> onPageFinished()

// 有重定向

shouldOverrideUrlLoading() -> onPageStarted() -> redirection -> ... -> onPageFinished()

// 有重定向(A->B->C)

shouldOverrideUrlLoading(A) -> onPageStarted(A) ->

onPageStarted(B) -> shouldOverrideUrlLoading(B) ->

onPageStarted(C) -> shouldOverrideUrlLoading(C) -> onPageFinished(C)

后退/前进/刷新 时回调：

onPageStarted() -> onPageFinished()

关于window.location

假设从A页面跳转到B页面

如果页面B中直接输出 window.location="http://example.com"，那页面B不会被加入回退栈，回退将直接回到A页

如果页面B加载完成后，比如用setTimeout延迟了，那页面B会被加入回退栈，当回退到页面A时会再执行跳转，这会导致回退功能看起来不正常，需要快速回退两次才能回到A页面

4

视口(viewport)

https://developer.android.com/guide/webapps/targeting.html

https://developer.mozilla.org/en-US/docs/Mozilla/Mobile/Viewport_meta_tag

https://developer.mozilla.org/zh-CN/docs/Web/CSS/@viewport

视口是一个为网页提供绘图区域的矩形。

你可以指定数个视口属性，比如尺寸和初始缩放系数(initial scale)。其中最重要的是视口宽度，它定义了网页水平方向的可用像素总数(可用的CSS像素数)。

多数 Android 上的网页浏览器(包括 Chrome)设置默认视口为一个大尺寸(被称为"wide viewport mode"，宽约 980px)。

也有许多浏览器默认会尽可能缩小以显示完整的视口宽度(被称为"overview mode")。

// 是否支持viewport属性，默认值 false

// 页面通过``自适应手机屏幕

// 当值为true且viewport标签不存在或未指定宽度时使用 wide viewport mode

settings.setUseWideViewPort( true);

// 是否使用overview mode加载页面，默认值 false

// 当页面宽度大于WebView宽度时，缩小使页面宽度等于WebView宽度

settings.setLoadWithOverviewMode( true);

viewport 语法

content= "

height = [pixel_value | "device-height "] ,

width = [pixel_value | "device-width "] ,

initial-scale = float_value ,

minimum-scale = float_value ,

maximum-scale = float_value ,

user-scalable = ["yes" | "no"]

"/>

指定视口宽度精确匹配设备屏幕宽度同时禁用了缩放

Example

通过WebView设置初始缩放(initial-scale)

// 设置初始缩放百分比

// 0表示依赖于setUseWideViewPort和setLoadWithOverviewMode

// 100表示不缩放

web.setInitialScale( 0)

5

管理 Cookies

https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Cookies

Cookie 是服务器发送到用户浏览器并保存在浏览器上的一块数据，它会在浏览器下一次发起请求时被携带并发送到服务器上。

可通过Cookie保存浏览信息来获得更轻松的在线体验，比如保持登录状态、记住偏好设置，并提供本地的相关内容。

会话Cookie 与 持久Cookie

会话cookie不需要指定Expires和Max-Age，浏览器关闭之后它会被自动删除。

持久cookie指定了Expires或Max-Age，会被存储到磁盘上，不会因浏览器而失效。

第一方Cookie 与 第三方Cookie

每个Cookie都有与之关联的域，与页面域一样的就是第一方Cookie，不一样的就是第三方Cookie。

// 设置接收第三方Cookie

if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {

CookieManager.getInstance().setAcceptThirdPartyCookies(vWeb, true);

}

读取/写入/移除 Cookie

// 获取指定url关联的所有Cookie

// 返回值使用"Cookie"请求头格式："name=value; name2=value2; name3=value3"

CookieManager.getInstance().getCookie(url);

// 为指定的url设置一个Cookie

// 参数value使用"Set-Cookie"响应头格式，参考：https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Set-Cookie

CookieManager.getInstance().setCookie(url, value);

// 移除指定url下的指定Cookie

CookieManager.getInstance().setCookie(url, cookieName + "=");

webkit cookie 工具类

publicclassWebkitCookieUtil{

// 移除指定url关联的所有cookie

publicstaticvoidremove(String url){

CookieManager cm = CookieManager.getInstance();

for(String cookie : cm.getCookie(url).split( "; ")) {

cm.setCookie(url, cookie.split( "=")[ 0] + "=");

}

flush();

}

// sessionOnly 为true表示移除所有会话cookie，否则移除所有cookie

publicstaticvoidremove(booleansessionOnly){

CookieManager cm = CookieManager.getInstance();

if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {

if(sessionOnly) {

cm.removeSessionCookies( null);

} else{

cm.removeAllCookies( null);

}

} else{

if(sessionOnly) {

cm.removeSessionCookie();

} else{

cm.removeAllCookie();

}

}

flush();

}

// 写入磁盘

publicstaticvoidflush(){

if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {

CookieManager.getInstance().flush();

} else{

CookieSyncManager.getInstance().sync();

}

}

}

同步系统Cookie 与 Webkit Cookie

// 将系统级Cookie(比如`new URL(...).openConnection()`的Cookie) 同步到 WebView

public classWebkitCookieHandlerextendsCookieHandler{

private staticfinal StringTAG = WebkitCookieHandler.class.getSimpleName();

private CookieManager wcm;

public WebkitCookieHandler() {

this.wcm = CookieManager.getInstance();

}

@Override

public voidput(URI uri, Map< String, List< String>> headers) throws IOException {

if((uri == null) || (headers == null)) {

return;

}

Stringurl = uri.toString();

for( StringheaderKey : headers.keySet()) {

if((headerKey == null) || !(headerKey.equalsIgnoreCase( "set-cookie2") || headerKey.equalsIgnoreCase( "set-cookie"))) {

continue;

}

for( StringheaderValue : headers.get(headerKey)) {

Log.e(TAG, headerKey + ": "+ headerValue);

this.wcm.setCookie(url, headerValue);

}

}

}

@Override

public Map< String, List< String>> get(URI uri, Map< String, List< String>> headers) throws IOException {

if((uri == null) || (headers == null)) {

thrownewIllegalArgumentException( "Argument is null");

}

Stringurl = uri.toString();

Stringcookie = this.wcm.getCookie(url);

Log.e(TAG, "cookie: "+ cookie);

if(cookie != null) {

returnCollections.singletonMap( "Cookie", Arrays.asList(cookie));

} else{

returnCollections.emptyMap();

}

}

}

6

缓存(Cache)

设置缓存模式

WebSettings.LOAD_DEFAULT 根据cache-control决定是否从网络上取数据

WebSettings.LOAD_CACHE_ELSE_NETWORK 无网，离线加载，优先加载缓存(即使已经过期)

WebSettings.LOAD_NO_CACHE 仅从网络加载

WebSettings.LOAD_CACHE_ONLY 仅从缓存加载

// 网络正常时根据cache-control决定是否从网络上取数据

if(isNetworkConnected(mActivity)) {

settings.setCacheMode(WebSettings.LOAD_DEFAULT);

} else{

settings.setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK);

}

清除缓存

// 传入 true表示同时内存与磁盘， false表示仅清除内存

// 由于内核缓存是全局的因此这个方法不仅仅针对webview而是针对整个应用程序

web.clearCache( true);

7

预加载(Preload)

一个简单的预加载示例(shouldInterceptRequest)

点击 assets/demo.xml 里的链接"hello"时会加载本地的 assets/hello.html

assets/demo.xml

hello

assets/hello.html

helloworld!

重载 shouldInterceptRequest

@Override

public WebResourceResponse shouldInterceptRequest(WebView view, Stringurl) {

returnpreload( "assets/", url);

}

WebResourceResponse preload( Stringpath, Stringurl) {

if(!url.contains(path)) {

returnnull;

}

Stringlocal = url.replaceFirst( "^http.*"+ path, "");

try{

InputStream is = getApplicationContext().getAssets().open(local);

Stringext = MimeTypeMap.getFileExtensionFromUrl(local);

StringmimeType = MimeTypeMap.getSingleton().getMimeTypeFromExtension(ext);

returnnewWebResourceResponse(mimeType, "UTF-8", is);

} catch(Exception e) {

e.printStackTrace();

returnnull;

}

}

8

与Java交互

启用Java

// 是否支持Java，默认值 false

settings.setJavaEnabled( true);

注入对象到Java

//注入对象 'jsobj'，在网页中通过` jsobj.say(...)`调用

web.addJavaInterface( newJSObject(), "jsobj")

在API17后支持白名单，只有添加了@JavaInterface注解的方法才会注入JS

publicclassJSObject{

@JavaInterface

publicvoidsay(String words){

// todo

}

}

移除已注入Java的对象

web.removeJavaInterface( "jsobj")

执行JS表达式

// 弹出提示框

web.loadUrl( "java:alert('hello')");

// 调用注入的jsobj.say方法

web.loadUrl( "java:jsobj.say('hello')");

在API19后可异步执行JS表达式，并通过回调返回值

if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {

vWeb.evaluateJava( "111+222", newValueCallback() {

@ Override

publicvoidonReceiveValue(String value) {

// value => "333"

}

});

}

9

地理位置(Geolocation)

https://developer.mozilla.org/zh-CN/docs/Web/API/Geolocation/Using_geolocation

需要以下权限

默认可用

settings.setGeolocationEnabled( true);

当H5调用地理位置API时，会先通过WebChromeClient.onGeolocationPermissionsShowPrompt申请授权

// 指定源的网页内容在没有设置权限状态下尝试使用地理位置API。

@Override

publicvoidonGeolocationPermissionsShowPrompt(String origin, GeolocationPermissions.Callback callback){

booleanallow = true; // 是否允许origin使用定位API

booleanretain = false; // 内核是否记住这次制授权

callback.invoke(origin, true, false);

}

// 之前调用 onGeolocationPermissionsShowPrompt() 申请的授权被取消时，隐藏相关的UI。

@Override

publicvoidonGeolocationPermissionsHidePrompt(){

}

注：从API24开始，仅支持安全源(https)的请求，非安全源的请求将自动拒绝且不调用 onGeolocationPermissionsShowPrompt 与 onGeolocationPermissionsHidePrompt

10

弹框(alert/confirm/prompt/onbeforeunload)

在java中使用 alert/confirm/prompt 会弹出对话框，可通过重载 WebChromeClient 的下列方法控制弹框的交互，比如替换系统默认的对话框或屏蔽这些对话框

@Override

publicbooleanonJsAlert(WebView view, String url, String message, JsResult result){

// 这里处理交互逻辑

// result.cancel(); 表示用户取消了操作(点击了取消按钮)

// result.confirm(); 表示用户确认了操作(点击了确认按钮)

// ...

// 返回true表示自已处理，返回false表示由系统处理

returnfalse;

}

@Override

publicbooleanonJsConfirm(WebView view, String url, String message, JsResult result){

returnfalse;

}

@Override

publicbooleanonJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result){

returnfalse;

}

@Override

publicbooleanonJsBeforeUnload(WebView view, String url, String message, JsResult result){

returnfalse;

}

11

全屏(Fullscreen)

Fullscreen API

https://developer.mozilla.org/zh-CN/docs/DOM/Using_fullscreen_mode

当H5请求全屏时，会回调 WebChromeClient.onShowCustomView 方法

当H5退出全屏时，会回调 WebChromeClient.onHideCustomView 方法

1.manifest

自己处理屏幕尺寸方向的变化(切换屏幕方向时不重建activity)

WebView播放视频需要开启硬件加速

android:name=".WebViewActivity"

android:configChanges="orientation|screenSize"

android:hardwareAccelerated="true"

android:screenOrientation="portrait"/>

2.页面布局

android:layout_width="match_parent"

android:layout_height="match_parent"

android:orientation="vertical">

android:id="@+id/toolbar"

style="@style/Toolbar.Back"/>

android:layout_width="match_parent"

android:layout_height="match_parent">

android:id="@+id/web"

android:layout_width="match_parent"

android:layout_height="match_parent"/>

...

3.处理全屏回调

CustomViewCallback mCallback;

View vCustom;

@Override

publicvoidonShowCustomView(View view, CustomViewCallback callback){

setFullscreen( true);

vCustom = view;

mCallback = callback;

if(vCustom != null) {

ViewGroup parent = (ViewGroup) vWeb.getParent();

parent.addView(vCustom);

}

}

@Override

publicvoidonHideCustomView(){

setFullscreen( false);

if(vCustom != null) {

ViewGroup parent = (ViewGroup) vWeb.getParent();

parent.removeView(vCustom);

vCustom = null;

}

if(mCallback != null) {

mCallback.onCustomViewHidden();

mCallback = null;

}

}

4.设置全屏，切换屏幕方向

voidsetFullscreen(booleanfullscreen){

if(fullscreen) {

getWindow().clearFlags(WindowManager.LayoutParams.FLAG_FORCE_NOT_FULLSCREEN);

getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN, WindowManager.LayoutParams.FLAG_FULLSCREEN);

vToolbar.setVisibility(View.GONE);

vWeb.setVisibility(View.GONE);

} else{

getWindow().clearFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);

getWindow().setFlags(WindowManager.LayoutParams.FLAG_FORCE_NOT_FULLSCREEN, WindowManager.LayoutParams.FLAG_FORCE_NOT_FULLSCREEN);

vToolbar.setVisibility(View.VISIBLE);

vWeb.setVisibility(View.VISIBLE);

}

if(getResources().getConfiguration().orientation == Configuration.ORIENTATION_PORTRAIT) {

setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE);

} else{

setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);

}

}

12

内存泄漏

直接 new WebView 并传入 application context 代替在 XML 里面声明以防止 activity 引用被滥用，能解决90+%的 WebView 内存泄漏。

vWeb = new WebView(getContext().getApplicationContext());

container.addView(vWeb);

注：此方法会导致select无法弹出，因为select默认会弹出一个原生的框，需要activity承载。

W/WindowManager: Attempted to add windowwithnon-application token WindowToken{ 75b7f7c null}. Aborting.

销毁 WebView

if(vWeb != null) {

vWeb.setWebViewClient( null);

vWeb.setWebChromeClient( null);

vWeb.loadDataWithBaseURL( null, "", "text/html", "utf-8", null);

vWeb.clearHistory();

((ViewGroup) vWeb.getParent()).removeView(vWeb);

vWeb.destroy();

vWeb = null;

}

参考

https://developer.android.com/reference/android/webkit/package-summary.html

Fullscreen API 全屏显示网页

http://calefy.org/2012/06/03/fullscreen-web-page-width-fullscreen-api.html

WebView实现全屏播放的一种方法

https://segmentfault.com/a/1190000007561455

第一方Cookie和第三方Cookie区别

https://www.biaodianfu.com/first-party-cookie-and-third-party-cookie.html

Android WebView的Js对象注入漏洞解决方案

http://blog.csdn.net/leehong2005/article/details/11808557

Android安全开发之WebView中的地雷

http://yaq.qq.com/blog/10

Android WebView：性能优化不得不说的事

https://juejin.im/entry/57d6434067f3560057e50b20

上次四哥的书，通过小程序中奖的，其中7位已经提交了相关信息，我已经发给四哥了，还有位胡宸浩一直没有填写，看到请尽快提交，或者后台给我发消息即可~返回搜狐，查看更多

责任编辑：