iOS agent release notesRSS

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.

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.

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.

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.

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.

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.

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.

Fixed in this release

• 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.

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.