[xcode16.3] Merge main into xcode16.3.

Make.config

@@ -401,7 +401,7 @@ DOTNET_BCL_DIR:=$(abspath $(TOP)/packages/microsoft.netcore.app.ref/$(DOTNET_BCL
 ifneq ($(DOTNET_BCL_DIR),$(shell ls -1d $(DOTNET_BCL_DIR) 2>/dev/null))
 DOTNET_BCL_DIR:=$(abspath $(TOP)/packages/microsoft.netcore.app.ref/$(DOTNET_BCL_VERSION)/ref/net8.0)
 endif
-DOTNET_ANALYZERS_DIR=$(DOTNET_DIR)/sdk/$(DOTNET_VERSION_BAND)/Sdks/Microsoft.NET.Sdk/analyzers
+DOTNET_ANALYZERS_DIR?=$(DOTNET_DIR)/sdk/$(DOTNET_VERSION_BAND)/Sdks/Microsoft.NET.Sdk/analyzers
 
 # The sdk version band has the last two digits set to 0: https://github.com/dotnet/sdk/blob/22c4860dcb2cf6b123dd641cc4a87a50380759d5/src/Resolvers/Microsoft.NET.Sdk.WorkloadManifestReader/SdkDirectoryWorkloadManifestProvider.cs#L52-L53
 DOTNET_MANIFEST_VERSION_BAND=$(shell echo $(DOTNET_VERSION_BAND) | sed 's/..$$/00/')

NuGet.config

@@ -14,20 +14,14 @@
     <!--  Begin: Package sources from dotnet-emsdk -->
     <!--  End: Package sources from dotnet-emsdk -->
     <!--  Begin: Package sources from dotnet-aspnetcore -->
-    <add key="darc-int-dotnet-aspnetcore-4442a18" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-aspnetcore-4442a188/nuget/v3/index.json" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-8" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-aspnetcore-4442a188-8/nuget/v3/index.json" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-7" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-aspnetcore-4442a188-7/nuget/v3/index.json" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-6" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-aspnetcore-4442a188-6/nuget/v3/index.json" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-5" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-aspnetcore-4442a188-5/nuget/v3/index.json" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-4" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-aspnetcore-4442a188-4/nuget/v3/index.json" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-3" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-aspnetcore-4442a188-3/nuget/v3/index.json" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-2" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-aspnetcore-4442a188-2/nuget/v3/index.json" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-1" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-aspnetcore-4442a188-1/nuget/v3/index.json" />
     <!--  End: Package sources from dotnet-aspnetcore -->
     <!--  Begin: Package sources from dotnet-runtime -->
-    <add key="darc-int-dotnet-runtime-c8acea2" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-runtime-c8acea22/nuget/v3/index.json" />
-    <add key="darc-int-dotnet-runtime-c8acea2-8" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-runtime-c8acea22-8/nuget/v3/index.json" />
-    <add key="darc-int-dotnet-runtime-c8acea2-3" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-runtime-c8acea22-3/nuget/v3/index.json" />
+    <add key="darc-int-dotnet-runtime-80aa709" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-runtime-80aa709f/nuget/v3/index.json" />
+    <add key="darc-int-dotnet-runtime-80aa709-2" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-runtime-80aa709f-2/nuget/v3/index.json" />
+    <add key="darc-int-dotnet-runtime-80aa709-15" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-runtime-80aa709f-15/nuget/v3/index.json" />
+    <add key="darc-int-dotnet-runtime-80aa709-14" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-runtime-80aa709f-14/nuget/v3/index.json" />
+    <add key="darc-int-dotnet-runtime-80aa709-12" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-runtime-80aa709f-12/nuget/v3/index.json" />
+    <add key="darc-int-dotnet-runtime-80aa709-10" value="https://pkgs.dev.azure.com/dnceng/internal/_packaging/darc-int-dotnet-runtime-80aa709f-10/nuget/v3/index.json" />
     <!--  End: Package sources from dotnet-runtime -->
     <!--End: Package sources managed by Dependency Flow automation. Do not edit the sources above.-->
     <add key="dotnet-public" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-public/nuget/v3/index.json" protocolVersion="3" />
@@ -46,25 +40,21 @@
     <add key="darc-pub-dotnet-runtime-c1ae962" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/darc-pub-dotnet-runtime-c1ae9626/nuget/v3/index.json" />
     <!-- Add a 8.0.13 feed -->
     <add key="darc-pub-dotnet-runtime-e346656" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/darc-pub-dotnet-runtime-e346656d/nuget/v3/index.json" />
+    <!-- Add a 8.0.14 feed -->
+    <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" />
   </packageSources>
   <disabledPackageSources>
     <clear />
     <!--Begin: Package sources managed by Dependency Flow automation. Do not edit the sources below.-->
     <!--  Begin: Package sources from dotnet-runtime -->
-    <add key="darc-int-dotnet-runtime-c8acea2-3" value="true" />
-    <add key="darc-int-dotnet-runtime-c8acea2-8" value="true" />
-    <add key="darc-int-dotnet-runtime-c8acea2" value="true" />
+    <add key="darc-int-dotnet-runtime-80aa709-10" value="true" />
+    <add key="darc-int-dotnet-runtime-80aa709-12" value="true" />
+    <add key="darc-int-dotnet-runtime-80aa709-14" value="true" />
+    <add key="darc-int-dotnet-runtime-80aa709-15" value="true" />
+    <add key="darc-int-dotnet-runtime-80aa709-2" value="true" />
+    <add key="darc-int-dotnet-runtime-80aa709" value="true" />
     <!--  End: Package sources from dotnet-runtime -->
     <!--  Begin: Package sources from dotnet-aspnetcore -->
-    <add key="darc-int-dotnet-aspnetcore-4442a18-1" value="true" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-2" value="true" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-3" value="true" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-4" value="true" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-5" value="true" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-6" value="true" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-7" value="true" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18-8" value="true" />
-    <add key="darc-int-dotnet-aspnetcore-4442a18" value="true" />
     <!--  End: Package sources from dotnet-aspnetcore -->
     <!--End: Package sources managed by Dependency Flow automation. Do not edit the sources above.-->
   </disabledPackageSources>

create-make-config.sh

@@ -33,4 +33,10 @@ if which ccache > /dev/null 2>&1; then
 	echo "Found ccache on the system, enabling it"
 fi
 
+# Detect ADR
+if test -d ../macios-adr; then
+	printf "ENABLE_XAMARIN=1\n" >> "$OUTPUT_FILE"
+	echo "Detected the macios-adr repository, automatically enabled the Xamarin build"
+fi
+
 mv "$OUTPUT_FILE" "$OUTPUT"

docs/api/AudioToolbox/AudioQueue.xml

@@ -0,0 +1,66 @@
+<Documentation>
+  <Docs DocId="P:AudioToolbox.AudioQueue.CurrentLevelMeter">
+        <summary>Current Level meters, one per channel in the range zero (minimum) to one (maximum).</summary>
+        <value>Array of level meters, one per audio channel.</value>
+        <remarks>
+          <para>
+	    To use this property, make sure that you set the <see cref="P:AudioToolbox.AudioQueue.EnableLevelMetering" /> property on the queue.
+	  </para>
+          <para>
+	    Use the <see cref="P:AudioToolbox.AudioQueue.CurrentLevelMeterDB" /> if you want to get the values in decibels.
+	  </para>
+          <example>
+            <code lang="c#"><![CDATA[
+class MyInputQueue : InputAudioQueue {
+    public MyQueueInput (AudioStreamBasicDescription desc) : base (desc) 
+    {
+    	inputQueue.EnableLevelMetering = true;
+    }
+
+    protected virtual void OnInputCompleted (IntPtr audioQueueBuffer, 
+                                             AudioTimeStamp timeStamp, 
+                                             AudioStreamPacketDescription [] packetData)
+    {
+        var levels = CurrentLevelMeterDB;
+        for (int channel = 0; channel < levels.Count; channel.Length)
+    	Console.WriteLine ("Channel {0} Average Power: {1} Peak Power: {2}", 
+                               channel, levels [channel].AveragePower, levels [channel].PeakPower);
+        }
+    }
+}]]></code>
+          </example>
+        </remarks>
+      </Docs>
+  <Docs DocId="P:AudioToolbox.AudioQueue.CurrentLevelMeterDB">
+        <summary>Current Level meters, one per channel in decibels.</summary>
+        <value>Array of level meters, one per audio channel.</value>
+        <remarks>
+          <para>
+	    To use this property, make sure that you set the <see cref="P:AudioToolbox.AudioQueue.EnableLevelMetering" /> property on the queue.
+	  </para>
+          <para>
+	    Use the <see cref="P:AudioToolbox.AudioQueue.CurrentLevelMeter" /> if you want to get the values normalized to the range zero (minimum) to one (maximum).
+	  </para>
+          <example>
+            <code lang="c#"><![CDATA[
+class MyInputQueue : InputAudioQueue {
+    public MyQueueInput (AudioStreamBasicDescription desc) : base (desc) 
+    {
+    	inputQueue.EnableLevelMetering = true;
+    }
+
+    protected virtual void OnInputCompleted (IntPtr audioQueueBuffer, 
+                                             AudioTimeStamp timeStamp, 
+                                             AudioStreamPacketDescription [] packetData)
+    {
+        var levels = CurrentLevelMeterDB;
+        for (int channel = 0; channel < levels.Count; channel.Length)
+    	Console.WriteLine ("Channel {0} Average Power: {1} Peak Power: {2}", 
+                               channel, levels [channel].AveragePower, levels [channel].PeakPower);
+        }
+    }
+}]]></code>
+          </example>
+        </remarks>
+      </Docs>
+</Documentation>

docs/api/AudioUnit/AUAudioUnit.xml

@@ -0,0 +1,54 @@
+<Documentation>
+  <Docs DocId="P:AudioUnit.AUAudioUnit.AudioComponentRegistrationsChangedNotification">
+        <summary>Notification constant for AudioComponentRegistrationsChanged</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>
+          <example>
+            <code lang="csharp lang-csharp"><![CDATA[
+// Lambda style
+NSNotificationCenter.DefaultCenter.AddObserver (
+        AUAudioUnit.AudioComponentRegistrationsChangedNotification, (notification) => {Console.WriteLine ("Received the notification AUAudioUnit", notification); }
+
+
+// Method style
+void Callback (NSNotification notification)
+{
+    Console.WriteLine ("Received a notification AUAudioUnit", notification);
+}
+
+void Setup ()
+{
+    NSNotificationCenter.DefaultCenter.AddObserver (AUAudioUnit.AudioComponentRegistrationsChangedNotification, Callback);
+}
+]]></code>
+          </example>
+        </remarks>
+      </Docs>
+  <Docs DocId="P:AudioUnit.AUAudioUnit.AudioComponentInstanceInvalidationNotification">
+        <summary>Notification constant for AudioComponentInstanceInvalidation</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>
+          <example>
+            <code lang="csharp lang-csharp"><![CDATA[
+// Lambda style
+NSNotificationCenter.DefaultCenter.AddObserver (
+        AUAudioUnit.AudioComponentInstanceInvalidationNotification, (notification) => {Console.WriteLine ("Received the notification AUAudioUnit", notification); }
+
+
+// Method style
+void Callback (NSNotification notification)
+{
+    Console.WriteLine ("Received a notification AUAudioUnit", notification);
+}
+
+void Setup ()
+{
+    NSNotificationCenter.DefaultCenter.AddObserver (AUAudioUnit.AudioComponentInstanceInvalidationNotification, Callback);
+}
+]]></code>
+          </example>
+        </remarks>
+      </Docs>
+</Documentation>

docs/api/AudioUnit/AudioComponentDescription.xml

@@ -0,0 +1,62 @@
+<Documentation>
+  <Docs DocId="F:AudioUnit.AudioComponentDescription.ComponentSubType">
+        <summary>Audio Unit component subtype, depending on the <see cref="F:AudioUnit.AudioComponentDescription.ComponentSubType" /> value you should use one of the values from <see cref="T:AudioUnit.AudioTypeOutput" />, <see cref="T:AudioUnit.AudioTypeMusicDevice" />, <see cref="T:AudioUnit.AudioTypeConverter" />, <see cref="T:AudioUnit.AudioTypeEffect" />, <see cref="T:AudioUnit.AudioTypeMixer" />, <format type="text/html"><a href="https://docs.microsoft.com/en-us/search/index?search=T:AudioUnit.AudioTypePanner,&amp;scope=Xamarin" title="T:AudioUnit.AudioTypePanner,">T:AudioUnit.AudioTypePanner,</a></format> <see cref="T:AudioUnit.AudioTypeGenerator" /></summary>
+        <remarks>
+          <para>Audio Unit component subtype, depending on the <see cref="F:AudioUnit.AudioComponentDescription.ComponentType" /> you should use one of the values from <see cref="T:AudioUnit.AudioTypeOutput" />, <see cref="T:AudioUnit.AudioTypeMusicDevice" />, <see cref="T:AudioUnit.AudioTypeConverter" />, <see cref="T:AudioUnit.AudioTypeEffect" />, <see cref="T:AudioUnit.AudioTypeMixer" />, <format type="text/html"><a href="https://docs.microsoft.com/en-us/search/index?search=T:AudioUnit.AudioTypePanner,&amp;scope=Xamarin" title="T:AudioUnit.AudioTypePanner,">T:AudioUnit.AudioTypePanner,</a></format> <see cref="T:AudioUnit.AudioTypeGenerator" />.</para>
+          <para />
+          <para>Since this is an integer, and the values on those enumerations are strongly typed, you typically need to cast.   The following example shows this:</para>
+          <para />
+          <para />
+          <example>
+            <code lang="csharp lang-csharp"><![CDATA[var processingGraph = new AUGraph ();
+
+int samplerNode, ioNode;
+
+var musicSampler = new AudioComponentDescription () {
+        ComponentManufacturer = AudioComponentManufacturerType.Apple,
+        ComponentType = AudioComponentType.MusicDevice,
+        ComponentSubType = (int)AudioTypeMusicDevice.Sampler
+};
+samplerNode = processingGraph.AddNode (musicSampler);
+
+var remoteOutput = new AudioComponentDescription () {
+        ComponentManufacturer = AudioComponentManufacturerType.Apple,
+        ComponentType = AudioComponentType.Output,
+        ComponentSubType = (int)AudioTypeOutput.Remote
+};
+ioNode = processingGraph.AddNode (remoteOutput);
+
+processingGraph.Open ();]]></code>
+          </example>.</remarks>
+      </Docs>
+  <Docs DocId="F:AudioUnit.AudioComponentDescription.ComponentSubType">
+        <summary>Audio Unit component subtype, depending on the <see cref="F:AudioUnit.AudioComponentDescription.ComponentSubType" /> value you should use one of the values from <see cref="T:AudioUnit.AudioTypeOutput" />, <see cref="T:AudioUnit.AudioTypeMusicDevice" />, <see cref="T:AudioUnit.AudioTypeConverter" />, <see cref="T:AudioUnit.AudioTypeEffect" />, <see cref="T:AudioUnit.AudioTypeMixer" />, <format type="text/html"><a href="https://docs.microsoft.com/en-us/search/index?search=T:AudioUnit.AudioTypePanner,&amp;scope=Xamarin" title="T:AudioUnit.AudioTypePanner,">T:AudioUnit.AudioTypePanner,</a></format> <see cref="T:AudioUnit.AudioTypeGenerator" /></summary>
+        <remarks>
+          <para>Audio Unit component subtype, depending on the <see cref="F:AudioUnit.AudioComponentDescription.ComponentType" /> you should use one of the values from <see cref="T:AudioUnit.AudioTypeOutput" />, <see cref="T:AudioUnit.AudioTypeMusicDevice" />, <see cref="T:AudioUnit.AudioTypeConverter" />, <see cref="T:AudioUnit.AudioTypeEffect" />, <see cref="T:AudioUnit.AudioTypeMixer" />, <format type="text/html"><a href="https://docs.microsoft.com/en-us/search/index?search=T:AudioUnit.AudioTypePanner,&amp;scope=Xamarin" title="T:AudioUnit.AudioTypePanner,">T:AudioUnit.AudioTypePanner,</a></format> <see cref="T:AudioUnit.AudioTypeGenerator" />.</para>
+          <para />
+          <para>Since this is an integer, and the values on those enumerations are strongly typed, you typically need to cast.   The following example shows this:</para>
+          <para />
+          <para />
+          <example>
+            <code lang="csharp lang-csharp"><![CDATA[var processingGraph = new AUGraph ();
+
+int samplerNode, ioNode;
+
+var musicSampler = new AudioComponentDescription () {
+        ComponentManufacturer = AudioComponentManufacturerType.Apple,
+        ComponentType = AudioComponentType.MusicDevice,
+        ComponentSubType = (int)AudioTypeMusicDevice.Sampler
+};
+samplerNode = processingGraph.AddNode (musicSampler);
+
+var remoteOutput = new AudioComponentDescription () {
+        ComponentManufacturer = AudioComponentManufacturerType.Apple,
+        ComponentType = AudioComponentType.Output,
+        ComponentSubType = (int)AudioTypeOutput.Remote
+};
+ioNode = processingGraph.AddNode (remoteOutput);
+
+processingGraph.Open ();]]></code>
+          </example>.</remarks>
+      </Docs>
+</Documentation>