全部產品
Search
文件中心

Mobile Platform as a Service:解決 utdid 衝突

更新時間:Jun 11, 2025

衝突說明

如果您在使用了 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 的應用刪除並重新安裝後,裝置標識、威脅感知的裝置識別碼 會發生變化。

  • 接入舊版本 utdid 的應用升級為接入新版本 utdid 的應用,初次開機後可能會因為 utdid 變化導致移動分析大盤中的新使用者數增加。