Android WebView 开发教程

时间  2019-11-21
标签 android webview 开发 教程 栏目 Android 繁體版
原文   原文链接

声明在先：必须在AndroidMainfest.xml 里面声明权限，不然在Java里面编写的全部WebView浏览网页的代码都没法正常使用javascript

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

1.WebView的使用

(a). 建立WebView的实例加入到Activity中html

WebView webview = new WebView(this);  
setContentView(webview);

或者在xml中配置WebViewjava

<Webview  
    android:layout_width="match_parent" android:layout_height="match_parent" > </Webview>

(b). 访问网页android

webview.loadUrl("https://www.baidu.com/");

2.WebView API使用详解

(a). 请求加载网页部分

public void loadData (String data, String mimeType, String encoding)

加载指定的data数据web

参数说明：数据库

data  字符串String形式的数据 能够经过base64编码而来api

mineType data数据的 MIME类型， e.g. 'text/html'浏览器

encoding data数据的编码格式安全

注意：cookie

1.Javascript有同源限制，同源策略限制了一个源中加载文本或者脚本与来自其余源中的数据交互方式。避免这种限制可使用loadDataWithBaseURL()方法。

2.encoding参数制定data参数是否为base64或者 URL 编码，若是data是base64编码那么 encoding必须填写 "base64“。

 

public void loadDataWithBaseURL (String baseUrl, String data, String mimeType, String encoding, String historyUrl)

使用baseUrl加载base URL的网页内容，baseUrl解决相关url使用Javascript相同源问题。

 

public void loadUrl (String url)

加载制定url的网页内容

 

public void loadUrl (String url, Map<String, String> additionalHttpHeaders)

加载制定url并携带http header数据。


public void reload ()

从新加载页面  注意：页面全部资源会从新加载

  
public void stopLoading ()

中止加载页面 

(b). 网页的前进后退

public void goBack ()  // 页面后退
public void goForward ()  // 页面前进 
public void goBackOrForward (int steps) // 以当前的index为起始点前进或者后退到历史记录中指定的steps，  若是steps为负数则为后退，正数则为前进
public boolean canGoForward ()  // 判断页面是否可以前进
public boolean canGoBack ()  // 判断页面是否可以后退

(c). JavaScript操做

public void addJavascriptInterface (Object object, String name)

当网页须要和App进行交互时，能够注入Java对象提供给JavaScritp调用.  Java对象提供相应的方法供js使用.

注意：在Android 4.2如下使用这个api会涉及到JavaScript安全问题， javascript能够经过反射这个Java对象的相关类进行攻击。

连接：Android WebView 总结 —— Java和JavaScript交互 

连接：Android 4.2版本如下使用WebView组件addJavascriptInterface方法存在JS漏洞

 

public void evaluateJavascript (String script, ValueCallback<String> resultCallback)

这个方法在Android 4.4系统引入，所以只能在Android4.4系统中才能使用，提供在当前页面显示上下文中异步执行javascript代码

注意： 这个方法必须在UI线程调用，这个函数的回调也会在UI线程执行。那么在Android4.4一下如何执行javascrit代码呢？能够经过 WebView提供的loadUrl方法：具体格式以下：

webView.loadUrl("javascript:alert(injectedObject.toString())");

其中javascript: 是执行javascript代码的标识 ， 后面是javascript语句。

  
public void removeJavascriptInterface (String name)

删除addJavascripInterface时对webview注入的java对象. 此方法在不一样的Android系统WebView会有问题，会存在失效状况。

(d). 网页查找功能

public void findAllAsync (String find)

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

 

public void findNext (boolean forward)

查找下一个匹配的字符

 

(e). WebView 事件回调监听

public void setWebChromeClient (WebChromeClient client)

主要通知客户端app加载当前网页的 title，Favicon，progress,javascript dialog等事件，通知客户端处理这些相应的事件。

  
public void setWebViewClient (WebViewClient client)

主要通知客户端app加载当前网页时的各类时机状态，onPageStart,onPageFinish,onReceiveError等事件。

3.WebViewClient,WebChromeClient

WebView 作为承载网页的载体控件，他在网页显示的过程当中会产生一些事件，并回调给咱们的应用程序，以便咱们在网页加载过程当中作应用程序想处理的事情。好比说客户端须要显示网页加载的进度、网页加载发生错误等等事件。 WebView提供两个事件回调类给应用层，分别为WebViewClient,WebChromeClient开发者能够继承这两个类，接手相应事件处理。WebViewClient 主要提供网页加载各个阶段的通知，好比网页开始加载onPageStarted，网页结束加载onPageFinished等；WebChromeClient主要提供网页加载过程当中提供的数据内容，好比返回网页的title。

(a).WebViewClient

--WebViewClient使用

建立WebViewClient实例并设置到WebView对象中，具体代码参考以下： 
webview.setWebViewClient(new WebViewClient () {
　　@Override  
    public void onPageStarted(WebView view, String url, Bitmap favicon) {  
       // TODO  
    }  
  
    @Override  
    public void onPageFinished(WebView view, String url) {  
      // TODO  
    }  
});

 

--WebViewClient API详解

public boolean shouldOverrideUrlLoading(WebView view, String url)
当加载的网页须要重定向的时候就会回调这个函数告知咱们应用程序是否须要接管控制网页加载，若是应用程序接管，而且return true意味着程序接管网页加载，若是返回false让webview本身处理。
 
注意：
(1) 当请求的方式是"POST"方式时这个回调是不会通知的。
(2) 当咱们访问的地址须要咱们应用程序本身处理的时候，能够在这里截获，好比咱们发现跳转到的是一个market的连接，那么咱们能够直接跳转到应用市场，或者其余app。
  
public void onPageStarted(WebView view, String url, Bitmap favicon)
当开始加载访问的url时，会通知应用程序，对每一个main frame这个函数只会被调用一次，页面包含iframe 或者framesets 不会另外调用一次onPageStarted，当网页内内嵌的frame 发生改变时也不会调用onPageStarted。
注意： 当咱们经过loadUrl的方式从新加载一个网址时候，这时候会先调用onPageStarted再调用shouldOverrideUrlLoading，当咱们在打开的这个网址点击一个link，这时候会先调用shouldOverrideUrlLoading 再调用onPageStarted。不过shouldOverrideUrlLoading不必定每次都被调用，只有须要的时候才会被调用。
  
public void onPageFinished(WebView view, String url)
当加载完当前页面时会通知咱们的应用程序，这个函数只有在main frame状况下才会被调用。 

public void onLoadResource(WebView view, String url)

 

通知应用程序WebView即将加载url 制定的资源
  
public WebResourceResponse shouldInterceptRequest(WebView view, String url)

 通知应用程序内核即将加载url制定的资源，应用程序能够返回本地的资源提供给内核，若本地处理返回数据，内核不从网络上获取数据。

注意：这个回调并不必定在UI线程执行，因此咱们须要注意在这里操做View或者私有数据相关的动做。若是咱们须要改变网页的背景，或者须要实现网页页面颜色定制化的需求，能够在这个回调时机处理。
  
public void onReceivedError(WebView view, int errorCode,  String description, String failingUrl)  
当浏览器访问制定的网址发生错误时会通知咱们应用程序，好比网络错误。

参数说明：
@param view 接收WebViewClient的那个实例，前面看到webView.setWebViewClient(new MyAndroidWebViewClient())，便是这个webview。
@param errorCode 错误号能够在WebViewClient.ERROR_* 里面找到对应的错误名称。
@param description 描述错误的信息
@param failingUrl  当前访问失败的url，注意并不必定是咱们主url
 
注意：
在onReceiveError咱们能够自定义网页的错误页面。
  
public void onFormResubmission(WebView view, Message dontResend, Message resend)

 

若是浏览器须要从新发送POST请求，能够经过这个时机来处理。默认是不从新发送数据。
  
public void doUpdateVisitedHistory(WebView view, String url, boolean isReload)
通知应用程序能够将当前的url存储在数据库中，意味着当前的访问url已经生效并被记录在内核当中。这个函数在网页加载过程当中只会被调用一次。注意网页前进后退并不会回调这个函数。
  
public void onReceivedHttpAuthRequest(WebView view, HttpAuthHandler handler, String host, String realm)
通知应用程序WebView接收到了一个Http auth的请求，应用程序可使用supplied 设置webview的响应请求。默认行为是cancel 本次请求。
  
public boolean shouldOverrideKeyEvent(WebView view, KeyEvent event)

提供应用程序同步一个处理按键事件的机会，菜单快捷键须要被过滤掉。若是返回true，webview不处理该事件，若是返回false， webview会一直处理这个事件，所以在view 链上没有一个父类能够响应到这个事件。默认行为是return false；

 

public void onScaleChanged(WebView view, float oldScale, float newScale)
通知应用程序webview 要被scale。应用程序能够处理改事件，好比调整适配屏幕。
 

(b).WebChromeClient 

--webChromeClient使用

webView.setWebChromeClient(new WebChromeClient() {});
--webChromeCilent API详解
建立WebChromeClient实例并设置到WebView对象中，具体代码参考以下：  
public void onProgressChanged(WebView view, int newProgress)
通知应用程序当前网页加载的进度。
  
public void onReceivedTitle(WebView view, String title)
当document 的title变化时，会通知应用程序。注意：这个函数调用时机不肯定，有可能很早，有可能很晚，取决于网页把title设置在什么位置，大多数网页通常把title设置到页面的前面，所以不少状况会比较早回调到这个函数。
  
public void onReceivedIcon(WebView view, Bitmap icon)
当前页面有个新的favicon时候，会回调这个函数。
  
public void onShowCustomView(View view, CustomViewCallback callback)

 通知应用程序webview须要显示一个custom view，主要是用在视频全屏HTML5Video support。

参数说明：
@param view 即将要显示的view
@param callback  当view 须要dismiss 则使用这个对象进行回调通知。
  
public void onHideCustomView()
退出视频通知 

public boolean onCreateWindow(WebView view, boolean isDialog, boolean isUserGesture, Message resultMsg)
请求建立一个新的窗口，若是咱们应用程序接管这个请求，必须返回true，而且建立一个新的webview来承载主窗口。
若是应用程序不处理，则须要返回false，默认行为和返回false表现同样。
参数说明：
@param view 请求建立新窗口的webview
@param isUserGesture 若是是true，则说明是来自用户收拾操做行为，好比用户点击连接
@param isDialog true 请求建立的新窗口必须是个dialog，而不是全屏的窗口。
@param resultMsg 当webview建立时须要发送一个消息。WebView.WebViewTransport.setWebView(WebView)
  
public void onRequestFocus(WebView view)  
webview请求获得focus，发生这个主要是当前webview不是前台状态，是后台webview。
  
public void onCloseWindow(WebView window)
通知应用程序从关闭传递过来的webview并从view tree中remove。
  
public boolean onJsAlert(WebView view, String url, String message, JsResult result)

通知应用程序显示javascript alert对话框，若是应用程序返回true内核认为应用程序处理这个消息，返回false，内核本身处理。

注意： 若是咱们应用接管处理， 则必须给出result的结果，result.cancel,result.comfirm必须调用其中以后，不然内核会hang住。
  
public boolean onJsConfirm(WebView view, String url, String message,  JsResult result)
通知应用程序提供confirm 对话框。
参数说明同上onJsAlert
  
public boolean onJsBeforeUnload(WebView view, String url, String message,  JsResult result)
通知应用程序显示一个对话框，让用户选择是否离开当前页面，这个回调是javascript中的onbeforeunload事件，若是客户端返回true，内核会认为客户端提供对话框。默认行为是return false。
参数说明和以前介绍的onJsAlert()相同。
  
public void openFileChooser(ValueCallback<Uri> uploadFile, String acceptType, String capture)
这个回调是私有回调， 当页面须要请求打开系统的文件选择器，则会回调这个方法，好比咱们须要上传图片，请求拍照，邮件的附件上传等等操做。
若是不实现这个私有API，则上面的请求都将不会执行。
 

4.WebSettings

Android WebView提供展现网页，也提供咱们应用程序对网页加载的一些定制，好比咱们为了减小网络数据能够设置当前加载的页面不能显示图片。Android 提供管理WebView的一些setting的类WebSettings，在WebView对象被建立时WebSettings对象也会被同时建立，并附有默认的settings值. WebSettings对象能够经过WebView.getSettings()得到。WebSettings的生命周期同WebView生命周期相同，若是WebView被destroy 则WebSettings应该被释放，不然若是使用WebSettings继续再操做的话， 会抛出异常IllegalStateException。
 
注意：调用WebSettings设置的全部函数是异步制定的，所以咱们设置某个状态并不能立刻生效。
 

(a).WebSettings API详解

public synchronized void setLoadsImagesAutomatically(boolean flag)

设置当前webview是否须要加载图片，这个标记控制整个webview的状态，而且对全部的资源都采起这种策略。若是设置为false 那么访问的当前网址中的因此图片资源将不会被加载。默认值是true；经过配置这个方法的标志，能够实现浏览器的无图模式和有图模式的控制。

  
public synchronized void setBlockNetworkImage (boolean flag)
当getLoadsImagesAutomatically返回true这个方法才有效， 默认值为：false；
  
public void setCacheMode(int mode)
一个普通网页的加载cache会被检查，内容也会被从新校验，第一次访问网页时，会存储cache到本地，设置策略可让网页加载方式发生变化，cache模式有以下几种:
LOAD_DEFAULT: 若是咱们应用程序没有设置任何cachemode， 这个是默认的cache方式。 加载一张网页会检查是否有cache，若是有而且没有过时则使用本地cache，不然从网络上获取。
LOAD_CACHE_ELSE_NETWORK: 使用cache资源，即便过时了也使用，若是没有cache才从网络上获取。
LOAD_NO_CACHE: 不使用cache 所有从网络上获取
LOAD_CACHE_ONLY:  只使用cache上的内容。
  
public synchronized void setLayoutAlgorithm(LayoutAlgorithm l)

NORMAL：正常显示，没有渲染变化。 
SINGLE_COLUMN：把全部内容放到WebView组件等宽的一列中。   //这个是强制的，把网页都挤变形了(基本不推荐使用) 
NARROW_COLUMNS：可能的话，使全部列的宽度不超过屏幕宽度。 //默认的
TEXT_AUTOSIZING: 这个在API 19及以后才能使用，目前不须要了解和使用.

  
public void setLoadWithOverviewMode(boolean overview)
概览模式的设置，默认指是false。
  
public synchronized void setJavaScriptEnabled (boolean flag)
默认值是false.  若是咱们网页须要javascript时，须要开启这个设置，不然网页加载不全。
 
 

5. WebView 使用 TIPS

(a).为WebView自定义错误显示界面:

覆写WebViewClient中的onReceivedError()方法:

  
/** 
 * 显示自定义错误提示页面，用一个View覆盖在WebView 
 */  
protected void showErrorPage() {  
    LinearLayout webParentView = (LinearLayout)mWebView.getParent();  
      
    initErrorPage();  
    while (webParentView.getChildCount() > 1) {  
        webParentView.removeViewAt(0);  
    }  
    LinearLayout.LayoutParams lp = new LinearLayout.LayoutParams(LayoutParams.FILL_PARENT,LayoutParams.FILL_PARENT);  
    webParentView.addView(mErrorView, 0, lp);  
    mIsErrorPage = true;  
}  
protected void hideErrorPage() {  
    LinearLayout webParentView = (LinearLayout)mWebView.getParent();  
      
    mIsErrorPage = false;  
    while (webParentView.getChildCount() > 1) {  
        webParentView.removeViewAt(0);  
    }  
}  
  
  
   protected void initErrorPage() {  
    if (mErrorView == null) {  
        mErrorView = View.inflate(this, R.layout.online_error, null);  
        Button button = (Button)mErrorView.findViewById(R.id.online_error_btn_retry);  
        button.setOnClickListener(new OnClickListener() {  
            public void onClick(View v) {  
                mWebView.reload();  
            }  
        });  
        mErrorView.setOnClickListener(null);  
    }  
}  

@Override  
public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) {   
　　mErrorView.setVisibility(View.VISIBLE);  
　　super.onReceivedError(view, errorCode, description, failingUrl);  
}          =

(b).WebView cookies 清理

CookieSyncManager.createInstance(this);   
CookieSyncManager.getInstance().startSync();   
CookieManager.getInstance().removeSessionCookie();

(c).清理cache和历史记录

webView.clearCache(true);   
webView.clearHistory();

(d).屏蔽长按事件

mWebView.setOnLongClickListener(new OnLongClickListener() {  
            
          @Override  
          public boolean onLongClick(View v) {  
              return true;  
          }  
});

(e).Webview保留缩放功能，可是隐藏缩放控价

mWebView.getSettings().setSupportZoom(true);  
mWebView.getSettings().setBuiltInZoomControls(true);  
if (DeviceUtils.hasHoneycomb()) { 
　　　　mWebView.getSettings().setDisplayZoomControls(false);  
}
注意：setDisplayZoomControls是在Android 3.0中新增的API.
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程