AgentWeb：AgentWeb是基于Android WebView的功能强大的库

<div style="display: flex;flex-direction: row;justify-content: center" width="100%"> <img src="./img/logo.png"></img> </div> ## AgentWeb 介绍 AgentWeb 是一个基于的 Android WebView ，极度容易使用以及功能强大的库，提供了 Android WebView 一系列的问题解决方案 ，并且轻量和极度灵活，体验请下载的 [agentweb.apk](https://github.com/Justson/AgentWeb/raw/master/agentweb.apk)， 或者你也可以到 Google Play 里面下载 [AgentWeb](https://play.google.com/store/apps/details?id=com.just.agentweb.sample) ， 详细使用请参照上面的 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组件](https://github.com/Justson/flying-pigeon) * [AgentWebX5](https://github.com/Justson/AgentWebX5) * [WebView 进度条](https://github.com/Justson/CoolIndicator) * [Downloader 一个轻量的文件下载器](https://github.com/Justson/Downloader) ## 使用 #### 基础用法 ```java mAgentWeb = AgentWeb.with(this) .setAgentWebParent((LinearLayout) view, new LinearLayout.LayoutParams(-1, -1)) .useDefaultIndicator() .createAgentWeb() .ready() .go("http://www.jd.com"); ``` ## 效果图 <a href="img/img-function-list.png"><img src="img/img-function-list.png" width="30%"/></a> <a href="img/img-permission.png"><img src="img/img-permission.png" width="30%"/></a> <a href="img/img-sonic.png"><img src="img/img-sonic.png" width="30%"/></a> <a href="img/img-scheme.png"><img src="img/img-scheme.png" width="30%"/></a> <a href="img/img-download.png"><img src="img/img-download.png" width="30%"/></a> <a href="img/img-bounce.png"><img src="img/img-bounce.png" width="30%"/></a> <a href="img/jd.png"><img src="img/jd.png" width="30%"/></a> <a href="img/wechat pay.png"><img src="img/wechat pay.png" width="30%"/></a> <a href="img/alipay.png"><img src="img/alipay.png" width="30%"/></a> <a href="img/js.png"><img src="img/js.png" width="30%"/></a> <a href="img/custom setting.png"><img src="img/custom setting.png" width="30%"/></a> <a href="img/video.png"><img src="img/video.png" width="30%"/></a> * #### 调用 Javascript 方法拼接太麻烦 ？ 请看 。 ```javascript function callByAndroid(){ console.log("callByAndroid") } mAgentWeb.getJsAccessEntrace().quickCallJs("callByAndroid"); ``` * #### Javascript 调 Java ? ```java mAgentWeb.getJsInterfaceHolder().addJavaObject("android",new AndroidInterface(mAgentWeb,this)); window.android.callAndroid(); ``` * #### 事件处理 ```java @Override public boolean onKeyDown(int keyCode, KeyEvent event) { if (mAgentWeb.handleKeyEvent(keyCode, event)) { return true; } return super.onKeyDown(keyCode, event); } ``` * #### 跟随 Activity Or Fragment 生命周期 ， 释放 CPU 更省电 。 ```java @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(); } ``` * #### 全屏视频播放 ``` <!--如果你的应用需要用到视频 ， 那么请你在使用 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" /> ``` * #### WebChromeClient 与 WebViewClient ```java 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 } }; ``` * #### 返回上一页 ```java if (!mAgentWeb.back()){ AgentWebFragment.this.getActivity().finish(); } ``` * #### 获取 WebView ```java mAgentWeb.getWebCreator().getWebView(); ``` * #### 查看 Cookies ```java String cookies=AgentWebConfig.getCookiesByUrl(targetUrl); ``` * #### 同步 Cookie ```java AgentWebConfig.syncCookie("http://www.jd.com","ID=XXXX"); ``` * #### MiddlewareWebChromeBase 支持多个 WebChromeClient ```java //略，请查看 Sample ``` * #### MiddlewareWebClientBase 支持多个 WebViewClient ```java //略，请查看 Sample ``` * #### 清空缓存 ```java AgentWebConfig.clearDiskCache(this.getContext()); ``` * #### 权限拦截 ```java 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 完整用法 ```java //略，请查看 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(该值会更新) ``` ## 混淆 如果你的项目需要加入混淆 ， 请加入如下配置 ```java -keep class com.just.agentweb.** { *; } -dontwarn com.just.agentweb.** ``` Java 注入类不要混淆 ， 例如 sample 里面的 AndroidInterface 类 ， 需要 Keep 。 ```java -keepclassmembers class com.just.agentweb.sample.common.AndroidInterface{ *; } ``` ## 注意事项 * 支付宝使用需要引入支�