Android WebView 开发教程
声明在先:必须在AndroidMainfest.xml 里面声明权限,否则在Java里面编写的所有WebView浏览网页的代码都无法正常使用
<uses-permission android:name="android.permission.INTERNET" />
1.WebView的使用
(a). 创建WebView的实例加入到Activity中
WebView webview = new WebView(this);
setContentView(webview);
或者在xml中配置WebView
<Webview
android:layout_width="match_parent"
android:layout_height="match_parent" >
</Webview>
(b). 访问网页
webview.loadUrl("https://www.baidu.com/");
2.WebView API使用详解
(a). 请求加载网页部分
public void loadData (String data, String mimeType, String encoding)
加载指定的data数据
参数说明:
data 字符串String形式的数据 可以通过base64编码而来
mineType data数据的 MIME类型, e.g. 'text/html'
encoding data数据的编码格式
注意:
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使用
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自己处理。
public void onPageStarted(WebView view, String url, Bitmap favicon)
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制定的资源,应用程序可以返回本地的资源提供给内核,若本地处理返回数据,内核不从网络上获取数据。
public void onReceivedError(WebView view, int errorCode, String description, String failingUrl)
当浏览器访问制定的网址发生错误时会通知我们应用程序,比如网络错误。
@param errorCode 错误号可以在WebViewClient.ERROR_* 里面找到对应的错误名称。
public void onFormResubmission(WebView view, Message dontResend, Message resend)
如果浏览器需要重新发送POST请求,可以通过这个时机来处理。默认是不重新发送数据。
public void doUpdateVisitedHistory(WebView view, String url, boolean isReload)
public void onReceivedHttpAuthRequest(WebView view, HttpAuthHandler handler, String host, String realm)
public boolean shouldOverrideKeyEvent(WebView view, KeyEvent event)
提供应用程序同步一个处理按键事件的机会,菜单快捷键需要被过滤掉。如果返回true,webview不处理该事件,如果返回false, webview会一直处理这个事件,因此在view 链上没有一个父类可以响应到这个事件。默认行为是return false;
public void onScaleChanged(WebView view, float oldScale, float newScale)
(b).WebChromeClient
--webChromeClient使用
webView.setWebChromeClient(new WebChromeClient() {});
--webChromeCilent API详解
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。
public void onHideCustomView()
public boolean onCreateWindow(WebView view, boolean isDialog, boolean isUserGesture, Message resultMsg)
请求创建一个新的窗口,如果我们应用程序接管这个请求,必须返回true,并且创建一个新的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,内核自己处理。
public boolean onJsConfirm(WebView view, String url, String message, JsResult result)
通知应用程序提供confirm 对话框。
public boolean onJsBeforeUnload(WebView view, String url, String message, JsResult result)
通知应用程序显示一个对话框,让用户选择是否离开当前页面,这个回调是javascript中的onbeforeunload事件,如果客户端返回true,内核会认为客户端提供对话框。默认行为是return false。
public void openFileChooser(ValueCallback<Uri> uploadFile, String acceptType, String capture)
这个回调是私有回调, 当页面需要请求打开系统的文件选择器,则会回调这个方法,比如我们需要上传图片,请求拍照,邮件的附件上传等等操作。
4.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)
public synchronized void setLayoutAlgorithm(LayoutAlgorithm l)
NORMAL:正常显示,没有渲染变化。
SINGLE_COLUMN:把所有内容放到WebView组件等宽的一列中。 //这个是强制的,把网页都挤变形了(基本不推荐使用)
NARROW_COLUMNS:可能的话,使所有列的宽度不超过屏幕宽度。 //默认的
TEXT_AUTOSIZING: 这个在API 19及之后才能使用,目前不需要了解和使用.
public void setLoadWithOverviewMode(boolean overview)
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.
最新文章
- Linux命令-文件文本操作grep
- Linux 平台安装Oracle Database 12c
- 分享自己的超轻量级高性能ORM数据访问框架Deft
- 此数据库文件与当前sql server实例不兼容
- MySQL运算符之 <;=>;
- jmeter中线程之间传递参数
- jQuery css() 方法
- oracle hints
- JS高级程序设计学习笔记之第三章基本概念(语法,数据类型,流控制语句,函数)——查漏补缺
- poj3159 Candies(差分约束)
- 怎么样eclipse发达国家多重聚合关系maven项目和使用git管理
- 如何使用$.each()与$().each()以及他们的区别
- Spring Cloud 2-Ribbon 客户端负载均衡(二)
- UVa 11100 - The Trip, 2007 难度: 0
- 做完小程序项目、老板给我加了5k薪资~
- POJ 3279 Fliptile(翻格子)
- 我的虚拟机静态IP配置
- c++三种进制格式
- 小程序中监听textarea或者input输入的值动态改变data中数组的对象的值
- 转载:Google 官方应用架构的最佳实践指南 赞&#128077;