> ## 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 com React Native e Expo

> Reporte erros de apps React Native e Expo com o AppSignal for JavaScript e faça upload de sourcemaps do Hermes para que os backtraces apontem para o seu código-fonte.

O AppSignal for JavaScript reporta erros de apps React Native e Expo. Reporte os erros que você captura com [`sendError`](https://docs.appsignal.com/front-end/error-handling). Reporte erros de renderização com o `ErrorBoundary` do [`@appsignal/react`](https://docs.appsignal.com/front-end/integrations/react). O AppSignal for JavaScript reporta apenas erros. Ele não oferece suporte a tracing distribuído.

Um erro é mais fácil de corrigir quando o backtrace aponta para o seu código-fonte. Um app mobile não executa o seu código-fonte diretamente. O Expo compila o seu JavaScript em um bundle [Hermes](https://reactnative.dev/docs/hermes) que é distribuído para cada dispositivo. As linhas do backtrace então apontam para esse bundle no dispositivo do usuário, assim:

```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
```

Um [sourcemap](https://docs.appsignal.com/front-end/sourcemaps.md) converte uma posição no bundle de volta para o seu arquivo-fonte, função e número de linha. O AppSignal encontra o sourcemap certo pelo nome do arquivo no backtrace. Aqui, esse nome é diferente em cada dispositivo e após cada atualização, então nenhum sourcemap corresponde a ele. Para obter backtraces legíveis:

1. [Dê um nome fixo aos caminhos do bundle](#give-the-bundle-paths-a-fixed-name) com `matchBacktracePaths`.
2. [Gere sourcemaps do Hermes](#generate-hermes-sourcemaps) com `npx expo export --source-maps`.
3. [Faça upload dos sourcemaps](#upload-the-sourcemaps) com esse nome fixo.

> [!NOTE]
>
> O [Expo](https://expo.dev/) é um conjunto de ferramentas construído sobre o [React Native](https://reactnative.dev/). Todo app Expo é um app React Native, mas nem todo app React Native usa Expo. Estas etapas são para apps Expo. Os sourcemaps para apps sem Expo ainda não estão documentados.

Estas etapas pressupõem que o AppSignal for Front-end já esteja [instalado](https://docs.appsignal.com/front-end/installation.md) no seu app. Elas dependem da opção `matchBacktracePaths`, que só está disponível nessa biblioteca. O AppSignal for Browser não oferece suporte a essa opção.

## Dê um nome fixo aos caminhos do bundle

A opção [`matchBacktracePaths`](https://docs.appsignal.com/front-end/configuration/options#matchbacktracepaths) reescreve cada caminho do backtrace antes de o erro ser enviado. Adicione uma função que dá ao bundle um nome fixo para cada plataforma:

```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;
    },
  ],
});
```

A função renomeia o bundle para `index.ios.bundle` no iOS e `index.android.bundle` no Android. iOS e Android precisam de nomes diferentes, porque cada plataforma tem o seu próprio sourcemap. Os demais caminhos permanecem inalterados.

O backtrace do início desta página então chega ao AppSignal como `index.android.bundle:1:123456`.

A `revision` deve corresponder à revision com a qual você faz upload dos sourcemaps.

## Gere sourcemaps do Hermes

Apps Expo usam o motor JavaScript Hermes por padrão. Exporte o app com sourcemaps:

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

A exportação grava um sourcemap por plataforma, terminado em `.hbc.map`, em `dist/_expo/static/js/android` e `dist/_expo/static/js/ios`.

Cada arquivo `.hbc.map` combina o sourcemap do Metro com o sourcemap do Hermes, então ele mapeia o bytecode de volta para o seu código-fonte. Você não precisa de um sourcemap separado do Metro.

> [!WARNING]
>
> Não gere sourcemaps com `npx react-native bundle --sourcemap-output`. Os sourcemaps gerados por ele não correspondem ao bundle Hermes que um app Expo executa, então o AppSignal não consegue converter o backtrace.

## Faça upload dos sourcemaps

Faça upload de cada arquivo `.hbc.map` para a [API de sourcemaps](https://docs.appsignal.com/api/sourcemaps.md). Defina `name[]` como o nome que a sua função retorna, e `revision` como a mesma versão do app usada na opção `revision` do seu 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"
```

Repita a requisição para o iOS, com `name[]=index.ios.bundle` e o sourcemap de `dist/_expo/static/js/ios`. Use o nome do app e o ambiente exibidos no AppSignal.

Repita a exportação e o upload para cada build ou atualização que você publicar. Um sourcemap descreve apenas o código a partir do qual foi exportado.

### Verifique o resultado

Reporte um erro de teste a partir do seu app e, em seguida, abra-o no AppSignal. O backtrace mostra os seus arquivos-fonte, funções e números de linha.

![Painel de backtrace mostrando a linha /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)

Uma linha de backtrace convertida com um sourcemap enviado, apontando para um arquivo-fonte do app.

## Solução de problemas

Se erros mais antigos ainda mostram os caminhos do bundle, isso é esperado. O AppSignal aplica os sourcemaps aos erros reportados após o upload. Os erros reportados antes dele mantêm os backtraces originais. Reporte um novo erro para verificar a sua configuração.


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