• EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Manual de instalación de CocoaPods

Le recomendamos que utilice nuestra instalación guiada para configurar el monitoreo de iOS. Sin embargo, si necesita instalar el agente manualmente, siga los pasos a continuación para instalar el agente New Relic iOS con Cocoapods.

Instala tu aplicación iOS

Como parte del proceso de instalación, New Relic genera automáticamente un token de aplicación. Esta es una cadena hexadecimal de 40 caracteres para autenticar cada aplicación móvil que monitor en New Relic.

Para instalar y configurar su aplicación iOS o tvOS:

  1. Vaya a

    one.newrelic.com

    .

  2. (Si corresponde) De la lista

    Mobile Apps

    , seleccione

    Add a new app

    .

  3. Desde la página

    Get Started

    , seleccione

    iOS

    como plataforma de monitoreo de móviles.

  4. Escriba un nombre para su aplicación móvil y luego seleccione

    Continue

    .

Continúe con los pasos para configurar New Relic para monitoreo de móviles.

Configurar usando Objective-C

Estos procedimientos para configurar su aplicación iOS/tvOS con CocoaPods y Objective-C también aparecen en la página Get Started en New Relic.

  1. En el Podfile de su proyecto, agregue esta línea:

    pod 'NewRelicAgent'
  2. Cierre su proyecto en Xcode, luego abra su terminal y ejecute este comando en el directorio de su proyecto:

    bash
    $
    pod install
  3. Abra su proyecto en Xcode ejecutando este comando en la terminal:

    bash
    $
    open App.xcworkspace
  4. En su archivo AppDelegate.m, agregue este encabezado New Relic :

    #import <NewRelic/NewRelic.h>
  5. En su archivo AppDelegate.m , agregue esta llamada como la primera línea de application:didFinishLaunchingWithOptions, reemplazando APP_TOKEN con su token de aplicación:

    [NewRelic startWithApplicationToken:@"APP_TOKEN"];

    Importante

    El agente debe estar en la primera línea de didFinishLaunchingWithOptions y ejecutarse en el subproceso principal para garantizar una instrumentación adecuada. Iniciar la llamada más tarde, en un subproceso en segundo plano o de forma asincrónica puede provocar un comportamiento inesperado o inestable.

  6. Descargue este repositorio: https://github.com/newrelic/newrelic-ios-agent-spm/archive/refs/heads/main.zip.

  7. Desde el repositorio descargado, copie dsym-upload-tools en la carpeta que contiene su archivo xcodeproject . Ahora debería tener una carpeta que contenga estos archivos:

    • YOUR_PROJECT.xcodeproj
    • dsym-upload-tools/
  8. Según la versión de su agente de iOS, agregue el siguiente script de compilación al Build Phases de su objetivo. Asegúrese de que el script sea el último script de compilación y reemplace APP_TOKEN con el token de su aplicación.

    • Para agente iOS 7.4.0 o superior:
    bash
    $
    ARTIFACT_DIR="${BUILD_DIR%Build/*}"
    $
    SCRIPT=`/usr/bin/find "${SRCROOT}" "${ARTIFACT_DIR}" -type f -name run-symbol-tool | head -n 1`
    $
    /bin/sh "${SCRIPT}" "APP_TOKEN"
    • Para agente iOS 7.3.8 o bajo:
    bash
    $
    SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
    $
    /bin/sh "${SCRIPT}" "APP_TOKEN"
  9. (Opcional) Agregue las siguientes líneas al script de compilación anterior para omitir la carga de símbolos durante la depuración:

    bash
    $
    if [ ${CONFIGURATION} = "Debug" ]; then
    $
    echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"
    $
    exit 0
    $
    fi
  10. Limpie y cree su aplicación, luego ejecútela en el simulador o en otro dispositivo.

Configurar usando Swift

Estos procedimientos para configurar su aplicación iOS/tvOS con CocoaPods y Swift también aparecen en la página Get Started en New Relic.

  1. En el Podfile de su proyecto, agregue la siguiente línea:

    pod 'NewRelicAgent'
  2. Cierre su proyecto en Xcode y actualícelo ejecutando este comando desde la terminal en el directorio de su proyecto:

    bash
    $
    pod install
  3. Abra su proyecto en Xcode ejecutando este comando desde la terminal en el directorio de su proyecto:

    bash
    $
    open App.xcworkspace
  4. En tu AppDelegate.swift, agrega el encabezado New Relic: (si tu aplicación está escrita en SwiftUI, sigue estas instrucciones para agregar un AppDelegate a tu proyecto).

    import NewRelic
  5. En su archivo AppDelegate.swift , agregue esta llamada como la primera línea de application:didFinishLaunchingWithOptions, reemplazando APP_TOKEN con su token de aplicación:

    NewRelic.start(withApplicationToken:"APP_TOKEN")

    Importante

    Para garantizar una instrumentación adecuada, debe llamar al agente en la primera línea de didFinishLaunchingWithOptions() y ejecutar el agente en el hilo principal. Iniciar la llamada más tarde (en un subproceso en segundo plano o de forma asincrónica) puede provocar un comportamiento inesperado o inestable.

  6. Descargue este repositorio: https://github.com/newrelic/newrelic-ios-agent-spm/archive/refs/heads/main.zip.

  7. Desde el repositorio descargado, copie dsym-upload-tools en la carpeta que contiene su archivo xcodeproject . Ahora debería tener una carpeta que contenga estos archivos:

    • YOUR_PROJECT.xcodeproj
    • dsym-upload-tools/
  8. Según la versión de su agente de iOS, agregue el siguiente script de compilación al Build Phases de su objetivo. Asegúrese de que el script sea el último script de compilación y reemplace APP_TOKEN con el token de su aplicación.

    • Para agente iOS 7.4.0 o superior:
    ARTIFACT_DIR="${BUILD_DIR%Build/*}"
    SCRIPT=`/usr/bin/find "${SRCROOT}" "${ARTIFACT_DIR}" -type f -name run-symbol-tool | head -n 1`
    /bin/sh "${SCRIPT}" "APP_TOKEN"
    • Para agente iOS 7.3.8 o bajo:
    SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
    /bin/sh "${SCRIPT}" "APP_TOKEN"
  9. (Opcional) Agregue las siguientes líneas al script de compilación anterior para omitir la carga de símbolos durante la depuración:

    if [ ${CONFIGURATION} = "Debug" ]; then
    echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"
    exit 0
    fi
  10. Limpie y cree su aplicación, luego ejecútela en el simulador o en otro dispositivo.

¿Te ha ayudado este documento con la instalación?

(Opcional) Cambiar el nivel de logging

De forma predeterminada, el agente de iOS inicia sesión en el nivel info . Puedes cambiar el nivel de logs para recopilar más o menos datos. Hay seis niveles de logs admitidos:

  • none
  • error
  • warning
  • info
  • verbose
  • ALL

Importante

Aumente el nivel de logs solo a verbose o superior para la depuración, no para las versiones de lanzamiento.

Para cambiar el nivel de logging en su aplicación, agregue esta llamada a método antes de llamar a NewRelic.start(withApplicationToken):

  • C objetivo:

    [NRLogger setLogLevels:NRLogLevelALL];
  • Swift:

    NRLogger.setLogLevels(NRLogLevelALL.rawValue)
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.