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:
- Dê um nome fixo aos caminhos do bundle com
matchBacktracePaths. - Gere sourcemaps do Hermes com
npx expo export --source-maps. - 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.
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çãomatchBacktracePaths 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:
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:.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.
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:
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.
Uma linha de backtrace convertida com um sourcemap enviado, apontando para um arquivo-fonte do app.