Zum Hauptinhalt springen
AppSignal for JavaScript meldet Fehler aus React Native- und Expo-Apps. Melden Sie abgefangene Fehler mit 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:
Eine Sourcemap übersetzt eine Position im Bundle zurück in Ihre Quelldatei, Funktion und Zeilennummer. AppSignal findet die passende Sourcemap anhand des Dateinamens im Backtrace. Hier ist dieser Name auf jedem Gerät und nach jedem Update anders, sodass keine Sourcemap dazu passt. So erhalten Sie lesbare Backtraces:
  1. Geben Sie den Bundle-Pfaden einen festen Namen mit matchBacktracePaths.
  2. Erzeugen Sie Hermes-Sourcemaps mit npx expo export --source-maps.
  3. 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.
Diese Schritte setzen voraus, dass AppSignal for Front-end bereits in Ihrer App installiert ist. Sie basieren auf der Option 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 Option matchBacktracePaths 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:
Die Funktion benennt das Bundle unter iOS in 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:
Der Export schreibt pro Plattform eine Sourcemap mit der Endung .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.
Erzeugen Sie Sourcemaps nicht mit npx react-native bundle --sourcemap-output. Diese Sourcemaps passen nicht zu dem Hermes-Bundle, das eine Expo-App ausführt, sodass AppSignal den Backtrace nicht übersetzen kann.

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:
Wiederholen Sie die Anfrage für iOS mit 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.
Backtrace-Bereich mit der Zeile /src/profile/screens/DevModeSettingsScreen.tsx:68:22.

Eine mit einer hochgeladenen Sourcemap übersetzte Backtrace-Zeile, die auf eine Quelldatei in der App verweist.

Fehlerbehebung

Wenn ältere Fehler noch die Bundle-Pfade anzeigen, ist das zu erwarten. AppSignal wendet Sourcemaps auf Fehler an, die nach dem Upload gemeldet werden. Fehler, die davor gemeldet wurden, behalten ihre ursprünglichen Backtraces. Melden Sie einen neuen Fehler, um Ihre Einrichtung zu prüfen.