iOS agent release notesRSS

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.

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.

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.

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.

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.