Repository navigation
Releases
2.1.0
Both packages now ship a .NET 10 build next to the .NET 8 one, and the bundled native SDKs move to
the latest releases. The managed API is unchanged. Three things need a look before upgrading: the iOS
minimum is now 15.0, Pushwoosh.DotNet.Geozones has to be updated together with Pushwoosh.DotNet, and
PWInlineInAppView no longer shows anything.
Packages
- Pushwoosh.DotNet: 2.1.0
- Pushwoosh.DotNet.Geozones: 2.1.0
Native SDKs
- Android SDK: 6.17.0 (was 6.10.0)
- iOS SDK: 7.2.10 (was 6.7.18)
Before you upgrade
iOS minimum 11.0 → 15.0. The native Pushwoosh iOS SDK 7.x frameworks are built for iOS 15.0.
An app with a lower minimum would build and then crash at launch on iOS 11–14, so the package now
stops such a build with error PW0001. Set SupportedOSPlatformVersion for the iOS target to 15.0
or higher. The MAUI 8 project template sets 11.0, so a new MAUI 8 app has to raise it. The iOS lib
folder is renamed lib/net8.0-ios11.0 → lib/net8.0-ios15.0; NuGet does not pick folders by it, so
restore is not affected.
Update both packages together. Pushwoosh.DotNet.Geozones 2.0.x is linked against the iOS SDK
6.x and crashes at launch with the 7.x frameworks that Pushwoosh.DotNet 2.1.0 ships. An app that
updates only Pushwoosh.DotNet and keeps Geozones 2.0.x now stops at build time with error PW0002;
update Pushwoosh.DotNet.Geozones to 2.1.0 as well. Android is not affected.
PWInlineInAppView is obsolete and shows nothing. The native iOS SDK 7.x removed inline in-app
banners with no replacement. The type stays in Com.Pushwoosh.iOS, so code that references it still
compiles with an [Obsolete] warning, but the view is empty, and code typed on its
PWInlineInAppViewAppearance class no longer compiles. The Android InlineInAppView was already
removed in 2.0.0.
Added
- .NET 10 assets in both packages:
lib/net10.0,lib/net10.0-android36.0and
lib/net10.0-ios26.0. The net8 assets are unchanged apart from the iOS minimum above. - iOS:
PushwooshCoreandPushwooshBridgeare bundled next toPushwooshFramework. In 7.x
PushwooshFrameworklinks them dynamically; nothing to change in the app.
Fixed
- .NET 10 / MAUI 10 apps got NU1608 on every restore, fatal with warnings as errors.
NuGet gave them the net8 build, whoseXamarin.AndroidX.Work.Runtime2.9.0.1 caps
Lifecycle.Runtimebelow 2.7.1 while MAUI 10 resolves 2.9.2.1. The net10 build depends on
Work.Runtime2.10.2.1 and the AndroidX versions MAUI 10 already resolves, so MAUI 10 and plain
net10.0-androidapps restore clean. A .NET 9 app still gets the net8 build and the same NU1608
as with 2.0.1.
Changed (from the native SDKs)
- Android: a tap on a
pw_buttonsaction button also raisesPushAccepted; the button id is not
passed to C#. - Android: a deep link from an opened push reaches the activity that is already running
(OnNewIntent) instead of a new copy of it. - Android: the inbox UI marks messages as read as soon as they are on screen, not only on tap.
- Android and iOS: the SDK reports the device's push permission status to Pushwoosh.
- iOS: a visible push that also carries
content-availableis opened only by a tap, not by the
background wake-up, and is counted as received exactly once. - iOS: the SDK picks up the APNs device token itself when the app does not pass it on.
2.0.1
Packaging only. The assemblies, the bundled native SDKs and the dependency graph are byte-for-byte
what 2.0.0 shipped, so there is nothing to gain from upgrading unless you were reading the package
page on nuget.org. No API changed, and no target framework or platform floor moved.
Packages
- Pushwoosh.DotNet: 2.0.1
- Pushwoosh.DotNet.Geozones: 2.0.1
Native SDKs
- Android SDK: 6.10.0 (unchanged)
- iOS SDK: 6.7.18 (unchanged)
Fixed
-
The package page on nuget.org showed its header as raw markup instead of a rendered one —
<p align="center">, the logo<img>and the badge block all appeared as literal text. The
packages carried the GitHub README, which opens with an HTML header; nuget.org renders CommonMark
only and does not support HTML. On top of that it renders images only from absolute URLs on its own
allow-list, so the logo bundled inside the package could never have appeared regardless of markup.
The packages now ship a readme written for nuget.org: CommonMark throughout, logo and badges from
allowed hosts, every link absolute. The README in the repository is unchanged.2.0.0 keeps its broken page: nuget.org accepts a readme correction only as a new package version.
2.0.0
Major. Both packages now share one version, and the minimum framework and platform floors move.
Read the breaking changes before upgrading — some of them are silent.
Packages
- Pushwoosh.DotNet: 2.0.0
- Pushwoosh.DotNet.Geozones: 2.0.0 (was 1.0.2 — the two packages are versioned together from now on)
Native SDKs
- Android SDK: 6.10.0 (was 6.7.14)
- iOS SDK: 6.7.18 (was 6.7.9)
Breaking changes
Target frameworks. net7.0, net7.0-android33.0 and net7.0-ios10.0 are gone; the packages
ship net8.0, net8.0-android34.0 and net8.0-ios11.0. A project on net7 gets NU1202 and cannot
restore 2.0.0 — stay on 1.0.6 or move the project to net8.
Android platform floor 33 → 34, and this one is silent. A project targeting
net8.0-android33.0 still restores: NuGet falls back to the lib/net8.0 folder, which holds only
the managed core assemblies — no bindings, no .aar, and none of the 19 Android dependencies. There
is no warning. The build succeeds, and push notifications simply never work at runtime. Raise
TargetFramework to net8.0-android34.0.
iOS platform floor 10 → 11.
Native Android 6.7.14 → 6.10.0 removes API with no replacement. Verified by unpacking both
.aar sets: GDPRManager, PushwooshInApp and InlineInAppView exist in 6.7.14 and are absent in
6.10.0. GDPR consent management and inline in-app banners are therefore gone — this is a loss of
capability, not an API move, and there is nothing to migrate to. If you call any of them, do not
upgrade until we have a replacement.
AndroidX and Firebase floors were raised (Xamarin.AndroidX.Core 1.13.1.2,
Xamarin.AndroidX.WebKit 1.10.0.2, Xamarin.Firebase.Messaging 123.3.1.1 and the rest — see the
package dependencies). A project pinning any of them lower gets NU1605 and has to move up.
Pushwoosh.DotNet.Geozones now requires Pushwoosh.DotNet. The dependency was missing, so
NuGet allowed Geozones to be installed on its own and the app died at native load time
(pushwoosh-location.aar needs com.pushwoosh.internal.*, and every PushwooshGeozones slice has
an LC_LOAD_DYLIB on PushwooshFramework). The dependency is a same-major range, so both packages
move together.
TagsBundle getters now throw instead of failing quietly or obscurely. The three of them
disagreed with each other on the same mistake: GetInt did (value as int?).Value and threw a bare
NullReferenceException, while GetString and GetList returned null and let the problem surface
somewhere unrelated. None of them said which key or what it actually held. All three now throw
KeyNotFoundException naming the missing key, or InvalidCastException naming the key, the type
stored and the type asked for. Code that relied on GetString/GetList returning null for a
type mismatch has to catch instead — reading a tag with the wrong getter was always a bug, it just
used to be silent.
Registered and RegisterError now actually fire on Android. They were declared but never
raised. Code that subscribed and saw nothing will start receiving events — including error paths it
may never have exercised. Note that RegisterError can arrive synchronously, on the calling
thread, if registration fails before it reaches the network; do not assume a handler runs later or
on the UI thread.
Purchase reporting is removed entirely, and there is no replacement. Four declarations are
gone:
SendPurchaseData(string identifier, decimal price, string currency)— the abstract member on
Core/PushManagerand its overrides in bothiOS.LibraryandAndroid.LibrarySendPurchase(...)iniOS.Bindings(sendPurchase:withPrice:currencyCode:andDate:)SendSKPaymentTransactions(...)iniOS.Bindings(sendSKPaymentTransactions:), which was a
binding-only declaration nothing in this SDK ever called
Any code calling PushManager.Instance.SendPurchaseData(...), or reaching into
Com.Pushwoosh.iOS for either binding, stops compiling. There is nothing to migrate to: the
default In-app Product, In-app Purchase and Last In-app Purchase date tags that these calls
used to fill are no longer written from this SDK.
The Purchase card is gone from the Sample app's Actions tab for the same reason.
Fixed
- Android: rich media could not open — the AndroidX dependency floor needed by
pushwoosh-inbox-ui
was not declared. - Android: the registration callbacks are raised from the native callback, and the error path no
longer swallows the failure. - iOS:
InboxManager.LoadMessages()threwNullReferenceExceptionfor the whole batch when a
message had noaction_params, or nosendDate. Both properties are nullable in the native SDK
and are now handled as such. - Android:
InboxManager.LoadMessages()had the same defect from the other direction —
DateTime.Parse(msg.ISO8601SendDate)with no guard.com.pushwoosh.inbox.data.InboxMessage
declares every getter as a plain Java type, so that string can be null (ArgumentNullException)
or malformed (FormatException), andgetType()can be null too. Neither was caught by the
surrounding handler, which only looks forInvalidCastException, so one unparseable message cost
the caller the entire list. Parsing is nowTryParseinto a nullableSendDate, a null type
falls back toPlain, and each message is converted inside its own guard so a bad one is skipped
instead of taking the batch down. - Geozones on Android: the binding for
PushwooshLocation.startLocationTracking(Callback<Void, LocationNotAvailableException>)was
dropped during generation because the referenced types could not be resolved, so no .NET caller
could learn that tracking failed to start. The binding project now resolves them and the overload
is generated. GeozonesSample: theAndroidX.Collectionfloor was too low to build.- iOS sample: added the entitlement that push registration needs.
Notes
- Native (template) in-app messages are not rendered on .NET. The
pushwoosh-inapp-uimodule
is not part of these packages, so a native in-app is received, recognised and then skipped — the
native SDK logsnative in-app detected but pushwoosh-inapp-ui module is not connected, skipping.
HTML and rich-media in-apps work. This is not new in 2.0.0; it has never worked and was never
documented. Use HTML or rich media until the module ships. - Inbox attachments and images need Glide, and
Xamarin.Android.Glideis now declared as a
dependency. It was previously only present becauseMicrosoft.Maui.Corepulls it in, so a
non-MAUI Android consumer had no Glide and inbox images failed at runtime. MAUI apps get the same
version they already resolved (4.15.1.2), so nothing changes for them. - The samples ship the
XXXXX-XXXXXplaceholder application code, and each one carries a
google-services.json.examplewhere the real file belongs. Copy your own from the Firebase
console into that folder — Android builds fail until you do. The samples also no longer declare
com.pushwoosh.senderid: the native SDK does not read that metadata, and FCM takes the sender
fromgoogle-services.json. - MAUI 8 does not render on iOS 26 — use an iOS 18.x simulator or device. On an iOS 26.2
simulator the app installs, launches, the process stays alive and the screen stays black, with no
UI at all. Nothing in this SDK is involved: a baredotnet new mauiproject containing no
Pushwoosh code was measured on the same simulator and behaves identically, while the same build of
Sample/runs correctly on iOS 18.6 (registration, HWID, APNs token, push delivery all verified
there). MAUI 8.0 predates iOS 26 and there is no SDK-level workaround. Recent Xcode installs ship
only 26.x simulators, so this is easy to hit and looks like a broken SDK when it is not. - How far the iOS side of this release was verified. The package installs into a
net8.0-ios
project and the nativePushwooshFramework.xcframeworkshipped inside
PushwooshSDK.DotNet.iOS.Bindings.resources.zipis unpacked in the consumer's build — both
checked, and both run in CI. Linking that framework into an application is not covered by CI —
it needs the iOS 18 SDK (Xcode 16 or newer), the build machine runs Xcode 15.4, and the resulting
MT0180is not bypassable by linker flags — so it was checked by hand instead: on Xcode 26.3 a
Release build links the framework in for both slices, the simulator (iossimulator-arm64) and
the device (ios-arm64, unsigned), each withLC_LOAD_DYLIBon
@rpath/PushwooshFramework.frameworkand@executable_path/Frameworkson the app's rpath.
Linking alone is not behaviour, so the runtime path was checked as well: on an iOS 18.6 simulator
the SDK initialises, issues a hardware id,Register()returns a real APNS token, the device
reportsRegisteredwith remote notificationsavailable, and a delivered push is presented.
Push delivery has been confirmed. The Android side of the package was verified by installation
into a barenet8.0-androidproject and a MAUI project, plus a Release build of the installed
package.
Pushwoosh Dotnet 1.0.6
Updated
- Pushwoosh iOS SDK updated to 6.7.9
- Pushwoosh Android SDK updated to 6.7.14
Pushwoosh Dotnet 1.0.5
Updated
- Pushwoosh iOS SDK updated to 6.5.13
- Pushwoosh Android SDK updated to 6.7.10
Pushwoosh Dotnet 1.0.4
Added
- Pushwoosh iOS and Android Geozones module
- MAUI 8 support
Updated
- All solution projects now use .NET 7
- Pushwoosh iOS SDK updated to 6.5.9
- Pushwoosh iOS SDK updated to 6.7.5
1.0.3
1.0.1: Merge pull request #1 from Pushwoosh/feature/SDK-101-set-appid-from-code
Changed
PushManager.Instance.AppCodenow has a setter, so Pushwoosh App ID can now be dynamically set from your app (previously it was only possible to set it from manifest/info.plist)
Updated
- Pushwoosh Android SDK updated to 6.6.12
- Pushwoosh iOS SDK updated to 6.4.13