Xam.Plugin.Mixpanel.iOS

Xamarin.iOS bindings for Mixpanel iOS v5.0.9.

This repository aims to target net9.0-ios and net10.0-ios which are currently the latest .NET iOS STS and LTS releases.

Installation

Xam.Plugin.Mixpanel.iOS is available via NuGet. https://www.nuget.org/packages/Xam.Plugin.Mixpanel.iOS/

Usage

Include Mixpanel

using Xam.Plugin.Mixpanel.iOS;

And then follow the docs provided at the Mixpanel Developer Documentation (https://developer.mixpanel.com/docs/ios)

Build

These build instructions are intended to be run on macOS.

Local dll builds

1. Navigate to the Binding directory
2. Run FetchFramework.sh
3. Run BuildDlls.sh
4. Fetch your Xam.Plugin.Mixpanel.iOS.dll from the Xam.Plugin.Mixpanel.iOS/bin/Release/net10-ios/ directory.

Building a .nupkg

1. Navigate to the Binding directory
2. Run FetchFramework.sh
3. Run BuildNugetPackage.sh
4. Fetch your Xam.Plugin.Mixpanel.iOS.x.y.z.nupkg and Xam.Plugin.Mixpanel.iOS.x.y.z.snupkg from the `Xam.Plugin.Mixpanel.iOS/bin/Release/`` directory.

Updating Mixpanel SDK

To update the Mixpanel SDK change the version within Binding/Cartfile to your desired SDK version and run the FetchFramework.sh script. This desired version is generally then latest version from mixpanel/mixpanel-iphone releases.

If there are API changes you will want to also run SharpieBind.sh and examine code output in the newly generated NewBinding_ApiDefinition.cs and NewBinding_StructsAndEnums.cs files. Desired API changes should be then modified in the ApiDefinition.cs and StructsAndEnums.cs files. NOTE: The NewBinding_ files are not build ready and need to be modified manually.

Requirements

• To generate new bindings - Xcode 16.2 (why Xcode 16.2? See below)
• To compile the project - Xcode 26.2
• Carthage
• Objective Sharpie

Why Xcode 16.2?

Objective Sharpie has fallen a little behind in its updates and as such it is not compatible with modern versions of Xcode. Essentially in order to create new bindings you need to have the iPhone 18.2 SDK, and this comes with Xcode 16.2. Attempting to create bindings in any newer versions will generate errors.

After the bindings are made you can use the latest Xcode (26.2 at the time of writing) to be compile the nuget packages. You can see this thread for more information. It may also be useful to watch this thread to get information about Objective Sharpie updates.

TODO

• Verify the Verify statements work as expected.
• Figure out how to handle MixpanelTypeCategory correctly.

Pull requests welcome!