[GameController] Implement up to Xcode 16.3 RC.

.github/copilot-instructions.md

@@ -0,0 +1,95 @@
+# Instructions for AIs
+
+This repository is .NET for iOS.
+
+This is the main branch targeting .NET 9.
+
+## Nullable Reference Types
+
+When opting C# code into nullable reference types:
+
+Only make the following changes when asked to do so.
+
+* Add `#nullable enable` at the top of the file.
+
+* Don't *ever* use `!` to handle `null`!
+
+* Declare variables non-nullable, and check for `null` at entry points.
+
+* Use `throw new ArgumentNullException (nameof (parameter))` in `netstandard2.0` projects.
+
+* Use `ArgumentNullException.ThrowIfNull (parameter)` in iOS projects that will be .NET 9+.
+
+* `[Required]` properties in MSBuild task classes should always be non-nullable with a default value.
+
+* Non-`[Required]` properties should be nullable and have null-checks in C# code using them.
+
+* For MSBuild task properties like:
+
+```csharp
+public string NonRequiredProperty { get; set; }
+public ITaskItem [] NonRequiredItemGroup { get; set; }
+
+[Output]
+public string OutputProperty { get; set; }
+[Output]
+public ITaskItem [] OutputItemGroup { get; set; }
+
+[Required]
+public string RequiredProperty { get; set; }
+[Required]
+public ITaskItem [] RequiredItemGroup { get; set; }
+```
+
+Fix them such as:
+
+```csharp
+public string? NonRequiredProperty { get; set; }
+public ITaskItem []? NonRequiredItemGroup { get; set; }
+
+[Output]
+public string? OutputProperty { get; set; }
+[Output]
+public ITaskItem []? OutputItemGroup { get; set; }
+
+[Required]
+public string RequiredProperty { get; set; } = "";
+[Required]
+public ITaskItem [] RequiredItemGroup { get; set; } = [];
+```
+
+If you see a `string.IsNullOrEmpty()` check, don't change it.
+
+## Formatting
+
+C# code uses tabs (not spaces) and the Mono code-formatting style defined in `.editorconfig`
+
+* Your mission is to make diffs as absolutely as small as possible, preserving existing code formatting.
+
+* If you encounter additional spaces or formatting within existing code blocks, LEAVE THEM AS-IS.
+
+* If you encounter code comments, LEAVE THEM AS-IS.
+
+* Place a space prior to any parentheses `(` or `[`
+
+* Use `""` for empty string and *not* `string.Empty`
+
+* Use `[]` for empty arrays and *not* `Array.Empty<T>()`
+
+Examples of properly formatted code:
+
+```csharp
+Foo ();
+Bar (1, 2, "test");
+myarray [0] = 1;
+
+if (someValue) {
+    // Code here
+}
+
+try {
+    // Code here
+} catch (Exception e) {
+    // Code here
+}
+```

Make.config

@@ -44,10 +44,10 @@ include $(TOP)/Make.versions
 # The value is taken from the name + version of the Ref pack.
 # Example: given the Ref pack "Microsoft.iOS.Ref.net8.0_17.5" with the version "17.5.8030", the value
 # to write here would be the part after "Microsoft.iOS.Ref." + "/" + version: "net8.0_17.5/17.5.8030"
-STABLE_NUGET_VERSION_iOS=net9.0_18.2/18.2.9170
-STABLE_NUGET_VERSION_tvOS=net9.0_18.2/18.2.9170
-STABLE_NUGET_VERSION_MacCatalyst=net9.0_18.2/18.2.9170
-STABLE_NUGET_VERSION_macOS=net9.0_15.2/15.2.9170
+STABLE_NUGET_VERSION_iOS=net9.0_18.4/18.4.9288
+STABLE_NUGET_VERSION_tvOS=net9.0_18.4/18.4.9288
+STABLE_NUGET_VERSION_MacCatalyst=net9.0_18.4/18.4.9288
+STABLE_NUGET_VERSION_macOS=net9.0_15.4/15.4.9288
 
 PACKAGE_HEAD_REV=$(shell git rev-parse HEAD)
 
@@ -447,11 +447,13 @@ DOTNET_MONOVM_PLATFORMS+=iOS
 DOTNET_IOS_BITNESSES+=64
 DOTNET_NATIVEAOT_PLATFORMS+=iOS
 XCFRAMEWORK_PLATFORMS+=iossimulator
+XCFRAMEWORK_iOS_PLATFORMS+=iossimulator
 XCFRAMEWORK_iossimulator_RUNTIME_IDENTIFIERS=iossimulator-x64 iossimulator-arm64
 
 # 64-bit architectures
 DOTNET_IOS_RUNTIME_IDENTIFIERS_64=ios-arm64
 XCFRAMEWORK_PLATFORMS+=ios
+XCFRAMEWORK_iOS_PLATFORMS+=ios
 XCFRAMEWORK_ios_RUNTIME_IDENTIFIERS=ios-arm64
 DOTNET_IOS_RUNTIME_IDENTIFIERS_64+=iossimulator-x64 iossimulator-arm64
 
@@ -465,10 +467,12 @@ DOTNET_MONOVM_PLATFORMS+=tvOS
 DOTNET_TVOS_BITNESSES+=64
 DOTNET_NATIVEAOT_PLATFORMS+=tvOS
 XCFRAMEWORK_PLATFORMS+=tvossimulator
+XCFRAMEWORK_tvOS_PLATFORMS+=tvossimulator
 XCFRAMEWORK_tvossimulator_RUNTIME_IDENTIFIERS=tvossimulator-x64 tvossimulator-arm64
 
 DOTNET_TVOS_RUNTIME_IDENTIFIERS=tvos-arm64 tvossimulator-x64 tvossimulator-arm64
 XCFRAMEWORK_PLATFORMS+=tvos
+XCFRAMEWORK_tvOS_PLATFORMS+=tvos
 XCFRAMEWORK_tvos_RUNTIME_IDENTIFIERS=tvos-arm64
 DOTNET_TVOS_RUNTIME_IDENTIFIERS_64+=$(DOTNET_TVOS_RUNTIME_IDENTIFIERS)
 endif
@@ -481,6 +485,7 @@ DOTNET_NATIVEAOT_PLATFORMS+=MacCatalyst
 DOTNET_MACCATALYST_RUNTIME_IDENTIFIERS=maccatalyst-x64 maccatalyst-arm64
 DOTNET_MACCATALYST_RUNTIME_IDENTIFIERS_64+=$(DOTNET_MACCATALYST_RUNTIME_IDENTIFIERS)
 XCFRAMEWORK_PLATFORMS+=maccatalyst
+XCFRAMEWORK_MacCatalyst_PLATFORMS+=maccatalyst
 XCFRAMEWORK_DESKTOP_PLATFORMS+=maccatalyst
 XCFRAMEWORK_maccatalyst_RUNTIME_IDENTIFIERS=$(DOTNET_MACCATALYST_RUNTIME_IDENTIFIERS)
 endif
@@ -493,6 +498,7 @@ DOTNET_NATIVEAOT_PLATFORMS+=macOS
 DOTNET_MACOS_RUNTIME_IDENTIFIERS=osx-x64 osx-arm64
 DOTNET_MACOS_RUNTIME_IDENTIFIERS_64=$(DOTNET_MACOS_RUNTIME_IDENTIFIERS)
 XCFRAMEWORK_PLATFORMS+=macos
+XCFRAMEWORK_macOS_PLATFORMS+=macos
 XCFRAMEWORK_DESKTOP_PLATFORMS+=macos
 XCFRAMEWORK_macos_RUNTIME_IDENTIFIERS=$(DOTNET_MACOS_RUNTIME_IDENTIFIERS)
 endif

NuGet.config

@@ -38,6 +38,8 @@
     <add key="darc-pub-dotnet-runtime-0fdf85d" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/darc-pub-dotnet-runtime-0fdf85d5/nuget/v3/index.json" />
     <!-- Add a 8.0.15 feed -->
     <add key="darc-pub-dotnet-runtime-7aa8bb0" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/darc-pub-dotnet-runtime-7aa8bb0e/nuget/v3/index.json" />
+    <!-- Add a 8.0.16 feed -->
+    <add key="darc-pub-dotnet-runtime-0239fb04" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/darc-pub-dotnet-runtime-0239fb04/nuget/v3/index.json" />
   </packageSources>
   <disabledPackageSources>
     <clear />

docs/api/ARKit/ARSessionDelegate_Extensions.xml

@@ -0,0 +1,12 @@
+<Documentation>
+  <Docs DocId="M:ARKit.ARSessionDelegate_Extensions.DidUpdateFrame(ARKit.IARSessionDelegate,ARKit.ARSession,ARKit.ARFrame)">
+
+        <param name="session">The session that is supplying the information for the event.</param>
+        <param name="frame">The frame that was updated.</param>
+        <summary>Indicates that <paramref name="frame" /> has been updated due to tracking.</summary>
+        <remarks>
+          <para>Developers who override this method must be sure to call <format type="text/html"><a href="https://docs.microsoft.com/en-us/search/index?search=System%20IDisposable%20Dispose&amp;scope=Xamarin" title="M:System.IDisposable.Dispose*">M:System.IDisposable.Dispose*</a></format> on the <paramref name="frame" /> when they have finished processing. Internally, ARKit only generates a new <see cref="T:ARKit.ARFrame" /> object when there are no more references to an existing frame.
+          If <format type="text/html"><a href="https://docs.microsoft.com/en-us/search/index?search=System%20IDisposable%20Dispose&amp;scope=Xamarin" title="M:System.IDisposable.Dispose*">M:System.IDisposable.Dispose*</a></format> is not called, ARKit will not produce until the GC collects the <paramref name="frame" />. This typically appears as a frozen, non-responsive, or "severely stuttering" video feed.</para>
+        </remarks>
+      </Docs>
+</Documentation>

docs/api/AVFoundation/AVAudioSession.xml

@@ -265,14 +265,14 @@ void Setup ()
     </remarks>
   </Docs>
   <Docs DocId="P:AVFoundation.AVAudioSession.RouteChangeNotification">
-        <summary>Notification constant for RouteChange</summary>
-        <value>NSString constant, should be used as a token to NSNotificationCenter.</value>
-        <remarks>
-          <para id="tool-remark">This constant can be used with the <see cref="T:Foundation.NSNotificationCenter" /> to register a listener for this notification.   This is an NSString instead of a string, because these values can be used as tokens in some native libraries instead of being used purely for their actual string content.    The 'notification' parameter to the callback contains extra information that is specific to the notification type.</para>
-          <para id="tool-remark">To subscribe to this notification, developers can use the convenience <see cref="T:AVFoundation.AVAudioSession.Notifications" />.<see cref="M:AVFoundation.AVAudioSession.Notifications.ObserveRouteChange*" /> method which offers strongly typed access to the parameters of the notification.</para>
-          <para>The following example shows how to use the strongly typed Notifications class, to take the guesswork out of the available properties in the notification:</para>
-          <example>
-            <code lang="csharp lang-csharp"><![CDATA[
+    <summary>Notification constant for RouteChange</summary>
+    <value>NSString constant, should be used as a token to NSNotificationCenter.</value>
+    <remarks>
+      <para id="tool-remark">This constant can be used with the <see cref="T:Foundation.NSNotificationCenter" /> to register a listener for this notification.   This is an NSString instead of a string, because these values can be used as tokens in some native libraries instead of being used purely for their actual string content.    The 'notification' parameter to the callback contains extra information that is specific to the notification type.</para>
+      <para id="tool-remark">To subscribe to this notification, developers can use the convenience <see cref="T:AVFoundation.AVAudioSession.Notifications" />.<see cref="M:AVFoundation.AVAudioSession.Notifications.ObserveRouteChange*" /> method which offers strongly typed access to the parameters of the notification.</para>
+      <para>The following example shows how to use the strongly typed Notifications class, to take the guesswork out of the available properties in the notification:</para>
+      <example>
+        <code lang="csharp lang-csharp"><![CDATA[
 //
 // Lambda style
 //
@@ -311,10 +311,10 @@ void Teardown ()
 {
     notification.Dispose ();
 }]]></code>
-          </example>
-          <para>The following example shows how to use the notification with the DefaultCenter API:</para>
-          <example>
-            <code lang="csharp lang-csharp"><![CDATA[
+      </example>
+      <para>The following example shows how to use the notification with the DefaultCenter API:</para>
+      <example>
+        <code lang="csharp lang-csharp"><![CDATA[
 // Lambda style
 NSNotificationCenter.DefaultCenter.AddObserver (
         AVAudioSession.RouteChangeNotification, (notification) => {Console.WriteLine ("Received the notification AVAudioSession", notification); }
@@ -331,18 +331,18 @@ void Setup ()
     NSNotificationCenter.DefaultCenter.AddObserver (AVAudioSession.RouteChangeNotification, Callback);
 }
 ]]></code>
-          </example>
-        </remarks>
-      </Docs>
+      </example>
+    </remarks>
+  </Docs>
   <Docs DocId="P:AVFoundation.AVAudioSession.SilenceSecondaryAudioHintNotification">
-        <summary>Notification constant for SilenceSecondaryAudioHint</summary>
-        <value>NSString constant, should be used as a token to NSNotificationCenter.</value>
-        <remarks>
-          <para id="tool-remark">This constant can be used with the <see cref="T:Foundation.NSNotificationCenter" /> to register a listener for this notification.   This is an NSString instead of a string, because these values can be used as tokens in some native libraries instead of being used purely for their actual string content.    The 'notification' parameter to the callback contains extra information that is specific to the notification type.</para>
-          <para id="tool-remark">To subscribe to this notification, developers can use the convenience <see cref="T:AVFoundation.AVAudioSession.Notifications" />.<see cref="M:AVFoundation.AVAudioSession.Notifications.ObserveSilenceSecondaryAudioHint*" /> method which offers strongly typed access to the parameters of the notification.</para>
-          <para>The following example shows how to use the strongly typed Notifications class, to take the guesswork out of the available properties in the notification:</para>
-          <example>
-            <code lang="csharp lang-csharp"><![CDATA[
+    <summary>Notification constant for SilenceSecondaryAudioHint</summary>
+    <value>NSString constant, should be used as a token to NSNotificationCenter.</value>
+    <remarks>
+      <para id="tool-remark">This constant can be used with the <see cref="T:Foundation.NSNotificationCenter" /> to register a listener for this notification.   This is an NSString instead of a string, because these values can be used as tokens in some native libraries instead of being used purely for their actual string content.    The 'notification' parameter to the callback contains extra information that is specific to the notification type.</para>
+      <para id="tool-remark">To subscribe to this notification, developers can use the convenience <see cref="T:AVFoundation.AVAudioSession.Notifications" />.<see cref="M:AVFoundation.AVAudioSession.Notifications.ObserveSilenceSecondaryAudioHint*" /> method which offers strongly typed access to the parameters of the notification.</para>
+      <para>The following example shows how to use the strongly typed Notifications class, to take the guesswork out of the available properties in the notification:</para>
+      <example>
+        <code lang="csharp lang-csharp"><![CDATA[
 //
 // Lambda style
 //
@@ -381,10 +381,10 @@ void Teardown ()
 {
     notification.Dispose ();
 }]]></code>
-          </example>
-          <para>The following example shows how to use the notification with the DefaultCenter API:</para>
-          <example>
-            <code lang="csharp lang-csharp"><![CDATA[
+      </example>
+      <para>The following example shows how to use the notification with the DefaultCenter API:</para>
+      <example>
+        <code lang="csharp lang-csharp"><![CDATA[
 // Lambda style
 NSNotificationCenter.DefaultCenter.AddObserver (
         AVAudioSession.SilenceSecondaryAudioHintNotification, (notification) => {Console.WriteLine ("Received the notification AVAudioSession", notification); }
@@ -401,7 +401,72 @@ void Setup ()
     NSNotificationCenter.DefaultCenter.AddObserver (AVAudioSession.SilenceSecondaryAudioHintNotification, Callback);
 }
 ]]></code>
-          </example>
-        </remarks>
-      </Docs>
+      </example>
+    </remarks>
+  </Docs>
+  <Docs DocId="M:AVFoundation.AVAudioSession.SetCategory(Foundation.NSString,Foundation.NSError@)">
+    <param name="theCategory">One of 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryAmbient" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategorySoloAmbient" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryPlayback" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryRecord" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryPlayAndRecord" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryAudioProcessing" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryMultiRoute" />.
+	</param>
+    <param name="outError">On failure, this contains the error details.</param>
+    <summary>Weakly typed; Requests a change to the <see cref="P:AVFoundation.AVAudioSession.Category" />.</summary>
+    <returns>true on success, false on error.   If there is an error the outError parameter contains the new instance of NSError describing the problem.</returns>
+    <remarks>
+      <para>
+	    In general, you should set the category before activating
+	    your audio session with <see cref="M:AVFoundation.AVAudioSession.SetActive(System.Boolean,AVFoundation.AVAudioSessionSetActiveOptions,Foundation.NSError@)" />.
+	    If you change the category at runtime, the route will change. 
+	  </para>
+    </remarks>
+  </Docs>
+  <Docs DocId="M:AVFoundation.AVAudioSession.SetCategory(Foundation.NSString)">
+    <param name="theCategory">One of 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryAmbient" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategorySoloAmbient" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryPlayback" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryRecord" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryPlayAndRecord" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryAudioProcessing" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryMultiRoute" />.
+	</param>
+    <summary>Weakly typed;  Requests a change to the <see cref="P:AVFoundation.AVAudioSession.Category" />.</summary>
+    <returns>
+	  null on success, or an instance of NSError in case of failure with the details about the error.
+	</returns>
+    <remarks>
+      <para>
+	    In general, you should set the category before activating
+	    your audio session with <see cref="M:AVFoundation.AVAudioSession.SetActive(System.Boolean,AVFoundation.AVAudioSessionSetActiveOptions,Foundation.NSError@)" />.
+	    If you change the category at runtime, the route will change. 
+	  </para>
+    </remarks>
+  </Docs>
+  <Docs DocId="M:AVFoundation.AVAudioSession.SetCategory(System.String,AVFoundation.AVAudioSessionCategoryOptions,Foundation.NSError@)">
+    <param name="category">One of 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryAmbient" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategorySoloAmbient" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryPlayback" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryRecord" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryPlayAndRecord" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryAudioProcessing" />, 
+	<see cref="P:AVFoundation.AVAudioSession.CategoryMultiRoute" />.</param>
+    <param name="options">Options on how to handle audio.</param>
+    <param name="outError">On failure, this contains the error details.</param>
+    <summary>Weakly typed;  Requests a change to the <see cref="P:AVFoundation.AVAudioSession.Category" />.</summary>
+    <returns>
+      <see langword="true" /> if the request was successful, otherwise the outError parameter contains an instance of NSError describing the problem.</returns>
+    <remarks>
+      <para>
+	    In general, you should set the category before activating
+	    your audio session with <see cref="M:AVFoundation.AVAudioSession.SetActive(System.Boolean,AVFoundation.AVAudioSessionSetActiveOptions,Foundation.NSError@)" />.
+	    If you change the category at runtime, the route will change. 
+	  </para>
+    </remarks>
+  </Docs>
 </Documentation>