AutoEx异常处理工具解决方案指南

环境适配流程

场景描述：项目集成配置失败

核心原因分析：依赖仓库未正确配置或版本兼容性问题导致依赖下载失败，影响项目构建流程。

基础解决方案： 1️⃣ 配置仓库地址
在项目根目录的build.gradle中添加仓库配置：

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

2️⃣ 添加依赖项
在模块级build.gradle中配置依赖：

dependencies {
    debugImplementation 'com.github.BolexLiu.AutoEx:AutoEx-Lib:v1.0.8'
    releaseImplementation 'com.github.BolexLiu.AutoEx:AutoEx-Lib-No-Op:v1.0.8'
}

进阶解决方案：

• 使用动态版本管理：debugImplementation 'com.github.BolexLiu.AutoEx:AutoEx-Lib:latest.release'
• 配置依赖排除规则解决冲突：

debugImplementation ('com.github.BolexLiu.AutoEx:AutoEx-Lib:v1.0.8') {
    exclude group: 'com.android.support'
}

避坑指南：

1. 错误案例：仓库URL拼写错误（常见将jitpack写成jitpak）
2. 错误案例：混淆release和debug依赖（导致生产环境包含调试代码）
3. 错误案例：未指定版本号或使用不存在的版本标签

效果验证方法：
执行./gradlew dependencies命令，检查输出中是否包含AutoEx-Lib相关依赖项。

💡 经验提示
建议使用固定版本号而非动态版本，避免构建结果不可控。首次集成后执行./gradlew clean build确保依赖正确加载。

依赖类型	适用场景	最低支持版本
debugImplementation	开发调试环境	SDK 14+
releaseImplementation	生产发布环境	SDK 14+

类引用错误排查

场景描述：运行时类找不到

核心原因分析：依赖未正确引入或ProGuard混淆规则配置不当，导致运行时类加载失败。

基础解决方案： 1️⃣ 检查依赖配置
确认模块级build.gradle中已正确添加AutoEx依赖，同步项目后清理重建。

2️⃣ 验证SDK版本兼容性
确保项目minSdkVersion不低于14，compileSdkVersion为26或更高版本。

进阶解决方案：

• 添加ProGuard规则（在proguard-rules.pro中）：

-keep class com.bolex.autoEx.** { *; }

• 使用./gradlew :app:dependencies --configuration debugCompileClasspath检查依赖传递情况

避坑指南：

1. 错误案例：混淆规则未排除AutoEx类导致类被移除
2. 错误案例：同时引用多个版本的AutoEx依赖造成冲突
3. 错误案例：模块间依赖传递被意外阻断

效果验证方法：
在Application类中添加AutoEx.apply();，运行应用并检查Logcat是否有初始化成功日志。

💡 经验提示
使用Android Studio的"Sync Project with Gradle Files"功能后，通过"Build > Rebuild Project"确保所有依赖正确编译。

知识卡片：SDK版本
SDK（软件开发工具包）版本决定了应用支持的Android系统版本范围。AutoEx要求最低SDK版本14（Android 4.0），建议使用26+（Android 8.0）以获得最佳兼容性。

调试配置优化

场景描述：日志信息不完整

核心原因分析：默认配置未开启调试模式或未设置自定义日志标签，导致问题排查困难。

基础解决方案： 1️⃣ 基础初始化配置
在Application类onCreate()方法中添加：

AutoEx.apply(); // 默认配置

2️⃣ 开启调试模式
使用带参数的初始化方法：

AutoEx.apply("AutoEx-Debug", true); // 自定义标签并开启调试

进阶解决方案：

• 实现自定义日志输出：

AutoEx.setLogger(new AutoEx.Logger() {
    @Override
    public void log(String tag, String message) {
        // 自定义日志处理逻辑
        Log.d(tag, "[AutoEx] " + message);
    }
});

避坑指南：

1. 错误案例：生产环境开启调试模式导致性能问题
2. 错误案例：日志标签超过23个字符导致截断
3. 错误案例：在非主线程调用初始化方法

效果验证方法：
触发测试崩溃，检查Logcat中是否有包含自定义标签的AutoEx日志输出。

💡 经验提示
建议在BuildConfig.DEBUG条件下开启调试模式，避免生产环境泄露敏感信息：

if (BuildConfig.DEBUG) {
    AutoEx.apply("AutoEx-Debug", true);
} else {
    AutoEx.apply();
}

配置参数	类型	说明
日志标签	String	标识日志来源的标签，建议使用项目名称前缀
调试模式	boolean	true启用详细日志，false仅输出关键信息