Unity SDK 疑難解答

這很重要

Visual Studio App Center 於 2025 年 3 月 31 日淘汰，但分析和診斷功能除外，這些功能將持續支援到 2026 年 6 月 30 日。 瞭解更多資訊。

• 安卓
• iOS
• macOS
• tvOS
• React Native
• 統一
• Windows 作業系統
• MAUI/Xamarin

分析數據不會顯示在入口網站中

1. 請確定您已正確整合 SDK 模組。
2. 請確定您的專案已包含已附加 AppCenterBehavior 的 「App Center」 物件，且您的應用程式秘密會新增至偵測器視窗中的對應欄位。 請務必也勾選您想使用的每個 App Center 服務的 [{service}] 方塊。
3. 檢查記錄顯示「App Center SDK 已成功設定」（在 詳細資訊 記錄層級中），然後檢查您是否看到 HTTPS 要求記錄。
4. 請確定您的裝置已上線。
5. 有時，記錄可能需要幾分鐘的時間才會出現在入口網站中。 如果情況如此，請稍候一段時間。
6. 若要檢查 App Center 後端是否收到您的數據，請移至 Analytics 服務中的 [記錄流程 ] 區段。 事件傳送後應立即出現。

當機未顯示在入口網站中

1. 請確定您已正確整合 SDK 模組。
2. 請確定您的專案已包含已附加 AppCenterBehavior 的 「App Center」 物件，且您的應用程式秘密會新增至偵測器視窗中的對應欄位。 請務必也勾選您想使用的每個 App Center 服務的 [{service}] 方塊。
3. 當機後重新啟動應用程式。 App Center 損毀只會在重新啟動後轉送損毀記錄檔。 如果您附加調試程式，SDK 將不會儲存任何當機記錄檔。 當應用程式當機時，請確保偵錯工具未被附加。
4. 檢查記錄顯示「App Center SDK 已成功設定」（在 詳細資訊 記錄層級中），然後檢查您是否看到 HTTPS 要求記錄。
5. 請確定您的裝置已上線。
6. 有時，記錄可能需要幾分鐘的時間才會出現在入口網站中。 如果情況如此，請稍候一段時間。
7. 如果您想要檢查 SDK 是否偵測到下一個應用程式啟動時當機，您可以呼叫 API 來檢查應用程式是否在最後一個工作階段中當機，並顯示警示。 或者，您可以擴充當機回呼，以查看它是否已成功傳送至伺服器。
8. 若要檢查 App Center 後端是否收到當機，請移至 Analytics 服務中的 [記錄流程 ] 區段。 您的當機一旦被傳送，就會出現在那裡。
9. 請確定應用程式實際上已當機並重新啟動：Unity 預設會攔截大部分未處理的例外狀況，這表示應用程式不會結束，而且不會被視為當機。 如果 Unity 捕捉到當機，SDK 會將其報告為「錯誤」。

Android 專案建置失敗

Distribute 模組 4.1.0 版或更新版本新增了一個用於支援 Android 11 的指令清單標記。 如果您使用先前 2019.4 版本的 Unity，您應該明確指定 gradle 版本以避免發生錯誤 AAPT: error: unexpected element <queries> found in <manifest>.。 若要避免建置項目時發生問題，您必須新增 mainTemplate.gradle 和 launcherTemplate.gradle （只有當您使用 Unity 2019.4） 檔案來明確指定 gradle 版本時，才應該新增此檔案。 請開啟 專案設定>播放器>Android 索引標籤>發佈設定>建置，然後選取 自定義主要 Gradle 範本 和 自定義啟動器 Gradle 範本。 產生檔案之後，請在檔案頂端插入下列幾行：

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.4.3'
    }
}

allprojects {
   repositories {
      google()
      mavenCentral()
      flatDir {
        dirs 'libs'
      }
   }
}

了解更多關於 在 Unity 中為 Android 11 建置的指導方針。

保護 App Center 機密值

app_secret是應用程式的標識碼，必須知道流量套用到哪個應用程式，而且無法用來擷取或編輯現有數據。 如果您的app_secret被曝露，最大的風險是將錯誤資料傳送至您的應用程式，但是不會影響資料的安全性。

若要擷取任何敏感數據，您必須提供用戶端上產生的應用程式/使用者 令牌。 無法讓客戶端上的數據完全安全。

您可以使用環境變數將應用程式秘密插入程式碼，以改善應用程式的安全性。 如此一來，您的程式代碼中就看不到秘密。