.NET Package Changelog

The latest updates to the Airship .NET MAUI library.

View as Markdown
Note

See the SDK Support Policy for version coverage and maintenance windows.

21.5.1 September 24, 2026

Patch release that restores the public Message Center event APIs that were unintentionally removed in 21.5.0. Code written against 21.4.0 and earlier compiles and behaves as it did before; the restored members are deprecated in favor of their replacements on the Airship facade.

Changes

  • Restored IAirshipMessageCenter.OnMessagesUpdated and IAirshipMessageCenter.OnMessageCenterDisplay, now deprecated in favor of Airship.Instance.OnMessageCenterUpdated and Airship.Instance.OnDisplayMessageCenter
  • Restored Airship.Instance.OnMessageCenterDisplay, now deprecated in favor of Airship.Instance.OnDisplayMessageCenter
  • Restored the AirshipEventType members BackgroundPushReceived, BackgroundNotificationResponse and ForegroundNotificationResponse, now deprecated. All AirshipEventType values are now pinned explicitly so that deprecating or adding a member can no longer renumber the others
  • Note: on iOS, a Message Center display request without a message ID now fires the display event with a null MessageId. In 21.4.0 and earlier this callback was silently dropped, so a display delegate set by the app was never invoked for a plain display request
  • Note: events raised while no handler is attached are now queued and delivered when a handler subscribes. In 21.4.0 and earlier they were dropped

22.0.0 September 24, 2026

Major release that updates the native SDKs to Airship SDK 21, raises the Android minimum to API 26, and consolidates lifecycle events onto the Airship.Instance facade.

Changes

  • Updated iOS SDK to 21.0.2 
  • Updated Android SDK to 21.0.2 
  • Updated Android minimum version to API 26 (Android 8.0)
  • Moved Message Center events onto the Airship.Instance facade: Airship.MessageCenter.OnMessagesUpdated -> Airship.Instance.OnMessageCenterUpdated, and OnMessageCenterDisplay -> Airship.Instance.OnDisplayMessageCenter
  • Collapsed the background and foreground variants of AirshipEventType into PushReceived and NotificationResponse
  • Added OnPushReceived, OnNotificationResponse, OnPushTokenReceived and OnDisplayPreferenceCenter events on Airship.Instance, with typed event args
  • Added OnAuthorizedNotificationSettingsChanged event on Airship.Instance (iOS)
  • Added six Permission values for the system-permission actions used by Scenes: AppTrackingTransparency, Camera, Microphone, Bluetooth, PhotoLibrary, Contacts
  • Added the Features.OnDeviceAI privacy feature flag
  • Added Airship.Net.CustomViews, a new package for registering MAUI views that Scenes can render inline
  • Added Airship.AI for supplying app context to on-device AI evaluations, with SetContextProvider and SetDefaultContextProvider
  • Removed the Message Center user credentials and native bridge bindings (UAMessageCenterUser, UAMessageCenterNativeBridge), removed from the native iOS SDK
  • Removed the background-fetch app integration method, removed from the native iOS SDK
  • Updated Microsoft.Maui.Controls to 10.0.110 (from 9.0.0), aligning the MAUI version with the net10.0 target
  • Apps built against the iOS 27 SDK must now declare a UIApplicationSceneManifest; see the Migration Guide for the required values
  • Building from source now requires Xcode 27 and JDK 17

See the Migration Guide  for upgrade instructions.

21.5.0 September 9, 2026

Minor release that updates the iOS SDK to 20.12.1 and Android SDK to 20.12.0.

Changes

21.4.0 August 3, 2026

Minor release that updates the iOS SDK to 20.7.0 and Android SDK to 20.7.0.

Changes

21.3.0 March 21, 2026

Minor release that updates the iOS SDK to 20.6.0 and Android SDK to 20.4.0, adding Native Message Center support, Scene improvements, and fixing deep links in Message Center messages on iOS.

Changes

  • Updated iOS SDK to 20.6.0
  • Updated Android SDK to 20.4.0
  • Fixed deep links inside Message Center messages not working on iOS
  • Adjusted Markdown rendering in Scenes to be less aggressive when interpreting styling delimiters inside words
  • Improved Scene border rendering when rounded corners are present
  • Improved accessibility for single choice and multiple choice questions in Scenes (iOS)
  • Fixed Message Center unread indicator to only show for unread messages (iOS)

21.2.0 February 1, 2026

Minor release that adds programmatic deep link handling for iOS.

Changes

  • Updated iOS SDK to 20.3.0
  • Added Airship.ProcessDeepLink() for programmatic deep link handling (iOS)

21.1.0 January 30, 2026

21.0.0 January 21, 2026

Major release that moves Message Center inbox functionality into the main package, updates native SDKs to 20.1.1, and upgrades to .NET 10.

Changes

  • Updated to .NET 10.0 (net10.0-android and net10.0-ios)
  • Updated iOS SDK to 20.1.1
  • Updated Android SDK to 20.1.1
  • Moved Message Center inbox functionality (IAirshipMessageCenter, Message model) from Airship.Net.MessageCenter to Airship.Net
  • Changed Message Center access pattern from extension method to static property: Airship.Instance.MessageCenter() → Airship.MessageCenter
  • Airship.Net.MessageCenter package now contains only MAUI UI components (Controls)
  • Updated iOS minimum version to iOS 16+
  • Updated MAUI Controls dependency to 9.0.0

See the Migration Guide  for upgrade instructions.

20.2.1 January 2, 2026

Minor release to update SDKs and resolve crashes caused by calling iOS SDK methods on background threads instead of the main thread.

Changes

  • Resolve crashes caused by calling iOS SDK methods on background threads instead of the main thread.
  • Updated iOS SDK to 19.11.5
  • Updated Android SDK to 19.13.6

20.2.0 October 8, 2025

Minor release that updates the SDKs and restores onMessageCenterDisplay.

Changes

  • Restored onMessageCenterDisplay that was erroneously removed in version 20.0.0.
  • Updated iOS SDK to 19.11.0
  • Updated Android SDK to 19.13.4

20.1.0 August 26, 2025

Minor release that updates the SDKs and fixes a build signing issue with iOS.

Changes

  • Removed embedded framework that failed to be signed during a release build.
  • Updated iOS SDK to 19.8.2
  • Updated Android SDK to 19.11.0

20.0.0 August 11, 2025

Major release with complete interface modernization and architectural improvements.

Changes

  • Updated iOS SDK to 19.6.1
  • Updated Android SDK to 19.8.0
  • Complete interface modernization - split monolithic IAirship into module-specific interfaces
  • Changed access pattern from instance-based to static module properties
  • All async operations now return Tasks
  • Merged Message Center functionality into main Airship.Net package
  • Added iOS AirshipWrapper to handle Swift async method compatibility
  • Improved type safety and separation of concerns across modules

19.5.0 February 8, 2025

Minor release that updates the Android SDK to 18.7.0, including AndroidX library updates.

Changes

  • Updated Android SDK to 18.7.0

19.4.1 December 13, 2024

Minor release that updates the Airship.Net package to no longer depend on MAUI and adds methods to fetch channel and contact subscription lists to the cross-platform library.

Changes

  • Removed unnecessary MAUI dependency from Airship.Net
  • Added FetchChannelSubscriptionLists and FetchContactSubscriptionLists methods to Airship.Net
View Older Releases →