优聚智汇

简体中文

English

简体中文

English

外观

Android 准备工作 ​

开发环境要求 ​

  • minSdkVersion：26（API 26，兼容 Android 8.0+）
  • Java：Java 11 或更高版本
  • Kotlin：Kotlin 1.8 或更高版本
  • Gradle：8.0+
  • Android Studio：推荐使用最新版本

注意：SDK 内部依赖 AndroidX Lifecycle 组件，请确保项目已启用 AndroidX 并引入对应的 lifecycle 依赖（如 lifecycle-runtime-ktx、lifecycle-process 等）。

Maven 仓库引入（推荐） ​

前置条件：配置 Maven 仓库 ​

在项目根目录的 settings.gradle.kts（Kotlin DSL）或 settings.gradle（Groovy DSL）中，确保已配置 mavenCentral() 仓库：

kotlin
// settings.gradle.kts — 使用 Kotlin DSL 的项目
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral() // 必须配置
    }
}
groovy
// settings.gradle — 使用 Groovy DSL 的项目
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral() // 必须配置
    }
}

核心库（必须） ​

在应用级 build.gradle 中添加以下依赖：

groovy
// app/build.gradle
dependencies {
    // 推荐集成最新版本SDK，可在【更新日志】中查找对应版本信息
    // 优聚广告核心 SDK（必须）
    implementation("com.ujusdk:uju-ad-core:3.4.2")
    // ADX 自有广告源（推荐，获得额外广告预算）
    implementation("com.ujusdk:uju-ad-ext:1.3.1")
}

华为 / 荣耀 OAID 库引入（建议引入，提高 ECPM） ​

为提高广告填充率和 ECPM，建议引入华为和荣耀的 OAID 标识库。

配置仓库 ​

在 settings.gradle 中追加华为和荣耀的 Maven 仓库：

groovy
// settings.gradle
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // 华为 Maven 仓库
        maven { url "https://developer.huawei.com/repo" }
        // 荣耀 Maven 仓库
        maven { url "https://developer.hihonor.com/repo" }
    }
}
kotlin
// settings.gradle.kts
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // 华为 Maven 仓库
        maven("https://developer.huawei.com/repo")
        // 荣耀 Maven 仓库
        maven("https://developer.hihonor.com/repo")
    }
}

添加依赖 ​

groovy
// app/build.gradle
dependencies {
    // 华为 OAID 标识服务
    implementation("com.huawei.hms:ads-identifier:3.4.62.300")
    // 荣耀 OAID 标识服务
    implementation("com.hihonor.mcs:ads-identifier:1.0.2.301")
}

本地引入 ​

如果无法使用远程 Maven 仓库，也可以采用本地 AAR 文件方式引入 SDK。请先从 下载页面 获取对应的 AAR 文件，并将其放置到 app/libs/ 目录下。

核心库 ​

groovy
// app/build.gradle
dependencies {
    // 推荐集成最新版本SDK，可在【更新日志】中查找对应版本信息
    // 优聚广告核心 SDK（本地 AAR，请将 ${version} 替换为实际版本号）
    implementation(files("libs/uju-ad-core-${version}.aar"))
    // ADX 自有广告源（本地 AAR，请将 ${version} 替换为实际版本号）
    implementation(files("libs/uju-ad-ext-${version}.aar"))
}

混淆配置 ​

groovy
# 优聚广告 SDK 混淆规则
-keep class com.uju.** { *; }

第三方广告平台特殊配置 ​

开发者按需选择第三方广告平台，务必要关注第三方广告平台的特殊说明（权限、混淆规则等）：

下一步 ​

完成准备工作后，您可以继续进行：