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、 相关使用

• AgentWebX5
• 一个炫酷的 WebView 进度条
• Downloader 一个轻量的文件下载器

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);