Chucker项目从2.x版本迁移到3.x版本指南

最新推荐文章于 2025-06-10 09:01:21 发布

原创最新推荐文章于 2025-06-10 09:01:21 发布 · 323 阅读

CC 4.0 BY-SA版权

Chucker项目从2.x版本迁移到3.x版本指南

chucker 🔎 An HTTP inspector for Android & OkHTTP (like Charles but on device) 项目地址: https://gitcode.com/gh_mirrors/ch/chucker

前言

Chucker作为一款优秀的Android网络请求拦截和调试工具，在3.x版本中进行了多项重要改进。本文将为开发者详细介绍从2.0.4版本升级到3.x版本时需要注意的关键变更点，帮助开发者顺利完成迁移工作。

类名变更

在3.x版本中，所有类名前缀从"Chuck"统一变更为"Chucker"。这一变更是为了保持项目命名的一致性。

变更示例：

ChuckInterceptor → ChuckerInterceptor
ChuckCollector → ChuckerCollector
Chuck.getLaunchIntent() → Chucker.getLaunchIntent()

影响范围：这一变更涉及库中的所有类，开发者需要全局搜索并替换所有相关引用。

包名变更

3.x版本对包结构进行了调整，新的基础包名为com.chuckerteam.chucker.api。

新旧包名对照表：

| 旧包名 | 新包名 | |-------|-------| | com.readystatesoftware.chuck.api.Chuck | com.chuckerteam.chucker.api.Chucker | | com.readystatesoftware.chuck.api.ChuckCollector | com.chuckerteam.chucker.api.ChuckerCollector | | com.readystatesoftware.chuck.api.ChuckerInterceptor | com.chuckerteam.chucker.api.ChuckerInterceptor |

迁移建议：建议使用IDE的重构功能批量修改包引用，避免手动修改可能导致的遗漏。

拦截器配置方式变更

3.x版本移除了Builder模式，改为使用Kotlin命名参数和默认值来配置拦截器。

Java代码示例

旧版本代码：

ChuckInterceptor interceptor = new ChuckInterceptor(context, collector)
    .maxContentLength(120000L);

新版本代码：

ChuckInterceptor interceptor = new ChuckInterceptor(context, collector, 120000);

Kotlin代码示例

旧版本代码：

val retentionManager = RetentionManager(androidApplication, ChuckCollector.Period.ONE_HOUR)

val collector = ChuckCollector(androidApplication)
            .retentionManager(retentionManager)
            .showNotification(true)

val interceptor = ChuckInterceptor(context, collector)
    .maxContentLength(120000L)

新版本代码：

val collector = ChuckerCollector(
    context = this,
    showNotification = true,
    retentionPeriod = RetentionManager.Period.ONE_HOUR
)

val interceptor = ChuckerInterceptor(
    context = context,
    collector = collector,
    maxContentLength = 120000L
)

优势说明：新的配置方式更加简洁直观，特别是在Kotlin环境下，可以利用命名参数提高代码可读性。