macOS SDK 疑難解答

重要

Visual Studio App Center 已排定於 2025 年 3 月 31 日淘汰。 雖然您可以繼續使用 Visual Studio App Center，直到它完全淘汰為止，但有數個建議您考慮移轉至的建議替代方案。

深入瞭解支持時程表和替代方案。

• Android
• iOS
• macOS
• tvOS
• React Native \(英文\)
• Cordova
• Unity
• Windows
• MAUI/Xamarin

安裝期間的問題

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

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

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

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

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

   [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
   

   AppCenter.logLevel = .verbose
   

   請確定 [App Center SDK 設定成功] 會出現在 資訊 記錄層級 () 的記錄檔中，然後檢查您是否看到 HTTPS 要求記錄。

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

   注意

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

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

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

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

當機不會顯示在入口網站中。

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

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

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

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

   [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
   

   AppCenter.logLevel = .verbose
   

   請確定 [App Center SDK 設定成功] 會出現在 資訊 記錄層級 () 的記錄檔中，然後檢查您是否看到 HTTPS 要求記錄。

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

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

   注意

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

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

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

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

9. 若要檢查 App Center 後端是否收到損毀，請移至分析服務中的 [記錄流程] 區段。 您的當機應該會出現在該處，一旦傳送它。

保護App Center秘密值

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

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

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