下载 SDK

当前版本 1.0.0（2026-09-20，发布说明）。 仅 Android，minSdk 25（Android 7.1.1）、compileSdk 34、JDK 17、AGP 8.x。

交付物是三个 aar，版本号三者一致：

坐标	什么时候引
com.admix:core	必需，聚合核心，不依赖任何广告 SDK
com.admix:adapter-csj	接穿山甲时引，自动带上穿山甲 SDK com.pangle.cn:mediation-sdk:7.7.1.6
com.admix:adapter-gdt	接优量汇时引，自动带上优量汇 SDK com.qq.e.union:union:4.680.1550

只接一家就只引那一个 adapter，另一家连同它的广告 SDK 都不会进包。

另外提供聚合坐标（只有 pom、没有代码），一行引入一组模块：

一行引入	等价于	什么时候用
com.admix:sdk:1.0.0	core + adapter-csj + adapter-gdt	两家广告平台都接（最常用）
com.admix:sdk-csj:1.0.0	core + adapter-csj	只接穿山甲
com.admix:sdk-gdt:1.0.0	core + adapter-gdt	只接优量汇

推荐用聚合坐标：三个坐标就是三个版本号，升级时漏改一个不会报错， 而「core 新版 + adapter 旧版」这种组合能编过、能跑，行为却没人验证过； 聚合坐标把版本收成一个数字。需要精细控制依赖（比如自己排除某个传递依赖）的工程照旧可以逐个引，两条路等价。

方式一：Maven 仓库（推荐）

仓库地址 https://admin.maemi.cn/maven/，公开只读，不需要账号。

1. 配置仓库

// settings.gradle
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://admin.maemi.cn/maven/' }                      // AdMix
        maven { url 'https://artifact.bytedance.com/repository/pangle' }    // 穿山甲官方仓库
    }
}

Kotlin DSL：

// settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven("https://admin.maemi.cn/maven/")                      // AdMix
        maven("https://artifact.bytedance.com/repository/pangle")    // 穿山甲官方仓库
    }
}

穿山甲仓库不能省

穿山甲 SDK 只发在字节自己的仓库里，Maven Central 上没有。少配这一条的表现是 Could not find com.pangle.cn:mediation-sdk，而不是「广告少一家」。 优量汇 SDK 在 Maven Central 上，不需要额外仓库。

2. 声明依赖

// app/build.gradle —— 一行版（推荐）
dependencies {
    implementation "com.admix:sdk:1.0.0"   // core + 穿山甲 + 优量汇
}

只接一家，或者想逐个控制：

// app/build.gradle —— 逐个引
dependencies {
    implementation "com.admix:core:1.0.0"          // 必需
    implementation "com.admix:adapter-csj:1.0.0"   // 穿山甲，自动带上穿山甲 SDK
    implementation "com.admix:adapter-gdt:1.0.0"   // 优量汇，自动带上优量汇 SDK
}

混淆规则随 aar 自动生效（consumer-rules.pro），不需要写任何 -keep。 接下来的初始化与广告位写法见 集成快速指南。

方式二：离线包

构建机访问不了外网 Maven 仓库时用这个。

↓

admix-android-sdk-1.0.0.zip

包内：三个 AdMix aar（libs/）＋ 全套对外文档（docs/）＋ 按步骤写的 README.md。不含任何凭证。

离线包里没有穿山甲、优量汇的 SDK —— 这不是漏打

两家的开发者协议禁止把它们的 SDK 提供或转让给第三方 （优量汇《开发者协议》3.4.6 / 9.2、穿山甲《平台服务协议》3.4.2），所以我方不能随包转发。

接哪家就自己取哪家，版本必须一致，适配器是按这两个版本编译并真机验证过的：

广告平台	必须使用的版本	从哪儿取
穿山甲（GroMore 通道）	7.7.1.6	穿山甲后台「SDK 下载」里的融合 SDK（GroMore）；或从 https://artifact.bytedance.com/repository/pangle 取 com/pangle/cn/mediation-sdk/7.7.1.6/mediation-sdk-7.7.1.6.aar
优量汇	4.680.1550	优量汇开发者平台（developers.adnet.qq.com）；或从 Maven Central 取 com/qq/e/union/union/4.680.1550/union-4.680.1550.aar

换版本可能出现找不到方法的崩溃。包内 README.md 里有逐步说明。

历史版本

版本	发布日期	Maven	离线包	说明
1.0.0	2026-09-20	com.admix:*:1.0.0	zip	首个正式发布版

旧版本的 aar 会一直留在 Maven 仓库里，不会被删除；同一个版本号的构件不会被改内容。

还需要什么

东西	从哪来
AppID、App 密钥	平台运营在后台为你的应用生成，登录后台后在「接入指引」页能直接复制
广告位标识（如 splash_main）	同上，「我的应用」里能看到
各广告平台的 appId 与广告位 ID	不需要你填，由平台配置服务下发；SDK 侧没有本地写入口
AppSecret（服务端发奖验签用）	只在生成时显示一次，由平台运营单独交付，只能放在你的服务器上