android AgentWeb webview框架（强力推荐）

小咪咪 2022-11-21 01:13 955阅读 0赞

AgentWeb 是一个基于的 Android WebView ，极度容易使用以及功能强大的库，提供了 Android WebView 一系列的问题解决方案 ，并且轻量和极度灵活，体验请下载的 [agentweb.apk][]， 或者你也可以到 Google Play 里面下载 [AgentWeb][] ， 详细使用请参照上面的 Sample 。

## 引入 ##

*  Gradle
    
        implementation 'com.just.agentweb:agentweb:4.1.4' // (必选)
        implementation 'com.just.agentweb:filechooser:4.1.4'// (可选)
        implementation 'com.download.library:Downloader:4.1.4'// (可选)
 *  androidx
    
        implementation 'com.just.agentweb:agentweb-androidx:4.1.4' // (必选)
        implementation 'com.just.agentweb:filechooser-androidx:4.1.4'// (可选)
        implementation 'com.download.library:downloader-androidx:4.1.4'// (可选)

## 相关 ##

*  [flying-pigeon跨进程IPC组件][flying-pigeon_IPC]
 *  [AgentWebX5][]
 *  [WebView 进度条][WebView]
 *  [Downloader 一个轻量的文件下载器][Downloader]

## 使用 ##

基础用法

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

## 效果图 ##

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

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

*  Javascript 调 Java ?

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

*  事件处理

@Override
        public boolean onKeyDown(int keyCode, KeyEvent event) {
    
            if (mAgentWeb.handleKeyEvent(keyCode, event)) {
                return true;
            }
            return super.onKeyDown(keyCode, event);
        }

*  跟随 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();
        }

*  全屏视频播放

android:hardwareAccelerated="true"
    android:configChanges="orientation|screenSize"

*  定位

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

*  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
            }
        };

*  返回上一页

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

*  获取 WebView

mAgentWeb.getWebCreator().getWebView();

*  查看 Cookies

String cookies=AgentWebConfig.getCookiesByUrl(targetUrl);

*  同步 Cookie

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

*  MiddlewareWebChromeBase 支持多个 WebChromeClient

//略，请查看 Sample

*  MiddlewareWebClientBase 支持多个 WebViewClient

//略，请查看 Sample

*  清空缓存

AgentWebConfig.clearDiskCache(this.getContext());

*  权限拦截

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

*  AgentWeb 完整用法

//略，请查看 Sample

*  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>

*  AgentWeb 所依赖的库

compile "com.android.support:design:${SUPPORT_LIB_VERSION}" // (3.0.0开始该库可选)
        compile "com.android.support:support-v4:${SUPPORT_LIB_VERSION}"
        SUPPORT_LIB_VERSION=27.0.2(该值会更新)

## 混淆 ##

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

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

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

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

## [https://github.com/Justson/AgentWeb][https_github.com_Justson_AgentWeb] ##

[agentweb.apk]: https://github.com/Justson/AgentWeb/raw/master/agentweb.apk
[AgentWeb]: https://play.google.com/store/apps/details?id=com.just.agentweb.sample
[flying-pigeon_IPC]: https://github.com/Justson/flying-pigeon
[AgentWebX5]: https://github.com/Justson/AgentWebX5
[WebView]: https://github.com/Justson/CoolIndicator
[Downloader]: https://github.com/Justson/Downloader
[https_github.com_Justson_AgentWeb]: https://github.com/Justson/AgentWeb