Repository files navigation

This module is the main repository for:

• .NET for iOS
• .NET for Mac Catalyst
• .NET for macOS
• .NET for tvOS

These SDKs allow us to create native iOS, Mac Catalyst, macOS and tvOS applications using the same UI controls we would in Objective-C and Xcode, except with the flexibility and elegance of a modern language (C#), the power of the .NET Base Class Library (BCL), and first-class IDEs and editors—Visual Studio and Visual Studio Code—at our fingertips.

This repository is where we do development for the .NET for iOS, Mac Catalyst, macOS, and tvOS SDKs. .NET for iOS, Mac Catalyst, macOS, and tvOS are part of.NET MAUI, and may also be used independently for native iOS and macOS development with .NET.

There are a few ways that you can contribute, for example:

• Submit bugs and feature requests
• Review source code changes
• Submit pull requests to resolve issues and fix bugs

.NET for iOS, Mac Catalyst, macOS, and tvOS are part of .NET MAUI, since it was introduced in May 2022 as part of .NET 6, and is currently supported as described on the.NET MAUI Support Policy.

Support for Xamarin.iOS and Xamarin.Mac ended onMay 1, 2024 as per theXamarin Support Policy:

Xamarin support ended on May 1, 2024 for all Xamarin SDKs including Xamarin.Forms. Android API 34 and Xcode 15 SDKs (iOS and iPadOS 17, macOS 14) are the final versions Xamarin targets from existing Xamarin SDKs (i.e. no new APIs are planned).

If you are interested in fixing issues and contributing directly to the code base, please see the documentHow to Contribute, which covers the following:

• How tobuild and run from source
• Thedevelopment workflow, includingdebugging andrunning tests
• Coding Guidelines
• Submitting pull requests

The preferred method for installing Xamarin.iOS and Mac is to use the Visual Studio installers (Windows,Mac).

The team alsostrongly recommends using the latest Xamarin SDK and Xcode whenever possible.

However, we provide links to older Xamarin.iOS and Mac packages for macOS downgrades and build machine configuration, seeDownloads.

• Ask a question onStack Overflow or theXamarin Forums
• Request a new feature on GitHub
• Vote on existing feature requests
• Submit bugs to GitHub Issues
• Discuss development and design onDiscord

Copyright (c) .NET Foundation Contributors. All rights reserved.Licensed under theMIT License.