MacOS SDK– Problembehandlung

Von Bedeutung

Visual Studio App Center wurde am 31. März 2025 eingestellt, mit Ausnahme der Analyse- und Diagnosefeatures, die bis zum 30. Juni 2026 weiterhin unterstützt werden. Weitere Informationen

• Android
• Ios
• macOS
• tvOS
• React Native
• Einheit
• Fenster
• MAUI/Xamarin

Probleme während der Einrichtung

1. Suchen Sie in der Konsole nach einem Assert-Protokoll mit der Meldung "App Center SDK wurde erfolgreich konfiguriert". Dadurch wird überprüft, ob das SDK erfolgreich konfiguriert ist.
2. Wenn Sie Cocoapods zum Integrieren von App Center in Ihre macOS-App verwenden und auf einen Fehler stoßen, dessen Meldung CocoaPods - Unable to find a specification for AppCenter beinhaltet, führen Sie pod repo update aus, um Ihr lokales Cocoapods-Repository zu aktualisieren und führen Sie dann pod install erneut aus.
3. Wenn Sie die SDK-Binärdateien manuell integrieren, stellen Sie sicher, dass Ihre Module für Ihr Projekt aktiviert sind.

Analysedaten werden nicht im Portal angezeigt.

1. Stellen Sie sicher, dass Sie die SDK-Module ordnungsgemäß integriert haben.

2. Stellen Sie sicher, dass der richtige App-Schlüssel zusammen mit dem start:withServices: Methodenaufruf enthalten ist. Sie können den exakten start:withServices:Code kopieren, indem Sie die App im Portal öffnen und zur Seite " Erste Schritte " navigieren.

3. Wenn Sie die an das Back-End gesendeten Protokolle anzeigen möchten, ändern Sie die Protokollebene in "Ausführlich" in Ihrer Anwendung, und das SDK druckt die Protokolle in der Konsole. Fügen Sie den folgenden Aufruf vor dem SDK-Start ein:

   [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
   

   AppCenter.logLevel = .verbose
   

   Stellen Sie sicher, dass "App Center SDK erfolgreich konfiguriert" in den Protokollen (auf INFO-Protokollebene ) angezeigt wird, und überprüfen Sie dann, ob HTTPS-Anforderungsprotokolle angezeigt werden.

4. Stellen Sie sicher, dass Ihr Gerät online ist und die App über Internetzugriff verfügt.

   Hinweis

   Wenn Ihre App den App-Sandbox verwendet, müssen Sie die Möglichkeit festlegen, eingehende (Server) und ausgehende Verbindungen (Client) zuzulassen, damit die App Zugriff auf das Internet hat. Xcode 9 aktiviert standardmäßig den App-Sandkasten, die Funktionen für eingehende und ausgehende Verbindungen müssen jedoch explizit festgelegt werden.

   Wählen Sie Ihr Projekt im Projektnavigator aus, wählen Sie die Registerkarte "Funktionen " aus, und fügen Sie die Funktionen für eingehende und ausgehende Verbindungen hinzu, wenn Ihre App den Sandkasten verwendet.

5. Manchmal kann es einige Minuten dauern, bis Protokolle im Portal angezeigt werden. Warten Sie einige Zeit, wenn dies der Fall ist.

6. Um zu überprüfen, ob Das App Center-Back-End Ihre Daten erhalten hat, wechseln Sie zum Abschnitt "Protokollfluss " im Analysedienst . Ihre Ereignisse sollten angezeigt werden, sobald sie gesendet wurden.

Abstürze werden nicht im Portal angezeigt.

1. Stellen Sie sicher, dass Sie die SDK-Module ordnungsgemäß integriert haben.

2. Stellen Sie sicher, dass der richtige App-Schlüssel zusammen mit dem start:withServices: Methodenaufruf enthalten ist. Sie können den genauen start:withServices: Code kopieren, indem Sie die App im Portal öffnen und zur Seite " Erste Schritte " navigieren.

3. Starten Sie die App nach einem Absturz neu. Erst nach dem Neustart der App wird das Absturzprotokoll von App Center Crashes weitergeleitet. Außerdem leitet das SDK keine Absturzprotokolle weiter, wenn Sie mit dem Debugger verbunden sind. Stellen Sie sicher, dass der Debugger beim Abstürzen der App nicht verbunden ist.

4. Wenn Sie die an das Back-End gesendeten Protokolle anzeigen möchten, ändern Sie die Protokollebene in "Ausführlich" in Ihrer Anwendung, und das SDK druckt die Protokolle in der Konsole. Fügen Sie den folgenden Aufruf vor dem SDK-Start ein:

   [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
   

   AppCenter.logLevel = .verbose
   

   Stellen Sie sicher, dass "App Center SDK erfolgreich konfiguriert" in den Protokollen (auf INFO-Protokollebene ) angezeigt wird, und überprüfen Sie dann, ob HTTPS-Anforderungsprotokolle angezeigt werden.

5. Verwenden Sie keine anderen Bibliotheken, die Absturzberichterstattungsfunktionen bereitstellen. Sie können nur ein Absturzberichts-SDK in Ihre App integriert haben.

6. Stellen Sie sicher, dass Ihr Gerät online ist und die App über Internetzugriff verfügt.

   Hinweis

   Wenn Ihre App den App-Sandbox verwendet, müssen Sie die Möglichkeit festlegen, eingehende (Server) und ausgehende Verbindungen (Client) zuzulassen, damit die App Zugriff auf das Internet hat. Xcode 9 aktiviert standardmäßig den App-Sandkasten, die Funktionen für eingehende und ausgehende Verbindungen müssen jedoch explizit festgelegt werden.

   Wählen Sie Ihr Projekt im Projektnavigator aus, wählen Sie die Registerkarte "Funktionen " aus, und aktivieren Sie eingehende und ausgehende Verbindungen, wenn Ihre App den Sandkasten verwendet.

7. Manchmal kann es einige Minuten dauern, bis Protokolle im Portal angezeigt werden. Warten Sie einige Zeit, wenn dies der Fall ist.

8. Wenn Sie überprüfen möchten, ob das SDK den Absturz beim nächsten Start der App festgestellt hat, können Sie die API aufrufen, um zu überprüfen, ob die App in der letzten Sitzung abgestürzt ist und eine Warnung anzeigt. Oder Sie können den Absturzrückruf didSucceedSendingErrorReport erweitern, um festzustellen, ob er erfolgreich an den Server gesendet wurde.

9. Um zu überprüfen, ob das App Center-Back-End den Absturz erhalten hat, wechseln Sie zum Abschnitt "Protokollfluss" im Analysedienst. Ihre Abstürze sollten dort angezeigt werden, sobald sie gesendet wurden.

Den Geheimwert des App Centers schützen

Dies app_secret ist ein Bezeichner Ihrer App, es ist erforderlich, zu wissen, für welche App der Datenverkehr gilt, und es kann nicht zum Abrufen oder Bearbeiten vorhandener Daten verwendet werden. Wenn Ihre app_secret Daten verfügbar gemacht werden, besteht das größte Risiko darin, schlechte Daten an Ihre App zu senden, hat aber keine Auswirkungen auf die Sicherheit der Daten.

Um vertrauliche Daten abzurufen, müssen Sie ein App-/ Benutzertoken bereitstellen, das auf der Clientseite generiert wird. Es gibt keine Möglichkeit, Daten auf der Clientseite vollständig sicher zu machen.

Sie können die Sicherheit Ihrer App verbessern, indem Sie eine Umgebungsvariable verwenden, um den geheimen App-Schlüssel in Ihren Code einzufügen. Auf diese Weise ist der geheime Schlüssel in Ihrem Code nicht sichtbar.