iOS SDK

MT iOS SDK v5.3.2

Update Date

• 2026-03-17

Updates

• Fixed known MA bugs.

Update Guide

• MA Feature Integration Documentation
• MA API Documentation

Verification Info

• File name: sdk-iOS-5.3.2.zip
• SHA256: 113191deb4e0ea7d17cef1b6f6cb02fbab277e086c33d46e30fb5bc16c1d3bc5

MT iOS SDK v5.3.0

Update Time

• 2025-12-30

Updates

• iOS now supports SPM integration.
• The integration documentation now supports both Objective-C and Swift.
• Performance optimizations and known bug fixes.

MT iOS SDK v5.2.3

Update Date

• 2025-11-21

Updates

• Optimized the functional logic for MA event reporting.
• Fixed known MA bugs.

Update Guide

• MA Feature Integration Documentation
• MA API Documentation

MT iOS SDK v5.2.1

Update Time

• 2025-11-05

Updates

• Fixed known MA bugs.

Update Guide

• MA Feature Integration Documentation
• MA API Documentation

MT iOS SDK v5.2.0

Update Date

• September 26, 2025

Updates

• Supports the target conversion rate feature.
• iOS: Added a callback API for setting badges. - (void)setBadge:(NSInteger)value completion:(void (^)(NSError *error))completion;.
• Fixed known issues.

MT iOS SDK v5.1.0

Update Date

• July 29, 2025

Update Content

• Added the setEnableResetOnDeviceChange interface to control whether the SDK re-registers when the device model changes.
• Feature optimizations and known bug fixes.

MT iOS SDK v5.0.1

Update Time

• 2025-05-21

Updates

• Fixed known bugs.

MT iOS SDK v5.0.0

Update Time

• 2025-03-20

Update Content

• The MA function is newly launched, which supports reporting user behavior data required for marketing automation on the SDK side. The following API functions are supported:
• This function is an optional feature.
  • Set user identification
  • Set user contact information
  • Get EUID
  • Set UTM properties
  • Set and delete user properties
  • Report events
  • Set the report interval of uploaded data
  • Set the upper limit of event cache entries
  • Set the session timeout
  • Data collection control
• Fixed known bugs.

Update Guide

• MA Function Integration Document
• MA API Interface Document

MT iOS SDK v4.5.4

Update Date

• December 31, 2024

Change Log

• Added support for switching AppKey functionality. You can switch AppKey by calling the initialization method.
• Introduced a new VoIP Token unbinding method: + (void)unregisterVoipToken:(MTPushVoipTokenCompletion)completion;

Update Guide

Explanation of AppKey switching functionality

• Before switching the AppKey, you must proactively call the VoIP Token unbinding method and set the real-time activity token reporting interface to nil. After switching the AppKey, you need to re-upload the VoIP Token and real-time activity token.

MT iOS SDK v4.5.1

Update Date

• October 11, 2024

Changelog

• The enhanc_message feature is designed for notification bar message types and can be enabled for users who have disabled notification permissions. Once enabled, when the user runs the app in the foreground, the notification bar message content will be displayed as an in-app message to increase message visibility.
• The notification enhancement feature can be enabled via the WebPortal in the "Create Push" section under "Advanced Settings" or by setting the option_enhanc_message field to true in the Create Push API through the Rest API.

Update Guide

• SDK API Guide。

MT iOS SDK v4.5.0

Update Time

• September 19, 2024

Change Log

• Support for in-app messages.

MT iOS SDK v4.4.0

Update Time

• July 05, 2024

Release Notes

• Added support for iOS live activity messages.
• Added support for voip messages.

Update Guide

Please refer to the Real-time Activity Best Practices for more information.

MT iOS SDK v4.3.5

Update Time

• 2024-05-27

Update Log

• Supports automatic adaptation to the AppKey's data center node.

MT iOS SDK v4.3.4

Update Time

• 2024-05-08

Update Log

• Added support for voice broadcast of push content, suitable for various push scenarios such as "payment received announcements" and "bus arrival announcements."

Update Guide

Prerequisites for using the voice broadcast feature: The application needs to enable the appgroups feature and activate App Groups in Xcode. Both the extension program and the main project need to activate this feature and fill in the value of App Groups.

Before initializing MTPush, execute the following code:

              
                // Set App Group ID (please replace with your actual App Group ID).
  [MTPushService setAppGroupId:@"group.jiguang.hxhg"];

  // Enable the text-to-speech feature for push notifications.
  [MTPushService enablePushTextToSpeech:YES];

  // In your notification extension:

  // Set App Group ID in the notification extension.
  [MTNotificationExtensionService mtpushSetAppGroupId:@"group.jiguang.hxhg"];

  // Set site name, for example "Singapore".
  [MTNotificationExtensionService setSiteName:@"Singapore"];

  // Set Appkey (please replace with your actual Appkey).
  [MTNotificationExtensionService mtpushSetAppkey:@"dab1134204a962d4ca905cce"];

  // Log the start of processing the voice file.
  NSLog(@"start - Begin processing voice file");

  // Process the voice.
  [MTNotificationExtensionService handleVoice:request with:^(NSString *soundName) {

    // Assign a custom sound to the notification.
    self.bestAttemptContent.sound = [UNNotificationSound soundNamed:soundName];

    // Log the end of processing the voice file.
    NSLog(@"stop - End processing voice file");

    // Process the notification request.
    [MTNotificationExtensionService mtpushReceiveNotificationRequest:request with:^ {

      // Log the successful upload to APNS.
      NSLog(@"apns upload success");

      // Complete the modification of the notification content.
      self.contentHandler(self.bestAttemptContent);

    }];
  }];

            

MT iOS SDK v4.3.3

Update time

• 2024-03-08

Change Log

• New support for data nodes in Frankfurt, Germany.
• Add privacy list to adapt to the latest Apple policies.

MT iOS SDK v4.3.2

Update time

• 2023-11-06

Change Log

• Fixed known bugs.

MT iOS SDK v4.3.1

Update time

• 2023-09-23

Change Log

• Solve the problem of compiling errors in xcode15 using cocoapods integration.
• Fixed known bugs.

MT iOS SDK v4.3.0

update time

• 2023-08-23

change log

• Support configuration data center function.
• Support API function for setting user language (setUserLanguage).
• Fix known bugs.

MT iOS SDK v3.5.0

update time

• 2023-05-15

change log

• Support tag/alias push.

MT iOS SDK v3.3.0

Release Date

• 2023-04-04

Change Log

• Added tcp encryption interface, please call [MTPushService setTcpSSL:YES] before initializing the interface.