Fix NativeLinker.LogFailure: add XA3008 coded warning with format arguments

Documentation/docs-mobile/messages/index.md

@@ -168,6 +168,7 @@ Either change the value in the AndroidManifest.xml to match the $(SupportedOSPla
 + XA3005: The detected Android NDK version is incompatible with the targeted LLVM configuration.
 + XA3006: Could not compile native assembly file: {file}
 + XA3007: Could not link native shared library: {library}
++ XA3008: Failed to extract debug info from '{library}'
 
 ## XA4xxx: Code generation
 

Documentation/docs-mobile/messages/xa3008.md

@@ -0,0 +1,28 @@
+---
+title: .NET for Android warning XA3008
+description: XA3008 warning code
+ms.date: 05/15/2026
+f1_keywords:
+  - "XA3008"
+---
+
+# .NET for Android warning XA3008
+
+## Issue
+
+This warning is emitted when the build system fails to extract debug symbols from
+a native shared library using `objcopy`. The shared library itself was linked
+successfully, but separate debug symbol files (`.dbg.so`) could not be created.
+
+## Solution
+
+This warning is non-fatal and the app will still work correctly. Debug symbols
+are used for native crash diagnostics. If you need native debug symbols, check
+that the NDK `objcopy` tool is installed and functioning correctly.
+
+## Example messages
+
+```
+warning XA3008: Failed to extract debug info from 'libmonodroid.so':
+objcopy: error: ...
+```

src/Xamarin.Android.Build.Tasks/Properties/Resources.resx

@@ -589,6 +589,10 @@ Either change the value in the AndroidManifest.xml to match the $(SupportedOSPla
     <value>Could not link native shared library: {0}{1}</value>
     <comment>The '{1}' placeholder is replaced with full output of the failed command, starting and ending with a newline.</comment>
   </data>
+  <data name="XA3008" xml:space="preserve">
+    <value>Failed to extract debug info from '{0}': {1}</value>
+    <comment>'{0}' is the native shared library filename. '{1}' is the full output of the failed command, starting and ending with a newline.</comment>
+  </data>
   <data name="XA4209" xml:space="preserve">
     <value>Failed to generate Java type for class: {0} due to {1}</value>
     <comment>{0} - The managed type name

src/Xamarin.Android.Build.Tasks/Utilities/NativeLinker.cs

@@ -402,9 +402,7 @@ bool ExtractDebugSymbols (ITaskItem outputSharedLibrary)
 		void LogFailure ()
 		{
 			var sb = MonoAndroidHelper.MergeStdoutAndStderrMessages (stdoutLines, stderrLines);
-			// TODO: consider making it a warning
-			// TODO: make it a coded message
-			log.LogError ("Failed to extract debug info", Path.GetFileName (sourceLib), sb.ToString ());
+			log.LogCodedWarning ("XA3008", Properties.Resources.XA3008, Path.GetFileName (sourceLib), sb.ToString ());
 		}
 	}