AgentWeb 介绍 English
AgentWeb 是一个基于的 Android WebView ,简单易用 , 带有进度条 、 支持文件上传 、 下载 、 简化与 Javascript 通信 、 链式调用 、带有错误页、权限拦截、定位 、 支持多个 WebViewClient ,WebChromeClient、 加强 Web 安全,功能强大的库 ,更多使用请参照上面的 Sample 。
AgentWeb Sample 展示了 AgentWeb 库强大的功能 , 详细请点击下面链接下载体验。
Web | 文件下载 | 文件上传 | Js 通信 | 使用简易度 | 进度条 | 全屏视频 | ...... |
---|---|---|---|---|---|---|---|
WebView | 不支持 | 不支持 | 支持 | 麻烦 | 没有 | 不支持 | 不支持 |
AgentWeb | 支持 | 支持 | 更简洁 | 简洁 | 有 | 支持 | 支持 |
-
Gradle
compile 'com.just.agentweb:agentweb:3.0.0'
-
Maven
<dependency> <groupId>com.just.agentweb</groupId> <artifactId>agentweb</artifactId> <version>3.0.0</version> <type>pom</type> </dependency>
-
Gradle
compile 'com.just.agentweb:agentweb:3.1.0-beta'
mAgentWeb = AgentWeb.with(this)//传入Activity or Fragment
.setAgentWebParent(mLinearLayout, new LinearLayout.LayoutParams(-1, -1))//传入AgentWeb 的父控件 ,如果父控件为 RelativeLayout , 那么第二参数需要传入 RelativeLayout.LayoutParams ,第一个参数和第二个参数应该对应。
.useDefaultIndicator()// 使用默认进度条
.defaultProgressBarColor() // 使用默认进度条颜色
.setReceivedTitleCallback(mCallback) //设置 Web 页面的 title 回调
.createAgentWeb()//
.ready()
.go("http://www.jd.com");
//Javascript 方法
function callByAndroid(){
console.log("callByAndroid")
}
//Android 端
mAgentWeb.getJsEntraceAccess().quickCallJs("callByAndroid");
//结果
consoleMessage:callByAndroid lineNumber:27
//Android 端 , AndroidInterface 是一个注入类 ,里面有一个无参数方法:callAndroid
mAgentWeb.getJsInterfaceHolder().addJavaObject("android",new AndroidInterface(mAgentWeb,this));
//在 Js 里就能通过
window.android.callAndroid() //调用 Java 层的 AndroidInterface 类里 callAndroid 方法
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
if (mAgentWeb.handleKeyEvent(keyCode, event)) {
return true;
}
return super.onKeyDown(keyCode, event);
}
@Override
protected void onPause() {
mAgentWeb.getWebLifeCycle().onPause(); //暂停应用内所有 WebView , 需谨慎。
super.onPause();
}
@Override
protected void onResume() {
mAgentWeb.getWebLifeCycle().onResume();
super.onResume();
}
@Override
public void onDestroyView() {
mAgentWeb.getWebLifeCycle().onDestroy();
super.onDestroyView();
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
mAgentWeb.uploadFileResult(requestCode, resultCode, data);
super.onActivityResult(requestCode, resultCode, data);
}
<!--如果你的应用需要用到视频 , 那么请你在使用 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" />
// AgentWeb 保持了 WebView 的使用 ,
mAgentWeb = AgentWeb.with(this)//
.setAgentWebParent(mLinearLayout,new LinearLayout.LayoutParams(-1,-1) )//
.useDefaultIndicator()//
.defaultProgressBarColor()
.setReceivedTitleCallback(mCallback)
.setWebChromeClient(mWebChromeClient)
.setWebViewClient(mWebViewClient)
.setSecutityType(AgentWeb.SecurityType.strict)
.createAgentWeb()//
.ready()
.go(getUrl());
//WebViewClient
private WebViewClient mWebViewClient=new WebViewClient(){
@Override
public void onPageStarted(WebView view, String url, Bitmap favicon) {
//do you work
}
};
//WebChromeClient
private WebChromeClient mWebChromeClient=new WebChromeClient(){
@Override
public void onProgressChanged(WebView view, int newProgress) {
//do you work
}
};
if (!mAgentWeb.back()){// true表示AgentWeb处理了该事件
AgentWebFragment.this.getActivity().finish();
}
WebView mWebView=mAgentWeb.getWebCreator().get();
AgentWebConfig.syncCookie("http://www.jd.com","ID=XXXX")
//略,请查看 Sample
//略,请查看 Sample
String cookies=AgentWebConfig.getCookiesByUrl(targetUrl);
protected PermissionInterceptor mPermissionInterceptor = new PermissionInterceptor() {
//AgentWeb 在触发某些敏感的权限时候会回调该方法, 比如定位触发 。
//该方法是每次都会优先触发的 , 开发者可以做一些敏感权限拦截 。
@Override
public boolean intercept(String url, String[] permissions, String action) {
Log.i(TAG, "url:" + url + " permission:" + permissions + " action:" + action);
return false;
}
};
mAgentWeb = AgentWeb.with(this)//
.setAgentWebParent((LinearLayout) view, new LinearLayout.LayoutParams(-1,-1))//传入AgentWeb的父控件。
.setIndicatorColorWithHeight(-1, 2)//设置进度条颜色与高度,-1为默认值,高度为2,单位为dp。
.setAgentWebWebSettings(getSettings())//设置 AgentWebSettings。
.setWebViewClient(mWebViewClient)//WebViewClient , 与 WebView 使用一致 ,但是请勿获取WebView调用setWebViewClient(xx)方法了,会覆盖AgentWeb DefaultWebClient,同时相应的中间件也会失效。
.setWebChromeClient(mWebChromeClient) //WebChromeClient
.setPermissionInterceptor(mPermissionInterceptor) //权限拦截 2.0.0 加入。
.setReceivedTitleCallback(mCallback)//标题回调。
.setSecurityType(AgentWeb.SecurityType.strict) //严格模式 Android 4.2.2 以下会放弃注入对象 ,使用AgentWebView没影响。
.addDownLoadResultListener(mDownLoadResultListener) //下载回调
.setAgentWebUIController(new UIController(getActivity())) //自定义UI AgentWeb3.0.0 加入。
.setMainFrameErrorView(R.layout.agentweb_error_page, -1) //参数1是错误显示的布局,参数2点击刷新控件ID -1表示点击整个布局都刷新, AgentWeb 3.0.0 加入。
.useMiddleWareWebChrome(getMiddleWareWebChrome()) //设置WebChromeClient中间件,支持多个WebChromeClient,AgentWeb 3.0.0 加入。
.useMiddleWareWebClient(getMiddleWareWebClient()) //设置WebViewClient中间件,支持多个WebViewClient, AgentWeb 3.0.0 加入。
.openParallelDownload()//打开并行下载 , 默认串行下载。
.setNotifyIcon(R.drawable.ic_file_download_black_24dp) //下载通知图标。
.setOpenOtherPageWays(DefaultWebClient.OpenOtherPageWays.ASK)//打开其他页面时,弹窗质询用户前往其他应用 AgentWeb 3.0.0 加入。
.interceptUnkownScheme() //拦截找不到相关页面的Scheme AgentWeb 3.0.0 加入。
.createAgentWeb()//创建AgentWeb。
.ready()//设置 WebSettings。
.go(getUrl()); //WebView载入该url地址的页面并显示。
<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>
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.library.agentweb.AndroidInterface{ *; }
- 支付宝使用需要引入支付宝SDK ,并在项目中依赖 , 微信支付不需要做任何操作。
- AgentWeb 内部使用了
AlertDialog
需要依赖AppCompat
主题 。 setAgentWebParent
不支持ConstraintLayout
。mAgentWeb.getWebLifeCycle().onPause();
会暂停应用内所有WebView
。minSdkVersion
低于等于16以下自定义WebView
请注意与JS
之间通信安全。- AgentWeb v3.0.0以上版本更新了包名,混淆的朋友们,请更新你的混淆配置。
- Wiki(不全)
Sample
(推荐,详细)
- v_3.1.0 更新
WebProgress
进度条动画更细腻。- 修复部分机型拍照文件大小为0情况。
- 更新了
FileUpLoadChooserImpl
。
- v_3.0.0 更新
- 加入
MiddleWareWebChromeBase
中间件 ,支持多个WebChromeClient
。 - 加入
MiddleWareWebClientBase
中间件 , 支持多个WebViewClient
。 - 加入了默认的错误页,并支持自定义错误页 。
- 加入
AgentWebUIController
,统一控制UI 。 - 支持拦截未知的页面 。
- 支持调起其他应用 。
- 加入
- v_2.0.1 更新
- 支持并行下载 , 修复 #114 #109 。
- v_2.0.0 更新
- 加入动态权限 。
- 拍照。
- v_1.2.6 更新
- 修复Android 4.4以下布局错乱 。
- v_1.2.5 提示信息支持配置 。
- 提示信息支持配置 。
- v_1.2.4 更新
- 支持传入 IWebLayout ,支持下拉回弹,下拉刷新效果 。
- v_1.2.3 更新
- 新增下载结果回调 。
- v_1.2.2 更新
- 修复已知 Bug 。
- v_1.2.1 更新
- 支持调起支付宝 , 微信支付 。
- v_1.2.0 更新
- 全面支持全屏视频 。
- v_1.1.2 更新
- 完善功能 。
- 欢迎提 Issues
一个位于深圳的 Android 开发者 , 如果你有问题 , 请联系 Email : xiaozhongcen@gmail.com
如果你喜欢了 AgentWeb
的设计 , 你也可以请作者喝一杯咖啡。
最后如果该库对你有帮助不妨对右上角点点 Star 对我支持 , 感谢万分 ! 当然我更喜欢你 Fork PR 成为项目贡献者 。 AgentWeb
Copyright (C) Justson(https://github.com/Justson/AgentWeb)
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.