26.3 Release Notes¶
Patch Release Notes Mobile Development Kit Client 26.3.1¶
This patch release includes the following minor updates and important bug fixes for mobile development kit client 26.3.1:
- Fixed a create-client issue in Windows.
Mobile Development Kit Client 26.3.0¶
Minimum OS versions requirements for this release:
- iOS/iPadOS 26.x or newer (It has been tested with Xcode 26, iOS/iPadOS 26).
- Android OS 8.0 or newer (It has been tested with Android 12 / 13 / 14 / 15 / 16).
New Features and Enhancements Mobile Development Kit Client 26.3.0¶
Introduction of PreferredCaptionSize Property in Action Bar¶
The Action Bar now supports flexible caption sizing through the new PreferredCaptionSize property, which replaces the existing PrefersLargeCaption property. This new property PreferredCaptionSize lets you set the Action Bar caption size to "Small", "Medium", or "Large".
Note:
- iOS supports small and large caption size
- Android supports small, medium, and large caption size.
Behavior Notes:
- When
PreferredCaptionSizeis set to "large", any definedSubheadwill be ignored. - When setting
CaptionAlignment(Android only) to "center", thePreferCaptionSizeautomatically set to small. - On iOS, large caption mode is not supported on pages with
BottomNavigation,Tabs,SideDrawer,FormCellContainer, orFlexibleColumncontrols. -
If both
PreferredCaptionSizeand the deprecatedPrefersLargeCaptionproperty are specified,PreferredCaptionSizetakes precedence. -
For more information, refer to the
ActionBartopic.
Enhanced Troubleshooting with Offline Store Upload¶
-
A device's offline store can be valuable for troubleshooting issues in some cases. This new feature enables you to send the offline store (Both the main offline database (UDB) and the Request Queue database) to the server, assisting in the diagnostic process. To facilitate this capability, a new MDK action has been introduced:
Action.Type.OfflineOData.UploadStore. This action includes optional parameters, such as a temporary encryption key and a note for additional context. -
Before utilizing this feature, you must enable the Offline Store Upload Policy in SAP Mobile Services Admin UI for a given MDK app. Note that there is a maximum database size restriction of 1024 MB.
-
For more information, refer to the Working with Offline Stores topic.
RequiredIndicator Support for Segmented Form Cell¶
-
The Segmented Form Cell control now supports
RequiredIndicator, enabling you to add a mandatory field indicator to show that this form cell must be filled. This indicator is visual only and does not enforce validation; it indicates that the field is required. The default indicator is an asterisk * placed at the end of the caption or title. You can customize the indicator by specifying a different single character in the metadata using theRequiredIndicatorproperty. Only one character is allowed for customization. If you define more than one, the control defaults to the default asterisk indicator *. -
You can apply custom styling to the indicator using the
Stylesproperty with the style nameRequiredIndicator. This is supported through style classes, and you can set the indicator color using thefont-colororcolorproperty.
Onboarding via MDM App Configuration (Managed Configuration)¶
-
Onboarding via MDM App Configuration (Managed Configuration) is now supported. This feature streamlines the deployment and management of
MDKclients by enabling administrators to push configuration settings directly through their MDM solution (for example,Microsoft Intune). TheMDKclient retrieves configurations from theMDKSettingsroot property within the Managed Configuration, which currently accepts theConnectionSettingsobject. Managed Configuration is prioritized fourth in theConnectionSettingshierarchy, after URL/QR Scan, Local Overrides, and previous connection settings from URL/QR scan after successful onboarding, but before Branded Settings and Default Settings. TheEnableOverridesproperty controls whether settings can be replaced byOverrides.jsonor manual onboarding via QR code or URL. SetEnableOverridesto false in Managed Configuration to prevent replacements. TheMDKclient re-evaluates Managed Configuration settings when you log out or restart the app while logged out. Important: Previous connection settings from URL or QR code persist after successful onboarding, regardless ofEnableOverridesor Managed Configuration updates. You must reinstall the application to clear them. To prevent this, setEnableOverridesto false initially. -
For more information, see Onboarding to the Mobile Development Kit Client App topic.
Support In-App Camera in AttachmentFormCell (Android Only)¶
-
Introduced a new property in the
Application.appfile (underSettingsobject). This new property,UseInAppCamera, is of type boolean; by default, it is set to false. This flag determines whether to use the in-app camera for theAttachmentFormCellcontrol's "Take Photo" option. If set to true, the in-app camera would be used instead of the device's default camera. -
We have also introduced two new APIs. The first one is
getUseInAppCamera, to get the current value of this flag. This method is to get the current state of usage of in-app camera for Android Attachment form cell control. The second one issetUseInAppCamera. This method enables or disables the use of the in-app camera for the Android Attachment form cell control. The new value will be effective immediately. Specifically, for already rendered attachment form cell controls on the current page, it will only take effect after being reset via the control's reset() API. Note that calling the control's reset() API will discard the existing attachments. - For more information, see the
getUseInAppCameratopic.
Add Styling to KeyValueItem Control for iOS and Android¶
-
The purpose of this feature is to add a new
Stylesproperty to theKeyValueItemcontrol and to its two sub-controls:KeyNameandValue. ForKeyValueItem, theStylesproperty applies to the entire item and supports only the background color. ForKeyNameandValue, each sub-control accepts a style class string and supports standard label/text styling properties, such as font-size, font-color, color, and others. Please note thatValuestyle will take priority overLinkColor, regardless of whetherOnPressis defined or not. -
For more information, see the
KeyValueItemtopic.
Support for Initials in Contact Cell Component¶
- The Contact Cell component on iOS and Android now supports displaying user initials, providing a more personalized and recognizable visual experience when profile pictures are unavailable. This enhancement makes it easier to scan and identify contacts, replacing generic placeholder icons with meaningful initials.
- Three new properties have been introduced to support this feature. The
DetailImageTextproperty is a string that displays text in the image container when no detail image is present, showing 2-4 characters maximum, allowing you to manually specify custom text such as initials. TheDetailImageIsCircularproperty is a boolean with a default value of true that controls the shape of the image container — when set to true, the image displays in a circular shape, and when set to false, it displays in a rounded rectangular shape. TheUseHeadlineForDetailImageproperty is a boolean with a default value of false that, when set to true and noDetailImageis provided, automatically extracts and displays the first two initials from theHeadline propertyin the image container; this property takes precedence overDetailImageText.