# Android_CN_OAID **Repository Path**: source/Android_CN_OAID ## Basic Information - **Project Name**: Android_CN_OAID - **Description**: 安卓设备唯一标识解决方案，可完全替代移动安全联盟统一 SDK 闭源方案。包括国内手机厂商的开放匿名标识（OAID）、海外手机平台的安卓广告标识（AAID），另外也提供了 AndroidID、GUID 等常见的设备标识的获取方法。 - **Primary Language**: Android - **License**: MulanPSL-2.0 - **Default Branch**: master - **Homepage**: https://github.com/gzu-liyujiang/Android_CN_OAID - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 141 - **Created**: 2022-02-10 - **Last Updated**: 2022-02-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Android_CN_OAID ![Release APK](https://github.com/gzu-liyujiang/Android_CN_OAID/workflows/Release%20APK/badge.svg) ![Gradle Package](https://github.com/gzu-liyujiang/Android_CN_OAID/workflows/Gradle%20Package/badge.svg) 安卓设备唯一标识解决方案，可作为移动安全联盟统一 SDK （miit_mdid_xxx.aar）的替代方案。本项目提供了国内各大手机厂商获取 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` ## 接入指引 最新版本：[![jitpack](https://jitpack.io/v/gzu-liyujiang/Android_CN_OAID.svg)](https://jitpack.io/#gzu-liyujiang/Android_CN_OAID) （[更新日志](/CHANGELOG.md) | [JavaDoc](https://gzu-liyujiang.github.io/Android_CN_OAID/)） ### 依赖配置 ```groovy allprojects { repositories { maven { url 'https://www.jitpack.io' } } } ``` **4.0.0 以前的版本** 不建议再使用，请尽快升级到最新版本。**4.0.0 版本以后重新调整了与移动安全联盟 SDK 共存的方案** ，直接使用如下依赖即可： ```groovy dependencies { implementation 'com.github.gzu-liyujiang:Android_CN_OAID:' } ``` 自 **4.1.1** 开始默认加入了 `READ_PHONE_STATE`、`WRITE_SETTINGS`及`WRITE_EXTERNAL_STORAGE` 权限以便适配低版本安卓系统。 为** 遵循最小必要原则**保护用户隐私，若项目中没用到 IMEI 及 GUID，那么可酌情在 `AndroidManifest.xml` 中加入如下代码移除相关权限： ```xml ``` ### 注意事项 - **本库 4.1.1 至 4.1.3 之间的版本** ，若 Gradle 插件未指定 `targetSdkVersion 29+`，在 Android11+ 设备上可能会导致无法动态申请读写权限问题，参阅 [在权限里面加 maxSdkVersion 的用意](https://github.com/gzu-liyujiang/Android_CN_OAID/issues/25) 。 - **Gradle Plugin 4.0.0 及以下版本编译失败解决方案** ，参阅 [Missing 'package' key attribute on element package](https://github.com/gzu-liyujiang/Android_CN_OAID/issues/26) 。 ### 代码示例 获取多个可能的设备标识，结合服务端引入[拜占庭容错方案](https://juejin.cn/post/6844903952148856839#heading-11)得到可靠的稳定的设备唯一标识： - 第一步： ```text // 在`Application#onCreate`里初始化，注意APP合规性，若最终用户未同意隐私政策则不要调用 @Override public void onCreate() { super.onCreate(); if (privacyPolicyAgreed) { DeviceIdentifier.register(this); } } ``` - 第二步： ```text // 获取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`如下混淆规则，不混淆厂商的相关接口及类。若通过远程依赖的方式引用，则无需进行额外配置： ```proguard -keep class repeackage.com.uodis.opendevice.aidl.** { *; } -keep interface repeackage.com.uodis.opendevice.aidl.** { *; } -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.** { *; } ``` ## 支持情况 | 厂商或品牌 | 系统或框架 | | --------------------------------- | ------------------------------------------------------- | | 华为（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（开放匿名设备标识符） - 华为手机 ![huawei](/screenshot/oaid_huawei.png) - 荣耀手机 ![hono](/screenshot/oaid_honor.png) - 小米手机 ![xiaomi](/screenshot/oaid_xiaomi.png) - 红米手机 ![redmi](/screenshot/oaid_redmi.png) - 黑鲨手机 ![blackshark](/screenshot/oaid_blackshark.png) - 维沃手机 ![vivo_iqoo](/screenshot/oaid_vivo_iqoo.png) - 欧珀手机 ![oppo](/screenshot/oaid_oppo.png) - 真我手机 ![realm](/screenshot/oaid_realme.png) - 三星手机 ![samsung](/screenshot/oaid_samsung.png) - 魅族手机 ![meizu](/screenshot/oaid_meizu.png) - 联想手机 ![lenovo](/screenshot/oaid_lenovo.png) - 一加手机 ![oneplus](/screenshot/oaid_oneplus.png) - 华硕手机 ![asus](/screenshot/oaid_asus.png) - 努比亚机 `待验证` - 酷派手机 `待验证` - 酷赛手机 `待验证` - 卓易手机 `待验证` ### AAID（安卓广告标识符） - 谷歌手机 ![google](/screenshot/aaid_google.png) - 中兴手机 ![zte](/screenshot/aaid_zte.png) - 摩托罗拉 ![motorola](/screenshot/aaid_motorola.png) - 索尼手机 ![sony](/screenshot/aaid_sony.png) - 诺基亚机 ![nokia](/screenshot/aaid_nokia.png) - HTC 手机 ![htc](/screenshot/aaid_htc.png) - LG 手机 ![lge](/screenshot/aaid_lge.png) ### 不支持 OAID 或 AAID - 用户关闭了广告标识符 ![disabled](/screenshot/oaid_disabled.png) - 以下厂商或品牌手机截止`2021年8月26日`已验证尚不支持： ```text 锤子（Smartisan）、360（360）、奇酷（QiKu）、海信（Hisense）、金立（Gionee）、 美图（Meitu）、糖果（SOAP）、格力（Gree）、朵唯（Doov）、优思（Uniscope）、 夏普（SHARP）、乐视（LeTV）、维图（VOTO）、宏碁（Acer）、TCL（TCL）、…… ``` ## 参考资料 OAID 是移动智能终端补充设备标识体系中的一员，官方定义为 Open Anonymous Device Identifier（开放匿名设备标识符）， 华为称之为 Open Advertising ID （开放广告标识符），谷歌称之为 Android Advertising ID （安卓广告标识符）。 - 逆向分析还原的 [手机厂商开放匿名设备标识符获取接口(AIDL)](https://github.com/gzu-liyujiang/Android_CN_OAID/tree/master/aidl) 。 - [移动安全联盟统一 SDK 下载](https://github.com/2tu/msa) （from `http://www.msa-alliance.cn` ）。 - 谷歌官方文档 [使用标识符的最佳做法](https://developer.android.google.cn/training/articles/user-data-ids) 。 - [团体标准-移动智能终端补充设备标识规范-v20190516.pdf](https://swsdl.vivo.com.cn/appstore/developer/uploadfile/20191109/uohz59/%E5%9B%A2%E4%BD%93%E6%A0%87%E5%87%86-%E7%A7%BB%E5%8A%A8%E6%99%BA%E8%83%BD%E7%BB%88%E7%AB%AF%E8%A1%A5%E5%85%85%E8%AE%BE%E5%A4%87%E6%A0%87%E8%AF%86%E8%A7%84%E8%8C%83-v20190516.pdf) 。 - 华为 [开放广告标识符（OAID）](https://developer.huawei.com/consumer/cn/codelab/HMSAdsOAID/index.html#0) 。 - 小米 [设备标识体系说明](https://dev.mi.com/console/doc/detail?pId=1821) 。 - 魅族 [移动智能终端补充设备标识](http://open-wiki.flyme.cn/doc-wiki/index#id?133) 。 - 维沃 [移动智能终端补充设备标识服务](https://dev.vivo.com.cn/documentCenter/doc/253) 。 - 欧珀 [移动智能终端补充设备标识体系](https://open.oppomobile.com/wiki/doc#id=10608) 。 - 三星 [适配指导 | Android Q Device ID 权限变更](https://support-cn.samsung.com/App/DeveloperChina/notice/detail?noticeid=115) 。 - 北京数字联盟公开的获取各厂商 OAID 的代码：[Get_Oaid_CNAdid](https://github.com/shuzilm-open-source/Get_Oaid_CNAdid)。 - 获取或生成设备唯一标识后，推荐参考“[一种 Android 移动设备构造 UDID 的方案](https://github.com/No89757/Udid) ” 。 - StackOverFlow [Is there a unique Android device ID ?](https://stackoverflow.com/questions/2785485/is-there-a-unique-android-device-id) 。 ## 远程真机 - 免费 [华为远程真机云调试](https://developer.huawei.com/consumer/cn/agconnect/cloud-adjust) 。 - 免费 [小米云测平台远程真机租用](https://testit.miui.com/remote) 。 - 免费 [VIVO 云测平台远程真机](https://vcl.vivo.com.cn/#/machine/picking) 。 - 免费 [OPPO 云测平台远程真机](https://open.oppomobile.com/cloudmachine/device/list-plus) 。 - 免费 [三星远程开发测试平台真机调试](http://samsung.smarterapps.cn/index.php?app=home&mod=Index&act=samsung) 。 - 新人试用 ~~腾讯 WeTest 云真机调试、阿里 EMAS 移动测试远程真机、百度 MTC 远程真机调试、Testin 远程真机测试、AllTesting 真机测试~~ 。 ## 许可协议 ```text Copyright (c) 2019-2021 gzu-liyujiang <1032694760@qq.com> 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. ```