---
title: ".NET for iOS, macOS, and Mac Catalyst"
description: "Learn about Sentry's .NET integration with .NET for iOS, macOS, and Mac Catalyst"
url: https://docs.sentry.io/platforms/dotnet/guides/apple/
---

# .NET for iOS, macOS, and Mac Catalyst | Sentry for .NET for iOS, macOS, and Mac Catalyst

Sentry supports [.NET for iOS, macOS, and Mac Catalyst](https://learn.microsoft.com/dotnet/ios/) directly from the [Sentry NuGet package](https://www.nuget.org/packages/Sentry).

## [Overview of the features](https://docs.sentry.io/platforms/dotnet/guides/apple.md#overview-of-the-features)

* All the features of our main [.NET SDK](https://docs.sentry.io/platforms/dotnet.md), for your managed code

* Native crash reporting for Apple platforms, leveraging our [Cocoa SDK](https://docs.sentry.io/platforms/apple.md) including:

  * Automatically [attach screenshots to Native exceptions](https://docs.sentry.io/platforms/apple/guides/ios/configuration/options.md#attach-screenshot)
  * Detect [App Hangs](https://docs.sentry.io/platforms/apple/configuration/app-hangs.md)
  * [Automatic performance tracing](https://docs.sentry.io/platforms/apple/performance.md)
  * [Automatic breadcrumbs](https://docs.sentry.io/platforms/apple/enriching-events/breadcrumbs.md#automatic-breadcrumbs)
  * [Swizzling](https://docs.sentry.io/platforms/apple/configuration/swizzling.md)

* Automatic session tracking and [release health](https://docs.sentry.io/product/releases.md)

## [Install](https://docs.sentry.io/platforms/dotnet/guides/apple.md#install)

Add the Sentry dependency to your .NET for iOS, macOS, and/or Mac Catalyst application:

```shell
dotnet add package Sentry -v 6.3.0
```

## [Configure](https://docs.sentry.io/platforms/dotnet/guides/apple.md#configure)

In your `AppDelegate.cs` file, call `SentrySdk.Init` in the `FinishedLaunching` event and include any options you would like to set. The `Dsn` is the only required parameter.

```csharp
[Register("AppDelegate")]
public class AppDelegate : UIApplicationDelegate
{
    public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions)
    {
        // Init the Sentry SDK
        SentrySdk.Init(options =>
        {
            options.Dsn = "___PUBLIC_DSN___";
            options.SendDefaultPii = true; // adds the user's IP address automatically
#if DEBUG
            // Log debug information about the Sentry SDK
            options.Debug = true;
#endif

            // All the native iOS SDK options are available below
            // https://docs.sentry.io/platforms/apple/guides/ios/configuration/
            // Enable Native iOS SDK App Hangs detection
            options.Native.EnableAppHangTracking = true;

            options.SetBeforeSend(evt =>
            {
                if (evt.Exception?.Message.Contains("Something you don't care want logged?") ?? false)
                {
                    return null; // return null to filter out event
                }
                // or add additional data
                evt.SetTag("dotnet-iOS-Native-Before", "Hello World");
                return evt;
            });

            options.OnCrashedLastRun = e =>
            {
                Console.WriteLine(e);
            };
        });
    }
}
```

### [Options](https://docs.sentry.io/platforms/dotnet/guides/apple.md#options)

The .NET for iOS, macOS, and Mac Catalyst integration is part of [Sentry](https://docs.sentry.io/platforms/dotnet.md). Please refer to the documentation for that package for information about platform agnostic options.

## [Verify](https://docs.sentry.io/platforms/dotnet/guides/apple.md#verify)

This snippet includes an intentional error, so you can test that everything is working as soon as you set it up.

```csharp
try
{
    throw null;
}
catch (Exception ex)
{
    SentrySdk.CaptureException(ex);
}
```

## [Next Steps](https://docs.sentry.io/platforms/dotnet/guides/apple.md#next-steps)

* Explore [practical guides](https://docs.sentry.io/guides.md) on what to monitor, log, track, and investigate after setup

## Other .NET Frameworks

- [.NET for Android](https://docs.sentry.io/platforms/dotnet/guides/android.md)
- [ASP.NET](https://docs.sentry.io/platforms/dotnet/guides/aspnet.md)
- [ASP.NET Core](https://docs.sentry.io/platforms/dotnet/guides/aspnetcore.md)
- [AWS Lambda](https://docs.sentry.io/platforms/dotnet/guides/aws-lambda.md)
- [Azure Functions](https://docs.sentry.io/platforms/dotnet/guides/azure-functions-worker.md)
- [Blazor WebAssembly](https://docs.sentry.io/platforms/dotnet/guides/blazor-webassembly.md)
- [Entity Framework](https://docs.sentry.io/platforms/dotnet/guides/entityframework.md)
- [Google Cloud Functions](https://docs.sentry.io/platforms/dotnet/guides/google-cloud-functions.md)
- [log4net](https://docs.sentry.io/platforms/dotnet/guides/log4net.md)
- [MAUI](https://docs.sentry.io/platforms/dotnet/guides/maui.md)
- [Microsoft.Extensions.Logging](https://docs.sentry.io/platforms/dotnet/guides/extensions-logging.md)
- [NLog](https://docs.sentry.io/platforms/dotnet/guides/nlog.md)
- [Serilog](https://docs.sentry.io/platforms/dotnet/guides/serilog.md)
- [Windows Forms](https://docs.sentry.io/platforms/dotnet/guides/winforms.md)
- [WinUI](https://docs.sentry.io/platforms/dotnet/guides/winui.md)
- [WPF](https://docs.sentry.io/platforms/dotnet/guides/wpf.md)
- [Xamarin](https://docs.sentry.io/platforms/dotnet/guides/xamarin.md)

## Topics

- [Capturing Errors](https://docs.sentry.io/platforms/dotnet/guides/apple/usage.md)
- [Enriching Events](https://docs.sentry.io/platforms/dotnet/guides/apple/enriching-events.md)
- [Extended Configuration](https://docs.sentry.io/platforms/dotnet/guides/apple/configuration.md)
- [Logs](https://docs.sentry.io/platforms/dotnet/guides/apple/logs.md)
- [Data Management](https://docs.sentry.io/platforms/dotnet/guides/apple/data-management.md)
- [Tracing](https://docs.sentry.io/platforms/dotnet/guides/apple/tracing.md)
- [Profiling](https://docs.sentry.io/platforms/dotnet/guides/apple/profiling.md)
- [Security Policy Reporting](https://docs.sentry.io/platforms/dotnet/guides/apple/security-policy-reporting.md)
- [Crons](https://docs.sentry.io/platforms/dotnet/guides/apple/crons.md)
- [Migration Guide](https://docs.sentry.io/platforms/dotnet/guides/apple/migration.md)
- [Troubleshooting](https://docs.sentry.io/platforms/dotnet/guides/apple/troubleshooting.md)
- [User Feedback](https://docs.sentry.io/platforms/dotnet/guides/apple/user-feedback.md)
- [Metrics](https://docs.sentry.io/platforms/dotnet/guides/apple/metrics.md)
- [Unit Testing](https://docs.sentry.io/platforms/dotnet/guides/apple/unit-testing.md)
- [Legacy SDK](https://docs.sentry.io/platforms/dotnet/guides/apple/legacy-sdk.md)