IMEI 弃用！收下这份保姆级的 OAID 集成教程 原文标题：IMEI 弃用！收下这份保姆级的 OAID 集成教程-阿里云开发者社区

1. 前言

• IMEI 等设备标识符已经被认定为用户隐私的一部分，在非必要的场景获取甚至频繁获取 IMEI，会被认定为违规获取用户信息的行为；

• 从 Android 10 开始，应用无法获取 IMEI、MAC 等设备唯一标识（申请 READ_PRIVILEGED_PHONE_STATE 权限后也可以获取，但这个权限只有系统应用能够获取）。如果应用强行获取，则会获取到 null 信息或发生 SecurityException（取决于 targetSdkVersion）；

• 为了解决这个问题，国家相关部委成立了移动安全联盟 MSA，制定了一套《移动智能终端补充设备标识体系》。因为其中最重要的一个标识符是 OAID 匿名设备标识符，因此也有人把这个体系简称为 OAID。

2. 补充设备标识体系

补充设备标识体系主要分为四层结构：

• UUID 设备唯一标识符 是不依赖于这个体系的，它们在设备出厂时就固化到硬件信息上了，即使恢复出厂设置也不会重置；

• OAID 匿名设备标识 是 UUID 的替代品，在终端首次启动时生成。同一设备的 OAID 相同，因此可以在多个应用之间共享，恢复出厂设置会重置 OAID；

• VAID 开发者匿名设备标识符 是开发者维度的 ID，在应用安装时生成。同一设备上且同一开发者的所有应用 VAID 相同，其他情况 VAID 不同，重新安装应用会重置 VAID；

• AAID 应用匿名设备标识符 是应用沙盘维度的 ID，在应用安装时生成。即使是同一设备且同一个开发者的应用，AAID 也不同，重新安装、清除用户数据会重置 AAID。

3. 准备工作

• 注册 MSA 账号：

根据 MSA 的要求，下载 SDK 和集成文档前需要注册一个企业账户，这一步按照指引提交相关信息和资料即可，一般 1~2 个工作日就可以审核通过。

• 申请 SDK 证书：

从 v1.0.26 开始，SDK 引入了证书校验机制，每个 APP 都需要申请一个证书文件（包名.cert.pem），并且只有包名与证书匹配的 APP 才能正常获取补充设备 ID。默认证书的有效期为 1 年，证书过期也会影响获取补充设备 ID。因此你还需要根据实际场景需要设计证书更新机制，比如在应用中内置一个默认证书，并应用开到期时提前从后台服务器更新证书。申请证书需要向 msa@caict.ac.cn 发送申请邮件，并附带表格 example_batch.csv，例如：

• 下载 SDK 与集成文档：

企业账号注册并审核通过后，就可以从官网下载到相关资料了（因为 MSA 禁止第三方违规分发 SDK，所以小伙伴们还是得自己去下载）。

• 准备 vivo 商城 AppID：

因为 vivo 手机的方案不同，在配置 SDK 时需要用到你的应用在应用商城上申请的 APPID。

4. 集成与封装

• 集成 aar： 依赖 oaid_sdk_x.x.x.aar，具体方法你肯定会了；

• APPID 配置： 将 supplierconfig.json 复制到项目 /main/assets 目录下，并修改里面的 APPID 配置，主要是修改 vivo 的配置，例如：

• 证书配置： 将 包名.cert.pem 证书文件复制到项目 /main/assets 目录下，例如：

• 设置混淆： 配置 SDK 集成文档中列举的混淆配置，具体方法你肯定会了；

• 设置 Gradle 编译选项： 根据你的项目需要，配置 ndk 编译配置，例如：

// ndk {
// abiFilters 'armeabi-v7a', 'x86', 'arm64-v8a', 'x86_64'
// }
splits {
 abi {
 enable true
 reset()
 include 'armeabi-v7a', 'arm64-v8a'
 universalApk true
 }
}
packagingOptions {
 doNotStrip "*/armeabi-v7a/*.so"
 doNotStrip "*/arm64-v8a/*.so"
}
复制代码

• 代码封装： 完成以上集成和配置步骤后，剩下就是调用 SDK 接口获取 OAID 了。官方提供的 Demo 中 DemoHelper 代码质量一般，我简单整理了一版，代码不难，你直接看吧。有一些点要注意下：

• 1、隐私政策授权： 需要确保用户同意《隐私政策》后，再初始化 SDK，懂得都懂；

• 2、初始化时机： 加固版本在调用前需要先 loadLibrary(”msaoaidsec”)，因为加载有延迟，所以官方推荐尽早提前初始化；

• 3、回调时机： MidSdkHelper#InitSdk() 的结果回调可能是同步的，也可能是从异步子线程回调，与 SDK 内部的判断也有关。

IOAIDApi.kt

interface IOAIDApi {
 /**
 * 1. 初始化，确保用户同意《隐私政策》之后，再初始化 OAID SDK
 * 2. 加固版本在调用前必须载入SDK安全库，因为加载有延迟，推荐在 Application 中调用 loadLibrary 方法
 *
 * @param debug 是否调试，debug 状态会开启 SDK 日志输出
 */
 fun init(debug: Boolean)
 /**
 * 获取 ID，回调可能是同步的，也可能是异步的
 */
 @AnyThread
 fun fetchDeviceIds(callback: (OAIDResult) -> Unit)
}
复制代码

OAID.kt

internal class OAID private constructor(
 context: Context
) : IOAIDApi {
 // ApplicationContext
 private val context: Context = context.applicationContext
 /**
 * 证书初始化标记，true：已经初始化
 */
 @Volatile
 private var isCertInit: Boolean = false
 /**
 * 证书是否有效，true：有效
 */
 private var isCertValid: Boolean = false
 /**
 * 证书过期时间，null：证书无效
 */
 private var certExpDate: Date? = null
 /**
 * 调试开关
 */
 private var debug: Boolean = false
 companion object {
 @Volatile
 private var _oaid: IOAIDApi? = null
 @AnyThread
 fun oaid(context: Context): IOAIDApi {
 if (null == _oaid) {
 synchronized(IOAIDApi::class.java) {
 if (null == _oaid) {
 _oaid = OAIDImpl(context)
 }
 }
 }
 return _oaid!!
 }
 }
 override fun init(debug: Boolean) {
 System.loadLibrary("msaoaidsec")
 this.debug = debug
 }
 override fun fetchDeviceIds(callback: (OAIDResult) -> Unit) {
 // 1. 验证与初始化证书
 checkCertValidity()
 // 2.1 提供空信息的 ID 提供器
 val unsupportedIdSupplier = IdSupplierImpl()
 // 2.2 统一的回调接收器
 val listener = IIdentifierListener { supplier: IdSupplier? ->
 supplier?.let {
 // 回调
 callback(
 OAIDResult(
 supplier.isSupported, supplier.isLimited, supplier.oaid, supplier.vaid, supplier.aaid
 )
 )
 }
 }
 if (!isCertValid) {
 // 证书无效，直接回调空信息
 listener.onSupport(unsupportedIdSupplier)
 return
 }
 // 3. 调用 SDK 接口获取 OAID
 val code = try {
 MdidSdkHelper.InitSdk(context, debug, listener)
 } catch (error: Error) {
 error.printStackTrace()
 -1
 }
 // 4. 处理异常情况
 when (code) {
 InfoCode.INIT_ERROR_CERT_ERROR, // 证书未初始化或证书无效，SDK 内部不会回调 onSupport
 InfoCode.INIT_ERROR_DEVICE_NOSUPPORT, // 不支持的设备, SDK 内部不会回调 onSupport
 InfoCode.INIT_ERROR_LOAD_CONFIGFILE, // 加载配置文件出错, SDK 内部不会回调 onSupport
 InfoCode.INIT_ERROR_MANUFACTURER_NOSUPPORT, // 不支持的设备厂商, SDK 内部不会回调 onSupport
 InfoCode.INIT_ERROR_SDK_CALL_ERROR // SDK 调用出错, SDK 内部不会回调 onSupport
 -> {
 // 异常情况，直接回调空信息
 listener.onSupport(unsupportedIdSupplier)
 }
 InfoCode.INIT_INFO_RESULT_DELAY, // 获取接口是异步的，SDK 内部会回调 onSupport
 InfoCode.INIT_INFO_RESULT_OK // 获取接口是同步的，SDK 内部会回调 onSupport
 -> {
 // do nothing
 }
 else -> {
 // do nothing
 }
 }
 }
 /**
 * 验证与初始化证书
 * @return true：证书初始化成功；false：证书初始化失败
 */
 private fun checkCertValidity() {
 /**
 * 从asset文件读取证书内容
 *
 * @return 证书字符串
 */
 fun loadPemFromAssetFile(): String {
 return try {
 // 证书文件名
 val certFileName = context.packageName + ".cert.pem"
 val inputStream = context.assets.open(certFileName)
 val bufferReader = BufferedReader(InputStreamReader(inputStream))
 val builder = StringBuilder()
 var line: String?
 while (bufferReader.readLine().also { line = it } != null) {
 builder.append(line)
 builder.append('\n')
 }
 builder.toString()
 } catch (e: IOException) {
 ""
 }
 }
 /**
 * 解析证书过期时间
 * @return 过期时间，证书不合法时返回 null
 */
 fun getCertExpDate(certStr: String): Date? {
 return try {
 // 证书实体
 val cert = CertificateFactory.getInstance("X.509").generateCertificate(certStr.byteInputStream()) as X509Certificate
 // 验证证书有效性，如果证书过期会抛出异常
 cert.checkValidity()
 cert.notAfter
 } catch (ex: Exception) {
 // 证书无效
 null
 }
 }
 // DCL
 if (isCertInit) {
 // 初始化只需要进行一次，返回上一次的结果
 return
 }
 synchronized(IOAID::class) {
 if (isCertInit) {
 return
 }
 // 证书文件名
 val certStr = loadPemFromAssetFile()
 // 证书过期时间
 certExpDate = getCertExpDate(certStr)
 // TODO 如果你的应用场景对证书有效性要求非常高，可以在这个时机提前下载更新证书
 // 初始化证书，证书只需要初始化一次
 isCertValid = MdidSdkHelper.InitCert(context, certStr)
 isCertInit = true
 }
 }
}
复制代码

5. 其他细节

• 隐私政策（重要）： 因为 OAID 属于第三方 SDK，所以你需要制定使用 SDK 获取 ID 涉及的隐私政策，例如第三方 SDK 列表：

• SDK 提供的接口：

• IdSupplier#isSupported()： 判断设备是否支持补充设备标识符

• IdSupplier#isLimited()： 判断设备是否限制应用获取补充设备标识符

• IdSupplier#getOAID(Context)： 获取 OAID

• IdSupplier#getVAID(Context)： 获取 VAID

• IdSupplier#getAAID(Context)： 获取 AAID

• SDK 是否需要联网？

多数厂商在调用接口时会要求联网，比如获取 VAID、AAID 时需要去厂商后台校验和计算获得

• SDK 内部如何判断是否同一开发者的应用？

VAID 的定义是设备 + 开发者维度的 ID，同一设备上且同一开发者的所有应用 VAID 相同，其他情况 VAID 不同。不同手机厂商在判断是否同一开发者的方式不同，有些是直接通过 AppId 判断，如 vivo；有些是通过应用签名信息判断，如 oppo。基于 AppID 的方案，要求我们在配置文件中填写在应用商城中分配的 AppId（并配置到 assets/supplierconfig.json），基于应用签名的方案，对我们会友好些。

• SDK 是否支持模拟器？

补充设备标识符本质上是厂商提供的能力，因此只有真机支持，模拟器是不支持的。支持的真机列表见 SDK 文档：

—— 图片截图自 MSA 官方文档

• 如何判断证书的有效期？

可以通过代码解析，也可以把证书内容复制到 www.pianyissl.com/tools/cer_d… 在线解析，例如：

不了解数字证书的小伙伴，可以回顾下我们之前的讨论：《加密、摘要、签名、证书，一次说明白!》