SDK 15.0.0 Migration Guide for Xcode

With the release of Xcode 16, Apple now requires that apps submitted to the App Store be built using Xcode 16 or later. To align with this requirement, the latest version of the Instabug SDK is fully compatible with Xcode 16 but includes a few breaking changes.

Changes in SDK Version 15.0.0

Xcode Compatibility

  • The latest version of the Instabug SDK is compatible with Xcode 16 only.
  • If you’re using an earlier version of Xcode, you’ll need to upgrade before updating the SDK.

Minimum OS Version

  • The minimum supported iOS version is now iOS 13.0.
  • Please ensure your project’s deployment target is updated accordingly.

Module Name Change

  • As part of our ongoing efforts to standardize our module naming conventions, we have updated our SDK name from “Instabug“ to “InstabugSDK

Migration Steps

1. Update Import Statements

Swift

  • Before:
import Instabug
  • After:
import InstabugSDK

Objective-C

  • Before:
#import <Instabug/Instabug.h>
  • After:
#import <InstabugSDK/InstabugSDK.h>

2. Remove Strip Framework Script

  • If your project includes a Run Script Phase with a "Strip Frameworks Script", please remove it.
  • This script is no longer required and may cause build issues with the new SDK.

3. Ensure Minimum Deployment Target is iOS 13+

  • Go to your project settings and update the Deployment Target to iOS 13.0 or later.

Code Migration Examples

Swift

  • Before:

import Instabug  
// Initializing Instabug  
Instabug.start(withToken: "YOUR_TOKEN", invocationEvents: [.shake, .floatingButton])
  • After:

import InstabugSDK  // updated according to SDK 15.0 changes  
// Initializing Instabug  
Instabug.start(withToken: "YOUR_TOKEN", invocationEvents: [.shake, .floatingButton])

Objective-C

  • Before:

#import <Instabug/Instabug.h> 
// Initializing Instabug  
[Instabug startWithToken:@"YOUR_TOKEN" invocationEvents:IBGInvocationEventFloatingButton | IBGInvocationEventShake];
  • After:

#import <InstabugSDK/InstabugSDK.h>  // updated according to SDK 15.0 changes
// Initializing Instabug  
[Instabug startWithToken:@"YOUR_TOKEN" invocationEvents:IBGInvocationEventFloatingButton | IBGInvocationEventShake];