第2章 Gradle依赖配置：集成友盟基础统计、推送与屏幕适配

2.1 本章知识脉络

友盟SDK的构建依赖配置是整个项目对接的基础环节。从Gradle构建系统的依赖声明开始，需要依次引入基础统计库（umeng-common）、推送库（umeng-push）以及屏幕适配库（autosize），并处理好各库间的版本兼容性。本章按照“配置原理 → 实现步骤 → 调试验证 → 常见错误”的流程展开，最后给出稳定性优化建议。

2.2 依赖配置原理

友盟SDK以远程Maven artifact的形式发布，通过Gradle的implementation指令将aar包拉取到本地。基础统计库提供事件埋点、用户画像等核心能力；推送库依赖统计库的底层通道；屏幕适配库（autosize）需与推送库配合避免UI错乱。版本号采用语义化版本控制（MAJOR.MINOR.PATCH），主版本号不一致时可能产生API不兼容。

2.3 实现流程

1. 在项目级 build.gradle（或settings.gradle）中添加maven仓库地址。
2. 在模块级 build.gradle（一般是app/build.gradle）中添加依赖声明。
3. 同步Gradle，验证依赖是否成功解析。
4. 处理minSdkVersion、targetSdkVersion与友盟库的版本约束。
5. 可选：配置推送SDK的灰度版本适配（如华为、小米厂商通道）。

2.4 具体配置清单

2.4.1 项目级 build.gradle（或 settings.gradle）

// 项目级 build.gradle（groovy语法示例）
buildscript {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://repo1.maven.org/maven2' }
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://repo1.maven.org/maven2' }
    }
}
// 如果使用新版本 Gradle（7.0+），建议改用 settings.gradle 的 dependencyResolutionManagement

2.4.2 模块级 build.gradle（核心依赖）

android {
    defaultConfig {
        minSdkVersion 21
        targetSdkVersion 34
        // 友盟屏幕适配需配合该参数
        ndk {
            abiFilters "armeabi-v7a", "arm64-v8a", "x86_64"
        }
    }
}

dependencies {
    // 基础统计库（必选）
    implementation 'com.umeng.umsdk:common:9.6.2'
    // 推送库（可选，但本案例需要）
    implementation 'com.umeng.umsdk:push:6.5.2'
    // 屏幕适配库（第三方的 autosize，用于 Compose 界面适配）
    implementation 'me.jessyan:autosize:1.3.0'

    // 如果使用华为/小米等厂商通道，还需单独添加对应推送依赖
    // implementation 'com.umeng.umsdk:meizu:3.0.0'   // 示例
}

2.4.3 屏幕适配配置

autosize库需要在AndroidManifest.xml中配置全局适配策略，或在Application中初始化。本案例统一在Application类中初始化：

public class MyApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化友盟统计（推送SDK内部也会调用）
        UMConfigure.init(this, "your_appkey", "Umeng", UMConfigure.DEVICE_TYPE_PHONE, null);
        // 屏幕适配：宽度为360dp，高度为640dp的设计图标准
        AutoSizeConfig.getInstance()
                .setDesignWidth(360)
                .setDesignHeight(640)
                .setBaseOnWidth(true);
    }
}

2.5 内联SVG：Gradle依赖配置流程图

2.6 调试与验证

依赖配置完成后，可通过以下方式验证是否成功：

• Gradle Console检查：执行./gradlew app:dependencies --configuration implementation，确认umeng-common、umeng-push、autosize均出现在树中。
• 编译运行：如果出现Invoke-customs are only supported starting with Android N (26)等错误，说明minSdkVersion太低，需提升至21以上（友盟common 9.x要求minSdkVersion 19，但推送库要求21）。
• 推送初始化日志：在Logcat中过滤Umeng标签，应看到UMENG init success。

2.7 常见错误与解决方案