MarketingCloudSDK iOS (v8.1.2)

• Home
• Documentation
• AppleDoc
• MobilePush
• Get Started
• Overview
• 1. Provision for Push
• 2. Setup MobilePush Apps
• 3. Add the SDK
• 4. Configure the SDK
• 5. Enable Push
• 6. Migrating to 8.x
• Testing the SDK
• Development / Xcode
• Production / Distribution
• SDK Implementation
• Data Protection and Privacy
• Device and Contact Registration
• Handle URLs
• Runtime Toggles
• Push Notifications
• Customize Push Notifications
• Custom Sound
• Interactive Notifications
• Rich Notifications
• OpenDirect
• Custom Keys
• Application Badging
• Application Badge Override
• Event Tracking
• Mobile App Event Tracking
• In-App Messaging
• In-App Messaging
• Inbox Messaging
• Inbox Messaging
• Location Messaging
• Geofence and Beacon Messaging
• Background Location Updates
• Location Message Segmentation
• Analytics
• Analytics
• Einstein Recommendations and Collect API Integration
• Use Cases
• MobilePush SDK Privacy Manifest
• MobilePush SDK Use Cases
• Troubleshooting
• App Submission
• Push Setup
• Multiple Push SDKs
• iOS Data Protection
• Data Merge
• Keychain Crash
• MarketingCloudSDK.bundle inclusion Crash

The below troubleshooting guide is applicable until MarketingCloudSDK version 8.0.13. Post this version, manual addition of bundle to the application is removed and is automated.

When the SDK is upgraded to latest version, there might be changes to the resources bundle (MarketingCloudSDK.bundle) that comes packaged with the SDK. If the right versions are not copied, the app crashes with the exception as the SDK might not find the required resources in the .bundle file.

Common Exceptions When latest MarketingCloudSDK.bundle not added in the application

NSInvalidArgumentException, NSInternalInconsistencyException

1. +entityForName: nil is not a legal NSManagedObjectContext parameter searching for entity name 'SFMCEndpointConfigurationEntity'
2. 'NSFetchRequest could not locate an NSEntityDescription for entity name 'SFMCEventConfigurationEntity''
3. 'Cannot create an NSPersistentStoreCoordinator with a nil model'

Solution:

• After upgrading to the latest MarketingCloudSDK, make sure to:
  1. Remove the existing MarketingCloudSDK.bundle from Xcode -> Build phases -> Copy Resources Bundle
     
  2. Add the latest MarketingCloudSDK.bundle as mentioned here: Migrating to SFMCSdk if SPM is used as dependency manager or follow #5 in Add the SDK for other methods.

Note: For every upgrade of the SDK, it is recommended to pull the MarketingCloudSDK.bundle each time as there may be upgrades to the bundle.