sendError. Melden Sie Render-Fehler mit der ErrorBoundary aus @appsignal/react. AppSignal for JavaScript meldet nur Fehler. Distributed Tracing wird nicht unterstützt.
Ein Fehler lässt sich am einfachsten beheben, wenn sein Backtrace auf Ihren Quellcode verweist. Eine mobile App führt Ihren Quellcode nicht direkt aus. Expo kompiliert Ihr JavaScript in ein Hermes-Bundle, das an jedes Gerät ausgeliefert wird. Die Backtrace-Zeilen verweisen dann auf dieses Bundle auf dem Gerät des Benutzers, etwa so:
- Geben Sie den Bundle-Pfaden einen festen Namen mit
matchBacktracePaths. - Erzeugen Sie Hermes-Sourcemaps mit
npx expo export --source-maps. - Laden Sie die Sourcemaps unter diesem festen Namen hoch.
Expo ist eine Sammlung von Tools, die auf React Native aufbauen. Jede Expo-App ist eine React Native-App, aber nicht jede React Native-App verwendet Expo. Diese Schritte gelten für Expo-Apps. Sourcemaps für Apps ohne Expo sind noch nicht dokumentiert.
matchBacktracePaths, die nur in dieser Bibliothek verfügbar ist. AppSignal for Browser unterstützt diese Option nicht.
Den Bundle-Pfaden einen festen Namen geben
Die OptionmatchBacktracePaths schreibt jeden Backtrace-Pfad um, bevor der Fehler gesendet wird. Fügen Sie eine Funktion hinzu, die dem Bundle für jede Plattform einen festen Namen gibt:
index.ios.bundle und unter Android in index.android.bundle um. iOS und Android benötigen unterschiedliche Namen, da jede Plattform ihre eigene Sourcemap hat. Andere Pfade bleiben unverändert.
Der Backtrace vom Anfang dieser Seite erreicht AppSignal dann als index.android.bundle:1:123456.
Die revision muss mit der Revision übereinstimmen, mit der Sie die Sourcemaps hochladen.
Hermes-Sourcemaps erzeugen
Expo-Apps verwenden standardmäßig die JavaScript-Engine Hermes. Exportieren Sie die App mit Sourcemaps:.hbc.map nach dist/_expo/static/js/android und dist/_expo/static/js/ios.
Jede .hbc.map-Datei kombiniert die Sourcemap von Metro mit der Hermes-Sourcemap und ordnet so den Bytecode Ihrem Quellcode zu. Sie benötigen keine separate Metro-Sourcemap.
Die Sourcemaps hochladen
Laden Sie jede.hbc.map-Datei über die Sourcemaps-API hoch. Setzen Sie name[] auf den Namen, den Ihre Funktion zurückgibt, und revision auf dieselbe App-Version wie die Option revision in Ihrer App:
name[]=index.ios.bundle und der Sourcemap aus dist/_expo/static/js/ios. Verwenden Sie den App-Namen und die Umgebung, die in AppSignal angezeigt werden.
Wiederholen Sie Export und Upload für jeden Build und jedes Update, das Sie ausliefern. Eine Sourcemap beschreibt nur den Code, aus dem sie exportiert wurde.
Das Ergebnis prüfen
Melden Sie einen Testfehler aus Ihrer App und öffnen Sie ihn dann in AppSignal. Der Backtrace zeigt Ihre Quelldateien, Funktionen und Zeilennummern.
Eine mit einer hochgeladenen Sourcemap übersetzte Backtrace-Zeile, die auf eine Quelldatei in der App verweist.