如何将RCLShared类库添加到MAUI项目且避免运行时与编译问题

问题背景 #

我有一个.NET8类库RCLShared和一个.NET8 MAUI Blazor混合项目（Blazor项目本身运行正常）。最初按照微软官方文档将RCLShared添加为MAUI项目的项目引用。

给RCLShared添加NuGet包后，MAUI项目编译失败，报错：
NETSDK1082 There was no runtime pack for Microsoft.AspNetCore.App available for the specified RuntimeIdentifier

移除这些NuGet包会导致Web版本项目无法正常运行。将RCLShared改为共享项目引用后，编译问题解决，但无法通过_content/RCLShared/css/app.css路径访问wwwroot中的资源（如图片、CSS等）。

问题清单 #

1. 是否应该给共享类库添加NuGet包？
2. 有没有办法添加项目引用且不触发编译问题？
3. MAUI项目是否应该独立于Web版本，不复用RCLShared中的服务、页面及样式？
4. 是否应该采用包方案进行引用？我担心这仍会导致MAUI项目编译失败。
5. 还有其他解决方案建议吗？

补充信息 #

共享类库安装的NuGet包：

MAUI项目安装的NuGet包：

问题解答 #

1. 可以给共享类库添加NuGet包，但需区分依赖类型
   RCL作为共享组件库，本身需要的依赖可以正常添加，但要注意：部分Web专属的NuGet包（仅针对ASP.NET Core Web的）会引入MAUI不兼容的运行时依赖。你可以给这类依赖加上**<PrivateAssets>all</PrivateAssets>**，阻止依赖传递到MAUI项目，避免触发编译错误。

2. 有，通过调整项目依赖配置解决
   打开RCLShared的.csproj文件，对导致MAUI编译失败的NuGet包添加PrivateAssets配置，示例代码：

<PackageReference Include="Microsoft.AspNetCore.Mvc" Version="8.0.0">
  <PrivateAssets>all</PrivateAssets>
</PackageReference>

另外，确保RCL的项目文件设置了正确的多目标框架，适配MAUI的平台需求：

<TargetFrameworks>net8.0;net8.0-android;net8.0-ios;net8.0-maccatalyst</TargetFrameworks>
<TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net8.0-windows10.0.19041.0</TargetFrameworks>

这样RCL能适配多平台，MAUI引用时就不会出现RuntimeIdentifier缺失的问题。

3. 没必要独立，复用才是RCL的核心价值
   MAUI Blazor的设计初衷就是复用Web Blazor的组件、服务和样式，放弃复用完全违背了技术目标。只要解决依赖传递的问题，就能实现跨Web和MAUI的复用。

4. 可以采用包方案，但需先解决依赖问题
   如果先调整好RCL的依赖配置（比如设置PrivateAssets、多目标框架），打包后MAUI项目引用这个NuGet包不会触发编译错误。打包时要确保RCL的wwwroot资源被正确嵌入，这样MAUI项目就能通过_content/RCLShared/路径访问资源。

5. 其他解决方案建议

• 条件编译区分平台：在RCL中用#if指令区分Web和MAUI平台，针对不同平台加载不同依赖或逻辑，示例：

#if NET8_0
// Web专属逻辑代码
#elif NET8_0_ANDROID || NET8_0_IOS
// MAUI专属逻辑代码
#endif

• 拆分RCL：如果存在Web专属的组件或服务，可将其拆分到单独的Web RCL中，MAUI仅引用通用的RCL部分，避免引入不必要的依赖。
• 检查RuntimeIdentifier配置：在MAUI项目的.csproj中确保RuntimeIdentifier配置正确，比如Windows设置win10-x64、Android设置android-34等，避免因RID不匹配导致运行时包缺失。

内容的提问来源于stack exchange，提问作者Taariq