共用方式為

macOS SDK 疑難解答

這很重要

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

安裝期間的問題

  1. 在控制台中，尋找訊息為「App Center SDK 已成功設定」的 Assert 日誌記錄。 這會驗證 SDK 是否已順利設定。
  2. 如果您使用 Cocoapods 在 macOS 應用程式中整合 App Center，並出現錯誤訊息 - CocoaPods - Unable to find a specification for AppCenter請執行 pod repo update 以更新本機 Cocoapods 存放庫，然後再執行 pod install 一次。
  3. 如果您要手動整合 SDK 二進位檔，請確定在專案中已啟用您的模組。

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

  1. 請確定您已正確整合 SDK 模組。

  2. 請確保包含正確的應用程式秘密以及 start:withServices: 方法呼叫。 您可以在入口網站中開啟應用程式並流覽至 start:withServices:] 頁面，以複製確切的程序代碼。

  3. 如果您想要查看傳送至後端的記錄，請將記錄層級變更為應用程式中 的 Verbose，SDK 會在 控制台中列印記錄。 在 SDK 啟動之前插入下列呼叫：

    [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

    AppCenter.logLevel = .verbose

    請確定記錄中出現「已成功設定 App Center SDK」（ 在 INFO 記錄層級），然後檢查您是否看到 HTTPS 要求記錄。

  4. 請確定您的裝置已上線，且應用程式可存取因特網。

    備註

    如果您的應用程式使用應用程式沙箱，您必須設定允許連入 （伺服器） 和傳出 （用戶端） 連線的功能，讓應用程式能夠存取因特網。 Xcode 9 預設會啟用應用程式沙箱，但必須明確設定傳入和傳出連線的功能。

    在項目導覽器中選取您的專案，選取 [ 功能 ] 索引卷標，如果您的應用程式使用沙盒，請新增傳入和連出連線的功能。

  5. 有時候，記錄可能需要幾分鐘的時間才會出現在入口網站中。 如果情況如此，請稍候一段時間。

  6. 若要檢查 App Center 後端是否已收到您的數據，請移至 Analytics 服務中的 [記錄流程] 區段。 事件傳送後應立即出現。

事故不會顯示在平台中。

  1. 請確定您已正確整合 SDK 模組。

  2. 請確定包含正確的應用程式密碼以及 start:withServices: 方法呼叫。 您可以在入口網站中開啟應用程式並流覽至 start:withServices:] 頁面，以複製確切的程序代碼。

  3. 當機後重新啟動應用程式。 App Center 損毀 只會在應用程式重新啟動後轉送損毀記錄檔。 此外，如果您附加至調試程式，SDK 將不會轉送任何當機記錄。 當應用程式當機時，請確保偵錯工具未被附加。

  4. 如果您想要查看傳送至後端的記錄，請將記錄層級變更為應用程式中 的 Verbose，SDK 會在 控制台中列印記錄。 在 SDK 啟動之前插入下列呼叫：

    [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

    AppCenter.logLevel = .verbose

    請確定記錄中出現「已成功設定 App Center SDK」（ 在 INFO 記錄層級），然後檢查您是否看到 HTTPS 要求記錄。

  5. 請勿使用任何其他提供崩潰報告功能的函式庫。 您只能在應用程式中整合一個當機報告 SDK。

  6. 請確定您的裝置已上線，且應用程式可存取因特網。

    備註

    如果您的應用程式使用應用程式沙箱，您必須設定允許連入 （伺服器） 和傳出 （用戶端） 連線的功能，讓應用程式能夠存取因特網。 Xcode 9 預設會啟用應用程式沙箱，但必須明確設定傳入和傳出連線的功能。

    在項目導覽器中選取您的專案，選取 [ 功能 ] 索引標籤，如果您的應用程式正在使用沙箱，請啟用傳入和連出連線。

  7. 有時，記錄可能需要幾分鐘的時間才會出現在入口網站中。 如果情況如此，請稍候一段時間。

  8. 如果您想要檢查 SDK 是否偵測到下一個應用程式啟動時當機，您可以呼叫 API 來檢查應用程式是否在最後一個工作階段中當機，並顯示警示。 或者，您可以擴充當機 didSucceedSendingErrorReport 回呼，以查看它是否已成功傳送至伺服器。

  9. 若要檢查 App Center 後端是否收到當機，請移至 Analytics 服務中的 [記錄流程] 區段。 您的當機一旦被傳送，就會出現在那裡。

保護 App Center 機密值

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

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

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

  • Last updated on