Instalação manual do CocoaPods

Recomendamos que você use nossa instalação guiada para configurar o monitoramento do iOS. No entanto, se você precisar instalar o agente manualmente, siga as etapas abaixo para instalar o agente iOS New Relic com Cocoapods.

Instale seu aplicativo iOS

Como parte do processo de instalação, o New Relic gera automaticamente um token de aplicativo. Esta é uma string hexadecimal de 40 caracteres para autenticar cada aplicativo móvel que você monitor no New Relic.

Para instalar e configurar seu aplicativo iOS ou tvOS:

1. Vá para

   one.newrelic.com

   .

2. (Se aplicável) Na lista

   Mobile Apps

   , selecione

   Add a new app

   .

3. Na página

   Get Started

   , selecione

   iOS

   como plataforma para monitoramento de Mobile.

4. Digite um nome para seu aplicativo móvel e selecione

   Continue

   .

Continue com as etapas para configurar o New Relic para monitoramento de Mobile.

Configurar usando Objective-C

Esses procedimentos para configurar seu aplicativo iOS/tvOS com CocoaPods e Objective-C também aparecem na página Get Started do New Relic.

1. No Podfile do seu projeto, adicione esta linha:

   pod 'NewRelicAgent'

   Copiar

2. Feche seu projeto no Xcode, abra seu terminal e execute este comando no diretório do seu projeto:

   bash

   Copiar

   $
   pod install

3. Abra seu projeto no Xcode executando este comando no terminal:

   bash

   Copiar

   $
   open App.xcworkspace

4. Em seu arquivo AppDelegate.m , adicione este cabeçalho New Relic:

   #import <NewRelic/NewRelic.h>

   Copiar

5. No arquivo AppDelegate.m , adicione esta chamada como a primeira linha de application:didFinishLaunchingWithOptions, substituindo APP_TOKEN pelo token do seu aplicativo:

   [NewRelic startWithApplicationToken:@"APP_TOKEN"];

   Copiar

   Importante

   O agente deve estar na primeira linha de didFinishLaunchingWithOptions e ser executado no thread principal para garantir a instrumentação adequada. Iniciar a chamada posteriormente, em um thread em segundo plano ou de forma assíncrona pode causar um comportamento inesperado ou instável.

6. Baixe este repositório: https://github.com/newrelic/newrelic-ios-agent-spm/archive/refs/heads/main.zip.

7. No repositório baixado, copie dsym-upload-tools para a pasta que contém seu arquivo xcodeproject . Agora você deve ter uma pasta contendo estes arquivos:

   • YOUR_PROJECT.xcodeproj
   • dsym-upload-tools/

8. Com base na versão do seu agente iOS, adicione o script de compilação abaixo ao Build Phases do seu destino. Certifique-se de que o script seja o último script de construção e substitua APP_TOKEN pelo token do seu aplicativo.

   • Para agente iOS 7.4.0 ou superior:
   bash

   Copiar

   $
   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 ou inferior:
   bash

   Copiar

   $
   SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
   $
   /bin/sh "${SCRIPT}" "APP_TOKEN"

9. (Opcional) Adicione as seguintes linhas ao seu script de construção acima para ignorar o upload do símbolo durante a depuração:

   bash

   Copiar

   $
   if [ ${CONFIGURATION} = "Debug" ]; then
   $
       echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"
   $
       exit 0
   $
   fi

10. Limpe e crie seu aplicativo e execute-o no simulador ou em outro dispositivo.

Configurar usando Swift

Esses procedimentos para configurar seu aplicativo iOS/tvOS com CocoaPods e Swift também aparecem na página Get Started do New Relic.

1. No Podfile do seu projeto, adicione a seguinte linha:

   pod 'NewRelicAgent'

   Copiar

2. Feche seu projeto no Xcode e atualize-o executando este comando no terminal no diretório do seu projeto:

   bash

   Copiar

   $
   pod install

3. Abra seu projeto no Xcode executando este comando no terminal no diretório do seu projeto:

   bash

   Copiar

   $
   open App.xcworkspace

4. Em seu AppDelegate.swift, adicione o cabeçalho New Relic: (se seu aplicativo for escrito em SwiftUI, siga estas instruções para adicionar um AppDelegate ao seu projeto.)

   import NewRelic

   Copiar

5. No arquivo AppDelegate.swift , adicione esta chamada como a primeira linha de application:didFinishLaunchingWithOptions, substituindo APP_TOKEN pelo token do seu aplicativo:

   NewRelic.start(withApplicationToken:"APP_TOKEN")

   Copiar

   Importante

   Para garantir a instrumentação adequada, você deve chamar o agente na primeira linha de didFinishLaunchingWithOptions() e executar o agente no thread principal. Iniciar a chamada posteriormente (em um thread em segundo plano ou de forma assíncrona) pode causar um comportamento inesperado ou instável.

6. Baixe este repositório: https://github.com/newrelic/newrelic-ios-agent-spm/archive/refs/heads/main.zip.

7. No repositório baixado, copie dsym-upload-tools para a pasta que contém seu arquivo xcodeproject . Agora você deve ter uma pasta contendo estes arquivos:

   • YOUR_PROJECT.xcodeproj
   • dsym-upload-tools/

8. Com base na versão do seu agente iOS, adicione o script de compilação abaixo ao Build Phases do seu destino. Certifique-se de que o script seja o último script de construção e substitua APP_TOKEN pelo token do seu aplicativo.

   • Para agente iOS 7.4.0 ou 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"

   Copiar
   • Para agente iOS 7.3.8 ou inferior:

   SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
   /bin/sh "${SCRIPT}" "APP_TOKEN"

   Copiar

9. (Opcional) Adicione as seguintes linhas ao seu script de construção acima para ignorar o upload do símbolo durante a depuração:

   if [ ${CONFIGURATION} = "Debug" ]; then
       echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"
       exit 0
   fi

   Copiar

10. Limpe e crie seu aplicativo e execute-o no simulador ou em outro dispositivo.

(Opcional) Altere o nível de registro

Por padrão, o registro do agente iOS está no nível info . você pode alterar o nível de log para coletar mais ou menos dados. Existem seis níveis de log suportados:

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

Para alterar o nível de registro em seu aplicativo, adicione esta chamada de método antes de chamar NewRelic.start(withApplicationToken):

• Objetivo-c:

  [NRLogger setLogLevels:NRLogLevelALL];

  Copiar

• Swift:

  NRLogger.setLogLevels(NRLogLevelALL.rawValue)

  Copiar