Files
LanMountainDesktop/docs/cross-platform-shared-audit.md
2026-08-11 19:41:54 +08:00

2.9 KiB
Raw Blame History

共享库跨平台依赖审计报告

审计目标:确认以下共享库可被 Android headnet10.0-android安全引用。 审计方法:源码级扫描 DllImport/LibraryImport/Microsoft.Win32/System.Drawing/WindowsRuntime/System.Management + csproj 包引用检查。

结论总览

项目(合并后) 状态 说明
LanMountainDesktop.Core含 Shared.Contracts / Shared.IPC / PluginPackaging ⚠️ 可编译,运行时受限 Shared.IPC 依赖 dotnetCampus.Ipc命名管道。Android 上可编译但命名管道不可用,移动端必须走进程内传输
LanMountainDesktop.PluginSdk含 PluginIsolation / Host.Abstractions / Settings.Core / Appearance ⚠️ 需验证 引用 FluentAvaloniaUI / FluentIcons.AvaloniaExcludeAssets=runtime仅编译期与 dotnetCampus.IpcAndroid 引用时需实测还原

本报告基于合并前的项目结构Shared.Contracts、Shared.IPC、Settings.Core、Appearance、DesktopComponents.Runtime、Host.Abstractions、PluginIsolation.*),上述结论对合并后的 Core / PluginSdk 仍然成立。DesktopComponents.Runtime 为空壳项目,已删除。

详细发现

1. 源码扫描

合并后两个共享库(LanMountainDesktop.CoreLanMountainDesktop.PluginSdk)的 .cs 源码中均未发现:

  • DllImport / LibraryImportP/Invoke
  • Microsoft.Win32(注册表)
  • System.Drawing
  • System.Runtime.WindowsRuntime
  • System.Management

平台专属代码全部集中在 platform/LanMountainDesktop.Platform/(原 Platform.Windows 的 Windows 实现,已从主工程迁出)。

2. dotnetCampus.IpcCore 的 Shared.IPC 部分、PluginSdk

  • 编译期:跨平台 net 库Android 目标可编译。
  • 运行期传输基于命名管道Android 不可用。
  • 处置:移动端一律使用 PluginIsolation 的进程内传输InProc transport Core 中的 IPC 在移动端应仅作为契约/类型来源,不建立管道连接。
  • 后续(可选):若希望编译期硬隔离,可把"管道传输"从 Core 拆到独立子项目,移动端不引用。当前不阻塞。

3. FluentAvaloniaUI / FluentIcons.AvaloniaPluginSdk

  • ExcludeAssets="runtime",仅编译期类型引用。
  • 两者均为纯托管 Avalonia 库,预期可在 Android 还原;由 Mobile head 构建实测确认。

4. 面向未来移动 AOT 的裁剪风险(仅报告,不修复)

  • 主工程使用 YamlDotNet、反射式配置读取——不在本次共享库范围内 但如后续把相关逻辑下沉共享层,需加 DynamicallyAccessedMembers 注解或源生成序列化。
  • PluginSdk 中合并自 Settings.Core 的代码若存在基于 Activator.CreateInstance 的设置实例化路径, 迁移到移动端 AOT未来 iOS前需要审计AndroidJIT/interp 可用)不阻塞。

修复记录

本次审计未发现需要修改共享库源码的问题,未做代码改动。