【Android_CN_OAID】安卓设备唯一标识解决方案，可作为移动安全联盟统一 SDK （miit_mdid_xxx.aar）的替代方案。

Android_CN_OAID

安卓设备唯一标识解决方案，可作为移动安全联盟统一 SDK （miit_mdid_xxx.aar）的替代方案。
注意，这个项目的初衷主要是针对个人开发者的APP，个人开发者使用不了 MSA 的SDK，企业的APP应该去用 MSA 的 SDK。
本项目提供了国内各大手机厂商获取 OAID（开放匿名设备标识）及海外手机平台获取 AAID（安卓广告标识）的便携接口，
另外也提供了 IMEI/MEID、AndroidID、WidevineID、PseudoID、GUID 等常见的设备标识的获取方法。

• GitHub：https://github.com/gzu-liyujiang/Android_CN_OAID
• 码云(GitEE)：https://gitee.com/li_yu_jiang/Android_CN_OAID
• Demo：https://github.com/gzu-liyujiang/Android_CN_OAID/blob/master/demo.apk

接入指引

最新版本参见 JitPack/Android_CN_OAID（更新日志 | JavaDoc）

依赖配置

如果你的项目 Gradle 配置是在 7.0 以下，需要在 build.gradle 文件中加入：

allprojects {
    repositories {
        // JitPack 远程仓库
        maven { url 'https://jitpack.io' }
    }
}

如果你的 Gradle 配置是 7.0 及以上，则需要在 settings.gradle 文件中加入：

dependencyResolutionManagement {
    repositories {
        // JitPack 远程仓库
        maven { url 'https://jitpack.io' }
    }
}

然后直接使用如下依赖即可：

dependencies {
    implementation 'com.github.gzu-liyujiang:Android_CN_OAID:最新版本号'
}

注意事项

• 4.2.5.1 版本以后直接使用了华为官方广告标识服务SDK，与移动安全联盟 SDK 共存 的话可参考如下配置（PS：暂时没太多经历逆向华为的SDK重构包名来共存）：

dependencies {
    implementation('com.github.gzu-liyujiang:Android_CN_OAID:最新版本号') {
        // 如果使用了移动安全联盟SDK，共存的话需排除掉本项目依赖的华为官方广告标识服务SDK，因为移动安全联盟SDK也依赖了华为的SDK
        // 如果华为官方广告标识服务SDK下载失败或编译报错的话，可考虑在 build.gradle 中增加以下配置：
        // repositories { maven {url 'https://developer.huawei.com/repo/'} }
        // runtimeOnly "com.huawei.hms:ads-identifier:3.4.62.300"
        exclude group: 'com.huawei.hms', module: 'ads-identifier' 
    }
}

• 自 4.1.1 开始默认加入了 READ_PHONE_STATE、WRITE_SETTINGS及WRITE_EXTERNAL_STORAGE 权限以便适配低版本安卓系统。
• 为遵循最小必要原则保护用户隐私，若项目中没用到 IMEI 及 GUID，那么可酌情在 AndroidManifest.xml 中加入如下代码移除相关权限：

<manifest>
    <uses-permission android:name="android.permission.READ_PHONE_STATE" tools:node="remove" />
    <uses-permission android:name="android.permission.WRITE_SETTINGS" tools:node="remove" />
</manifest>

• 本库 4.1.1 至 4.1.3 之间的版本 ，若 Gradle 插件未指定 targetSdkVersion 29+，在 Android11+ 设备上可能会导致无法动态申请读写权限问题，参阅 在权限里面加 maxSdkVersion 的用意 。
• Gradle Plugin 4.0.0 及以下版本编译失败解决方案 ，参阅 Missing ‘package’ key attribute on element package 。

代码示例

获取多个可能的设备标识，结合服务端引入拜占庭容错方案得到可靠的稳定的设备唯一标识：

• 第一步：

    // 在`Application#onCreate`里初始化，注意APP合规性，若最终用户未同意隐私政策则不要调用
    @Override
    public void onCreate() {
        super.onCreate();
        if (privacyPolicyAgreed) {
            DeviceIdentifier.register(this);
        }
    }

• 第二步：

         // 获取IMEI，只支持Android 10之前的系统，需要READ_PHONE_STATE权限，可能为空
        DeviceIdentifier.getIMEI(this);
        // 获取安卓ID，可能为空
        DeviceIdentifier.getAndroidID(this);
        // 获取数字版权管理ID，可能为空
        DeviceIdentifier.getWidevineID();
        // 获取伪造ID，根据硬件信息生成，不会为空，有大概率会重复
        DeviceIdentifier.getPseudoID()；
        // 获取GUID，随机生成，不会为空
        DeviceIdentifier.getGUID(this);
        // 是否支持OAID/AAID
        DeviceID.supportedOAID(this);
        // 获取OAID/AAID，同步调用
        DeviceIdentifier.getOAID(this);
        // 获取OAID/AAID，异步回调
        DeviceID.getOAID(this, new IGetter() {
            @Override
            public void onOAIDGetComplete(String result) {
                // 不同厂商的OAID/AAID格式是不一样的，可进行MD5、SHA1之类的哈希运算统一
            }

            @Override
            public void onOAIDGetError(Exception error) {
                // 获取OAID/AAID失败
            }
        });

混淆规则

本库自带consumer-rules.pro如下混淆规则，不混淆厂商的相关接口及类。若通过远程依赖的方式引用，则无需进行额外配置：

-keep class repeackage.com.asus.msa.SupplementaryDID.** { *; }
-keep interface repeackage.com.asus.msa.SupplementaryDID.** { *; }
-keep class repeackage.com.bun.lib.** { *; }
-keep interface repeackage.com.bun.lib.** { *; }
-keep class repeackage.com.heytap.openid.** { *; }
-keep interface repeackage.com.heytap.openid.** { *; }
-keep class repeackage.com.samsung.android.deviceidservice.** { *; }
-keep interface repeackage.com.samsung.android.deviceidservice.** { *; }
-keep class repeackage.com.zui.deviceidservice.** { *; }
-keep interface repeackage.com.zui.deviceidservice.** { *; }
-keep class repeackage.com.coolpad.deviceidsupport.** { *; }
-keep interface repeackage.com.coolpad.deviceidsupport.** { *; }
-keep class repeackage.com.android.creator.** { *; }
-keep interface repeackage.com.android.creator.** { *; }
-keep class repeackage.com.google.android.gms.ads.identifier.internal.** { *; }
-keep interface repeackage.com.google.android.gms.ads.identifier.internal.* { *; }
-keep class com.huawei.hms.ads.** {*; }
-keep interface com.huawei.hms.ads.** {*; }
-keep class repeackage.com.oplus.stdid.** {*; }
-keep interface repeackage.com.oplus.stdid.** {*; }

支持情况

厂商或品牌	系统或框架
华为（Huawei、Honor）	HMS Core 2.6.2+ 、Google Play Service 4.0+
小米（XiaoMi、Redmi、BlackShark）	MIUI 10.2+、Google Play Service 4.0+
维沃（VIVO、IQOO）	Funtouch OS 9+、OriginOS 1.0+、Google Play Service 4.0+
欧珀（OPPO、Realme）	ColorOS 7.0+、Google Play Service 4.0+
三星（Samsung）	Android 10+、Google Play Service 4.0+
联想（Lenovo）	ZUI 11.4+、Google Play Service 4.0+
华硕（ASUS）	Android 10+、Google Play Service 4.0+
魅族（Meizu）	Android 10+、Google Play Service 4.0+
一加（OnePlus）	Android 10+、Google Play Service 4.0+
努比亚（Nubia）	Android 10+、Google Play Service 4.0+
酷派（Coolpad）	CoolOS、Google Play Service 4.0+
酷赛（Coosea ）	Android 10+、Google Play Service 4.0+
卓易（Droi ）	Freeme OS、Google Play Service 4.0+
其他（ZTE、HTC、Motorola、……）	SSUI、Google Play Service 4.0+

注：本项目的 OAID 获取接口主要参考北京数字联盟公开的代码以及逆向分析参考移动安全联盟的 SDK、HUAWEI Ads SDK、小米 DeviceId.jar、Google Play Services SDK 等。

效果预览

参考资料

OAID 是移动智能终端补充设备标识体系中的一员，官方定义为 Open Anonymous Device Identifier（开放匿名设备标识符），
华为称之为 Open Advertising ID （开放广告标识符），谷歌称之为 Android Advertising ID （安卓广告标识符）。

• 逆向分析还原的 手机厂商开放匿名设备标识符获取接口(AIDL) 。
• 移动安全联盟统一 SDK 下载 （from http://www.msa-alliance.cn ）。
• 谷歌官方文档 使用标识符的最佳做法 。
• 团体标准-移动智能终端补充设备标识规范-v20190516.pdf 。
• 华为 广告标识服务 。
• 小米 设备标识体系说明 。
• 魅族 移动智能终端补充设备标识 。
• 维沃 移动智能终端补充设备标识服务 。
• 欧珀 移动智能终端补充设备标识体系 。
• 三星 适配指导 | Android Q Device ID 权限变更 。
• 北京数字联盟公开的获取各厂商 OAID 的代码：Get_Oaid_CNAdid。
• 获取或生成设备唯一标识后，推荐参考“一种 Android 移动设备构造 UDID 的方案 ” 。
• StackOverFlow Is there a unique Android device ID ? 。

远程真机

• 免费 华为远程真机云调试 。
• 免费 小米云测平台远程真机租用 。
• 免费 VIVO 云测平台远程真机 。
• 免费 OPPO 云测平台远程真机 。
• 免费 三星远程开发测试平台真机调试 。
• 新人试用 腾讯 WeTest 云真机调试、阿里 EMAS 移动测试远程真机、百度 MTC 远程真机调试、Testin 远程真机测试、AllTesting 真机测试 。

许可协议

Copyright (c) 2016-present. gzu-liyujiang<1032694760@qq.com> and All Contributors.

The software is licensed under the Mulan PSL v2.
You can use this software according to the terms and conditions of the Mulan PSL v2.
You may obtain a copy of Mulan PSL v2 at:
    http://license.coscl.org.cn/MulanPSL2
THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY OR FIT FOR A PARTICULAR
PURPOSE.
See the Mulan PSL v2 for more details.