Installation manuelle de CocoaPods

Nous vous recommandons d'utiliser notre guide d'installation pour configurer monitoring iOS. Cependant, si vous devez installer l'agent manuellement, suivez les étapes ci-dessous pour installer l'agent New Relic iOS avec Cocoapods.

Installez votre application iOS

Dans le cadre du processus d'installation, New Relic génère automatiquement un jeton d'application. Il s'agit d'une chaîne hexadécimale de 40 caractères permettant d'authentifier chaque application mobile que vous monitorez dans New Relic.

Pour installer et configurer votre application iOS ou tvOS :

1. Allez à one.newrelic.com.
2. (Le cas échéant) Dans la liste Mobile Apps , sélectionnez Add a new app.
3. Depuis la page Get Started, sélectionnez iOS comme plateforme de monitoring des applications mobiles.
4. Saisissez un nom pour votre application mobile, puis sélectionnez Continue.

Continuez avec les étapes pour configurer New Relic pour monitoring des applications mobiles.

Configurer avec Objective-C

Ces procédures pour configurer votre application iOS/tvOS avec CocoaPods et Objective-C apparaissent également sur la page Get Started dans New Relic.

1. Dans le Podfile de votre projet, ajoutez cette ligne :

   pod 'NewRelicAgent'

   Copier

2. Fermez votre projet dans Xcode, puis ouvrez votre terminal et exécutez cette commande dans le répertoire de votre projet :

   bash

   Copier

   $
   pod install

3. Ouvrez votre projet dans Xcode en exécutant cette commande dans le terminal :

   bash

   Copier

   $
   open App.xcworkspace

4. Dans votre fichier AppDelegate.m , ajoutez cet en-tête New Relic :

   #import <NewRelic/NewRelic.h>

   Copier

5. Dans votre fichier AppDelegate.m , ajoutez cet appel comme première ligne de application:didFinishLaunchingWithOptions, en remplaçant APP_TOKEN par votre jeton d'application:

   [NewRelic startWithApplicationToken:@"APP_TOKEN"];

   Copier

   Important

   L'agent doit être sur la première ligne de didFinishLaunchingWithOptions et s'exécuter sur le thread principal pour garantir une instrumentation appropriée. Démarrer l'appel ultérieurement, sur un thread d'arrière-plan ou de manière asynchrone peut provoquer un comportement inattendu ou instable.

6. Téléchargez ce référentiel (dépôt) : https://github.com/newrelic/newrelic-ios-agent-spm/archive/refs/heads/main.zip.

7. Depuis le référentiel téléchargé, copiez dsym-upload-tools dans le dossier qui contient votre fichier xcodeproject . Vous devriez maintenant avoir un dossier contenant ces fichiers :

   • YOUR_PROJECT.xcodeproj
   • dsym-upload-tools/

8. En fonction de la version de votre agent iOS, ajoutez le script de build ci-dessous au Build Phases de votre cible. Assurez-vous que le script est le tout dernier script de build et remplacez APP_TOKEN par votre jeton d'application.

   • Pour l'agent iOS 7.4.0 ou supérieur :
   bash

   Copier

   $
   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"

   • Pour l'agent iOS 7.3.8 ou moins :
   bash

   Copier

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

9. (Facultatif) Ajoutez les lignes suivantes à votre script de construction ci-dessus pour ignorer le téléchargement de symboles pendant le débogage :

   bash

   Copier

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

10. Nettoyez et créez votre application, puis exécutez-la dans le simulateur ou sur un autre appareil.

Configurer avec Swift

Ces procédures pour configurer votre application iOS/tvOS avec CocoaPods et Swift apparaissent également sur la page Get Started dans New Relic.

1. Dans le Podfile de votre projet, ajoutez la ligne suivante :

   pod 'NewRelicAgent'

   Copier

2. Fermez votre projet dans Xcode et mettez-le à jour en exécutant cette commande depuis le terminal dans le répertoire de votre projet :

   bash

   Copier

   $
   pod install

3. Ouvrez votre projet dans Xcode en exécutant cette commande depuis le terminal dans le répertoire de votre projet :

   bash

   Copier

   $
   open App.xcworkspace

4. Dans votre AppDelegate.swift, ajoutez l'en-tête New Relic : (Si votre application est écrite en SwiftUI, suivez ces instructions pour ajouter un AppDelegate à votre projet.)

   import NewRelic

   Copier

5. Dans votre fichier AppDelegate.swift , ajoutez cet appel comme première ligne de application:didFinishLaunchingWithOptions, en remplaçant APP_TOKEN par votre jeton d'application:

   NewRelic.start(withApplicationToken:"APP_TOKEN")

   Copier

   Important

   Pour garantir une instrumentation appropriée, vous devez appeler l'agent sur la première ligne de didFinishLaunchingWithOptions() et exécuter l'agent sur le thread principal. Démarrer l'appel ultérieurement (sur un thread d'arrière-plan ou de manière asynchrone) peut provoquer un comportement inattendu ou instable.

6. Téléchargez ce référentiel (dépôt) : https://github.com/newrelic/newrelic-ios-agent-spm/archive/refs/heads/main.zip.

7. Depuis le référentiel téléchargé, copiez dsym-upload-tools dans le dossier qui contient votre fichier xcodeproject . Vous devriez maintenant avoir un dossier contenant ces fichiers :

   • YOUR_PROJECT.xcodeproj
   • dsym-upload-tools/

8. En fonction de la version de votre agent iOS, ajoutez le script de build ci-dessous au Build Phases de votre cible. Assurez-vous que le script est le tout dernier script de build et remplacez APP_TOKEN par votre jeton d'application.

   • Pour l'agent iOS 7.4.0 ou supérieur :

   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"

   Copier
   • Pour l'agent iOS 7.3.8 ou moins :

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

   Copier

9. (Facultatif) Ajoutez les lignes suivantes à votre script de construction ci-dessus pour ignorer le téléchargement de symboles pendant le débogage :

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

   Copier

10. Nettoyez et créez votre application, puis exécutez-la dans le simulateur ou sur un autre appareil.

(Facultatif) Modifier le niveau de logging

Par défaut, l'agent iOS se connecte au niveau info . vous pouvez modifier le niveau de log pour collecter plus ou moins de données. Il existe six niveaux de log pris en charge :

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

Pour modifier le niveau de logging dans votre application, ajoutez cet appel de méthode avant d'appeler NewRelic.start(withApplicationToken):

• Objectif-c :

  [NRLogger setLogLevels:NRLogLevelALL];

  Copier

• Swift:

  NRLogger.setLogLevels(NRLogLevelALL.rawValue)

  Copier