AgentWeb 介绍
AgentWeb是一个高度封装的 Android WebView ，简单易用 ， 带有进度条 、 支持文件上传 、 下载 、 简化 Javascript 通信 、 链式调用 、 加强 Web 安全的库 。让你几行代码集成一个小型浏览器在你的应用 。 App 下载体验
前言
WebView 可谓是每个应用必备的一个控件了 ，但是谈起它的使用 ，让很多人都不是那么喜欢它 ，比如说每个 Web 页面都需要各种一大推的 setting ，好一点的可能封装成一个 BaseWebActivity 和 BaseWebFragment ，但是重复的代码总是让有洁癖的程序员不舒服 ，而且 WebView 本身功能也不是很完善 ， AgentWeb 就泥补了这些空缺 。
AgentWeb 功能
支持进度条以及自定义进度条支持文件下载支持文件下载断点续传支持下载通知形式提示进度简化 Javascript 通信支持 Android 4.4 Kitkat 以及其他版本文件上传支持注入 Cookies加强 Web 安全兼容低版本安全 Js 通信为什么要使用 AgentWeb ?
Web文件下载文件上传Js 通信断点续传使用简易度进度条线程安全WebView不支持不支持支持不支持麻烦没有不安全AgentWeb支持支持更简洁支持简洁有安全简洁易用
为什么说它简洁易用吗 ? 下面京东效果图 ， 只需一句话 !
mAgentWeb = AgentWeb.with(this)//传入Activity .setAgentWebParent(mLinearLayout, new LinearLayout.LayoutParams(-1, -1))//传入AgentWeb 的父控件 ，如果父控件为 RelativeLayout ， 那么第二参数需要传入 RelativeLayout.LayoutParams .useDefaultIndicator()// 使用默认进度条 .defaultProgressBarColor() // 使用默认进度条颜色 .setReceivedTitleCallback(mCallback) //设置 Web 页面的 title 回调 .createAgentWeb()// .ready() .go("http://www.jd.com");你没看错 ，里面没有一句 Setting ， 甚至连 WebChromeClient 都不配置就有进度条 。
Javascript 通信拼接太麻烦 ? 请看 。
//Javascript 方法 function callByAndroid(){ console.log("callByAndroid") }Android 端
mAgentWeb.getJsEntraceAccess().quickCallJs("callByAndroid");结果
consoleMessage:callByAndroid lineNumber:27效果图
到了这里 ， 弱弱问一句 ， 你还有什么理由不使用 AgentWeb ?
浅谈进度条
为什么要谈一下进度条这个东西呢 ? 因为没有进度条的 WebView 页面体验实在太差了 ，AgentWeb 默认的进度条是一般浏览器的进度条 ，为什么采用这种进度条呢 ? 因为体验好 ，微信和QQ ，支付宝 、 UC 以及 Safari 都采用这种进度条是有他们道理的 , 我还见过应用加载 Web 页面的时候直接弹 Dialog 不可取消 ，没有非常必要让用户确定情况都别弹 Dialog ，特别在用户网络不好的情况下 ，加载速度变得突奇的慢 ，那么 Dialog 就一直存在 ，用户耐性不好 ，只能把你进程杀死 。
Agentweb 视图结构
<FrameLayout android:layout_width="match_parent" android:layout_height="match_parent"> <WebView android:layout_width="match_parent" android:layout_height="match_parent"> </WebView> <!--进度条--> <com.just.library.BaseIndicatorView android:layout_width="match_parent" android:layout_height="2dp" > </com.just.library.BaseIndicatorView> </FrameLayout>AgentWeb 最外层是 FrameLayout ， 所以在使用 AgentWeb 的时候还需要给 FrameLayout 指定父控件(下面有使用方式) 。
AgentWeb 内部结构
IndicatorController 进度条控制器WebCreator 创建 WebView 。WebSettings 统一设置 WebView 的 settingsWebSecurityController 安全控制器JsEntraceAccess Js 方法入口引入
Gradle
compile 'com.just.agentweb:agentweb:1.1.0'Maven
<dependency> <groupId>com.just.agentweb</groupId> <artifactId>agentweb</artifactId> <version>1.1.0</version> <type>pom</type> </dependency>用法
Activity 使用如下
mAgentWeb = AgentWeb.with(this)//传入Activity .setAgentWebParent(mLinearLayout, new LinearLayout.LayoutParams(-1, -1))//传入AgentWeb 的父控件 ，如果父控件为 RelativeLayout ， 那么第二参数需要传入 RelativeLayout.LayoutParams .useDefaultIndicator()// 使用默认进度条 .defaultProgressBarColor() // 使用默认进度条颜色 .setReceivedTitleCallback(mCallback) //设置 Web 页面的 title 回调 .createAgentWeb()// .ready() .go("http://www.jd.com");Fragment 使用如下
@Override public void onViewCreated(View view, @Nullable Bundle savedInstanceState) { super.onViewCreated(view, savedInstanceState); mAgentWeb = AgentWeb.with(this)//这里需要把 Fragment 传入 .setAgentWebParent((ViewGroup) view, new LinearLayout.LayoutParams(-1, -1))// 设置 AgentWeb 的父控件 ， 这里的view 是 LinearLayout ， 那么需要传入 LinearLayout.LayoutParams .useDefaultIndicator()// 使用默认进度条 .setReceivedTitleCallback(mCallback) //标题回调 .setSecurityType(AgentWeb.SecurityType.strict) //注意这里开启 strict 模式 ， 设备低于 4.2 情况下回把注入的 Js 全部清空掉 ， 这里推荐使用 onJsPrompt 通信 .createAgentWeb()// .ready()// .go(getUrl()); }混淆
保持 WebChromeClient 子类不被混淆
-keep public class * extends android.webkit.WebChromeClient{ *; }Java 注入类不要混淆 ， 例如 App 里面的 HelloJs 对象 ， 需要 Keep 。
-keepclassmembers class com.just.library.agentweb.HelloJs{ *; }致谢
360 大牛 SafeWebViewWebView 参考文献总结
AgentWeb 是一个把 WebView 完全代理出来 ， 脱离 Activity 、 Fragment xml 布局 ， 独立的 Android Web 库 。最后如果该库对你有帮助不妨对右上角点点 Star 对我支持 ， 感谢万分 ! 当然我更喜欢你 Fork PR 成为项目贡献者 . AgentWeb
本文作者：佚名 来源：51CTO 相关资源：七夕情人节表白HTML源码(两款)