AdamE.Firebase.iOS.CloudMessaging

.NET bindings for Firebase Cloud Messaging on Apple platforms.

Scope

FCM token, APNs token, topic subscription, message delivery, and notification service extension APIs exposed by the Firebase Apple SDK.

These packages are thin bindings over the native Firebase Apple SDK. The native documentation is the source of truth for product behavior, Firebase console setup, quotas, policy requirements, and feature workflows.

Native Documentation

• Firebase Apple setup: https://firebase.google.com/docs/ios/setup
• Firebase Cloud Messaging documentation: https://firebase.google.com/docs/cloud-messaging/ios/client

Package

• Package ID: AdamE.Firebase.iOS.CloudMessaging
• Managed namespace: Firebase.CloudMessaging

Supported target frameworks include:

• net9.0-ios
• net10.0-ios
• net9.0-maccatalyst
• net10.0-maccatalyst

When multi-targeting, condition package references so they restore only for Apple targets:

<ItemGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'ios' Or $([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'maccatalyst'">
  <PackageReference Include="AdamE.Firebase.iOS.CloudMessaging" Version="x.y.z" />
</ItemGroup>

Installation

dotnet add package AdamE.Firebase.iOS.CloudMessaging

Binding Notes

Use the official Firebase Apple docs for setup and usage. In .NET, call the equivalent APIs from the managed namespace listed above. Keep app-specific Firebase configuration, such as GoogleService-Info.plist, in the application project.

Most Firebase feature packages require AdamE.Firebase.iOS.Core and app startup should call Firebase.Core.App.Configure() before feature APIs are used. This is the .NET binding for native FirebaseApp.configure().

Follow the official Firebase and Apple documentation for APNs registration and notification permissions; this package only exposes the managed binding surface.

The managed entry point is Firebase.CloudMessaging.Messaging.SharedInstance. Set Delegate to an IMessagingDelegate, pass APNs tokens through ApnsToken or SetApnsToken(...), and read or fetch FCM tokens through FcmToken or FetchToken(...). If you disable swizzling with FirebaseAppDelegateProxyEnabled, route AppDelegate notification callbacks manually as described by the native docs.

Version Alignment

Firebase Apple SDKs are packaged as native xcframeworks. Applications should pin package versions intentionally and keep all AdamE.Firebase.iOS.* packages on the same major/minor Firebase line.

Avoid mixing unrelated Firebase binding package sets or mismatched Firebase native SDK lines in one application. That can cause duplicate symbols, linker failures, runtime loading failures, or undefined native SDK behavior.

Repository

• Repository: https://github.com/AdamEssenmacher/GoogleApisForiOSComponents
• Issues: https://github.com/AdamEssenmacher/GoogleApisForiOSComponents/issues