Native Library Interop for .NET MAUI

To build and run the Firebase Slim Binding sample for iOS using the .NET CLI, use the following command. This sample demonstrates basic usage of Firebase Analytics, Auth, and Messaging.

dotnet build sample -t:Run -f net9.0-ios

This repository contains sample bindings and MAUI apps for Facebook, Firebase (Analytics and Messaging), and Google Cast. To use them in your own project:

1. Clone or submodule this repository.
2. Navigate to the specific binding directory (e.g., firebase/macios/Firebase.MaciOS.Binding for Firebase Messaging) and read its local README for specific build and configuration instructions.
3. Reference the binding project in your .NET MAUI .csproj file, or build the binding projects and reference the resulting .dll assembly artifacts.

Note: There are currently no plans to ship these bindings via NuGet packages.

<!-- Example: Adding a project reference for Firebase Messaging in your .csproj -->
<ProjectReference Include="<YourPathToClonedRepo>\firebase\macios\Firebase.MaciOS.Binding\Firebase.MaciOS.Binding.csproj" />

To make the iOS sample functional, you must update the Info.plist file with your Facebook developer credentials.

Path: facebook/sample/Platforms/iOS/Info.plist

Required updates:

1. Replace YOUR_APP_ID with your Facebook App ID.
2. Replace YOUR_CLIENT_TOKEN with your Facebook App Client Token.

To deploy the Google Cast sample to a physical iOS device, you must configure code signing in Xcode:

1. Open macios/native/MauiGoogleCast.xcodeproj in Xcode.
2. Navigate to Targets -> MauiGoogleCast -> Signing & Capabilities.
3. Configure your development team and signing settings.

To deploy the sample to a physical device, you must handle code signing and APNs configuration in Xcode:

1. Open Project: Open macios/native/MauiFirebase.xcodeproj in Xcode.
2. Configure Signing: Navigate to Targets -> MauiFirebase -> Signing & Capabilities and configure your signing team and settings.
3. Configure APNs: Ensure you have a provisioning profile installed that supports Apple Notification Service (APNs) to enable messaging features.

To make the Android sample functional, you must update the strings.xml file with your Facebook developer credentials.

Path: facebook/sample/Platforms/Android/Resources/values/strings.xml

Required updates:

1. Replace YOUR_APP_ID with your Facebook App ID.
2. Replace YOUR_CLIENT_TOKEN with your Facebook App Client Token.

To create a new native library binding, copy the contents of this template repository and follow the official Microsoft documentation.

The template is structured to separate the .NET binding logic from the native source code for multiple platforms. Use this structure to organize your project:

• Android:
  • NewBinding.Android.Binding: The .NET API project that wraps the native code.
  • native: The Android project containing the Java or Kotlin code.
• macOS/iOS:
  • NewBinding.MaciOS.Binding: The .NET API project that wraps the native code.
  • native: The Xcode project containing the Objective-C code.
• Sample App:
  • sample: A .NET MAUI application demonstrating how to consume the newly created binding.

To build and execute the Google Cast Slim Binding sample project, use the dotnet build command with the Run target on the sample directory.

dotnet build sample -t:Run

The Firebase Slim Binding sample requires a valid Firebase configuration to function. Follow these steps to set up your Firebase iOS app:

1. Download Configuration: Download your GoogleService-Info.plist from the Firebase console.
2. Replace File: Replace the existing sample/Platforms/iOS/GoogleService-Info.plist with your downloaded file.
3. Update Application ID: Open Sample.csproj and update the <ApplicationId> value to match your Firebase iOS app identifier.

To build and run the Facebook Slim Binding sample application for Android or iOS, use the dotnet build command with the Run target and specify the appropriate target framework.

dotnet build sample -t:Run -f net9.0-android
dotnet build sample -t:Run -f net9.0-ios

To create your own binding using the Native Library Interop pattern:

1. Copy the contents of the template directory in this repository to your project.
2. Follow the detailed getting started instructions provided in the official Microsoft Learn documentation.