iOS Messaging SDK - Version 2.9.0

Version 2.9 planned roll-out: November 12th 2017

Version Specific System Requirements Document

These are the main feature releases available in the Mobile App Messaging SDK version 2.9 for iOS.

New functionalities

Xcode 9.1 and Swift 4.0.2 Support

Type: Developer Experience Feature

Available to all customers? Yes

The Mobile App Messaging SDK v2.9 was built and certified with Xcode 9.1 in Swift 4.0.2.

Customers wishing to use the Mobile App Messaging SDK v2.9 must upgrade their Xcode to 9.1 and their Swift version to 4.0.2.

iPhone X Device Support

Type: Device Support Feature

Available to all customers? Yes

The Mobile App Messaging SDK v2.9 is now supported on the iPhone X.

New parameters

Branding and configuration parameters

Type: Parameters

Available to all customers? Yes

The Mobile App Messaging SDK v2.9 exposes additional branding configuration parameters.

New parameters may control text, padding of conversation UI elements and more.

Parameter name and default value Description Image
customFontNameDateSeparator: String? Custom font for Timestamp. Fonts that are not part of the iOS families must be defined in the App's Info.plist. fontname
dateSeparatorFontSize : UIFontTextStyle = .footnote Defines the Date Separator font text style. fontsize
dateSeparatorTopPadding: Float = 0.0 Defines the Date Separator top spacing. toppadding
dateSeparatorBottomPadding: Float = 0.0 Defines the Date Separator bottom spacing. bottompadding
remoteUserAvatarLeadingPadding: Float = 8.0 Defines the remote avatar leading spacing (from the left edge to the avatar). leadingpadding
remoteUserAvatarTrailingPadding: Float = 8.0 Defines the remote avatar Trailing spacing (from the avatar to the bubble). trailingpadding
bubbleTopPadding: Float = 10.0 Defines the bubble top spacing. bubbleTopPadding
bubbleBottomPadding: Float = 10.0 Defines the bubble bottom spacing. bubbleBottomPadding
bubbleLeadingPadding: Float = 10.0 Defines the bubble leading spacing. bubbleLeadingPadding
bubbleTrailingPadding: Float = 10.0 Defines the bubble trailing spacing. bubbleTrailingPadding
inputTextViewTopBorderColor: UIColor = UIColor.clear Input TextView top border color. The default color is clear.
conversationSeparatorFontSize: UIFontTextStyle = .caption1 Defines the Conversation Closed separator font size. separatorfont
conversationSeparatorFontName: String? Custom font name for Conversation Closed separator. Fonts that are not part of the iOS families must be defined in App's Info.plist. separatorfontname
conversationSeparatorTopPadding: Float = 5.0 Defines the Conversation Closed Separator Top spacing. separatortoppadding
conversationSeparatorBottomPadding: Float = 7.0 Defines the Conversation Closed label to separator line spacing. separatorbottompadding
conversationSeparatorViewBottomPadding: Float = 7.0 Defines the conversation separator view bottom spacing. viewbottompadding
customRefreshControllerImagesArray:Array<UIImage>? = nil Array of images for creating the custom refresh controller. The controller will loop the images; two or more images are required for the array to take effect. imagesarray
customRefreshControllerAnimationSpeed:Float = 2 Custom refresh controller speed animation; defines the full images loop time. A smaller value will create a higher speed animation.
bubbleTimestampTopPadding: Float = 2.0 Defines the bubble Timestamp top spacing. timestamptoppadding
bubbleTimestampBottomPadding: Float = 5.0 Defines the bubble Timestamp bottom spacing. timestampbottompadding