解决 utdid 冲突

冲突说明

如果您在使用了 mPaaS 的同时也使用了阿里系 SDK,可能会遇到 utdid 冲突。当您遇到此种情况,请参考以下解决方案。

解决办法

移除 mPaaS utdid 库,使用其他阿里系 SDK 提供的 utdid。

操作步骤

  1. 确认 mPaaS 所使用的 utdid SDK 的版本,以便您选取相同或相近的版本。

    'com.taobao.android:utdid4all:1.5.1.3@jar'
  2. 获取 mPaaS 所使用的 utdid SDK 的 group:artifact 信息。

    'com.alipay.android.phone.thirdparty:utdid-build'
  3. 移除 mPaaS utdid SDK。

    • AAR 方式

      configurations {
      all*.exclude group:'com.alipay.android.phone.thirdparty', module: 'utdid-build'
      }
    • 组件化(Portal & Bundle)方式

      mpaascomponents {
      excludeDependencies = [
         "com.alipay.android.phone.thirdparty:utdid-build"
      ]
      }
  4. 加入接口包。

    • 10.1.68.8 及以下基线如果您使用了 utdid 相关的 API,请下载 jar 包 utdid-build-1.1.5.3-api.jar.zip,并引入 compile/implementation 到工程参与编译。

    • 10.1.68.9 及以上基线无需任何操作。

隐私合规

旧版本 utdid 存在读写 SD 卡行为。如果您需要完全禁止 utdid 的此类行为,请参考以下步骤更新 utdid 版本。

操作步骤

  1. 按照上述冲突解决方案移除 mPaaS utdid 库。

  2. 使用以下版本的 utdid,该版本移除了读写 SD 卡行为。

    implementation "com.taobao.android:utdid4all:1.5.3.1@jar"
  3. (可选)如果您属于私有云用户,且接入了移动分析,您可能需要在 AndroidManifest.xml 中 application 节点下添加以下配置。

    <meta-data
        android:name="use.utdid.1531"
        android:value="on" />
    说明

    请联系 mPaaS 支持人员确定是否需要添加该配置。

变更影响

使用新版本 utdid 后,由于不再读写 SD 卡,以下组件可能受到影响:

  • 接入新版本 utdid 的应用删除并重新安装后,设备标识、威胁感知的设备 ID 会发生变化。

  • 接入旧版本 utdid 的应用升级为接入新版本 utdid 的应用,首次启动后可能会因为 utdid 变化导致移动分析大盘中的新用户数增加。