AgentWeb 安装与配置完全指南

裘健强Blythe

于 2024-09-13 22:28:39 发布

阅读量343

点赞数 2

本文链接：https://blog.csdn.net/gitblog_07337/article/details/142232504

版权

AgentWeb 安装与配置完全指南

AgentWeb AgentWeb is a powerful library based on Android WebView. 项目地址: https://gitcode.com/gh_mirrors/ag/AgentWeb

项目基础介绍

AgentWeb 是一款基于 Android WebView 构建的强大而易于使用的库，旨在提供一系列完善的解决方案以应对常见的WebView问题。它以其轻量级、灵活性著称，非常适合集成到需要网页展示功能的应用中。本项目的编程语言主要是 Java。

关键技术和框架

核心库: 专注于解决Android WebView的常见难题，如加载、交互、权限管理等。
集成对话框: 内置对 AlertDialog 的支持，因此需依赖AppCompat主题。
跨进程IPC组件: flying-pigeon 作为可选技术栈的一部分。
文件下载: 提供了独立的下载器组件，便于实现文件下载功能。
兼容性: 支持Android SDK版本16以上，并针对新旧版本做了适配。

准备工作与详细安装步骤

步骤一：添加仓库依赖

首先，确保在你的项目 build.gradle（位于项目根目录）文件中加入了JitPack.io仓库:

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

步骤二：添加AgentWeb依赖

接下来，在你的app模块的 build.gradle 文件中，加入AgentWeb的核心库和其他可能需要的组件依赖：

dependencies {
    implementation 'io.github.justson:agentweb-core:v5.1.1-androidx'
    implementation 'io.github.justson:agentweb-filechooser:v5.1.1-androidx'
    
    // 可选依赖
    implementation 'com.github.Justson:Downloader:v5.0.4-androidx'
}

步骤三：配置AppCompatActivity

由于AgentWeb内部使用了AlertDialog，你需要确保应用的主题继承自Theme.AppCompat系列，例如：

<!-- 在res/values/styles.xml -->
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
    <!-- Customize your theme here. -->
</style>

步骤四：基本使用示例

在你希望显示WebView的Activity或Fragment中，按照以下步骤初始化AgentWeb：

创建容器视图：

在XML布局文件中添加一个LinearLayout或其它非ConstraintLayout的父布局来放置WebView（因为setAgentWebParent不支持ConstraintLayout）。

初始化并启动AgentWeb：

AgentWeb.with(this)
        .setAgentWebParent(findViewById(R.id.container), new LinearLayout.LayoutParams(-1, -1))
        .useDefaultIndicator()
        .createAgentWeb()
        .ready()
        .go("https://example.com"); // 替换为你想要加载的URL