Pular para o conteúdo principal
O AppSignal for JavaScript reporta erros de apps React Native e Expo. Reporte os erros que você captura com sendError. Reporte erros de renderização com o ErrorBoundary do @appsignal/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 que é distribuído para cada dispositivo. As linhas do backtrace então apontam para esse bundle no dispositivo do usuário, assim:
Um sourcemap 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 com matchBacktracePaths.
  2. Gere sourcemaps do Hermes com npx expo export --source-maps.
  3. Faça upload dos sourcemaps com esse nome fixo.
O Expo é um conjunto de ferramentas construído sobre o React Native. 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 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 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:
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:
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.
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. 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:
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.

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.