Migration to Swift SDK

Netmera is introducing a significant update to its mobile SDKs. To align with modern iOS development practices, the Objective-C SDK will be officially designated as legacy in October 2026. All customers are advised to migrate to the Swift SDK, which offers:

• Simplified setup and maintenance

• Modular, lightweight architecture

• Support for modern iOS capabilities (Live Activities, Deferred Deep Linking, WhatsApp)

• Enhanced reliability with offline queueing

• Advanced user preference and profile management

Docs:

• New Swift SDK

• Former Objective-C SDK

1) Installation & Project Setup

1.1 Remove Former SDK

• Remove CocoaPods or manually added frameworks referencing the Objective-C SDK.

• Run pod deintegrate if previously using CocoaPods and clean the build folder.

1.2 Install New Swift SDK (Recommended: SPM)

1. In Xcode, navigate to Project → Package Dependencies → +.

2. Add the Swift package URL: https://github.com/Netmera/swift-sdk.

3. Select only the required modules to reduce app size: Core, Notifications, Analytics, Location, Inbox, Advertising ID, Live Activities.

1.3 Configuration File

Add or update Netmera-Config.plist as required by the new SDK.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>sdk_params</key>
        <dict>
            <key>api_key</key>
            <string>your_api_key</string>
        </dict>
    </dict>
</plist>

Ensure environment keys, base URLs (for on-prem deployments), and app group identifiers (for media and carousel push) are configured. For details: Further Plist Configurations.

2) Choosing Modules & Imports (Swift SDK)

Import only required modules to minimize app size and improve build times.

Module	Purpose	Target
NetmeraNotification	Push permissions, token, delegate, deep links	App
NetmeraAnalytic	Send events (+ optional autotracking)	App
NetmeraAnalyticsAutotracking	Automatic screen transition and action tracking	App
NetmeraNotificationInbox	Push Inbox list/detail	App
NetmeraLocation	Location features	App
NetmeraGeofence	Geofence features	App
NetmeraAdvertisingId	IDFA/IDFV access	App
NetmeraLiveActivity	ActivityKit live activities	App (iOS 16.1+)
NetmeraNotificationServiceExtension	Rich/Media push processing	Notification Service Extension
NetmeraNotificationContentExtension	Custom push UI, Carousel & Slider Push	Notification Content Extension

NetmeraCore is imported automatically with any other module.

3) Initialization

Former iOS SDK

// AppDelegate.swift
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
	Netmera.start()
	Netmera.setAPIKey("YOUR_CLIENT_API_KEY")
	Netmera.setLogLevel(NetmeraLogLevel.debug)
	return true
}

New iOS SDK (Swift)

// AppDelegate.swift
func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
	Netmera.initialize()  
	Netmera.setLogLevel(.debug) 
	return true
}

4) Push Notifications

4.1 Permission & Token Flow

Former iOS SDK

Netmera.requestPushNotificationAuthorization(forTypes: [.alert, .badge, .sound]) 

New Swift SDK

Netmera.requestPushNotificationAuthorization(for: [.alert, .badge, .sound])

5) User & Attributes

Netmera.updateUser() is deprecated. Use Netmera.identifyUser(user) for identifiers and Netmera.updateUserProfile(userProfile: userProfile) for profile attributes.

Action Required for Custom Profile Attributes

• Update custom profile attributes using the snippet generated in the Netmera Dashboard. Developers → Profile Attributes → User Class → iOS → Swift (New) → copy the snippet and replace the existing user class.

Array-type profile attributes can now be updated incrementally (set / add / remove / unset) to avoid sending the entire array.

More details → User & Attributes

6) Events (Analytics)

Action Required for Custom Events

• Standard events remain unchanged.

• For custom events, regenerate and replace event code from Developers → Events in the panel. Select the event → Code → iOS → Swift (New) and update the project with the snippet.

Netmera SDK Function Mapping (Obj-C → Swift)

NetmeraCore

Obj-C	Swift	Description
[Netmera start];	Netmera.initialize()	SDK init
[Netmera updateUser:user];	Netmera.identifyUser(user)	IDs (userId, email, msisdn)
[Netmera updateUser:user];	Netmera.updateUserProfile(userProfile: userProfile)	Profile attributes
[Netmera startDataTransfer]; / [Netmera stopDataTransfer];	Netmera.setDataTransferEnabled(true)	Data transfer control
–	Netmera.isNetmeraRemoteMessage(payload:)	Detect Netmera push payload
[Netmera setAllowedEmailSubscription:YES];	Netmera.setEmailPermission(isAllowed: true)	Email subscription
[Netmera isAllowedEmailSubscription]	Netmera.getEmailPermission { ... }	Get email permission
–	Netmera.setSmsPermission(isAllowed: true)	SMS subscription
–	Netmera.getSmsPermission { ... }	Get SMS permission
–	Netmera.setAdditionalRequestHeaders(dict)	Add request headers

NetmeraAdvertisingId

Obj-C	Swift	Description
Netmera.requestTrackingAuthorization()	Netmera.requestAdvertisingAuthorization()	Ad ID consent

NetmeraNotification

Obj-C	Swift	Description
[Netmera setEnabledPopupPresentation:YES];	Netmera.setPopupPresentationEnabled()	Popup push
Netmera.setEnabledInAppMessagePresentation()	Netmera.setInAppMessagePresentationEnabled()	In-app messages
[Netmera setEnabledReceivingPushNotifications:YES];	Netmera.setReceivingPushNotificationsEnabled()	Push receiving
[Netmera isEnabledReceivingPushNotifications]	Netmera.isReceivingPushNotificationsEnabled()	Push status check
Netmera.requestPushNotificationAuthorizationForTypes:	Netmera.requestPushNotificationAuthorization(for:)	Push permissions
Netmera.setUserCategoryPreferenceWithCategoryId:	Netmera.setUserCategoryPreference(categoryId:categoryEnabled:){...}	Category preference

NetmeraNotificationInbox

Obj-C	Swift	Description
NetmeraInboxFilter + fetchInboxUsingFilter	NetmeraInboxManager + inbox(callback:)	Fetch inbox notifications
fetchInboxCount(with:)	inboxManager?.count(for:)	Inbox count by status
fetchNextPageWithCompletionBlock	inboxManager?.nextPage(callback:)	Pagination
updateStatus:forPushObjects:	inboxManager?.updateStatus(status, for: [object]) { ... }	Update status for selected objects
updateStatus:forAllWithCompletion:	inboxManager?.updateStatusForAllPushObjects(status) { ... }	Bulk status update