Migration to 3.x

Netmera Flutter SDK 3.x.x aligns the iOS layer with the Swift-based Netmera SDK and includes Dart API updates. The Objective-C–based iOS SDK is scheduled to become legacy as of October 2026; Flutter apps should move the native layer to the new flow.

Notation: Lines prefixed with - are removed or show the old form; lines prefixed with + are added or show the new form. For larger blocks, the line before the block uses Remove / Add / Replace.

1) Installation and project setup

1.1 pubspec.yaml

Replace

- netmera_flutter_sdk: 2.x.x

+ netmera_flutter_sdk: ^3.x.x

1.2 iOS configuration file

For compatibility with the Swift Netmera SDK, use **Netmera-Config.plist** (or equivalent), target membership, and extension setup as described in the Netmera iOS documentation (main app and Notification Extension targets where applicable).

<?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>app_group_name</key>
            <string>group.com.netmera.flutter</string>
            <key>api_key</key>
            <string>your_api_key</string>
        </dict>
    </dict>
</plist>

Important: Target Membership

Make sure Netmera-Config.plist is added to the correct Target Membership in Xcode.

It must be included in:

• Main App Target

• Notification Service Extension (if used)

• Notification Content Extension (if used)

2) iOS

2.1 Podfile

Replace (Media Push / extension pod names and versions)

- pod "Netmera", "3.x.x"
- pod "Netmera/NotificationServiceExtension", "3.x.x"
- pod "Netmera/NotificationContentExtension", "3.x.x"

+ pod 'NetmeraNotificationServiceExtension', "4.17.0"
+ pod "NetmeraNotificationContentExtension", "4.17.0"

Add — inside post_install, after flutter_additional_ios_build_settings(target) (Swinject distribution setting):

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
# Add
    target.build_configurations.each do |config|
      if target.name.include?('Swinject')
        target.build_configurations.each do |config|
          config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
        end
      end
    end
# Add
  end
end

Then run pod install.

2.2 AppDelegate.swift

Add — imports

  import UIKit
  import Flutter
+ import netmera_flutter_sdk
+ import NetmeraCore
+ import NetmeraNotification

Replace — class declaration (NetmeraPushDelegate moves to a separate extension)

- @objc class AppDelegate: FlutterAppDelegate, NetmeraPushDelegate {

+ @objc class AppDelegate: FlutterAppDelegate {

Remove — manual bridge when opening a push from a force-quit app via launchOptions

- let notification = launchOptions?[.remoteNotification]
- if notification != nil {
-     FNetmeraService.handleWork(ON_PUSH_RECEIVE, dict:["userInfo" : notification])
- }

Remove

- FNetmera.logging(true)
- FNetmera.initNetmera("")
- Netmera.setBaseURL("")
- Netmera.setAppGroupName("")

// If you do not use onWidgetUrlTriggered
- FNetmera.setPushDelegate(self)

Note: If your media push setup requires an App Group, configure it in Netmera-Config.plist or wherever the Swift SDK expects it; in this example the setAppGroupName call is removed.

Add — in didFinishLaunching (if you use Firebase, keep the delegate line; if not, you may remove the UNUserNotificationCenter line)

+ UNUserNotificationCenter.current().delegate = self

Remove — push token and remote notification bridge handlers

- override func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
-     FNetmeraService.handleWork(ON_PUSH_REGISTER, dict: ["pushToken": deviceToken])
- }

Remove — tap / dismiss handling that calls FNetmeraService.handleWork (didReceive response)

- @available(iOS 10.0, *)
- override func userNotificationCenter(_ center: UNUserNotificationCenter,
-                                      didReceive response: UNNotificationResponse,
-                                      withCompletionHandler completionHandler: @escaping () -> Void) {
-     ...
-     FNetmeraService.handleWork(ON_PUSH_DISMISS, ...)
-     FNetmeraService.handleWork(ON_PUSH_OPEN, ...)
-     completionHandler()
- }

Remove — legacy willPresent (only .alert + handleWork)

- @available(iOS 10.0, *)
- override func userNotificationCenter(..., willPresent notification: UNNotification, ...) {
-     completionHandler([UNNotificationPresentationOptions.alert])
-     if UIApplication.shared.applicationState == .active {
-         FNetmeraService.handleWork(ON_PUSH_RECEIVE, ...)
-     } else {
-         FNetmeraService.handleWork(ON_PUSH_RECEIVE_BACKGROUND, ...)
-     }
- }

Add — if you use Firebase, add the new willPresent (presentation options; no handleWork)

+ @available(iOS 10.0, *)
+ override func userNotificationCenter(
+   _ center: UNUserNotificationCenter,
+   willPresent notification: UNNotification,
+   withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void
+ ) {
+     if #available(iOS 14, *) {
+       completionHandler([.banner, .list, .badge, .sound])
+     } else {
+       completionHandler([.alert, .badge, .sound])
+     }
+ }

Add — if you use onWidgetUrlTriggered

+ extension AppDelegate: NetmeraPushDelegate {
+     func urlOpeningDecision(for url: URL, push: NetmeraBasePush) -> PushDelegateDecision {
+         return .sdkHandles
+     }
+     func openURL(_ url: URL, for push: NetmeraBasePush) {
+         FNetmera.openURL(url: url, forPushObject: push)
+     }
+ }

2.3 Runner-Bridging-Header.h

Objective-C headers are no longer required for the Swift bridge.

Remove

- #import "FNetmera.h"
- #import "FNetmeraService.h"
- #import "NetmeraFlutterSdkPlugin.h"

2.4 Media Push

Update the following files as shown.

NotificationService.swift

import UserNotifications
import NetmeraNotificationServiceExtension

class NotificationService: NotificationServiceExtension {
  override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
    super.didReceive(request, withContentHandler: contentHandler)
  }

  override func serviceExtensionTimeWillExpire() {
    super.serviceExtensionTimeWillExpire()
  }
}

NotificationViewController.swift

import UserNotifications
import UserNotificationsUI
import NetmeraNotificationContentExtension

class NotificationViewController: NotificationContentExtension {
  override func viewDidLoad() {
    super.viewDidLoad()
  }

  override func didReceive(_ notification: UNNotification) {
    super.didReceive(notification)
  }
}

Note: Enable the App Groups capability on your Notification Service Extension target if required by your setup.

Notification Service Extension Configuration

You must update the NSExtensionPrincipalClass value in your Service Extension's Info.plist file:

Ensure your NSExtensionPrincipalClass is updated from NotificationService to $(PRODUCT_MODULE_NAME).NotificationService.

Note: Please double-check your configuration against our Media Push Guide - Step 6 to ensure media content and push notifications are handled correctly during the transition.

3) Dart

3.1 User identification

Replace — use identifyUser and updateUserProfile instead of updateUser

NetmeraUser user = new NetmeraUser();
user.setUserId("...");
user.setEmail("...");
user.setMsisdn("...");
user.setWhatsAppNumber("...");

Netmera.identifyUser(user);

// or

Netmera.identifyUser(user,
  onSuccess: () {
    ...
  },
  onFailure: (error) {
    ...
  });    

NetmeraUserProfile profile = new NetmeraUserProfile();
profile.name.set("...");
profile.surname.set("...");
profile.dateOfBirth.set(DateTime(2000, 1, 1).millisecondsSinceEpoch);
profile.gender.set(Gender.notSpecified);

Netmera.updateUserProfile(profile);

// or

Netmera.updateUserProfile(profile,
  onSuccess: () {
    ...
  },
  onFailure: (error) {
    ...
  });

For more detail, see the official Netmera / package documentation for your SDK version.

4) Removed methods

• Netmera.updateUser

• Netmera.updateUserAsync

• Netmera.setApiKey

• Netmera.setBaseUrl

• Netmera.skipAppConfigAndSetBaseUrl

• Netmera.handleLastMessage

iOS native: FNetmera.initNetmera

5) Function Mapping

2.x and below	3.x and above	Description
Netmera.updateUser and Netmera.updateUserAsync	Netmera.identifyUser and Netmera.updateUserProfile	User identification and profile updates
Netmera.setBaseUrl and Netmera.skipAppConfigAndSetBaseUrl	Please use Netmera-Config.plist and FNetmeraConfiguration	Change base url at runtime
Netmera.setApiKey	Please use Netmera-Config.plist and FNetmeraConfiguration	Change API key at runtime
Netmera.setAppGroupName	Please use Netmera-Config.plist and Define in Signing & Capabilities	iOS Rich Media Push
Netmera.turnOffSendingEventAndUserUpdate	Netmera.startDataTransfer and Netmera.stopDataTransfer	Data transfer management
Netmera.areNotificationsEnabled	Netmera.checkNotificationPermission	Notification permission status