iOS agent release notes

iOS agent v1.300

Wed, 13 Mar 2013 00:00:00 +0000

Notes

Happy Pi Day!
Welcome to New Relic for Mobile Apps, we're glad to have you aboard.

iOS agent v1.354

Fri, 28 Jun 2013 00:00:00 +0000

Notes

This release fixes several customer-reported performance problems when using New Relic for iOS

prevents agent from adding duplicate X-NewRelic-ID headers to outgoing requests
prevents agent from interfering with HTTP cacheing
fixes potential crash if available heap space is exhausted

iOS agent v1.342

Fri, 31 May 2013 00:00:00 +0000

Notes

Stability Release

This release addresses a potential floating point exception in NRStatsEngine triggered by a race condition.

ASIHttpRequest Improvement

This release adds mobile-server correlation of HTTP requests when using the ASIHttpRequest library. Previously these requests would not be linked to the corresponding transaction in the application server view.

iOS agent v1.376

Tue, 17 Sep 2013 00:00:00 +0000

Notes

Bug fix release

Removes an Apple app store submission false-positive warning about accessing private APIs
Fixes an occasional block retain-related crash when handling UIWebView-initiated network requests on iOS 6

iOS agent v1.328

Mon, 22 Apr 2013 00:00:00 +0000

Notes

Fixes

Improve performance of certain concurrent networking operations in iOS 6
Correct errors effecting certain uses of UIWebView AJAX activity
Remove dependency on NSJSONSerialization when app is run on iOS 4
Prevent situation where some HTTP redirects were not reported to application

iOS agent v3.154

Mon, 16 Dec 2013 00:00:00 +0000

Notes

Improvements

Added explanation to missing CFBundleVersion/CFBundleShortVersion String exception

Fixes

-setThreadLocalTrace: crash fixed
UIImage -imageFromData: crash fixed
other various bug fixes

iOS agent v1.396

Fri, 22 Nov 2013 00:00:00 +0000

Notes

Fixes

Fixes occasional crashes in NRURLProtocol.

iOS agent v3.130

Mon, 02 Dec 2013 00:00:00 +0000

Notes

Features

End to end instrumentation for your mobile applications.
Automatic instrumentation of important system objects and methods.
Customizability to allow for instrumentation of your most important objects and methods.

iOS agent v3.174

Wed, 08 Jan 2014 00:00:00 +0000

Notes

Improvements

Supports C++ linkage. For projects using C++, the New Relic library now properly marks our exported symbols as requiring C linkage.

Fixes

Corrects an issue where data might cease reporting to New Relic after app has been running for 60 seconds.
Fixes an issue that could cause incorrectly sized UIImages or repeating icons.

iOS agent v3.252

Wed, 26 Feb 2014 00:00:00 +0000

Notes

This release is a recommended upgrade for all iOS SDK users.

Improvements

Agent stability & self-management. Critical sections of the agent have been isolated to prevent agent-related errors from destabilizing the host application, and certain classes of errors will be automatically reported to New Relic without the need for customer-initiated communication.
Performance tuning. Overhead for on-device code tracing has been reduced by over 50% in some cases. The agent will consume less CPU time on the mobile device, resulting in improved application responsiveness and lower battery drain.
Improved data accuracy. Under certain conditions it was possible for the SDK to record total time for method invocations but not record the associated exclusive time. This improvement will result in more accurate breakdown charts and tables, and improve the collection of certain interaction traces.

Fixes

This release resolves multiple stability issues in the SDK. We recommend this release for any customers who have encountered application crashes with previous SDK versions.

iOS agent v3.184

Tue, 21 Jan 2014 00:00:00 +0000

Notes

Improvements

ARM64 support - you can now compile New Relic in your native 64-bit applications.
Improved sub-millisecond timing resolution on method tracing. Blame breakdowns and interaction traces will now have improved "total time" and "total exclusive time" measurements.

Fixes

Resolves a crashing timing-related issue in method tracing. Relevant exceptions include note of "object cannot be nil" or "setObject:forKey:" with a nil value.
Resolves several stability and accuracy issues in the NRTimer class.

iOS agent v3.196

Fri, 31 Jan 2014 00:00:00 +0000

Notes

Fixes

Resolves NRURLProtocol crashes for non-webView network requests.
Large file uploads should no longer timeout after the default timeout period while there is network activity.

iOS agent v3.256

Fri, 07 Mar 2014 00:00:00 +0000

Notes

Improvements

Created a workaround for no-network-activity bug that occurs when New Relic and Crittercism are installed simultaneously.

Fixes

Fixed memory leak in NRTraceMachine

iOS agent v3.257

Tue, 11 Mar 2014 00:00:00 +0000

Notes

Fixes

Interaction traces will properly terminate on app closing. This avoids certain edge cases where the interaction will resume on app launch and create an Interaction that spans the length of time the app was backgrounded.

iOS agent v3.289

Wed, 26 Mar 2014 00:00:00 +0000

Notes

Fixes

Fixes a sporadic crash triggered by xpc_mach_port activity in the application after a call to read thread CPU usage fails. Also appears as a crash triggered by the SCReachability system API.
Fixes an issue where certain class inheritance hierarchies may cause a grandparent class's implementation of an instrumented method to be invoked multiple times.
Fixes a crash related to enabling both Verbose mode and File Output mode in the New Relic SDK.

iOS agent v3.311

Mon, 05 May 2014 00:00:00 +0000

Notes

Improvements

NSURLSession Instrumentation Beta

The iOS agent now instruments NSURLSessions. Specifically, network requests created with NSURLSessionDataTask and NSURLSessionUploadTask. Network requests made using these objects will appear in the Mobile UI under the Network tab along with previously instrumented network requests.

This feature is disabled by default. It can be enabled via the new configuration flags.
Configuration Flags Allow users to enable/disable New Relic features. This feature specifically added for Beta NSURLSession support, which is, by default, disabled.

Fixes

Agent will no longer produces garbled server response bodies under Network > Errors > Error Traces.
Agent will no longer display the error message "threadLocalTrace is not parentTrace" when it isn't actually an error.
Agent will no longer trim the last traced method of an activity trace.

iOS agent v3.324

Fri, 16 May 2014 00:00:00 +0000

Notes

Fixes

Fixed crash: BAD_ACCESS in +[NRThreadLocalStore currentThreadDictionary]
Resolves a warning from Veracode SAST about an unchecked return from a malloc call

iOS agent v3.343

Mon, 16 Jun 2014 00:00:00 +0000

Notes

Fixes

Fixed [AFURLSessionManager disposition]: unrecognized selector crash.
Crashes in NRURLProtocol client call backs should no longer occur.
Fixed C++ compilation error caused by the New Relic Agent feature flags.

Improvements

Added new flag for NRFeatureFlags: NRFeatureFlag_ExperimentalNetworkingInstrumentation. This forces all network traffic to run through the NRURLProtocol, normally only traffic on UIWebViews are routed through the NRURLProtocol. It is not recommended to enable this flag.

iOS agent v3.378

Thu, 24 Jul 2014 00:00:00 +0000

Notes

Improvements

Fixed build errors in NewRelicFeatureFlags.h that occurred if NewRelic.h was imported before foundation.h in the prefix.pch file.
Interaction traces period is more discrete. An interaction will only record traces until a new interaction is started, rather than combining the data into one interaction.
The method +[NRTaskQueue dequeue] will no longer fire on the UI thread.
Interaction traces now have more easily identifiable names. Instead of “ViewController#Method” they will now be named “Display ViewController”.
The healthy interaction timer will no longer fire repeatedly over very short intervals.
The agent will no longer crash if the instrumented method:; [NSURLConnection sendAsynchronousRequest:queue:completionHandler:] is passed a nil completionHandler.

Fixes

Default interaction traces can now be renamed by adding @protocol NewRelicCustomInteractionInterface( (defined in NewRelic.h) to the traced view controller.
Added new method for starting a custom interaction trace +startInteractionWithName: (defined in NewRelic.h)
Deprecated the following methods in NewRelic.h : +startInterationFromMethodName:object:, +startInterationFromMethodName:object:customizedName, and +startInterationFromMethodName:object:cancelRunningTrace:. Use +startInteractionWithName: instead.
Added method +stopCurrentInteraction: to NewRelic.h. Allows user to stop a custom interaction trace manually.

iOS agent v3.380

Tue, 05 Aug 2014 00:00:00 +0000

Notes

Fixes

Resolved issue that corrupted New Relic interaction trace data, and resulted in a "ThreadLocalTrace is not parentTrace" log message.

iOS agent v3.398

Wed, 27 Aug 2014 00:00:00 +0000

Fixes

Stability improvements: Certain application design patterns could trigger a concurrency problem in the New Relic SDK that caused app instability. This version properly handles those edge cases.

iOS agent v3.406

Wed, 03 Sep 2014 00:00:00 +0000

Notes

Fixes

Corrected edge case that caused network requests to fail in a 400 error.
Corrected issue causing New Relic Cross Application Tracing to fail.

iOS agent v3.396

Tue, 19 Aug 2014 00:00:00 +0000

Notes

Fixes

Stability improvements: Certain application design patterns could trigger a concurrency problem in the New Relic SDK that caused app instability. This version properly handles those edge cases.
A memory leak in NRMATraceMachine has been removed.

iOS agent v4.139

Fri, 21 Nov 2014 00:00:00 +0000

Notes

Improvements

Improved logging to identify when crash reporting is disabled during debugging.
You can now disable the capture of the HTTP response body for requests by calling the disableFeature method and passing the flag NRMAFeatureFlag_httpResponseCapture.
Added support for the armv7s architecture as it is not available in Xcode 6.
The SDK was updated to accept the HTTP method in the signature of the [NewRelic noticeNetworkRequestForURL] and [NewRelic noticeNetworkFailureForURL] methods allowing more detailed information to be collected.
The version of the New Relic iOS agent was added to the comments in NewRelic.h for convenience.

Fixes

Corrected a potentially crashing situation when calling [NewRelic noticeNetworkRequestForURL].
Updated SDK to include iOS agent symbols in crash reports that may include New Relic code.
Removed potential deadlock on main thread for reachability requests by moving reachability flags off the main thread.
Resolves a crashing issue with Swift related to cases where class_getSuperClass() was called with the root Swift class.

iOS agent v4.155

Thu, 08 Jan 2015 00:00:00 +0000

Notes

Fixes

Corrects a potential crash when an instrumented init method releases the self pointer or sets the self pointer to nil before invoking a superclass method.

iOS agent v4.152

Thu, 18 Dec 2014 00:00:00 +0000

Notes

Improvements

Improved network instrumentation performance resulting from a change in the way we detect the network connection type, which also prevents the potential for a deadlock under high concurrency.
The agent will raise an exception with detailed information in the event it detects a fatal conflict where another library interferes with our code instrumentation.

Fixes

Resolves an issue with ASI instrumentation that could cause a crash when receiving certain network level errors.
Resolves a deadlock scenario that could occur during certain high-load circumstances.
Fixes an issue where heavy network load could potentially cause the OS Reachability functionality to hang, forcing the OS to terminate the app on launch.
NewRelic.h was updated to correct syntax issues causing compiler warnings.

iOS agent v3.412

Fri, 12 Sep 2014 00:00:00 +0000

Notes

Fixes

Fixed minor memory leak caused by network instrumentation.
Fixed a bug where network data was missing from interaction traces.

iOS agent v4.174

Mon, 26 Jan 2015 00:00:00 +0000

Notes

Fixes

Fixes a potential crash in UIImage constructor instrumentation.

iOS agent v4.186

Thu, 29 Jan 2015 00:00:00 +0000

Notes

Fixes

Addresses a potential crash in a rare case when attempting to capture data from a metadata file that is empty.
Corrects an issue with custom interaction names that may not have been displayed properly.
Fixes an issue where duplicate data may have been recorded from from NSURLSession.

iOS agent v4.186.1

Thu, 23 Apr 2015 00:00:00 +0000

Fixes

Addresses a compatibility issue that could result in a crash when using Swift 1.2 and Xcode 6.3

iOS agent v4.83.0

Wed, 08 Oct 2014 00:00:00 +0000

Notes

Improvements

Crash reporting
- This release introduces crash reporting for mobile apps. Crash reporting supports capture and reporting of unhandled Objective-C runtime exceptions as well as native crashes like segfaults and bus errors.
- Crashes include Interaction trails: a history of automatically instrumented actions that occurred during the app session leading up to the crashing event. No breadcrumbs needed.
- The SDK includes a [NewRelic crashNow] method to trigger a test crash quickly and easily.
- When an app is built for release, the debugging symbols are sent to New Relic (via a dSYM file) to automatically provide human-readable crash reports in the UI.
Swift app compatibility
- This release can be safely included in Swift applications. While we do not yet support instrumentation of Swift code, the New Relic SDK is now capable of instrumenting the Objective-C code included in your Swift app.
More configuration options
- An expanded runtime configuration API now supports disabling of crash reporting and interaction tracing, as well as enabling experimental Swift instrumentation for dynamically invoked methods.

iOS agent v5.0.0

Fri, 01 May 2015 00:00:00 +0000

Improvements

Insights for Mobile

This release introduces Insights for New Relic Mobile.

The iOS SDK now automatically records Session, Interaction, and Crash events in New Relic Insights. After upgrading to this release, you will be able to build queries and dashboards in Insights with the new Mobile event type. All events include attributes reflecting session and unique install identifiers, device, OS, geography, duration and other data. See the Insights documentation for a description of Mobile attributes and Insights usage details.

Custom events

In addition to the standard events available in Insights, you can now record custom events. Custom events have a name and set of key:value attributes, perfect for capturing usage, monetization, and custom performance data. Custom events are also available in Insights. See the Mobile Custom Event documentation for details.

Custom attributes

In addition to event-specific attributes, this release provides support for install-scoped attributes. An attribute recorded in the app will be attached to every Session, Interaction, Crash, and Custom event reported from that instance of the app. Custom attributes are perfect for tracking durable information like account id, campaign origin, subscription level, etc. See the Mobile Custom Attribute documentation for details.

The iOS API documentation includes details on sending custom events and attributes to Insights.

iOS agent v5.0.2

Mon, 11 May 2015 00:00:00 +0000

Fixes

Fixes a crash in the agent that could occur when using the simulator for iOS 7.1 during testing.
Resolves a rare crash scenario that may have occurred when the app was sent to the background.

iOS agent v5.0.3

Fri, 15 May 2015 00:00:00 +0000

Fixes

Corrects an issue with default recorded attributes, ensuring osVersion and carrier attributes are sent properly.
Prevents out-of-session network requests from being included in activity traces

iOS agent v5.0.1

Fri, 01 May 2015 00:00:00 +0000

Fixes

Corrects an issue where Session events may not have been sent to New Relic Insights.

iOS agent v5.1.0

Wed, 03 Jun 2015 00:00:00 +0000

Improvements

The iOS SDK will now collect an app build identifier when an app crashes, which will be displayed in parentheses beside the version number in the Crash Details page in RPM. This value defaults to the string CFBundleVersion that is specified in Xcode build settings. If CFBundleVersion is not specified the build identifier will not be displayed.
A new API method +setApplicationBuild:(NSString*)buildNumber was added to allow specifying a custom app build identifier, overriding the default value pulled from CFBundleVersion.

iOS agent v5.1.2

Tue, 30 Jun 2015 00:00:00 +0000

Improvements

Improves overall agent performance.
Fixes race condition that prevents session start metrics from being logged on app launch.
Fixes crash in -setNRSessionAttribute:value: that can occasionally occur on app background or foreground.

iOS agent v5.2.0

Thu, 30 Jul 2015 00:00:00 +0000

Improvements

The SDK now tracks the number and duration of network requests per interaction, which will be used in upcoming features.
A session duration is now recorded for sessions that crash. Mobile crash events in Insights will have a session duration.

Fixes

Fixes a bug where certain HTTP request measurements were duplicated in interaction trace details.
Improves the accuracy of recording measurements in the SDK.

iOS agent v5.2.1

Mon, 17 Aug 2015 00:00:00 +0000

Fixes

Prevents the execution of certain NSNotification observers during key background operations. This will mitigate a crash that could occur during that time frame within the associated observers.

iOS agent v5.3.0

Thu, 17 Sep 2015 00:00:00 +0000

Improvements

This release adds support for building apps with Xcode 7. Xcode 6 and earlier are no longer supported. If you require Xcode 6, use version 5.2.2 or earlier of the iOS agent.
This release also adds Bitcode support, used in apps with Bitcode enabled (Bitcode is enabled by default in Xcode 7).

Notes

As of this release, the New Relic iOS agent no longer supports iOS 5. The minimum required version is now iOS 6.

iOS agent v5.3.2

Thu, 29 Oct 2015 00:00:00 +0000

Fixes

This release fixed incorrect data validation for some custom Insights events. The event attribute value validation was too strict, causing it to sometimes incorrectly reject valid input.

iOS agent v5.3.1

Tue, 13 Oct 2015 00:00:00 +0000

Improvements

Adds IPv6 support to the iOS agent. At WWDC this year, Apple announced they will be requiring IPv6 compatibility for all submitted apps at some point in the future.

Fixes

Fixes a crash that can occur when the app is backgrounded and the OS forcibly destructs the app while the agent was still active. This caused critical agent code to be unexpectedly destructed while data was still being processed.

iOS agent v1.309

Fri, 29 Mar 2013 00:00:00 +0000

Notes

Improvements

Improved verbose logging

Fixes

Fixes a circular strong reference memory leak of NSURLRequest
Ensures connection:didSendBodyData:totalBytesWritten:totalBytesExpectedToWrite: is dispatched to the correct thread

iOS agent v5.10.1

Tue, 07 Feb 2017 00:00:00 +0000

Fixes

Corrects WKWebView instrumentation bug that results in the NavigationDelegate method, webView:didCommitNavigation: being called instead of webView:didStartProvisionalNavigation:. This would result in a crash if the former is implemented in the delegate, but the latter is not.

iOS agent v5.10.0

Mon, 23 Jan 2017 00:00:00 +0000

Improvements

Adds limited network monitoring for WKWebView. Due to constraints within the WKWebView API data sent and received counts are not available.

iOS agent v5.11.0

Mon, 27 Feb 2017 00:00:00 +0000

Improvements

This release adds a new Insights event type: MobileRequestError. This new event tracks networking and http errors during the app's lifecycle, adding the ability to slice and dice network error data! More details can be found at Mobile Request Error Events.
This agent now applies the lastInteraction attribute to all events, not just crash events.
The applications build value is now added as a default session attribute: appBuild.

iOS agent v5.12.0

Thu, 09 Mar 2017 00:00:00 +0000

Improvements

Adds new API +[NewRelic recordCustomEvent:(NSString*)eventType withAttributes:(NSDictionary*)attributes]

This method replaces +[NewRelic recordEvent:(NSString*)name withAttributes:(NSDictionary*)attributes] which is now deprecated, with the intention of removal in the future. The new API creates a new event with an event type specified by the eventType parameter, whereas the deprecated method create a event with the Mobile event type and an attribute with the name 'name' and the value of the name parameter. This change satisfies customer requests for:

Improved Insights query performance
Defining custom event types
Finding custom event in Insights more easily
Flexibility to define data retention per custom event type

iOS agent v5.12.2

Wed, 29 Mar 2017 00:00:00 +0000

Fixes

The New Relic post-build script will now capture and upload dSYM files created in subfolders of the build folder.

iOS agent v5.13.0

Thu, 11 May 2017 00:00:00 +0000

Features

Added a new MobileBreadcrumb custom event type that allows you to annotate the execution of your app, to help troubleshoot crashes and provide greater detail in Insights. Record this new event type with the method +recordBreadcrumb:withAttributes:.
Added an additional +recordCustomEvent:name:withAttributes method that takes the event name as an optional parameter. This avoids the need to add a name attribute in the passed attribute set.

iOS agent v5.12.3

Thu, 20 Apr 2017 00:00:00 +0000

Fixes

Fixed rare app launch crash caused by collision of JSON serialization & New Relic's method instrumentation.
Added better messaging for custom eventType validation errors.
Improved crash report data quality.

iOS agent v5.14.0

Tue, 20 Jun 2017 00:00:00 +0000

New in this release

Now reports network request events to Insights! This feature must be enabled when starting the agent using [NewRelic enableFeatures:NRFeatureFlag_NetworkRequestEvents]. When enabled all network calls will be tracked, in addition to network errors. These new events will be available under the MobileNetworkRequest eventType. Examples of how to query these new events is available in our documentation: Mobile request query examples (MobileRequest).

iOS agent v5.14.1

Tue, 11 Jul 2017 00:00:00 +0000

Fixes

Removed URL parameters from MobileRequest and MobileRequestError events. The concern being there may be confidential information contained in these parameters.

iOS agent v5.14.2

Tue, 01 Aug 2017 00:00:00 +0000

Fixes

Fixes crash in WKWebView instrumentation caused by a nil WKNavigation object being passed to the web view delegate methods.

iOS agent v5.15.0

Tue, 17 Oct 2017 00:00:00 +0000

Improvements

Handled Exceptions in Objective-C

The iOS agent now exposes an API on the NewRelic object:

+recordHandledException:(NSException* _Nonnull)exception attributes:(NSDictionary* _Nullable)attributes.

Passing a caught exception to this API will record details as a MobileHandledException event and record the thread details of the exception. This information will be available in the new UI for handled exceptions.

A new feature flag is available, NRFeatureFlag_HandledExceptionEvents. This toggles the generation of MobileHandledExceptions events and auxiliary data. It is enabled by default

Fixes

Fixed memory leak introduced by NSURLSession instrumentation.

iOS agent v5.2.2

Tue, 01 Sep 2015 00:00:00 +0000

Fixes

The iOS SDK now accepts control characters (such as \t, \r, \n, etc.) while sending custom attributes and events for New Relic Insights.
Fixes a problem while sending quote characters in custom attribute or event data.
Addresses a crash that could occur in the iOS CoreTelephony library when the agent gathers the carrier name.
Mitigates a rare scenario that could result in the agent harvest process occurring twice when the app was sent to the background.

Notes

This is the last iOS agent release to support building with Xcode 6 or earlier.
This is the last iOS agent release to support iOS 5.

iOS agent v5.3.4

Thu, 19 Nov 2015 00:00:00 +0000

Improvements

Added new Insights attributes tracking new app installs and upgrades, for the upcoming Mobile Version Trends Report.

Fixes

Fixed missing Cross Application Trace header in HTTP Error data. This will result in more detailed data in HTTP Errors dashboards.
Off-loaded interaction event generation from main thread to background thread. This caused UI sluggishness under extreme circumstances

iOS agent v5.3.5

Thu, 07 Jan 2016 00:00:00 +0000

Improvements

This release changes the way Monthly Active Unique devices (MAUs) are identified. The iOS agent now uses the iOS provided identifierForVendor from Apple to count unique devices.

Fixes

Improved internal management of application termination, reducing occurrences of a specific agent crash.
The agent will no longer harvest in the background if the app is executing background activities.

iOS agent v5.3.6

Tue, 26 Jan 2016 00:00:00 +0000

Improvements

Improved the dSYM archive uploader so it will now dispatch asynchronously to the build, and will retry the upload up to 3 times.
Custom metrics will now accept spaces in the name.
Improved Cocoapods support. The NewRelicAgent podspec no longer includes version strings in framework paths. This eases pod management and reduces diff clutter when dealing with version control software.

Fixes

Corrected a bug in crash reporting where certain internal symbols were globally visible when the -ObjC linker flag is present.
Corrected a bug in crash reporting where Cortex-A9 chips were reported as ARM-Unknown in crash reports.
Validating the length of activities, only allowing those with a start time within the current session.

iOS agent v5.4.0

Fri, 04 Mar 2016 00:00:00 +0000

Improvements

Added new feature flag, NRFeatureFlag_DefaultInteraction, which allows default interactions to be disabled. Disabling this feature flag will allow the agent to only capture custom interactions.

Fixes

Corrected warnings inadvertently caused by new Xcode build setting, CLANG_ENABLE_MODULES = YES.

iOS agent v5.4.1

Fri, 18 Mar 2016 00:00:00 +0000

Fixes

Corrects possible crash on launch if key data file is corrupted.

iOS agent v5.5.1

Fri, 06 May 2016 00:00:00 +0000

Information

This release is a "roll-forward" of release 5.4.1. Agent release 5.5.0 was discovered to have compatibility issues with armv7 architecture devices.

iOS agent v5.5.0

Tue, 03 May 2016 00:00:00 +0000

Improvements

Crash Report Upload Retry Limiting
- Crash report upload retries will now be limited. This is to prevent crashes from being queued eternally.
Platform Tracking
- A new API, +setPlatform:, was added to NewRelic.h. This will allow bold users to set which platform their app is built with (for example, Unity, Xamarin, React, etc.). This will allow for additional features in the future.

Fixes

Insights API Improvements
- +recordEvent:withAttributes: and +setAttribute:withValue: will no longer block the calling thread.

This release is no longer available due to compatibility issues. See iOS agent release v5.5.1 notes for more details.

iOS agent v5.6.0

Thu, 16 Jun 2016 00:00:00 +0000

Improvements

tvOS is now supported! The New Relic agent will now build and run on your tvOS apps with the same great features as the iOS agent! For more information, learn how to install and configure the iOS agent for tvOS apps.

Fixes

Fixed crash caused by a notification that could occur if the app is shutting down when it attempts to access deallocated objects.

iOS agent v5.5.2

Mon, 23 May 2016 00:00:00 +0000

Improvements

Crash Report Upload Retry Limiting
- Crash report upload retries will now be limited. This is to prevent crashes from being queued eternally.
Platform Tracking
- A new API, +setPlatform:, was added to NewRelic.h. This will allow bold users to set which platform their app is built with (for example, Unity, Xamarin, React, etc.). This will allow for additional features in the future.

Fixes

Insights API Improvements
- +recordEvent:withAttributes: and +setAttribute:withValue: will no longer block the calling thread.

iOS agent v5.7.1

Tue, 02 Aug 2016 00:00:00 +0000

Fixes

The dSYM upload script can now handle targets with spaces in the name.

iOS agent v5.8.0

Fri, 02 Sep 2016 00:00:00 +0000

Improvements

Added support for control characters in insights data. Control characters will now be displayed by their common escaped character representation. e.g.: an 'end-of-text' control character will be displayed a '^C'.

This release was removed as compatibility issues were discovered. See iOS agent release v5.8.1 notes for more details.

iOS agent v5.7.0

Fri, 29 Jul 2016 00:00:00 +0000

Improvements

Embedded framework support in crash reporting: If your application is built with an embedded framework, the agent will now automatically upload all dSYMs associated with your app and utilize them in symbolication of crash reporting.

Fixes

UIWebView instrumentation improvements: Network requests coming out of UIWebViews will no longer get double recorded.
Corrected some instances where networking errors were being recorded as HTTP errors.

iOS agent v5.8.1

Fri, 09 Sep 2016 00:00:00 +0000

Information

This release is a "roll-forward" of release 5.7.1. Agent release 5.8.0 was discovered to have compatibility issues with a small set of devices and has been removed.

iOS agent v5.8.2

Thu, 22 Sep 2016 00:00:00 +0000

Improvements

Added support for control characters in Insights data. Control characters will now be displayed by their common escaped character representation. For example: an 'end-of-text' control character will be displayed as '^C'.

Fixes

Removed instrumentation of ASI networking framework. This prevents collisions with Apple's private API scans, which produces a false positive when scanning our instrumentation of this library. We recommend anyone still using ASI for networking to use our custom network instrumentation tools going forward.

iOS agent v5.8.3

Tue, 27 Sep 2016 00:00:00 +0000

Fixes

Corrected crashing issue the affected some ARMv7s device.

Improvements

This version of the iOS agent is built with Xcode 8, and Xcode 8 is required to build with this agent. If earlier versions of Xcode are required use iOS Agent 5.8.1.

iOS agent v5.9.0

Tue, 10 Jan 2017 00:00:00 +0000

Improvements

Adds helper method +setUserId: to NewRelic.h which sets a session attribute, userId, with the passed value. This method is effectively the same as [NewRelic setAttribute:@"userId" value:<username>];

iOS agent v6.0.0

Wed, 08 Nov 2017 00:00:00 +0000

Major release

This agent release was built with Xcode 9, breaking backwards compatibility with older versions of Xcode.

Improvements

Swift error support.

This release adds a new API in the NewRelic object +recordError:(NSError*)error withAttributes:(NSDictionary*)attributes;. This allows Swift errors to be recorded as MobileHandledException events and to be viewable in the Handled Exception Mobile UI page.

MobileRequest events are on by default.

MobileRequest events will now be transmitted by default. They can be turned off by calling [NewRelic disableFeatures:NRFeatureFlag_NetworkRequestEvents] before [NewRelic startWithApplicationToken:...].

Improved post build script.

Symbol files will now be processed at build time and uploaded to New Relic using the postbuild.sh, rather than uploading the entire dSYM at build time. This will reduce network overhead as well as improve the time it takes for crashes to symbolicate.

Fixes

Fixed low frequency crash in NRMAHarvestableMetric.m:45.
Resolved memory leaks.

iOS agent v6.10.0

Wed, 20 Nov 2019 00:00:00 +0000

Fixes

Now packaged with arm64e architectures.
dSYM upload script can handle paths with spaces in them.

iOS agent v6.1.0

Thu, 14 Dec 2017 00:00:00 +0000

New in this release

MobileRequestError events now contain the response body returned in the network request response, if one exists. Response bodies will only be reported if the http response body header capture feature flag is enabled. HttpResponseBodyCapture is enabled by default. Response body data will be limited to the first 4096 bytes (the Insights attribute limit).
MobileRequestError events now also contain any cross-application tracing (CAT) data returned in the response headers. See Introduction to cross-application traces for more information.

Fixed in this release

Fixed a memory leak in NRMAReachability.

iOS agent v6.1.1

Fri, 09 Feb 2018 00:00:00 +0000

Fixed in this release

Fixed an agent hang when relaunching an app after a crash. In some cases, the agent would appear to deadlock in the agent's startWithApplicationToken:appToken method after relaunching, which has been addressed.

iOS agent v6.13.0

Tue, 21 Jul 2020 00:00:00 +0000

Fixes

Removed deprecated use of NSURLConnection methods
Improved ptr auth stripping in arm64e crashes.

iOS agent v6.14.0

Tue, 25 Aug 2020 00:00:00 +0000

Improvements

Added API to allow the agent data upload hosts to be set during agent start-up. ( +(void) startWithApplicationToken:andCollectorAddress:andCrashCollectorAddress: )

iOS agent v6.11.0

Mon, 20 Apr 2020 00:00:00 +0000

Fixes

The New Relic WKWebView navigation delegate wrapper will respond as the wrapped delegate when isKindOfClass: is called.
+[NewRelic recordHandledException:(NSException*)] will no longer accept exceptions that were not thrown.

iOS agent v6.2.0

Tue, 06 Mar 2018 00:00:00 +0000

Improvements

Improved performance of symbol map upload script.
Improved performance of recordHandledException API.
Removed deprecated APIs.

Fixes

Prevents possible corrupted event data.
Event/Attribute APIs now accept NSNumbers containing BOOL values
+[NewRelic setApplicationVersion:] and +[NewRelic setApplicationBuild:] will now throw an exception if called after the agent is started.

iOS agent v6.3.0

Fri, 01 Jun 2018 00:00:00 +0000

Improvements

Agent can now handle region specific application tokens.
Moved New Relic specific files out of users' "Documents" directory.

Fixes

Fixed inconsistency in deviceManufacturer session attribute; it will always be set as "Apple, Inc".
memUsageMb session attribute will now be stored as a numeric value rather than a string value.
Fixed race-condition in gesture instrumentation that could cause a crash on app background.
RequestUrl and RequestPath attributes on MobileRequest and MobileRequestError events will consistently be not URL-encoded.
Crash reports will now be uploaded immediately after processing on subsequent launch.
Fixed potential race-condition in +[NewRelic stopCurrentInteraction:(NSString*)activityIdentifier]; that could result in dead-lock.

iOS agent v6.3.2

Wed, 12 Sep 2018 00:00:00 +0000

Fixes

Fixed race condition in handled exceptions component, which had the potential of crashing on background inside std::recursive_mutex::lock()

iOS agent v6.4.1

Tue, 30 Oct 2018 00:00:00 +0000

Fixes

Corrects bug in dSYM upload script introduced by Xcode10's new build system.

iOS agent v6.7.0

Fri, 07 Jun 2019 00:00:00 +0000

Improvements

The NewRelic NSURLSessionTaskDelegate object now provides an isKindOfClass: method that presents as the wrapped class. This improves compatibility with other frameworks.

Fixes

Fixes potential crash if _dyld_register_func_for_add_image callback is executed in an unexpected way.

iOS agent v6.4.0

Tue, 09 Oct 2018 00:00:00 +0000

Fixes

+setMaxEventBufferTime and +setMaxEventPoolSize now persist between background/foreground
dSYM upload script has been improved. It is now better at finding and uploading dSYMs.

Improvements

Reduced agent size by removing old architectures. Note: with the removal of i386 the agent will no longer build with iPhone4S simulators (however, it will still run on iPhone4S devices.)

Note: This agent was built with Xcode10. It may be necessary to use Xcode10 for compatibility.

iOS agent v6.5.0

Tue, 05 Feb 2019 00:00:00 +0000

Fixes

Improved dSYM upload script.

iOS agent v6.6.0

Thu, 14 Mar 2019 00:00:00 +0000

Improvements

Bumped session attribute limit to 128 from 64.

Fixes

+recordCustomEvent:withName:attributes: no longer requires a dictionary to capture name.
Values in attributes dictionaries passed to recordEvent APIs will no longer be cast to int or float values, which degraded large data types.

iOS agent v6.8.0

Fri, 13 Sep 2019 00:00:00 +0000

Improvements

Removed support and instrumentation for deprecated UIWebView.

Fixes

Fixed memory leak in WKWebView instrumentation.
Fixed incorrect time units recorded for response time of network errors. It was reporting as milliseconds, and it was corrected to seconds.

iOS agent v7.4.1

Wed, 22 Feb 2023 00:00:00 +0000

Fixed in this release

Added Network Monitoring support for async URLSession functions.
Fixed an issue that would cause conflicts with other iOS network monitoring tools such as FlipperKit.
Fixed an issue where install metrics were not sent with initial metric payload.
Fixed an issue that caused irrelevant logs to be printed to the console.
Fixed an issue that could cause crashes when monitoring network failures.

Other notes

Apple no longer supports bitcode-based submissions to the App Store. The New Relic iOS agent should not be used with bitcode-based apps. The included dSYM upload script will not work with bitcode-based apps.
Deprecation notice: The 7.4.0 version introduced a new Swift symbol upload script. See installation instructions for details on how to update to the new script. In a future version of the iOS agent, the Python-based symbol upload scripts will be removed.
This artifact was built using Xcode 14.2 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher and Swift Package Manager. The agent should be used with the latest Xcode version (Xcode 14.2 at the time of release).
For Mac Catalyst, the zip file installation may integrate more easily than using CocoaPods.

Support statement

As of this release, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version is 7.3.0 of the XCFramework.

iOS agent v7.0.0

Fri, 11 Sep 2020 00:00:00 +0000

Notes

The New Relic iOS agent is now deprecated. Please refer to the New Relic XCFramework Agent for iOS support.

iOS agent v6.9.0

Thu, 24 Oct 2019 00:00:00 +0000

Improvements

Adds support for crash reports from A12 devices.

Fixes

Improved possible race-condition with accessing currentSessionId.

Note: This release was built with Xcode11 and may be incompatible with earlier versions of Xcode.

iOS agent v7.4.11

Tue, 30 Apr 2024 00:00:00 +0000

Fixed in this release

Fixed an issue with the NewEventSystem flag that could cause crash data to upload incorrectly.

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.6.

iOS agent v7.4.10

Tue, 19 Mar 2024 00:00:00 +0000

Fixed in this release

Fixed a bug that caused some distributed tracing headers not being attached to network events.
Fixed the offline attribute not being added in the old event system.
Fixed an unrecognized selector crash in the react native agent for iOS 13 & 14 devices.

Other notes

The NRFeatureFlag_OfflineStorage feature flag will now be disabled by default. For more information on configuring the offline storage feature. More info

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.2.

iOS agent v7.4.2

Thu, 23 Feb 2023 00:00:00 +0000

Fixed in this release

Fixed an issue with the agent that could cause Apple App Store rejection.

Other notes

Apple no longer supports bitcode-based submissions to the App Store. The New Relic iOS agent should not be used with bitcode-based apps. The included dSYM upload script will not work with bitcode-based apps.
Deprecation notice: The 7.4.0 version introduced a new Swift symbol upload script. See installation instructions for details on how to update to the new script. In a future version of the iOS agent, the Python-based symbol upload scripts will be removed.
This artifact was built using Xcode 14.2 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher and Swift Package Manager. The agent should be used with the latest Xcode version (Xcode 14.2 at the time of release).
For Mac Catalyst, the zip file installation may integrate more easily than using CocoaPods.

Support statement

As of this release, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version is 7.3.0 of the XCFramework.

iOS agent v7.4.12

Wed, 29 May 2024 00:00:00 +0000

Fixed in this release

Fixed an issue that could cause the distributed tracing header to be missing on some requests.
Fixed issues that could cause CryptoKit or NSCoding warnings in some environments.
A feature flag has been added to enable background reporting. Background reporting is disabled by default. Enable the NRFeatureFlag_BackgroundReporting feature flag to turn on background reporting.

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.6.

iOS agent v7.4.3

Wed, 01 Mar 2023 00:00:00 +0000

Fixed in this release

Fixed an issue with the agent that could cause API MISUSE to log to the console.

Other notes

Apple no longer supports bitcode-based submissions to the App Store. The New Relic iOS agent should not be used with bitcode-based apps. The included dSYM upload script will not work with bitcode-based apps.
Deprecation notice: The 7.4.0 version introduced a new Swift symbol upload script. See installation instructions for details on how to update to the new script. In a future version of the iOS agent, the Python-based symbol upload scripts will be removed.
This artifact was built using Xcode 14.2 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher and Swift Package Manager. The agent should be used with the latest Xcode version (Xcode 14.2 at the time of release).
For Mac Catalyst, the zip file installation may integrate more easily than using CocoaPods.

Support statement

As of this release, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version is 7.3.0 of the XCFramework.

iOS agent v7.4.4

Mon, 17 Apr 2023 00:00:00 +0000

Fixed in this release

Fixed an issue with the agent that could cause a crash when releasing the Payload object.
Fixed an issue with the agent that could cause crashes during web view instrumentation.

Other notes

Apple no longer supports bitcode-based submissions to the App Store. The New Relic iOS agent should not be used with bitcode-based apps. The included dSYM upload script will not work with bitcode-based apps.
Deprecation notice: The 7.4.0 version introduced a new Swift symbol upload script. See installation instructions for details on how to update to the new script. In a future version of the iOS agent, the Python-based symbol upload scripts will be removed.
This artifact was built using Xcode 14.2 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher and Swift Package Manager. The agent should be used with the latest Xcode version (Xcode 14.2 at the time of release).
For Mac Catalyst, the zip file installation may integrate more easily than using CocoaPods.

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.1.

iOS agent v7.4.5

Wed, 31 May 2023 00:00:00 +0000

Fixed in this release

Added a feature flag for FedRAMP support.
Fixed an issue with tvOS not reporting carrier type as wifi.
Fixed an issue where the iOS agent prevented webView:decidePolicyForNavigationAction:decisionHandler: from getting called.
Fixed a bug that stopped http error data from getting uploaded.

Other notes

Instrumentation of async await url sessions that was added in v7.4.1 has been moved behind a feature flag. To use that feature include the NRFeatureFlag_SwiftAsyncURLSessionSupport flag in the enableFeatures function.
Deprecation notice: The 7.4.0 version introduced a new Swift symbol upload script. See installation instructions for details on how to update to the new script. In a future version of the iOS agent, the Python-based symbol upload scripts will be removed.
This artifact was built using Xcode 14.2 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher and Swift Package Manager. The agent should be used with the latest Xcode version (Xcode 14.2 at the time of release).
For Mac Catalyst, the zip file installation may integrate more easily than using CocoaPods.

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.2.

iOS agent v7.4.7

Mon, 02 Oct 2023 00:00:00 +0000

Fixed in this release

Fixed required privacy manifest for iOS 17.

Other notes

With the 7.4.6 release the dsym-upload-tools are no longer included inside the XCFramework. The dsym-upload-tools are available in the dsym-upload-tools folder of the https://github.com/newrelic/newrelic-ios-agent-spm Swift Package Manager repository. Please copy this dsym-upload-tools directory to your applications source code directory if you are integrating the New Relic iOS Agent by copying XCFramework into project or using cocoapods.

Please use the run script below in your Xcode build phases to perform symbol upload steps during app builds in Xcode.

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"

Instrumentation of async await url sessions that was added in 7.4.1 has been moved behind a feature flag in 7.4.6. To use that feature, include the NRFeatureFlag_SwiftAsyncURLSessionSupport flag in the enableFeatures function.
In version 7.4.6 of the iOS agent, the Python-based symbol upload scripts were removed. Update to the Swift based script.
This artifact was built using Xcode 14.3 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher and Swift Package Manager. The agent should be used with the latest Xcode version (Xcode 14.3 at the time of release).
Swift Package Manager is the preferred installation method.

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.2.

iOS agent v7.4.6

Mon, 24 Jul 2023 00:00:00 +0000

Fixed in this release

Fixed framework signing to be compatible with Xcode 15.
Fixed compatibility with RxWebKit.

Other notes

With this release the dsym-upload-tools are no longer included inside the XCFramework. The dsym-upload-tools are available in the dsym-upload-tools folder of the https://github.com/newrelic/newrelic-ios-agent-spm Swift Package Manager repository. Please copy this dsym-upload-tools directory to your applications source code directory if you are integrating the New Relic iOS Agent by copying XCFramework into project or using cocoapods.

Please use the run script below in your Xcode build phases to perform symbol upload steps during app builds in Xcode.

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"

Instrumentation of async await url sessions that was added in v7.4.1 has been moved behind a feature flag. To use that feature, include the NRFeatureFlag_SwiftAsyncURLSessionSupport flag in the enableFeatures function.
In version 7.4.6 of the iOS agent, the Python-based symbol upload scripts were removed. Update to the Swift based script.
This artifact was built using Xcode 14.3 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher and Swift Package Manager. The agent should be used with the latest Xcode version (Xcode 14.3 at the time of release).
Swift Package Manager is the preferred installation method.

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.2.

iOS agent v7.4.8

Mon, 11 Dec 2023 00:00:00 +0000

Fixed in this release [#fixed]

Fixes async requests so they appear in distributed tracing.
Adds NRFeatureFlag_NewEventSystem feature flag. Enable this flag to use our new, more stable, event system for iOS agent:

    NewRelic.enableFeatures([NRMAFeatureFlags.NRFeatureFlag_NewEventSystem])

Adds configurable request header instrumentation to network events:
- The agent will now produce network event attributes for select header values if it detects headers on the request. The header names to instrument pass into the agent when started.
- For more information, see Adding Tracked Headers in the Mobile Monitoring documentation.
Adds GraphQL attributes to network events:
- If the agent detects request headers from Apollo GraphQL servers, it will add additional attributes to the network request event.
- For more information, see Adding Tracked Headers in the Mobile Monitoring documentation.

Other notes

With the 7.4.6 release, the XCFramework no longer includes the dsym-upload-tools. You can find the dsym-upload-tools in the dsym-upload-tools folder of the https://github.com/newrelic/newrelic-ios-agent-spm Swift Package Manager repository. Please copy the dsym-upload-tools directory into your application source code directory by copying the XCFramework into your project or using Cocoapods if you're integrating the New Relic iOS Agent. Use the run script below in your Xcode build phases to perform symbol upload steps during app builds in Xcode.

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"

We recommend using the swift package manager for your installation method.

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.2.

iOS agent v7.5.0

Fri, 28 Jun 2024 00:00:00 +0000

Fixed in this release

Additional fixes for an issue that could cause CryptoKit or NSCoding warnings in some environments.
Fixed a bug when using setUserId that could cause some events to not align with the correct userId during a session.
Fixed a bug when using NRFeatureFlag_BackgroundReporting that caused some events created in the background to not get reported.
New Relic iOS agent now supports remote logging. Enable this feature within your mobile entity applications setting page to turn on logging for the agent. For more information on how to enable and configure remote logging visit our documentation.
Fixed a bug that caused crash reports to be uploaded without session attributes when NRFeatureFlag_HandledExceptionEvents is disabled.

Other notes

Added watchOS as a compatible environment for the iOS agent. For more information on using the agent in a watchOS project visit our documentation.
Starting the New Relic agent to your watchOS project

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.6.

iOS agent v7.5.10

Mon, 15 Sep 2025 00:00:00 +0000

Fixed in this release

Fixed a crash that could occur on agent start.

iOS agent v7.5.1

Wed, 21 Aug 2024 00:00:00 +0000

Fixed in this release

Added watchOS as a compatible environment for the iOS agent. Fixed to work with SPM and Cocoapods. For more information on using the agent in a watchOS project visit our documentation.
Starting the New Relic agent to your watchOS project

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.6.

iOS agent v7.4.9

Wed, 28 Feb 2024 00:00:00 +0000

Fixed in this release

Fixed events maximum buffer size not maintaining after backgrounding.
Fixed issue when /connect has a missing harvest configuration.

Other notes

Added the ability to store harvests that previously would be lost if the application doesn't have internet connection. These harvest are then sent after an internet connection is established and the next harvest successfully uploads.
Use the + (void) setMaxOfflineStorageSize:(unsigned int)megaBytes; API to set the maximum amount of data that can be stored locally. More info
The feature flag NRFeatureFlag_OfflineStorage was added to disable the above mentioned offline storage.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. The iOS and tvOS agents were deprecated with the release of version 7.2.1 of the XCFramework agent. As of this release, the oldest supported version is 7.0.0 of the XCFramework.

iOS agent v7.5.11

Tue, 07 Oct 2025 00:00:00 +0000

Fixed in this release

Fixed performance issues that could occur when using Interaction Tracing.
Fixed a log related to Distributed Tracing that could be incorrectly shown.

iOS agent v7.5.2

Mon, 23 Sep 2024 00:00:00 +0000

Fixed in this release

Fixed an issue that could cause app hangs.
Fixed an issue that caused events created in applicationDidFinishLaunchingWithOptions to not be reported.
Fixed a crash that could occur when using the NRFeatureFlag_NewEventSystem and forming the attribute json in a harvest.
Fixed a crash that could occur from a NRMAPayload object while using the NRFeatureFlag_NewEventSystem.

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.6.

iOS agent v7.5.3

Wed, 04 Dec 2024 00:00:00 +0000

Fixed in this release

The tracked headers set in addHTTPHeaderTrackingFor are now correctly added to network request events manually captured using noticeNetworkRequestForURL.
Fixed a bug in the new event system that prevented adding an attribute with a key that contain a reserved key string as a prefix.
Made changes to address the NRMA__deallocInteractionHistoryList crash reported by users.

Other notes

The iOS agent now supports automatic log collection for remote logging. This feature is limited to NSLog(), Swift print(), and other print-family functions. To enable it, use the NRFeatureFlag_AutoCollectLogs feature flag. For more information on how to enable and configure remote logging, visit our documentation.
Changed the agent to agent to consistently send the sampled flag as '01' (true) in the W3C Traceparent header to maintain trace continuity with OpenTelemetry agents, which expect '00' (false) for dropped spans and '01' (true) for sampled spans.

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.6.

iOS agent v7.5.4

Thu, 06 Mar 2025 00:00:00 +0000

Starting from iOS SDK version 7.5.4, a change has been implemented that causes previously suppressed Handled Exception events to be reported.

Fixed in this release

Fixed crash that could occur when recording handled exceptions.
Fixed various crashes that could occur when using the New Relic iOS agent.
The New Relic iOS agent now includes Session Attributes in Mobile Logs.
Fixed an issue that could occur when sending multiple handled exceptions to New Relic. The New Relic iOS agent will now will prevent data loss when sending multiple handled exceptions.

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.6.

iOS agent v7.5.6

Thu, 05 Jun 2025 00:00:00 +0000

Starting from iOS SDK version 7.5.4, a change has been implemented that causes previously suppressed Handled Exception events to be reported.

Fixed in this release

Agent is built using Xcode 16.3. This should correct any errors related to Code Coverage when using the New Relic iOS agent with Xcode 16.3.
Fixed in an issue that could cause distributed tracing account to be set incorrectly.
Fixed an issue that could cause the agent to crash when setting session attributes.

iOS agent v7.5.5

Tue, 22 Apr 2025 00:00:00 +0000

Starting from iOS SDK version 7.5.4, a change has been implemented that causes previously suppressed Handled Exception events to be reported.

Fixed in this release

Addressed customer-reported crashes and bugs.
Fixed a SPM version warning.

Support statement

As of iOS agent version 7.4.1, the iOS agent will consolidate previously separate XCFramework and tvOS agents into a singular iOS agent.
As of this release, the oldest supported version of the XCFramework is 7.3.6.

iOS agent v7.5.7

Mon, 28 Jul 2025 00:00:00 +0000

Starting from iOS SDK version 7.5.4, a change has been implemented that causes previously suppressed Handled Exception events to be reported.

Please update to New Relic iOS agent 7.5.8. We've identified a bug in iOS SDK version 7.5.7 that could cause a crash on agent launch, and a fix is included in the New Relic iOS agent 7.5.8 release.

Fixed in this release

Agent is built using Xcode 16.4.
Fixed an issue that could cause distributed tracing to not have all required account information at start of a session.

iOS agent v7.5.8

Wed, 30 Jul 2025 00:00:00 +0000

Starting from iOS SDK version 7.5.4, a change has been implemented that causes previously suppressed Handled Exception events to be reported.

Please update to New Relic iOS agent 7.5.9. We've identified a bug in iOS SDK version 7.5.8 that could cause incorrect data upload, and a fix is included in the New Relic iOS agent 7.5.9 release.

Please update to New Relic iOS agent 7.5.9. We've identified a bug in iOS SDK version 7.5.7 that could cause a crash on agent launch, and a fix is included in the New Relic iOS agent 7.5.9 release.

Fixed in this release

Agent is built using Xcode 16.4.
Fixed an issue that could cause distributed tracing to not have all required account information at start of a session.
Fixed an issue that could cause a crash on agent start.

iOS agent v7.6.0

Mon, 03 Nov 2025 00:00:00 +0000

Important

This release bumps the required iOS version of the New Relic iOS agent to iOS 16.

New in this release

Includes Public Preview of Mobile Session Replay.

Fixed in this release

Fixed issue with handled exceptions that could occur when logging.
Fixed incorrect parameter naming warning.

iOS agent v7.5.9

Mon, 18 Aug 2025 00:00:00 +0000

Fixed in this release

Agent is built using Xcode 16.4.
Fixed an issue that could cause distributed tracing to not have all required account information at start of a session.
Fixed an issue that could cause a crash on agent start.

iOS agent v7.6.1

Thu, 22 Jan 2026 00:00:00 +0000

Important

This release bumps the required iOS version of the New Relic iOS agent to iOS 16. iOS 15 support will come back in a future version.

New in this release

Updated the public preview of mobile Session Replay to include sampling for errored sessions and fixed issues related to Session Replay.

Fixed in this release

Fixed an issue that prevented distributed tracing from functioning in certain edge cases.
Added stability fixes for identified issues.

iOS agent v7.6.2

Wed, 18 Feb 2026 00:00:00 +0000

Fixed in this release

Restored iOS 15 support.
Session Replay Enhacnments - we have added fixes for SwiftUI colors that should improve replay fidelity
Session Replay Stability - we have fixed a number of issues that could occur. We have fixed an issue that could occur on older iOS devices.

iOS agent v5.13.0

Thu, 11 May 2017 00:00:00 +0000

Features

Added a new MobileBeadcrumb event type that allows you to annotate the execution of your app, to help troubleshoot crashes and provide greater detail in Insights. Use this new event type using the conveneince method +recordBreadcrumb:withAttributes:
Added an additional +recordCustomEvent:name:withAttributes method that takes the event name as an optional parameter. This avoids the need to add a name attribute in the passed attribute set.

iOS agent v5.12.1

Fri, 10 Mar 2017 00:00:00 +0000

Improvements

Adds new API +[NewRelic recordCustomEvent:(NSString*)eventType withAttributes:(NSDictionary*)attributes]

Improved Insights query performance
Defining custom event types
Finding custom event in Insights more easily
Flexibility to define data retention per custom event type
Adds helper method +setUserId: to NewRelic.h which sets a session attribute, userId, with the passed value. This method is effectively the same as [NewRelic setAttribute:@"userId" value:<username>];
This release adds a new Insights event type: MobileRequestError. This new event tracks networking and http errors during the app's lifecycle, adding the ability to slice and dice network error data! More details can be found at Mobile Request Error Events.
This agent now applies the lastInteraction attribute to all events, not just crash events.
The applications build value is now added as a default session attribute: appBuild.

iOS agent v5.14.0

Tue, 20 Jun 2017 00:00:00 +0000

New in this release

iOS agent v5.15.0

Tue, 17 Oct 2017 00:00:00 +0000

Improvements

Handled Exceptions in Objective-C

The tvOS agent now exposes an API on the NewRelic object:

+recordHandledException:(NSException* _Nonnull)exception attributes:(NSDictionary* _Nullable)attributes.

A new feature flag is available, NRFeatureFlag_HandledExceptionEvents. This toggles the generation of MobileHandledExceptions events and auxiliary data. It is enabled by default

Fixes

Fixed memory leak introduced by NSURLSession instrumentation.

iOS agent v5.6.0

Fri, 17 Jun 2016 00:00:00 +0000

Notes

This is the initial release of the New Relic Agent for tvOS!
The tvOS agent allows you to monitor and manage the performance of your tvOS applications by providing end-to-end details, errors, and throughput from every angle in real time.
Provides access to New Relic Crash Reporting to track and diagnose crashes in your tvOS apps.
Includes APIs for custom instrumentation to gain deeper insights into specific areas of your app.
Get more details in the New Relic for tvOS documentation

iOS agent v5.14.1

Tue, 11 Jul 2017 00:00:00 +0000

Fixes

Removed URL parameters from MobileRequestError and MobileRequest events. The concern being there may be confidential information contained in these parameters.

iOS agent v5.7.0

Fri, 29 Jul 2016 00:00:00 +0000

Improvements

Embedded framework support in crash reporting: If your application is built with an embedded framework, the agent will now automatically upload all dSYMs associated with your app and utilize them in symbolication of crash reporting.

Fixes

Corrected some instances where networking errors were being recorded as HTTP errors.

iOS agent v5.7.1

Tue, 02 Aug 2016 00:00:00 +0000

Fixes

The dSYM upload script can now handle targets with spaces in the name.

iOS agent v5.8.0

Fri, 02 Sep 2016 00:00:00 +0000

Improvements

Added support for control characters in insights data. Control characters will now be displayed by their common escaped character representation. e.g.: an 'end-of-text' control character will be displayed a '^C'.

iOS agent v6.0.0

Wed, 08 Nov 2017 00:00:00 +0000

Major release

This agent release was built with Xcode 9, breaking backwards compatibility with older versions of Xcode.

Improvements

Swift error support.

MobileRequest events are on by default.

Improved post build script.

Fixes

Fixed low frequency crash in NRMAHarvestableMetric.m:45.
Resolved memory leaks.

iOS agent v5.8.2

Thu, 22 Sep 2016 00:00:00 +0000

Improvements

Added support for control characters in Insights data. Control characters will now be displayed by their common escaped character representation. For example: an 'end-of-text' control character will be displayed as '^C'.

Fixes

Removed instrumentation of ASI networking framework. This prevents collisions with Apple's private API scans, which produces a false positive when scanning our instrumentation of this library. We recommend anyone still using ASI for networking to use our custom network instrumentation tools going forward.

iOS agent v6.1.0

Thu, 14 Dec 2017 00:00:00 +0000

New in this release

MobileRequestError events now contain the response body returned in the network request response, if one exists. Response bodies will only be reported if the http response body capture feature flag is enabled. HttpResponseBodyCapture is enabled by default. Response body data will be limited to the first 4096 bytes (the Insights attribute limit).
MobileRequestError events now also contain any cross-application tracing (CAT) data returned in the response headers. See Introduction to cross-application traces for more information.

Fixed in this release

Fixed a memory leak in NRMAReachability.

iOS agent v6.10.0

Wed, 20 Nov 2019 00:00:00 +0000

Fixes

dSYM upload script can handle paths with spaces in them.

iOS agent v6.11.0

Mon, 20 Apr 2020 00:00:00 +0000

Fixes

+[NewRelic recordHandledException:(NSException*)] will no longer accept exceptions that were not thrown.

iOS agent v6.14.0

Tue, 25 Aug 2020 00:00:00 +0000

Improvements

Added API to allow the agent data upload hosts to be set during agent start-up. ( +(void) startWithApplicationToken:andCollectorAddress:andCrashCollectorAddress: )

iOS agent v6.12.0

Mon, 13 Jul 2020 00:00:00 +0000

Fixes

Fixed build warnings related to the tvOS agent.

iOS agent v6.13.0

Tue, 21 Jul 2020 00:00:00 +0000

Fixes

Removed deprecated use of NSURLConnection methods
Improved ptr auth stripping in arm64e crashes.

iOS agent v6.2.0

Thu, 01 Mar 2018 00:00:00 +0000

Improvements

Improved performance of symbol map upload script.
Improved performance of recordHandledException API.
Removed deprecated APIs.

Fixes

Prevents possible corrupted event data.
Event/Attribute APIs now accept NSNumbers containing BOOL values
+[NewRelic setApplicationVersion:] and +[NewRelic setApplicationBuild:] will now throw an exception if called after the agent is started.

iOS agent v6.3.1

Thu, 14 Jun 2018 00:00:00 +0000

Fixes

Replaced missing llvm bitcode in framework.

iOS agent v6.3.0

Fri, 01 Jun 2018 00:00:00 +0000

Improvements

Agent can now handle region specific application tokens.

Fixes

Fixed inconsistency in deviceManufacturer session attribute; it will always be set as "Apple, Inc".
memUsageMb session attribute will now be stored as a numeric value rather than a string value.
Fixed race-condition in gesture instrumentation that could cause a crash on app background.
RequestUrl and RequestPath attributes on MobileRequest and MobileRequestError events will consistently be not URL-encoded.
Crash reports will now be uploaded immediately after processing on subsequent launch.
Fixed potential race-condition in +[NewRelic stopCurrentInteraction:(NSString*)activityIdentifier]; that could result in dead-lock.

Bugs

Missing llvm bitcode (fixed in 6.3.1)

iOS agent v6.3.2

Wed, 12 Sep 2018 00:00:00 +0000

Fixes

Fixed race condition in handled exceptions component, which had the potential of crashing on background inside std::recursive_mutex::lock()

iOS agent v6.4.0

Tue, 09 Oct 2018 00:00:00 +0000

Fixes

+setMaxEventBufferTime and +setMaxEventPoolSize now persist between background/foreground
dSYM upload script has been improved. It is now better at finding and uploading dSYMs.

Note: This agent was built with Xcode10. It may be necessary to use Xcode10 for compatibility.

iOS agent v6.4.1

Tue, 30 Oct 2018 00:00:00 +0000

Fixes

Corrects bug in dSYM upload script introduced by Xcode10's new build system.

iOS agent v6.5.0

Tue, 05 Feb 2019 00:00:00 +0000

Fixes

Improved dSYM upload script.

iOS agent v6.6.0

Thu, 14 Mar 2019 00:00:00 +0000

Improvements

Bumped session attribute limit to 128 from 64.

Fixes

+recordCustomEvent:withName:attributes: no longer requires a dictionary to capture name.
Values in attributes dictionaries passed to recordEvent APIs will no longer be cast to int or float values, which degraded large data types.

iOS agent v6.7.0

Fri, 07 Jun 2019 00:00:00 +0000

Improvements

The NewRelic NSURLSessionTaskDelegate object now provides an isKindOfClass: method that presents as the wrapped class. This improves compatibility with other frameworks.

Fixes

Fixes potential crash if _dyld_register_func_for_add_image callback is executed in an unexpected way.

iOS agent v6.8.0

Fri, 13 Sep 2019 00:00:00 +0000

Fixes

Fixed incorrect time units recorded for response time of network errors. It was reporting as milliseconds, and it was corrected to seconds.

iOS agent v6.9.0

Fri, 25 Oct 2019 00:00:00 +0000

Fixes

Improved possible race-condition with accessing currentSessionId. Note: This release was built with Xcode11 and may be incompatible with earlier versions of Xcode.

iOS agent v7.0.0

Fri, 11 Sep 2020 00:00:00 +0000

Notes

The New Relic tvOS agent is now deprecated. Please refer to the New Relic XCFramework Agent for tvOS support.

iOS agent v7.0.0

Wed, 09 Sep 2020 00:00:00 +0000

Notes

The New Relic XCFramework Agent is the updated distribution method for the iOS & tvOS agent. Starting with the 7.0.0 release, all future updates will be deployed via the XCFramework agent. The XCFramework agent will be distributed via the NewRelicAgent cocoapods, as well as via download.

New features

A single artifact support iOS, tvOS, and Catalyst apps.
Dynamic Library support. This will greatly improve support for shared frameworks instrumentation.

Notes

To import this artifact you'll have to use #import <NewRelic/NewRelic.h> instead of the previous#<NewRelicAgent/NewRelic.h>.

iOS agent v7.1.0

Thu, 15 Oct 2020 00:00:00 +0000

Improved attribute validation

The agent will no longer reject events containing invalid attributes. Attributes that fail basic event validation are pruned from the map of provided event attributes. We've also corrected an event creation error where attribute maps containing null keys would result in events with a subset of passed attributes.

This applies to recordCustomEvent:withAttributes: and recordBreadcrumb:withAttributes:.

Other Notes

This artifact was built using Xcode 12.0.1 with a minimum deployment target of iOS version 9.0

iOS agent v7.2.0

Thu, 19 Nov 2020 00:00:00 +0000

Improvements

The dSYM upload scripts and dependencies have been updated.

Other Notes

This artifact was built using Xcode 12.0.1 with a minimum deployment target of iOS version 9.0

Support Statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. The iOS and tvOS agents were deprecated with the release of version 7.0.0 of the XCFramework agent. As of this release, the oldest supported version is 6.5.0 for the iOS and tvOS agents.

iOS agent v7.2.1

Thu, 17 Dec 2020 00:00:00 +0000

Improvements

Resolve tvOS thinning issues when publishing to Apple.

Other Notes

This artifact was built using Xcode 12.0.1 with a minimum deployment target of iOS version 9.0

Support Statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. The iOS and tvOS agents were deprecated with the release of version 7.0.0 of the XCFramework agent. As of this release, the oldest supported version is 6.5.0 for the iOS and tvOS agents.

iOS agent v7.3.0

Wed, 31 Mar 2021 00:00:00 +0000

New in this release

Adds Distributed Tracing support

The agent will now add Distributed Tracing headers to instrumented network requests. This feature is enabled by default, but can be disabled through the DistributedTracing feature flag.

Refer to How New Relic distributed tracing works for more information on Distributed Tracing in mobile apps.

Fixed in this release

Support for Xcode running on Apple Silicon Macs.

Other Notes

This artifact was built using Xcode 12.3 with a minimum deployment target of iOS version 9.0

Support Statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. The iOS and tvOS agents were deprecated with the release of version 7.0.0 of the XCFramework agent. As of this release, the oldest supported version is 6.5.0 for the iOS and tvOS agents.

iOS agent v7.3.2

Thu, 17 Jun 2021 00:00:00 +0000

Fixed in this release

Updated framework anatomy for Mac Catalyst.
Crash reporting symbolication bug fixes.
URLSession error handling improvements.

Other notes

This artifact was built using Xcode 12.3 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher.
For Mac Catalyst, the zip file installation may integrate more easily than using CocoaPods.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. The iOS and tvOS agents were deprecated with the release of version 7.1.0 of the XCFramework agent. As of this release, the oldest supported version is 7.1.0 of the XCFramework

iOS agent v7.3.1

Fri, 30 Apr 2021 00:00:00 +0000

Fixed in this release

Support for Xcode running Catalyst and tvOS Simulator on Apple silicon Macs.

Other notes

This artifact was built using Xcode 12.3 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher.
For Mac Catalyst, the zip file installation may integrate more easily than using Cocoapods.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. The iOS and tvOS agents were deprecated with the release of version 7.0.0 of the XCFramework agent. As of this release, the oldest supported version is 7.0.0 of the XCFramework

iOS agent v7.3.3

Mon, 23 Aug 2021 00:00:00 +0000

Fixed in this release

Improved crash reporting symbolication for all iOS and tvOS architectures.
Updated post-build step script for uploading dSYM files.

Other notes

This artifact was built using Xcode 12.3 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher.
For Mac Catalyst, the zip file installation may integrate more easily than using CocoaPods.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. The iOS and tvOS agents were deprecated with the release of version 7.2.0 of the XCFramework agent. As of this release, the oldest supported version is 7.2.0 of the XCFramework

iOS agent v7.3.5

Fri, 22 Apr 2022 00:00:00 +0000

Fixed in this release

Support for Xcode 13
Fixed an issue with distributed tracing headers not being added

Other notes

This artifact was built using Xcode 13.3 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher and Swift Package Manager
For Mac Catalyst, the zip file installation may integrate more easily than using CocoaPods.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. The iOS and tvOS agents were deprecated with the release of version 7.2.1 of the XCFramework agent. As of this release, the oldest supported version is 7.0.0 of the XCFramework

iOS agent v7.3.4

Thu, 18 Nov 2021 00:00:00 +0000

Fixed in this release

Added New Relic dSYMs for deeper crash reporting symbolication on iOS and tvOS.
Fixed reachabilty crash.

Other notes

This artifact was built using Xcode 12.3 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher.
For Mac Catalyst, the zip file installation may integrate more easily than using CocoaPods.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. The iOS and tvOS agents were deprecated with the release of version 7.2.0 of the XCFramework agent. As of this release, the oldest supported version is 7.2.1 of the XCFramework

iOS agent v7.3.6

Wed, 01 Jun 2022 00:00:00 +0000

Fixed in this release

Bug fixes for stability
More accurate bytes received calculation for HTTP transactions
Updates to support Hybrid Frameworks

Other notes

This artifact was built using Xcode 13.3 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher and Swift Package Manager
For Mac Catalyst, the zip file installation may integrate more easily than using CocoaPods.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. The iOS and tvOS agents were deprecated with the release of version 7.2.1 of the XCFramework agent. As of this release, the oldest supported version is 7.0.0 of the XCFramework

iOS agent v7.3.8

Wed, 24 Aug 2022 00:00:00 +0000

Fixed in this release

Automatic dSYM file upload script updated to use Python 3.
Fix for custom event memory leak.

Other notes

This artifact was built using Xcode 13.4.1 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher and Swift Package Manager.
For Mac Catalyst, the zip file installation may integrate more easily than using CocoaPods.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. The iOS and tvOS agents were deprecated with the release of version 7.2.1 of the XCFramework agent. As of this release, the oldest supported version is 7.0.0 of the XCFramework

iOS agent v7.3.7

Wed, 13 Jul 2022 00:00:00 +0000

Fixed in this release

Updates to support Hybrid Frameworks
Fix for custom event memory leak
Fix for custom traces when disabling default traces

Other notes

This artifact was built using Xcode 13.3 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher and Swift Package Manager
For Mac Catalyst, the zip file installation may integrate more easily than using CocoaPods.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. The iOS and tvOS agents were deprecated with the release of version 7.2.1 of the XCFramework agent. As of this release, the oldest supported version is 7.0.0 of the XCFramework

iOS agent v7.4.0

Thu, 20 Oct 2022 00:00:00 +0000

Fixed in this release

Swift symbol upload script.
Cold and Hot App Launch Time Metrics are now reported automatically. Note: Warm and prewarmed times are not reported.
Fix a bug where install metrics were not sent in all cases.

Other notes

Deprecation notice: This version introduces a new Swift symbol upload script. See installation instructions for details on how to update to the new script. In a future version of the iOS agent the Python based symbol upload scripts will be removed.
This artifact was built using Xcode 13.4.1 with a minimum deployment target of iOS version 9.0. Compatible with CocoaPods 1.10 or higher and Swift Package Manager.
For Mac Catalyst, the zip file installation may integrate more easily than using CocoaPods.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. The iOS and tvOS agents were deprecated with the release of version 7.2.1 of the XCFramework agent. As of this release, the oldest supported version is 7.0.0 of the XCFramework

iOS agent v7.6.3

Fri, 06 Mar 2026 00:00:00 +0000

Fixed in this release

Bug fixes and performance enhancements.