Before you install and configure the iOS agent, follow these guidelines for compatibility and other requirements.
The iOS agent only monitors your app while it is in the foreground. The agent does not monitor background services while the app is closed. For more information, see our Mobile data privacy and security documentation.
Make sure your iOS app meets these requirements:
iOS application requirements
iOS 8 or higher
For Bitcode support, use SDK version 5.3.0 or higher.
Any iOS compatible device: iPhones, iPads, etc.
The agent adds about 2 to 12 megabytes to your iOS release app, depending on platform build.
ARM 32-bit or 64-bit.
As a standard security measure for data collection, New Relic requires that your application server supports SHA-2 (256-bit). SHA-1 is not supported.
To take advantage of New Relic's iOS features, make sure you have the latest version of Xcode.
To be able to properly symbolicate crashes from devices with arm64e architectures, make sure your Xcode settings are enabled for pointer authentication. For more information, see the Apple developer documentation.
In order to use the latest XCFramework Agent, use CocoaPods version 1.9 or higher.
Our agents are designed and tested to work in a normal app lifecycle. New Relic does not support running any testing environment on applications with the agent. Testing can cause conflicts and unpredictable behavior.
Our iOS agent utilizes method replacement during run time. This may result in a conflict with other libraries that also implement method replacement, such as ReactiveCocoa, Aspects, and AppleGuice.
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's and and documentation.