feat: add macOS arm64 static wkhtmltopdf dylib and compatibility fixes

- Build static libwkhtmltox.dylib (53MB) for macOS arm64 with Qt 5.15 and QtWebKit statically linked, zero external dependencies
- Fix netstandard2.0 compatibility: init→set properties, RuntimeInformation.RuntimeIdentifier fallback, string.Contains IndexOf workaround
- Add arm64→x64 native library path fallback in PdfNativeLibraryBootstrapper
- Update CI workflow to install wkhtmltopdf on Linux and macOS
- Replace old dynamic libwkhtmltox-next.0.dylib with static libwkhtmltox.dylib

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: hueifeng

.github/workflows/dotnetcore.yml

@@ -29,7 +29,11 @@ jobs:
 
       - name: Install Linux dependencies
         if: runner.os == 'Linux'
-        run: sudo apt-get update && sudo apt-get install -y libgdiplus libc6-dev libjpeg62
+        run: sudo apt-get update && sudo apt-get install -y libgdiplus libc6-dev libjpeg62 wkhtmltopdf fontconfig libxrender1 xfonts-75dpi
+
+      - name: Install macOS dependencies
+        if: runner.os == 'macOS'
+        run: brew install wkhtmltopdf
 
       - name: Restore
         run: dotnet restore Magicodes.IE.sln

src/Magicodes.ExporterAndImporter.Pdf/PdfEnvironmentInfo.cs

@@ -23,41 +23,41 @@ public sealed class PdfEnvironmentInfo
         /// <summary>
         /// 当前平台标识（如 "osx-arm64", "linux-x64", "win-x64"）。
         /// </summary>
-        public string Platform { get; init; }
+        public string Platform { get; set; }
 
         /// <summary>
         /// wkhtmltopdf native 库是否可用。
         /// 为 true 表示 PDF 导出功能可以正常工作。
         /// </summary>
-        public bool IsAvailable { get; init; }
+        public bool IsAvailable { get; set; }
 
         /// <summary>
         /// 找到的 native 库文件路径。
         /// 可能来自 runtimes/ 目录或系统路径。
         /// </summary>
-        public string NativeLibraryPath { get; init; }
+        public string NativeLibraryPath { get; set; }
 
         /// <summary>
         /// native 库文件是否存在（不论是否能加载）。
         /// 文件存在但加载失败通常意味着缺少系统依赖（Qt、fontconfig 等）。
         /// </summary>
-        public bool NativeLibraryFileExists { get; init; }
+        public bool NativeLibraryFileExists { get; set; }
 
         /// <summary>
         /// native 库是否能成功加载（通过 NativeLibrary.TryLoad 探测）。
         /// </summary>
-        public bool NativeLibraryLoadable { get; init; }
+        public bool NativeLibraryLoadable { get; set; }
 
         /// <summary>
         /// 加载失败时的详细错误信息。
         /// </summary>
-        public string ErrorDetail { get; init; }
+        public string ErrorDetail { get; set; }
 
         /// <summary>
         /// 针对当前平台的安装建议。
         /// 包含具体的安装命令。
         /// </summary>
-        public string InstallSuggestion { get; init; }
+        public string InstallSuggestion { get; set; }
 
         /// <summary>
         /// 检查当前环境并返回诊断信息。不会抛出异常。

src/Magicodes.ExporterAndImporter.Pdf/PdfNativeLibraryBootstrapper.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using System.IO;
 using System.Runtime.InteropServices;
 
@@ -24,7 +25,7 @@ internal static class PdfNativeLibraryBootstrapper
 
         private static PdfEnvironmentInfo CheckEnvironmentCore()
         {
-            var rid = RuntimeInformation.RuntimeIdentifier;
+            var rid = GetCurrentRuntimeIdentifier();
             var nativePath = FindNativeLibraryPath(rid);
             var loadable = TryProbeNativeLibrary(nativePath, out var error);
 
@@ -40,26 +41,58 @@ private static PdfEnvironmentInfo CheckEnvironmentCore()
             };
         }
 
+        /// <summary>
+        /// 获取当前运行时标识符（跨框架兼容）。
+        /// </summary>
+        private static string GetCurrentRuntimeIdentifier()
+        {
+#if NET5_0_OR_GREATER
+            return RuntimeInformation.RuntimeIdentifier;
+#else
+            var arch = RuntimeInformation.OSArchitecture.ToString().ToLowerInvariant();
+            if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+                return "win-" + arch;
+            if (RuntimeInformation.IsOSPlatform(OSPlatform.OSX))
+                return "osx-" + arch;
+            return "linux-" + arch;
+#endif
+        }
+
         /// <summary>
         /// 查找 native 库文件路径。
         /// 搜索 runtimes/{rid}/native/ 和应用根目录。
+        /// 在 arm64 平台上如果找不到，会自动 fallback 到 x64 版本（通过 Rosetta 2 运行）。
         /// </summary>
         private static string FindNativeLibraryPath(string rid)
         {
-            var dirs = new[]
+            var baseDir = AppContext.BaseDirectory;
+            var candidateRids = new List<string> { rid };
+
+            // arm64 平台 fallback：wkhtmltopdf 等 native 库通常没有 arm64 版本，
+            // x64 版本可通过 Rosetta 2 (macOS) 或兼容层 (Linux) 运行。
+            if (rid.EndsWith("-arm64", StringComparison.OrdinalIgnoreCase))
             {
-                Path.Combine(AppContext.BaseDirectory, "runtimes", rid, "native"),
-                AppContext.BaseDirectory
-            };
+                var x64Rid = rid.Substring(0, rid.Length - "arm64".Length) + "x64";
+                candidateRids.Add(x64Rid);
+            }
 
-            var names = GetNativeLibraryNames(rid);
-            foreach (var dir in dirs)
+            foreach (var candidateRid in candidateRids)
             {
-                if (!Directory.Exists(dir)) continue;
-                foreach (var name in names)
+                var dirs = new[]
+                {
+                    Path.Combine(baseDir, "runtimes", candidateRid, "native"),
+                    baseDir
+                };
+
+                var names = GetNativeLibraryNames(candidateRid);
+                foreach (var dir in dirs)
                 {
-                    var path = Path.Combine(dir, name);
-                    if (File.Exists(path)) return path;
+                    if (!Directory.Exists(dir)) continue;
+                    foreach (var name in names)
+                    {
+                        var path = Path.Combine(dir, name);
+                        if (File.Exists(path)) return path;
+                    }
                 }
             }
             return null;
@@ -70,7 +103,7 @@ private static string[] GetNativeLibraryNames(string rid)
             if (rid.StartsWith("win", StringComparison.OrdinalIgnoreCase))
                 return new[] { "wkhtmltox.dll" };
             if (rid.StartsWith("osx", StringComparison.OrdinalIgnoreCase))
-                return new[] { "libwkhtmltox-next.0.dylib", "libwkhtmltox.dylib", "libwkhtmltox-next.dylib" };
+                return new[] { "libwkhtmltox.dylib" };
             return new[] { "libwkhtmltox.so" };
         }
 
@@ -108,7 +141,7 @@ private static string GetInstallSuggestion(string rid)
                 return "brew install wkhtmltopdf  # macOS";
 
             // Alpine Linux (musl libc) - Docker 最常用的基础镜像之一
-            if (rid.Contains("musl", StringComparison.OrdinalIgnoreCase))
+            if (rid.IndexOf("musl", StringComparison.OrdinalIgnoreCase) >= 0)
                 return "apk add --no-cache wkhtmltopdf fontconfig ttf-freefont ttf-dejavu  # Alpine\n" +
                        "Note: Alpine uses musl libc. If using pre-built glibc binaries, also run: apk add --no-cache libc6-compat";
 

src/Magicodes.ExporterAndImporter.Pdf/runtimes/osx-arm64/native/libwkhtmltox-next.0.dylib

@@ -49,7 +49,11 @@ public void CheckEnvironment_ToString_ContainsPlatformAndDiagnostics()
         public void CheckEnvironment_Platform_MatchesRuntimeIdentifier()
         {
             var info = PdfEnvironmentInfo.Check();
+#if NET5_0_OR_GREATER
             info.Platform.ShouldBe(RuntimeInformation.RuntimeIdentifier);
+#else
+            info.Platform.ShouldNotBeNullOrWhiteSpace();
+#endif
         }
     }
 }