Bridges the worlds of .NET with the native APIs of macOS, iOS, tvOS, and watchOS.
Перейти к файлу
Rolf Bjarne Kvinge 323d28c220
[Foundation] Make the generic collection classes' generic GetEnumerator methods public. (#20808)
When finding an enumerator for the given code:

```cs
var collection = new NSSet<NSNumber> ();
foreach (var item in collection) {
	// ...
}
```

the C# compiler will first look for any `GetEnumerator` methods. The non-generic `NSSet` class defines a `IEnumerator<NSObject> GetEnumerator<NSObject> ()` method, which, since the generic `NSSet<T>` class doesn't define such a method, is selected.

The end result is that the type of the foreach element is `NSObject`
(`GetEnumerator`'s return type') - which is somewhat unexpected:

```cs
var collection = new NSSet<NSNumber> ();
foreach (var item in collection) {
	Console.WriteLine (item.LongValue); // error CS1061: 'NSObject' does not contain a definition for 'LongValue'
}
```

The fix is to define a  `IEnumerator<T> GetEnumerator<T> ()` method in the
generic `NSSet<T>` class, which the C# will find and choose over the base
class' method. Then the type of the foreach element is the correct type, and
the following code works:

```cs
var collection = new NSSet<NSNumber> ();
foreach (var item in collection) {
	Console.WriteLine (item.LongValue); // it works!
}
```

Do this for all our generic collection classes.

Also document these methods + all the other public `GetEnumerator` methods.
2024-07-03 20:16:53 +02:00
.config [main] Update dependencies from dotnet/installer (#15119) 2022-05-26 08:51:49 +02:00
.github Backport bot: Use managed identity (MI) authorization (#20798) 2024-07-01 13:14:18 -07:00
Localize Update AOTCompile task to handle cycles in up-to-date check (#20103) 2024-02-15 17:29:18 +01:00
builds [build] Parameterize the .NET download script url. (#20806) 2024-07-03 20:12:40 +02:00
docs [bgen] Implement support for using default interface members to bind protocols. (#20681) 2024-06-07 16:35:48 +02:00
dotnet Revert "Migrate Messaging Build agent to .NET 8 (#20705)" (#20790) 2024-07-01 18:25:55 +02:00
eng [main] Update dependencies from dotnet/installer (#20742) 2024-06-20 08:29:01 +02:00
external Bump Xamarin.MacDev. (#20518) 2024-04-26 09:09:10 +02:00
fsharp Add config file for libmono-native dllmap 2019-03-13 00:34:47 +01:00
jenkins [jenkins] Jenkins is dead, long live ~Wrench~ Azure Devops. (#16396) 2022-10-21 10:05:59 +02:00
mk [msbuild/dotnet] Automatically link with Swift's system libraries if a binding project has the IsSwift=true property. (#20546) 2024-05-20 20:17:29 +02:00
mono Add config file for libmono-native dllmap 2019-03-13 00:34:47 +01:00
msbuild [msbuild] Don't support RuntimeIdentifiers for Hot Restart. (#20750) 2024-07-01 19:26:57 +02:00
release [dotnet] Rename packs to contain target framework. (#19765) 2024-02-19 13:14:20 +01:00
runtime [runtime] Convert the bindings-generator.csproj project to a .NET project. (#20743) 2024-06-19 15:11:28 +02:00
src [Foundation] Make the generic collection classes' generic GetEnumerator methods public. (#20808) 2024-07-03 20:16:53 +02:00
tests [Foundation] Make the generic collection classes' generic GetEnumerator methods public. (#20808) 2024-07-03 20:16:53 +02:00
tools [CI] Disable the governance checks on the tests. (#20797) 2024-07-01 16:58:32 -04:00
.editorconfig Update editorconfig. (#19909) 2024-01-26 08:24:58 +01:00
.gitattributes [dotnet] Fix line endings in template localizations. (#16981) 2022-12-12 17:12:35 +01:00
.gitignore [net8.0] [build] Require using EnablePreviewFeatures=true when using preview releases. Contributes towards #18343. (#18476) 2023-06-22 08:16:50 +02:00
.gitmodules [Build] Update submodules remotes. (#19632) 2023-12-18 11:45:25 -05:00
CODEOWNERS [WebKit] Merge WKWebKit into WebKit. (#17062) 2022-12-19 18:37:53 +01:00
DOWNLOADS.md Update DOWNLOADS.md with new releases. (#19595) 2023-12-11 08:47:13 +01:00
Directory.Build.props Get Mono.Cecil from NuGet everywhere. (#19535) 2023-12-04 20:15:03 +01:00
ISSUE_TEMPLATE.md Add newlines to issue template to fix markdown formatting problems. (#15152) 2022-05-31 18:43:01 +02:00
LICENSE Adjust license to match requested format 2016-04-25 16:38:57 -04:00
Make.config [msbuild/dotnet] Automatically link with Swift's system libraries if a binding project has the IsSwift=true property. (#20546) 2024-05-20 20:17:29 +02:00
Make.versions [dotnet] Multi target with Xcode 15.0 (#20155) 2024-02-28 09:03:53 +01:00
Makefile [build] Add support for worktree checkouts (#19240) 2023-10-19 09:22:37 -07:00
NOTICE.txt Add NOTICE.txt and cgmanifest tool (#8843) 2020-06-12 14:30:21 -05:00
NuGet.config [main] Update dependencies from dotnet/installer (#20551) 2024-05-21 19:56:42 +02:00
README.md Update README (#20536) 2024-05-01 08:29:31 +02:00
SECURITY.MD Add SECURITY.MD to repo (as suggested by OSPO) (#7019) 2019-09-19 17:44:22 -04:00
Versions-ios.plist.in [Xcode 15.2] Bump to Xcode 15.2 (#19785) 2024-01-12 04:56:22 -05:00
Versions-mac.plist.in [Xcode 15.2] Bump to Xcode 15.2 (#19785) 2024-01-12 04:56:22 -05:00
Xamarin.Mac.sln Fix path to dont link project in Xamarin.Mac.sln. (#8109) 2020-03-16 09:42:52 +01:00
Xamarin.iOS.sln [tests] Make the mtouch test project reference the actual mtouch project. (#11400) 2021-05-04 14:10:03 +02:00
banner.png [README] Add Xamarin.iOS + Xamarin.Mac banner (#1665) 2017-02-08 17:42:48 -05:00
configure convert to if ... fi 2023-11-30 21:58:56 -05:00
create-make-config.sh Encode the .NET version we're targeting in the third NuGet version number. (#17818) 2023-03-17 07:39:59 +01:00
global.json [main] Update dependencies from dotnet/installer (#20742) 2024-06-20 08:29:01 +02:00
mac-entitlements.plist Implement notarization. (#6928) 2019-09-09 00:34:11 -07:00
product.snk Add our mono runtimes to the build. 2016-04-24 14:47:24 -04:00
system-dependencies.sh [siminstaller] Convert to .NET project. (#20739) 2024-06-19 15:10:39 +02:00
versions-check.csharp [dotnet] Differentiate between "OS version we support as TargetPlatformVersion" and "OS version we support or have supported". (#19882) 2024-01-23 19:17:25 +01:00

README.md

.NET for iOS, Mac Catalyst, macOS, tvOS

Welcome!

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:

Support

.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 on May 1, 2024 as per the Xamarin 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).

Contributing

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

Downloads

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

The team also strongly 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, see Downloads.

Feedback

Discord

License

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