chore: Add AnalyzerLoadFailed event handler logics to report warning (#10617)

chore: add analyzer load failure warning

Author: filzrev

src/Docfx.Common/Loggers/WarningCodes.cs

@@ -25,6 +25,12 @@ public static class Build
         public const string InvalidTocInclude = "InvalidTocInclude";
     }
 
+    public static class Metadata
+    {
+        public const string FailedToResolveAnalyzer = "FailedToResolveAnalyzer";
+        public const string FailedToLoadAnalyzer = "FailedToLoadAnalyzer";
+    }
+
     public static class Markdown
     {
         public const string InvalidInclude = "InvalidInclude";

src/Docfx.Dotnet/DotnetApiCatalog.Compile.cs

@@ -147,7 +147,22 @@ await LoadCompilationFromProject(project.AbsolutePath) is { } compilation)
                 {
                     Logger.LogWarning($"There is .NET Analyzer that can't be resolved. "
                                     + $"If this analyzer is .NET Source Generator project. "
-                                    + $"Try build with `dotnet build -c Release` command before running docfx. Path: {unresolvedAnalyzer.FullPath}");
+                                    + $"Try build with `dotnet build -c Release` command before running docfx. Path: {unresolvedAnalyzer.FullPath}",
+                                    code: WarningCodes.Metadata.FailedToResolveAnalyzer);
+                }
+
+                foreach (var analyzer in project.AnalyzerReferences.OfType<AnalyzerFileReference>())
+                {
+                    analyzer.AnalyzerLoadFailed += (sender, e) =>
+                    {
+                        var analyzerName = analyzer.Display;
+                        var errorCode = e.ErrorCode;
+                        var referencedCompilerVersion = e.ReferencedCompilerVersion;
+
+                        Logger.LogWarning($"Failed to load .NET Analyzer. AnalyzerName: {analyzerName}, ErrorCode: {errorCode}, ReferencedCompilerVersion: {referencedCompilerVersion}",
+                                          code: WarningCodes.Metadata.FailedToLoadAnalyzer);
+                    };
+
                 }
             }