Unity SDK 疑難解答
重要
Visual Studio App Center 已排定於 2025 年 3 月 31 日淘汰。 雖然您可以繼續使用 Visual Studio App Center,直到它完全淘汰為止,但有數個建議您考慮移轉至的建議替代方案。
分析數據不會顯示在入口網站中
- 請確定您已正確整合 SDK 模組。
- 請確定您的專案已包含已附加
AppCenterBehavior
的 「App Center」 物件,且您的應用程式密碼會新增至 [偵測器] 視窗中的對應欄位。 請務必也核取您想要使用之每個 App Center 服務的 [使用 {service}] 方塊。 - 在 詳細資訊 記錄層級) 中檢查記錄顯示「App Center SDK 已成功設定」 (,然後檢查您是否看到 HTTPS 要求記錄。
- 請確定您的裝置已上線。
- 有時候,記錄可能需要幾分鐘的時間才會出現在入口網站中。 如果是這種情況,請稍候一段時間。
- 若要檢查 App Center 後端是否已收到您的數據,請移至 Analytics 服務中的 [記錄流程 ] 區段。 一旦傳送事件,您的事件應該會出現。
當機不會顯示在入口網站中
- 請確定您已正確整合 SDK 模組。
- 請確定您的專案已包含已附加
AppCenterBehavior
的 「App Center」 物件,且您的應用程式密碼會新增至 [偵測器] 視窗中的對應欄位。 請務必也核取您想要使用之每個 App Center 服務的 [使用 {service}] 方塊。 - 當機後重新啟動應用程式。 App Center 當機只會在重新啟動後轉送損毀記錄檔。 如果您附加調試程式,SDK 將不會儲存任何損毀記錄。 當您損毀應用程式時,請確定調試程式未附加。
- 在 詳細資訊 記錄層級) 中檢查記錄顯示「App Center SDK 已成功設定」 (,然後檢查您是否看到 HTTPS 要求記錄。
- 請確定您的裝置已上線。
- 有時候,記錄可能需要幾分鐘的時間才會出現在入口網站中。 如果是這種情況,請稍候一段時間。
- 如果您想要檢查 SDK 是否在下次應用程式啟動時偵測到當機,您可以呼叫 API 來檢查應用程式是否在最後一個工作階段中當機,並顯示警示。 或者,您可以擴充損毀回呼,以查看它是否已成功傳送至伺服器。
- 若要檢查 App Center 後端是否收到損毀,請移至分析服務中的 [記錄流程 ] 區段。 您的當機應該會出現在該處,一旦傳送它。
- 請確定應用程式實際上已當機並重新啟動:Unity 預設會攔截大部分未處理的例外狀況,這表示應用程式不會結束,而且不會被視為當機。 如果 Unity 攔截損毀,SDK 會回報為「錯誤」。
Android 專案建置失敗
散發模組 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
最大的風險是將數據傳送到您的應用程式,但不會影響數據的安全性。
若要擷取任何敏感數據,您必須提供用戶端產生的應用程式/使用者 令牌。 沒有任何方法可讓用戶端上的數據完全安全。
您可以使用環境變數將應用程式秘密插入程式碼,以改善應用程式的安全性。 如此一來,您的程序代碼中看不到秘密。