AgentWeb浏览器库

简介:

AgentWeb是基于Android WebView一个功能完善小型浏览器库高度封装的 Android WebView ，简单易用，带有进度条、文件上传、下载、简化 Javascript 通信、链式调用、加强 Web 安然的库。让你几行代码集成一个小型浏览器在你的应用

AgentWeb 功能:

点击进入↓
AgentWeb
功能

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

使用方法简洁易用:

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)//传入Activity  在Fragment中使用Activity和Fragment两个都传
                .setAgentWebParent(mWebView, new LinearLayout.LayoutParams(-1, -1))//传入AgentWeb 的父控件 ，如果父控件为 RelativeLayout ， 那么第二参数需要传入 RelativeLayout.LayoutParams
                .useDefaultIndicator(-1,1)// 使用默认进度条
                .setSecurityType(AgentWeb.SecurityType.STRICT_CHECK)//WebView安全类型
                .setMainFrameErrorView(R.layout.agentweb_error_page, -1)//错误占位图
                .setOpenOtherPageWays(DefaultWebClient.OpenOtherPageWays.ASK)//打开其他应用时，弹窗咨询用户是否前往其他应用
                .interceptUnkownUrl()
                .createAgentWeb()
                .ready()
                .go("http://www.jd.com");

不用配置 Setting ，不用添加 WebChromeClient 就有进度条。

3.使用
安卓调用JavaScript方法：

//Javascript 方法
function callByAndroid(){
      console.log("callByAndroid")
  }
//Android 端
mAgentWeb.getJsEntraceAccess().quickCallJs("callByAndroid");
//结果
consoleMessage:callByAndroid  lineNumber:27

JavaScript调用安卓方法：


//Android 端 ， AndroidInterface 是一个注入类 ，里面有一个无参数方法：callAndroid 
mAgentWeb.getJsInterfaceHolder().addJavaObject("android",new AndroidInterfaceWeb(mAgentWeb,this)); 
//H5端  在 Js 里就能通过 
window.android.callAndroid() //调用 Java 层的 AndroidInterface 类里 callAndroid 方法

上面AndroidInterfaceWeb里的代码(记住是这新建的一个类共JS调用的)：

public class AndroidInterfaceWeb {
    private AgentWeb agent;
    private Activity activity;

    public AndroidInterfaceWeb(AgentWeb agent, Activity activity) {
        this.agent = agent;
        this.activity = activity;
    }

    //注解供JS调用 不写会报错
    @JavascriptInterface
    public void callAndroid() {
        Toast.makeText(activity, "潘潘", Toast.LENGTH_SHORT).show();
    }
}

跟随 Activity 或者 Fragment 生命周期，释放 CPU和资源，更省电。方法如下：

    /**
     * 跟随 Activity 生命周期释放CPU更省电 ↓↓↓↓↓
     */
    @Override
    protected void onPause() {
        mAgentWeb.getWebLifeCycle().onPause();
        super.onPause();
    }
    @Override
    protected void onResume() {
        mAgentWeb.getWebLifeCycle().onResume();
        super.onResume();
    }
    @Override
    protected void onDestroy() {
        mAgentWeb.getWebLifeCycle().onDestroy();
        super.onDestroy();
    }

清空Web缓存:

AgentWebConfig.clearDiskCache(this);

事件处理 (直接按下返回键会退出当前Activity,由新的事件接管建议使用在Fragment)：

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

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

如果非得想设置设置Chrome客户端和View客户端可以通过以下代码:


    //设置Chrome客户端
    private WebViewClient mWebViewClient = new WebViewClient() {
        @Override
        public void onPageStarted(WebView view, String url, Bitmap favicon) {
            //do you  work
        }
    };

    ////设置View客户端   (子线程)
    private WebChromeClient mWebChromeClient = new WebChromeClient() {
        @Override
        public void onProgressChanged(WebView view, int newProgress) {
            //do you work
            //加载进度
//            tv_jdt.setText(newProgress + "%");
            //给H5网页传参数
         mAgentWeb.getJsAccessEntrace().quickCallJs("checkTicketPage.appHook","哇哈哈"); //第一个参数为方法名, 第二个参数为Js方法的入参
        }
    };

返回上一页:

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

如果不想要进度条:(把设置进度条的第一个属性改成0,你就会发现进度条神奇的消失了)

.useDefaultIndicator(0,1)

全屏视频播放

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

定位

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

获取 WebView

mAgentWeb.getWebCreator().getWebView();

查看 Cookies

String cookies=AgentWebConfig.getCookiesByUrl(targetUrl);

同步 Cookie

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

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>

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

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

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

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

修改 AgentWeb 默认的背景色

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

注意事项:

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

基本打开效果图:(只使用第 1,2 步骤就可以实现基本效果其他功能按需求去添加使用)

image.png

与原生WebView对比: