Justson /AgentWeb

AgentWeb is a powerful library based on Android WebView.

★ 9,437⑂ 1,661👁 163⑃ 28● 1,050▤ 23
JavaApache-2.0Created 2017-05-12www.jianshu.com/p/fc7909e24178
Download: v5.1.7-androidxv5.1.7-androidx ↓v5.1.7-androidx2026-09-14
+0
Daily
9,437
stars
1,661
forks
163
watchers
28
prs
1,050
issues
23
releases

README

AgentWeb 介绍

AgentWeb 是一个基于的 Android WebView ,极度容易使用以及功能强大的库,提供了 Android WebView 一系列的问题解决方案 ,并且轻量和极度灵活,详细使用请参照上面的 Sample 。
	

 Gradle 引入

AgentWeb 通过 JitPack 分发,请先添加 JitPack 仓库:

groovy
allprojects {
  repositories {
    mavenCentral()
    maven { url 'https://jitpack.io' }
  }
}


Gradle 7+ 若使用 settings.gradle 集中管理仓库,则加在 dependencyResolutionManagement 中:

groovy
dependencyResolutionManagement {
    repositories {
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}


 Androidx

   groovy
    implementation 'com.github.Justson.AgentWeb:agentweb-core:5.1.7-androidx' // (必选)
    implementation 'com.github.Justson.AgentWeb:agentweb-filechooser:5.1.7-androidx' // (可选)
    implementation 'com.github.Justson:Downloader:v5.0.6-androidx' // (可选)
   
   

 注意版本号不带 v 前缀:Git tag 是 v5.1.7-androidx,而 JitPack 在生成坐标时会去掉前导 v,因此依赖里应写 5.1.7-androidx。


 相关
 flying-pigeon跨进程IPC组件
 AgentWebX5
 WebView 进度条
 Downloader 一个轻量的文件下载器

	


 注意事项
 支付宝使用需要引入支付宝SDK ,并在项目中依赖 , 微信支付不需要做任何操作。
 AgentWeb 内部使用了 AlertDialog 需要依赖 AppCompat 主题 。 
 setAgentWebParent 不支持  ConstraintLayout 。
 mAgentWeb.getWebLifeCycle().onPause();会暂停应用内所有WebView 。
 minSdkVersion 低于等于16以下自定义WebView请注意与 JS 之间通信安全。
 v5.1.2 起 compileSdk / targetSdk 升级到 36(Android 16),Android Gradle Plugin 升级到 8.13.2,请同步升级项目的 Gradle 与 AGP 版本。
 v5.1.3 起库已随包下发 @JavascriptInterface 的 keep 规则,接入方无需再在自己的 proguard-rules.pro 中重复声明。
 不要直接对 WebView 调用 setWebViewClient() / setWebChromeClient()。这会整体替换掉 AgentWeb 内部的实现,进度条、错误页、文件选择等功能都会随之失效。正确做法是使用 AgentWeb.with(...) 的 setWebViewClient() / setWebChromeClient(),或用 MiddlewareWebClientBase / MiddlewareWebChromeBase 中间件叠加。
 setOpenOtherPageWays(ASK) 只在目标 App 已安装时才会弹窗询问。未安装时系统中没有任何组件能处理该 scheme,不会弹窗,属预期行为。
 AgentWeb 在处理非 http/https 的 scheme 跳转时会调用 queryIntentActivities 判断能否唤起其他 App,应用市场的隐私检测可能将其识别为「读取已安装应用列表」。若无需唤起外部 App,设置 setOpenOtherPageWays(DefaultWebClient.OpenOtherPageWays.DISALLOW) 即可完全不触发该调用。




 文档帮助
 Wiki(不全)
 Sample(推荐,详细) 
 更新日志



 有问题或者有更好的建议
 [![QQ0Group][qq0groupsvg]][qq0group]
 欢迎提 Issues


 赞赏
开源不易,你的支持是我更新的动力。

  


[licensesvg]: https://img.shields.io/badge/License-Apache--2.0-brightgreen.svg
[license]: https://github.com/Justson/AgentWeb/blob/master/LICENSE

[qq0groupsvg]: https://img.shields.io/badge/QQ群-599471474-fba7f9.svg
[qq0group]: http://qm.qq.com/cgi-bin/qm/qr?k=KpyfInzI2nr-Lh4StG0oh68GpbcD0vMG

 

[![License][licensesvg]][license]

 License 

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.


​	

​

Top issues

Latest release

v5.1.7-androidx v5.1.7-androidx 2026-09-14
⚠️ 本次包含安全修复,影响 5.1.6-androidx 及更早的所有版本,强烈建议升级。

groovy
implementation 'com.github.Justson.AgentWeb:agentweb-core:5.1.7-androidx'
implementation 'com.github.Justson.AgentWeb:agentweb-filechooser:5.1.7-androidx' // (可选)


 安全修复

 网页可拉起宿主应用未导出的页面(Intent Redirection) —— DefaultWebClient 会把网页中的 intent URL(intent://...;component=...;end,或任意 scheme 附带 Intent;...;end 片段)原样解析,并以宿主 Activity 的身份启动。由于系统按宿主 uid 做导出检查,网页因此可以越过 android:exported="false" 的限制拉起宿主内部页面,并携带任意 extras。默认配置即受影响。现已修复:
   网页指定的组件若属于宿主自身,将被忽略,只能命中宿主声明过 intent-filter 的页面
   宿主未导出的页面在任何 OpenOtherPageWays 模式下都不会被打开
   清除网页传入的 selector、嵌套 I

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON