项目地址:https://github.com/Justson/AgentWeb
AgentWeb 介绍AgentWeb 是一个基于的 Android WebView ,极度容易使用以及功能强大的库,提供了 Android WebView 一系列的问题解决方案 ,并且轻量和极度灵活。
引入Gradle
compile 'com.just.agentweb:agentweb:4.0.2' // (必选) compile 'com.just.agentweb:download:4.0.2' // (可选) compile 'com.just.agentweb:filechooser:4.0.2'// (可选)Maven
<dependency> <groupId>com.just.agentweb</groupId> <artifactId>agentweb</artifactId> <version>4.0.2</version> <type>pom</type> </dependency>使用
基础用法
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(); }全屏视频播放
<!--如果你的应用需要用到视频 , 那么请你在使用 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
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(); 文件下载监听 protected DownloadListenerAdapter mDownloadListenerAdapter = new DownloadListenerAdapter() {@Overridepublic boolean onStart(String url, String userAgent, String contentDisposition, String mimetype, long contentLength, AgentWebDownloader.Extra extra) {extra.setOpenBreakPointDownload(true).setIcon(R.drawable.ic_file_download_black_24dp).setConnectTimeOut(6000).setBlockMaxTime(2000).setDownloadTimeOut(60L * 5L * 1000L).setAutoOpen(true).setForceDownload(false);return false;}@Overridepublic void onBindService(String url, DownloadingService downloadingService) {super.onBindService(url, downloadingService);mDownloadingService = downloadingService;LogUtils.i(TAG, "onBindService:" + url + " DownloadingService:" + downloadingService);}@Overridepublic void onUnbindService(String url, DownloadingService downloadingService) {super.onUnbindService(url, downloadingService);mDownloadingService = null;LogUtils.i(TAG, "onUnbindService:" + url);}@Overridepublic void onProgress(String url, long loaded, long length, long usedTime) {int mProgress = (int) ((loaded) / Float.valueOf(length) * 100);LogUtils.i(TAG, "onProgress:" + mProgress);super.onProgress(url, loaded, length, usedTime);}@Overridepublic boolean onResult(String path, String url, Throwable throwable) {if (null == throwable) { //do you work} else {}return false; }};查看 Cookies
String cookies=AgentWebConfig.getCookiesByUrl(targetUrl);同步 Cookie
AgentWebConfig.syncCookie("http://www.jd.com","ID=XXXX");MiddlewareWebChromeBase 支持多个 WebChromeClient
//略,请查看 SampleMiddlewareWebClientBase 支持多个 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 完整用法
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_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{ *; }