Swift gerenciador de pacote manual de instalação

Recomendamos que você use nossa instalação guiada para configurar o monitoramento do iOS. Porém, se você precisar instalar o agente manualmente, siga as etapas abaixo para instalar o agente New Relic iOS com Swift gerenciador de pacote.

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/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 Swift gerenciador de pacote

1. Selecione File > Swift Packages > Add Package Dependency....

2. Adicione o URL do Github do arquivo do pacote:

   https://github.com/newrelic/newrelic-ios-agent-spm

   Copiar

   Dica

   Se você receber um erro artifact of binary target 'NewRelic' failed extraction: The operation couldn’t be completed. (TSCBasic.StringError error 1.) ao extrair o pacote, feche o Xcode, exclua a pasta Dados Derivados, abra novamente o Xcode e tente novamente.

3. Selecione o produto do pacote NewRelic, selecione seu destino e selecione Finish.

4. No arquivo AppDelegate.swift , adicione esta chamada como a primeira linha de applicationDidFinishLaunchWithOptions, substituindo APP_TOKEN pelo token do seu aplicativo: (se o seu aplicativo for escrito em SwiftUI, siga estas instruções para adicionar um AppDelegate ao seu projeto.)

   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.

5. 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"

6. (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

7. Se houver uma caixa de seleção que diz "Executar script: com base na análise de dependência", certifique-se de que esteja desmarcada.

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

Resolução de problemas

Você poderá ver os seguintes erros ao adicionar o pacote Swift:

• O artefato não corresponde à soma de verificação
• Não é possível baixar framework do remoteSourceControl

Se você vir esses tipos de erros, tente o seguinte:

1. Desintegrar o pacote New Relic Swift do projeto Xcode.

2. Execute estes comandos no terminal para excluir caches spm:

   bash

   Copiar

   $
   rm -rf ~/Library/Caches/org.swift.swiftpm
   $
   rm -rf ~/Library/org.swift.swiftpm

3. Exclua dados derivados usando Xcode.

4. Integre novamente o pacote New Relic Swift ao projeto Xcode.

(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):

NRLogger.setLogLevels(NRLogLevelALL.rawValue)