---
title: iOS agent compatibility and requirements
source: https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile-ios/get-started/new-relic-ios-compatibility-requirements
---

Before you [install and configure](https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile-ios/get-started/ios-installation-configuration) the iOS agent, follow these guidelines for compatibility and other requirements.

## Foreground monitoring [#foreground]

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](https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile/get-started/security-mobile-apps).

## iOS requirements [#requirements]

Make sure your iOS app meets these requirements:

| **Component**    | **iOS application requirements**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Operating system | Minimum supported iOS version, by agent version: - Agent version 7.7.7 or higher: iOS 15.0 or higher - Agent versions 7.6.2 through 7.7.6: iOS 15.6 or higher - Agent versions 7.6.0 and 7.6.1: iOS 16 or higher - Agent versions prior to 7.6.0: iOS 10 or higher, except for iOS 15.0 through 15.5 > #### ⚠️ IMPORTANT > > Only agent version 7.7.7 and higher supports iOS 15.0 through iOS 15.5. Every earlier agent version is fully incompatible with those OS versions. If your app supports any of them, use agent version 7.7.7 or higher. Apple no longer supports bitcode-based submissions to the App Store. Bitcode is not supported by our iOS agent. |
| API/SDK          | - NSURLConnection and AFNetworking are supported. - NSURLSession supports `upload` and `data` functions only. - URLSession in Swift supports async `upload` and `data` functions only. - Network traffic for UIWebView and WKWebView is supported. However, WKWebView Transfer size and Http errors are not supported.                                                                                                                                                                                                                                                                                                                                              |
| Languages        | - Objective-C - Swift: Works with both network traces and crash reporting, but no interaction traces by default. Interaction traces must be [enabled for Swift](https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile/getting-started/enabling-interaction-tracing-swift).                                                                                                                                                                                                                                                                                                                                                                              |
| Devices          | Any iOS compatible device: iPhones, iPads, etc.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| File sizes       | The agent adds about 2 to 12 megabytes to your iOS release app, depending on platform build.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Architectures    | ARM 64-bit.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| SHA-2            | As a standard [security measure for data collection](https://docs.newrelic.com/docs/security/new-relic-security/data-privacy/security-controls-privacy), New Relic requires that your application server supports SHA-2 (256-bit). SHA-1 is not supported.                                                                                                                                                                                                                                                                                                                                                                                                          |
| Xcode            | To take advantage of New Relic's iOS features, make sure you have the latest version of [Xcode](https://developer.apple.com/documentation/xcode-release-notes).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| arm64e support   | 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](https://developer.apple.com/documentation/security/preparing_your_app_to_work_with_pointer_authentication?language=objc).                                                                                                                                                                                                                                                                                                                    |
| CocoaPods        | In order to use the latest iOS agent, use CocoaPods version 1.10.1 or higher.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

## tvOS [#tvos]

The iOS agent can monitor tvOS apps. For details, see [tvOS compatibility](https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile-ios/tvos/new-relic-tvos-compatibility-requirements).

## watchOS [#watchos]

The iOS agent can monitor watchOS apps. For details, see [watchOS compatibility](https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile-ios/watchOS/instrument-watchos).

## Testing is not supported [#testing]

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.

## Potential method replacement conflicts [#method]

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, Firebase, Aspects, and AppleGuice.