Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Dynamics Bindings for Microsoft.iOS 12.1
  3. BlackBerry Dynamics SDK for Microsoft .NET Release Notes
  4. BlackBerry Dynamics SDK for Microsoft.Maui 12.1

BlackBerry Dynamics SDK for Microsoft.Maui
 12.1

What's new in the
BlackBerry Dynamics SDK for Microsoft.Maui
 version 12.1 Hotfix

Feature
Description
Changes to the SDK and software requirements
  • This release requires
    Xcode
     15.2 or later for
    Microsoft.iOS
     17.5.8020 or later.
  • This release supports Maui version 8.0.72. For more information, see Maui Nightly Builds and NuGet Central Package Management.
  • Maui version 8.0.70 and later includes lifecycle changes and the fix for a key issue. As a result, AppDelegate can no longer be used, and must inherit from the standard MauiUIApplicationDelegate (this is a change from the 12.1 release). For more information, see the AppDelegate.cs sample.

What's new in the
BlackBerry Dynamics SDK for Microsoft.Maui
 version 12.1

This release was updated with the latest
BlackBerry Dynamics Bindings for Microsoft.iOS
 and
BlackBerry Dynamics Bindings for Microsoft.Android
.
The
BlackBerry Dynamics SDK
 supports
Microsoft.Maui
 for
Android
 and
iOS
.
Microsoft.Maui
 is a framework that developers can use to create user interfaces that can be used across platforms. For more information, see About the BlackBerry Dynamics SDK for Microsoft.Maui and the BlackBerry Dynamics SDK for Microsoft.Maui API Reference.
Feature
Description
Changes to the SDK and software requirements
  • This release requires
    Xcode
     15.1 or later for
    Microsoft.iOS
     17.2.8004 or later.
  • This release supports
    Android
     Target Framework API 34 or later.
  • This release supports Maui version 8.0.21. For more information, see Maui Nightly Builds and NuGet Central Package Management.
  • AppDelegate must inherit from BBDAppDelegate to meet the SDK configuration requirements. For reference, see the AppDelegate.cs sample.
.NET upgrade
.NET has been upgraded to version 8.0. For more information, see the
Microsoft
 resource What's new in .NET MAUI for .NET 8 and the
GitHub
 resource Upgrading .NET MAUI from .NET 7 to .NET 8.
Removal of unused or redeclared packages
The following package references were removed because they were unused or redeclared:
  • Microsoft.Maui.Controls.Compatibility
  • Xamarin.AndroidX.Legacy.Support.V4
  • Xamarin.Google.Android.Material

Known issues

The
iOS
 screenshot prevention feature supported for
Microsoft.iOS
 does not work with the
BlackBerry Dynamics SDK for Microsoft.Maui
 due to differences in how Maui handles core UI elements.
On
Android
, if an app displays dialog from an activity that was already destroyed, the app will stop functioning.
Workaround
: Developers can use the custom Dialog and ActionSheet implementations found in the PageBase.cs file of the AppKineticsService and SampleAppSuite sample apps in the
BlackBerry Dynamics SDK for Microsoft.Maui
 package. For more information, see 15024
The UI Preferences for
Microsoft Visual Studio
 experiences issues for SingleProject type projects and projects where multiple or specific mobile OS target versions are specified. Developers should always use source code in the .csproj file for reference. For more information, see 10316394.
User interface tests on
iOS
 16 are not yet working due to Xamarin packages incompatibility. For details, developers should refer to the information from Microsoft https://github.com/microsoft/appcenter/issues/2475 to see when this issue is resolved and they can update relevant packages.
Due to a
Microsoft Visual Studio
 for
Mac
 packaging issue, a runtime error might occur after switching to library level ProGuard dependencies.
Workaround
: Clean bin/obj project folders, clean project, restore dependencies, rebuild, and then deploy the application. In addition, when switching between
Microsoft Visual Studio
 for
Mac
 and your terminal (CLI dotnet build), the bin/obj folders must be cleaned or the "--no-incremental" parameter must be used. A build time warning has been added to the sample applications to pay special attention to this issue.