Configure el agente de React Native para EAS Build

Si compila la aplicación de React Native con EAS Build, la Generación Nativa Continua (CNG) de Expo regenera las carpetas android/ y ios/ desde cero en cada paso de expo prebuild —tanto a nivel local como en los servidores de compilación de EAS. Esto significa que un archivo newrelic.properties agregado manualmente o una fase de compilación de Xcode Run Script agregada a mano se elimina en la siguiente compilación.

El plug-in de configuración de newrelic-react-native-agent resuelve esto al regenerar la configuración de compilación de New Relic en cada precompilación, de modo que la carga del archivo de mapeo y del mapa de origen de Android y la carga de dSYM y del mapa de origen de iOS sigan funcionando en las compilaciones de EAS. El plug-in lee las credenciales de las variables de entorno en el momento de la compilación y nunca las confirma en el repositorio.

Antes de que empieces

Obtenga lo siguiente de la misma cuenta de New Relic:

• Una clave de API de usuario.
• El token de la aplicación de Android y/o iOS (el mismo token que pasa a NewRelic.startAgent()). Si distribuye en ambas plataformas, necesitará un token por plataforma.

Establecer variables de entorno de EAS

Registre la clave de API de usuario y los tokens de la aplicación como variables de entorno de EAS, con alcance a los entornos con los que compila:

$
eas env:create --environment production --name NEWRELIC_USER_API_KEY --value <YOUR_USER_API_KEY> --visibility sensitive
$
eas env:create --environment production --name NEWRELIC_ANDROID_APP_TOKEN --value <YOUR_ANDROID_APP_TOKEN> --visibility sensitive
$
eas env:create --environment production --name NEWRELIC_IOS_APP_TOKEN --value <YOUR_IOS_APP_TOKEN> --visibility sensitive

Android: carga automática de archivos de mapeo y mapas de origen

Sin configuración adicional, el plug-in lee la clave de API de usuario de NEWRELIC_USER_API_KEY y el token de la aplicación de Android de NEWRELIC_ANDROID_APP_TOKEN, y los escribe en android/app/newrelic.properties en cada precompilación:

{
  "name": "my app",
  "plugins": ["newrelic-react-native-agent"]
}

Esas propiedades son las que leen las tareas de Gradle newrelicMapUploadRelease y newrelicReactNativeSourceMapUploadRelease del agente para autenticar la carga del archivo de mapeo de ProGuard/R8 y el mapa de origen de React Native después de cada compilación de lanzamiento. Para obtener más información sobre cómo funciona esa carga (y cómo realizar la carga manualmente si es necesario), consulte Reporte de errores de JavaScript de React Native.

Si solo se configura una de las dos variables de entorno, el plug-in sigue escribiendo esa única propiedad, y la tarea de Gradle registra cuál falta en lugar de hacer fallar la compilación. Si no se configura ninguna, el plug-in deja newrelic.properties sin cambios y ambas tareas omiten la carga con un mensaje de log.

Utilice nombres de variables de entorno personalizados (Android)

Para obtener la clave y el token de variables de entorno con nombres diferentes, páselos explícitamente:

{
  "name": "my app",
  "plugins": [
    [
      "newrelic-react-native-agent",
      {
        "android": {
          "apiKeyEnvName": "MY_NR_USER_API_KEY",
          "appTokenEnvName": "MY_NR_ANDROID_APP_TOKEN"
        }
      }
    ]
  ]
}

iOS: carga automática de dSYM y source map

A diferencia de Android, los scripts de carga de dSYM y source map de React Native (run-symbol-tool y upload-react-native-sourcemap, de la carpeta dsym-upload-tools) no se incluyen dentro del CocoaPod NewRelicAgent, y normalmente requieren una fase de compilación Run Script agregada a mano en Xcode —lo que no sobrevive a que expo prebuild regenere ios/. En cambio, en cada precompilación, el plug-in:

• Copia ambos scripts en ios/dsym-upload-tools.
• Agrega una fase de compilación Run Script llamada “Upload dSYMs and Source Maps to New Relic” (después de “Bundle React Native code and images”) que los invoca, leyendo las credenciales de las variables de entorno en el momento de la compilación —el script generado solo hace referencia a las credenciales por su nombre y nunca las escribe en un archivo.
• Asegúrese de que la fase “Bundle React Native code and images” exporte SOURCEMAP_FILE, ya que la plantilla predeterminada de Expo no lo establece y, de lo contrario, Expo no generaría el mapa de origen.

Sin configuración adicional, la fase de compilación lee el token de la aplicación de iOS de NEWRELIC_IOS_APP_TOKEN y la clave de API de usuario de NEWRELIC_USER_API_KEY (compartida con el valor predeterminado de Android):

{
  "name": "my app",
  "plugins": ["newrelic-react-native-agent"]
}

Para obtener información sobre lo que hacen estos scripts y cómo funciona la carga de dSYM fuera de Expo, consulte Cargar dSYMs.

Utilice nombres de variables de entorno personalizados (iOS)

Para obtener el token y la clave de variables de entorno con nombres diferentes, páselos explícitamente:

{
  "name": "my app",
  "plugins": [
    [
      "newrelic-react-native-agent",
      {
        "ios": {
          "appTokenEnvName": "MY_NR_IOS_APP_TOKEN",
          "apiKeyEnvName": "MY_NR_USER_API_KEY"
        }
      }
    ]
  ]
}

Verificar la carga

Después de ejecutar una compilación de EAS, revise los registros de compilación de cada plataforma:

• Android: busque las tareas de Gradle newrelicMapUploadRelease y newrelicReactNativeSourceMapUploadRelease en el log. Una ejecución exitosa indica que el archivo de mapeo y el source map se encontraron y cargaron, sin advertencias de configuración faltante.
• iOS: busque el paso del script de ejecución “Upload dSYMs and Source Maps to New Relic”. Si falta una credencial, registra cuál es y omite esa carga (por ejemplo, NEWRELIC_IOS_APP_TOKEN not set, skipping...) en lugar de fallar la compilación. Cuando las credenciales están presentes, registra que está procesando los dSYM y el source map y cargándolos en New Relic.

Una vez que una compilación se realiza correctamente, confirme que el source map realmente llegó a New Relic consultando Listar y eliminar source maps de React Native.

Solucionar problemas