Was macht sentry-cocoa-sdk?
Vollständige Sentry-SDK-Einrichtung für Apple-Plattformen (iOS, macOS, tvOS, watchOS, visionOS). Verwenden Sie dies, wenn Sie aufgefordert werden, „Sentry zu iOS hinzufügen“, „Sentry zu Swift hinzufügen“, „sentry-cocoa installieren“ oder die Fehlerüberwachung, Ablaufverfolgung, Profilerstellung, Sitzungswiederholung, Protokollierung oder Metriken für Apple-Anwendungen zu konfigurieren. Unterstützt SwiftUI und UIKit.
Installation
Fügen Sie das Sentry-Cocoa-SDK mit dem Swift Package Manager oder CocoaPods zu Ihrem Projekt hinzu.
Swift Package Manager
- Öffnen Sie Ihr Projekt in Xcode.
- Navigieren Sie zu Datei > Paketabhängigkeiten hinzufügen.
- Geben Sie die Repository-URL ein:
https://github.com/getsentry/sentry-cocoa - Wählen Sie die gewünschte Version aus und fügen Sie das Paket zu Ihrem Ziel hinzu.
CocoaPods
Fügen Sie die folgende Zeile zu Ihrer Podfile-Datei hinzu:
pod 'Sentry'
Führen Sie dann pod install aus.
Initialisierung
Importieren Sie das Sentry-Modul und initialisieren Sie das SDK mit Ihrem DSN:
import Sentry
// In Ihrem AppDelegate (UIKit) oder App-Initialisierer (SwiftUI)
SentrySDK.start { options in
options.dsn = "https://[email protected]/0"
options.debug = true // Aktivieren für Debug-Protokolle während der Entwicklung
}
Optionale Konfiguration
Aktivieren Sie bei Bedarf Performance-Tracing und Sitzungswiederholung:
SentrySDK.start { options in
options.dsn = "https://[email protected]/0"
// Performance
options.tracesSampleRate = 1.0 // 0.0 bis 1.0 (1.0 = 100 %)
// Sitzungswiederholung
options.sessionReplay.sessionSampleRate = 0.1 // 10 %
options.sessionReplay.onErrorSampleRate = 1.0 // 100 % bei Fehlern
// Profiling
options.profilesSampleRate = 0.5 // 50 %
}
Benutzerdefinierte Ereignisse
Senden Sie benutzerdefinierte Fehler oder Nachrichten:
SentrySDK.capture(error: myNSError)
SentrySDK.capture(message: "Etwas ist schiefgelaufen")
Weitere Informationen
Detaillierte Dokumentation finden Sie im offiziellen Sentry-Cocoa-Leitfaden.