[Android基础] WebView

[ Demo下载 ]

资源

1. Web Apps
2. WebView
3. Android4.4 webview实现分析
4. Android WebView使用深入浅出
5. 深入讲解WebView(上) - 互调,缓存,异常处理等
6. 深入讲解WebView(下) - session,cookie等
7. Android WebView Memory Leak WebView内存泄漏 ==! 这个我用leakcanary没检测出来
8. PHP、Android、iOS 的恩恩怨怨
   
   

从Android 4.4(KitKat)开始,WebView组件是基于开源的Chromium项目.包含V8 js引擎并支持新的web标准,新webView也共享Chrome for Android的渲染引擎,另外,从5.0(Lollipop)开始,WebView被移到独立的apk中,因此它可以进行单独更新,可以从 “settings – Apps – Android System WebView” 中查看其版本;

用途

默认情况下,webView不启用js交互,并会忽略页面错误,适用于展示静态信息;
也可以启用js功能,实现与用户的交互

辅助类

• WebChromeClient 当可能影响webView UI的操作发生时会调用到该类,比如进度变化或者js提示框…
• WebViewClient 当可能影响内容渲染的操作发生时会调用到该类,比如错误等…另外,可以通过重写 shouldOverrideUrlLoading() 来中断url的加载;
• WebSettings 功能设置,比如可否允许js代码;

基本操作

• 访问网络的话需要添加网络权限

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

• 启用js功能

WebSettings webSettings = myWebView.getSettings();webSettings.setJavaScriptEnabled(true);
1
2

设置返回键回退功能

mWv.setOnKeyListener(new View.OnKeyListener() {            @Override            public boolean onKey(View v, int keyCode, KeyEvent event) {                // 需要添加 mWv.canGoBack(),不然当返回到初始页面时,可能无法继续通过返回键关闭页面                if (keyCode == KeyEvent.KEYCODE_BACK && mWv.canGoBack()) {                    mWv.goBack();                    return true;                }                return false;            }        });
1
2
3
4
5
6
7
8
9
10
11

也可以通过设置所在Activity的onBackPressed()方法来支持webView回退:

@Overridepublic void onBackPressed() {    if (mWv.canGoBack()) {        mWv.goBack();    } else {        super.onBackPressed();    }}
1
2
3
4
5
6
7
8

设置标题

mWv.setWebChromeClient(new WebChromeClient(){    @Override    public void onReceivedTitle(WebView view, String title) {        // title 是获取到的网页title,可以将之设置为webView所在页面的标题        MainActivity.this.setTitle(title);    })};
1
2
3
4
5
6
7

设置加载进度

@Overrideprotected void onCreate(Bundle savedInstanceState) {    //requestWindowFeature(Window.FEATURE_PROGRESS);    super.onCreate(savedInstanceState);    setContentView(R.layout.activity_main);    //getWindow().setFeatureInt(Window.FEATURE_PROGRESS, Window.PROGRESS_VISIBILITY_ON);    ......    mProgressDlg = new ProgressDialog(this);    mProgressDlg.setMessage("loading...");    mWv.setWebChromeClient(new WebChromeClient() {        @Override        public void onProgressChanged(WebView view, int newProgress) {            //更新进度条示数            //这种方式我没看到效果...            //MainActivity.this.setProgress(newProgress);            //使用控件ProgressDialog来显示进度            //但记得这种方式需要在error发生时也进行取消            if (newProgress <= 90) {                mProgressDlg.setProgress(newProgress);            } else {                mProgressDlg.dismiss();            }        }    });    mWv.setWebViewClient(new WebViewClient() {        @Override        public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {            super.onReceivedError(view, request, error);            // 加载某些网站的时候会报:ERR_CONNECTION_REFUSED,因此需要在这里取消进度条的显示            Toast.makeText(MainActivity.this, "error", Toast.LENGTH_SHORT).show();            if (mProgressDlg.isShowing()) {                mProgressDlg.dismiss();            }        }        @Override        public void onPageStarted(WebView view, String url, Bitmap favicon) {            super.onPageStarted(view, url, favicon);            if (!mProgressDlg.isShowing()) {                mProgressDlg.show();            }        }        @Override        public void onPageFinished(WebView view, String url) {            super.onPageFinished(view, url);            if (mProgressDlg.isShowing()) {                mProgressDlg.dismiss();            }        }    });
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

控制url跳转

mWv.setWebViewClient(new WebViewClient() {    @Override    public boolean shouldOverrideUrlLoading(WebView view, String url) {        // 这个方法我没有重写的话也还是使用webView来加载链接        // 而且我这里测试返回的true/false貌似没什么影响        if (Uri.parse(url).getHost().endsWith("jianshu.com")) {            //若是指定服务器的链接则在当前webView中跳转            view.loadUrl(url);            return false;        } else if (Uri.parse(url).getHost().length() == 0) {            // 本地链接的话直接在webView中跳转            return false;        }        // 其他情况则使用系统浏览器打开网址        Uri uri = Uri.parse(url);        Intent intent = new Intent(Intent.ACTION_VIEW, uri);        startActivity(intent);        return true;    }});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

加载页面

1. 加载本地asset文件

 mWv.loadUrl("file:///android_asset/index.html");
1

2. 加载本地网页2

//index.html文件放置于 src/main/assets 目录中myWebView.loadUrl("file:///android_asset/index.html");
1
2

3. 加载网页

myWebView.loadUrl("http://www.jianshu.com/users/302253a7ed00/latest_articles");
1

4. 解析html字符串

String summary = "<!DOCTYPE html>\n" +        "<html lang=\"zh_CN\">\n" +        "<head>\n" +        "    <meta charset=\"UTF-8\">\n" +        "    <title>webViewDemoFromAsset</title>\n" +        "    <script src=\"js/basic.js\"></script>\n" +        "</head>\n" +        "<body>\n" +        "<div>\n" +        "    <button id=\"btn\" onclick='showToast()'>调用android toast</button>\n" +        "</div>\n" +        "\n" +        "<label id='label'>js android代码互调测试</label>\n" +        "\n" +        "<br>\n" +        "<a href=\"http://www.jianshu.com/users/302253a7ed00/latest_articles/\">个人主页</a>\n" +        "</body>\n" +        "</html>";// 官网例子给的下面的写法,但是会出现中文乱码,// 原因:http://blog.csdn.net/top_code/article/details/9163597// mWv.loadData(summary, "text/html", "utf-8");mWv.loadData(summary, "text/html;charset=UTF-8", null);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

使用android studio的话,项目结构中没有asset目录,需要手动创建 src/main/assets 目录即可;
扩展:
1. 如果html文件存于sdcard：则加前缀：content://com.android.htmlfileprovider/sdcard/
　　　另外, content 前缀可能导致异常，直接使用 file:///sdcard/ 或者 file:/sdcard 也可以;
2. 也可使用 locaData() ,先将文件读取出来,在传入字符串到方法中,可以用于展示页面,但不会引用css,js等文件;

js与andorid互调

1. 通过 addJavaScriptInterface() 来设置接口,传入实例和类名,让js可以调用;
   

   Note: The object that is bound to your JavaScript runs in another thread and not in the thread in which it was constructed.
   允许网页调用android功能可以存在风险,比如加载其他网页,默认做法是使用浏览器去加载外部其他网页;

2. 自定义的js对应andoird实现类

//通过webView按钮调用android toast功能public class BasicJsAppInterface {    private Context cxt;    public BasicJsAppInterface(Context cxt) {        this.cxt = cxt;    }    // 如果targetSDKVersion设置为17以上,这里需要添加该annotation标志    @JavascriptInterface    public void showToast() {        Toast.makeText(this.cxt, "toast in android", Toast.LENGTH_SHORT).show();    }}
1
2
3
4
5
6
7
8
9
10
11
12

// 实现js调用android功能WebView mWv = (WebView) findViewById(R.id.wv); WebSettings wvSettings = mWv.getSettings();wvSettings.setJavaScriptEnabled(true);wvSettings.setDefaultTextEncodingName("utf-8");//传入实现js功能的android实例 以及 js调用时使用的名称mWv.addJavascriptInterface(new BasicJsAppInterface(this), "AndroidApp");//加载本地asset文件,以 `file:///` 开头mWv.loadUrl("file:///android_asset/index.html");
1
2
3
4
5
6
7
8
9

1. js 调用 android 功能

// 在src/main/assets 目录(不存在则手动创建)中创建该html文件<!DOCTYPE html><html lang="en"><head>    <meta charset="UTF-8">    <title>webViewDemoFromAsset</title>    <script src="js/basic.js"></script></head><body><div>    <button id="btn" onclick='showToast()'>调用android toast</button></div><label id='label'>js android代码互调测试</label><br><a href="http://lucid-lynxz.github.io/">github主页</a><a href="http://www.jianshu.com/users/302253a7ed00/latest_articles">简书主页</a><video width="400" controls>    <source src="res/shuai_dan_ge.mp4" type="video/mp4">    <source src="res/gongsi_de_liliang.flv" type="video/flv">    <p>不支持该格式视频</p></video></body></html>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

注意
:这里引入的独立js文件标签不能简写成 `

//在 assets/js/ 目录下创建js独立文件basic.js,当然也可以把这些代码直接嵌入到html中function setLabel(id, label) {    document.getElementById(id).innerHTML = label;}function showToast(){  AndroidApp.showToast(); //也可以写成window.AndroidApp.showToast();}
1
2
3
4
5
6
7
8

2. android 调用js代码:

//前缀javascript, `setLabel()是网页js文件中定义的方法`mWv.loadUrl("javascript:setLabel('label','通过android调用js代码')");
1
2

缓存/Cookie

webview应用的缓存文件放置于 /data/data/{yourProjectName}/ 下面,之前想提取webview缓存的图片,往上查找的资料大都是通过webviewcache.db 来获取图片对应的缓存文件,但是我在红米1s4.4以及nexus6p 6.0系统上都没有再发现这个文件了,新的缓存目录结构:

从上图可以发现 Cookies 文件存在,使用16进制编辑器打开查看,也可在程序中获取:

private String getCookie() {    CookieManager cm = CookieManager.getInstance();    String cookie = cm.getCookie(mUrl);    if (TextUtils.isEmpty(cookie)) {        cookie = "there is no cookie exist";    }    return cookie;}
1
2
3
4
5
6
7
8

另外,图中红色方框内的文件就是缓存的文件了,它们名称是如何跟实际资源文件对应起来的,这个我还没弄懂,不过还是可以获取缓存图片的,我们使用16进制编辑器来查看,可以发现头部有该图片的url地址(“?g….d64d.png”):

我们删除该文件的url地址信息,保存后,修改后缀名为png,即可看到实际的图片:

播放视频

支持标准MP4,ogg之类的,flash得启用插件进行播放,不考虑 [官网](http://developer.android.com/intl/zh-cn/reference/android/webkit/WebView.html) 建议播放视频的时候开启硬件加速,不过我在nexus6p上没有开(默认开了吗?)也ok的;

全屏播放

[参考](http://blog.csdn.net/zrzlj/article/details/8050633)

页面适应

[Pixel-Perfect UI in the WebView](https://developer.chrome.com/multidevice/webview/pixelperfect)

• 一个针对移动端优化过的页面带有如下类似的属性:

<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
1

系统将页面显示在一个虚拟的Viewport中,这个视口通常比屏幕大,这样网页就不会被限制在很小的范围内,用户可以通过缩放和平移来查看内容;

• 对于无法控制内容的线上网页,可以通过代码方式设置ViewPort:

//强制手机使用 desktop-size viewportwvSettings.setUseWideViewPort(true);wvSettings.setLoadWithOverviewMode(true);
1
2
3

扩展-响应式

调试

1. chrome
   需要在电脑上安装Chrome32以上的版本;

2. 在电脑上启动浏览器打开网址 chrome://inspect ,

3. android启用webView调试
   条件:

   • android 4.4以上
   • 允许远端调试

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {    // 官网: https://developer.chrome.com/devtools/docs/remote-debugging#debugging-webviews    // 官网说WebView不受manifest的debuggable标签的影响,若需要在该标签启用时才允许调试,则添加如下条件判断(注意:尽量不要在manifest中显式指定debuggable属性,放空即可,这样Android Studio会自动在调试时设置成true,在release版本中设置成false)    int debuggable = getApplicationInfo().flags &= ApplicationInfo.FLAG_DEBUGGABLE;    if (0 != debuggable) {        WebView.setWebContentsDebuggingEnabled(true);    }}
1
2
3
4
5
6
7
8

注意事项

1. All WebView methods must be called on the same thread
   wv.loadUrl() 方法放在主线程(根据错误提示来指定)中执行;
   P.S. webview类中有checkThread()方法,跟初始的Lopper.myLooper做比较,想跟踪setContentView看看,结果源码不全,断点跟踪不知道跟到哪里去了…后续得再补补;
2. html页面应用独立的js文件时,script不能写成自闭合标签,否则浏览器解析可能会出错;
3. 官方建议WebView的height属性设置为 match_parent 或者指定值,而非 wrap_content ,同事设置为match_parent 后,其各个父容器不允许设置height为 wrap_content ,否则可能导致异常发生;
4. android 4.4对webView做了些变化,可以参考 [这篇文章](Migrating to WebView in Android 4.4);
5. 混淆时,需要设置javaScriptInterface不被混淆

# app/proguard-rules.pro-keep public class org.lynxz.webviewdemo.BasicJsAppInterface{    public <methods>;}-keepattributes *Annotation*-keepattributes *JavascriptInterface*
1
2
3
4
5
6

异常

1. 内存泄露

这个我还没测试,Android WebView Memory Leak WebView内存泄漏
==! 然后查了内存检查:
Android最佳性能实践(二)——分析内存的使用情况

这里有人发现android 5.1也有类似的情况,我没有尝试加载很多页面,先记录下来:
Android 5.1 Webview 内存泄漏新场景

2. loadData() 中文乱码

参考这篇

mWv.loadData(yourHtmlString, "text/html;charset=UTF-8", null);
1

有人说这么设置也可以避免乱码,但是我在nexus 6p上没测试成功:

wvSettings.setDefaultTextEncodingName("utf-8");
1

3. eglCodecCommon:** ERROR unknown type 0x73000f (glSizeof,80)

Genymotion模拟器不支持硬件加速,关闭即可:
mWv.setLayerType(View.LAYER_TYPE_SOFTWARE, null);

4. html中含有angular.js,数据获取成功,但是显示空白:

已启用js支持:
mWv.getSettings().setJavaScriptEnabled(true);

logCat报错:

I/xxx: url = http://fep-web.debug.web.nd/#!/report/student/compositive?client=phone&mode=debug&user_id=2079947956D/dalvikvm: GC_FOR_ALLOC freed 37K, 14% free 21151K/24528K, paused 17ms, total 17msI/dalvikvm-heap: Grow heap (frag case) to 25.837MB for 3288976-byte allocationW/AwContents: nativeOnDraw failed; clearing to background color.I/Timeline: Timeline: Activity_idle id: android.os.BinderProxy@425bdee8 time:31230137I/chromium: [INFO:CONSOLE(39)] "Uncaught Error: [$injector:modulerr] http://errors.angularjs.org/1.4.10/$injector/modulerr?p0=app&p1=Error%3A%20%5B%24injector%3Amodulerr%5D%20http%3A%2F%2Ferrors.angularjs.org%2F1.4.10%2F%24injector%2Fmodulerr%3Fp0%3Dapp-theme%26p1%3DTypeError%253...<omitted>...3)", source: http://fep-web.debug.web.nd/bower_components/angular/angular.min.js?v=201604181940 (39)I/chromium: [INFO:CONSOLE(72)] "error_log:localStorage error", source: http://fep-web.debug.web.nd/js-error.no-ng.js (72)
1
2
3
4
5
6
7

我也不懂angular.js用到了什么,添加下dom支持就可以了:

settings.setDomStorageEnabled(true);
1

5. A WebView method was called on thread ‘JavaBridge’. All WebView methods must be called on the same thread.

webview加载了网页后,在html中点击重新加载网页,我之前直接在接口类的方法中直接运行,

@JavascriptInterfacepublic void retriveToUrl(String url) {    mWv.loadUrl(url);}
1
2
3
4

需要将其放置在ui线程中运行:

The JavaScript method is executed on a background (i.e. non-UI) thread. You need to call all Android View related methods on the UI thread.

@JavascriptInterfacepublic void retriveToUrl(String url) {    mWv.post(new Runnable() {        @Override        public void run() {            mWebView.loadUrl(...).        }    });}
1
2
3
4
5
6
7
8
9

6. “TypeError: Object [object Object] has no method ‘callNative’ - 混淆

在release版本中,js代码调用不到我定义的接口类中的方法,从混淆文件中把这个类排除即可;
js interface proguard