AgentWeb的使用

一、前言：

在混合化开发大行其道的今天，安卓开发经常会用到WebView，用于加载网页。系统自带的WebView性能和流畅度都一般，今天给大家推荐一款第三方WebView，性能比系统自带的要好，功能也更多。
AgentWeb 是一个高度封装的 Android WebView ，简单易用，带有进度条、支持文件上传、下载、简化 Javascript 通信、链式调用、加强 Web 安全的库。让你几行代码集成一个轻量级浏览器在你的应用。

1、功能

支持进度条以及自定义进度条
支持文件下载
支持文件下载断点续传
支持下载通知形式提示进度
简化 Javascript 通信
支持 Android 4.4 Kitkat 以及其他版本文件上传
支持注入 Cookies
加强 Web 安全
支持全屏播放视频
兼容低版本 Js 安全通信
更省电。
支持调起微信支付
支持调起支付宝（请参照sample）
默认支持定位
支持传入 WebLayout（下拉回弹效果）
支持自定义 WebView
支持 JsBridge

2、优势

AgentWeb相对于系统自带的WebView的优势如下。
是一个轻量级而且功能强大的 Web 库 , 大小只有 200K 。

图片.png

gitHub地址：https://github.com/Justson/AgentWeb

二、使用：

1、依赖：

implementation 'com.just.agentweb:agentweb:4.1.3' // (必选)
implementation 'com.just.agentweb:filechooser:4.1.3'// (可选)
implementation 'com.download.library:Downloader:4.1.3'// (可选)

2、基础用法：

mAgentWeb = AgentWeb.with(this)
                .setAgentWebParent((LinearLayout) view, new LinearLayout.LayoutParams(-1, -1))                
                .useDefaultIndicator()
                .createAgentWeb()
                .ready()
                .go("http://www.jd.com");

3、相关使用

4、调用 Javascript 方法拼接太麻烦？请看。

function callByAndroid(){
      console.log("callByAndroid")
  }
mAgentWeb.getJsAccessEntrace().quickCallJs("callByAndroid");

5、 Javascript 调 Java ?

mAgentWeb.getJsInterfaceHolder().addJavaObject("android",new AndroidInterface(mAgentWeb,this));
window.android.callAndroid();

6、事件处理

    @Override
    public boolean onKeyDown(int keyCode, KeyEvent event) {

        if (mAgentWeb.handleKeyEvent(keyCode, event)) {
            return true;
        }
        return super.onKeyDown(keyCode, event);
    }

7、跟随 Activity Or Fragment 生命周期，释放 CPU 更省电。

    @Override
    protected void onPause() {
        mAgentWeb.getWebLifeCycle().onPause(); 
        super.onPause();

    }

    @Override
    protected void onResume() {
        mAgentWeb.getWebLifeCycle().onResume();
        super.onResume();
    }
    @Override
    public void onDestroyView() {
        mAgentWeb.getWebLifeCycle().onDestroy();
        super.onDestroyView();
    }

8、全屏视频播放

<!--如果你的应用需要用到视频 ， 那么请你在使用 AgentWeb 的 Activity 对应的清单文件里加入如下配置-->
android:hardwareAccelerated="true"
android:configChanges="orientation|screenSize"

9、定位

<!--AgentWeb 是默认允许定位的 ，如果你需要该功能 ， 请在你的 AndroidManifest 文件里面加入如下权限 。-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

10、webchromeclient-与-webviewclient

AgentWeb.with(this)
                .setAgentWebParent(mLinearLayout,new LinearLayout.LayoutParams(-1,-1) )
                .useDefaultIndicator()
                .setReceivedTitleCallback(mCallback)
                .setWebChromeClient(mWebChromeClient)
                .setWebViewClient(mWebViewClient)
                .setSecutityType(AgentWeb.SecurityType.strict)
                .createAgentWeb()
                .ready()
                .go(getUrl());
private WebViewClient mWebViewClient=new WebViewClient(){
        @Override
        public void onPageStarted(WebView view, String url, Bitmap favicon) {
           //do you  work
        }
    };
private WebChromeClient mWebChromeClient=new WebChromeClient(){
        @Override
        public void onProgressChanged(WebView view, int newProgress) {
            //do you work
        }
    };

11、返回上一页

if (!mAgentWeb.back()){
       AgentWebFragment.this.getActivity().finish();
}

12、获取-webview

    mAgentWeb.getWebCreator().getWebView();

13、查看-cookies

String cookies=AgentWebConfig.getCookiesByUrl(targetUrl);

14、同步-cookie

AgentWebConfig.syncCookie("http://www.jd.com","ID=XXXX");

15、middlewarewebchromebase-支持多个-webchromeclient

//略，请查看 Sample

16、 middlewarewebclientbase-支持多个-webviewclient

//略，请查看 Sample

17、清空缓存

AgentWebConfig.clearDiskCache(this.getContext());

18、权限拦截

protected PermissionInterceptor mPermissionInterceptor = new PermissionInterceptor() {

        @Override
        public boolean intercept(String url, String[] permissions, String action) {
            Log.i(TAG, "url:" + url + "  permission:" + permissions + " action:" + action);
            return false;
        }
    };

19、 agentweb-完整用法

 //略，请查看 Sample

20、AgentWeb 所需要的权限(在你工程中根据需求选择加入权限

    <uses-permission android:name="android.permission.INTERNET"></uses-permission>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"></uses-permission>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission>
    <uses-permission android:name="android.permission.READ_PHONE_STATE"></uses-permission>
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
    <uses-permission android:name="android.permission.CAMERA"></uses-permission>
    <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"></uses-permission>

21、混淆

如果你的项目需要加入混淆，请加入如下配置

-keep class com.just.agentweb.** {
    *;
}
-dontwarn com.just.agentweb.**

Java 注入类不要混淆，例如 sample 里面的 AndroidInterface 类，需要 Keep 。

-keepclassmembers class com.just.agentweb.sample.common.AndroidInterface{ *; }

三、注意事项

支付宝使用需要引入支付宝SDK ，并在项目中依赖，微信支付不需要做任何操作。
AgentWeb 内部使用了 AlertDialog 需要依赖 AppCompat 主题。
setAgentWebParent 不支持 ConstraintLayout 。
mAgentWeb.getWebLifeCycle().onPause();会暂停应用内所有WebView 。
minSdkVersion 低于等于16以下自定义WebView请注意与 JS 之间通信安全。
AgentWeb v3.0.0以上版本更新了包名，混淆的朋友们，请更新你的混淆配置。
多进程无法取消下载，解决方案。

常见问题
修改 AgentWeb 默认的背景色

        FrameLayout frameLayout = mAgentWeb.getWebCreator().getWebParentLayout();
        frameLayout.setBackgroundColor(Color.BLACK);