一个强大的Android WebView库.zip

<div style="display: flex;flex-direction: row;justify-content: center" width="100%"> <img src="./img/logo.png"></img> </div> ## AgentWeb 介绍 [English](./README-ENGLISH.md) 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 ``` api 'com.just.agentweb:agentweb:4.1.2' // (必选) api 'com.just.agentweb:filechooser:4.1.2'// (可选) api 'com.download.library:Downloader:4.1.2'// (可选) ``` ## 相关 * [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 mAgentWeb = AgentWeb.with(this) .setAgentWebParent((LinearLayout) view, new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT)) .useDefaultIndicator(-1, 3) .setAgentWebWebSettings(getSettings()) .setWebViewClient(mWebViewClient) .setWebChromeClient(mWebChromeClient) .setPermissionInterceptor(mPermissionInterceptor) .setSecurityType(AgentWeb.SecurityType.STRICT_CHECK) .setAgentWebUIController(new UIController(getActivity())) .setMainFrameErrorView(R.layout.agentweb_error_page, -1) .useMiddlewareWebChrome(getMiddlewareWebChrome()) .useMiddlewareWebClient(getMiddlewareWebClient()) .setOpenOtherPageWays(DefaultWebClient.OpenOtherPageWays.DISALLOW) .interceptUnkownUrl() .createAgentWeb() .ready() .go(getUrl()); ``` * #### 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_