> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AppSignal for JavaScript mit React Native und Expo

> Melden Sie Fehler aus React Native- und Expo-Apps mit AppSignal for JavaScript und laden Sie Hermes-Sourcemaps hoch, damit Backtraces auf Ihren Quellcode verweisen.

AppSignal for JavaScript meldet Fehler aus React Native- und Expo-Apps. Melden Sie abgefangene Fehler mit [`sendError`](https://docs.appsignal.com/front-end/error-handling). Melden Sie Render-Fehler mit der `ErrorBoundary` aus [`@appsignal/react`](https://docs.appsignal.com/front-end/integrations/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](https://reactnative.dev/docs/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:

```text Android theme={null}
/data/user/0/com.example.myapp/files/.expo-internal/0123456789abcdef0123456789abcdef:1:123456
```

```text iOS theme={null}
/var/mobile/Containers/Data/Application/00000000-0000-0000-0000-000000000000/Library/Application Support/.expo-internal/abcdef0123456789abcdef0123456789.bundle:1:123456
```

Eine [Sourcemap](https://docs.appsignal.com/front-end/sourcemaps.md) ü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](#give-the-bundle-paths-a-fixed-name) mit `matchBacktracePaths`.
2. [Erzeugen Sie Hermes-Sourcemaps](#generate-hermes-sourcemaps) mit `npx expo export --source-maps`.
3. [Laden Sie die Sourcemaps](#upload-the-sourcemaps) unter diesem festen Namen hoch.

> [!NOTE]
>
> [Expo](https://expo.dev/) ist eine Sammlung von Tools, die auf [React Native](https://reactnative.dev/) 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](https://docs.appsignal.com/front-end/installation.md) 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`](https://docs.appsignal.com/front-end/configuration/options#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:

```typescript TypeScript theme={null}
import Appsignal from "@appsignal/javascript";
import { Platform } from "react-native";

export const appsignal = new Appsignal({
  key: "<your frontend API key>",
  revision: "<your app version>",
  matchBacktracePaths: [
    (path: string) => {
      if (path.includes("/.expo-internal/")) {
        return `index.${Platform.OS}.bundle`;
      }
      return undefined;
    },
  ],
});
```

```javascript JavaScript theme={null}
import Appsignal from "@appsignal/javascript";
import { Platform } from "react-native";

export const appsignal = new Appsignal({
  key: "<your frontend API key>",
  revision: "<your app version>",
  matchBacktracePaths: [
    (path) => {
      if (path.includes("/.expo-internal/")) {
        return `index.${Platform.OS}.bundle`;
      }
      return undefined;
    },
  ],
});
```

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:

```bash Shell theme={null}
npx expo export --source-maps
```

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.

> [!WARNING]
>
> 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](https://docs.appsignal.com/api/sourcemaps.md) 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:

```bash Shell theme={null}
curl --fail -X POST \
  -F "push_api_key=$APPSIGNAL_PUSH_API_KEY" \
  -F "app_name=My App" \
  -F "environment=production" \
  -F "revision=<your app version>" \
  -F "name[]=index.android.bundle" \
  -F "file=@dist/_expo/static/js/android/<name>-<hash>.hbc.map" \
  "https://appsignal.com/api/sourcemaps"
```

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.](https://mintcdn.com/appsignal-715f5a51/mM8bpWloa5M9x6f1/assets/images/screenshots/frontend/react-native-sourcemapped-backtrace.png?fit=max\&auto=format\&n=mM8bpWloa5M9x6f1\&q=85\&s=f661179f98f13a93e1daffdcaacbd099)

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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.