Uno平台多目标框架发布问题的解决方案

问题背景

在使用Uno平台开发跨平台应用时，开发人员可能会遇到一个特定的发布问题：当项目文件(.csproj)中同时指定了多个目标框架(如net9.0-desktop和net9.0-maccatalyst)时，尝试发布自包含(self-contained)的Linux-x64部署会出现错误。

错误现象

具体错误信息表现为系统无法找到特定版本的运行时包：

Unable to find package Microsoft.NETCore.App.Runtime.Mono.linux-x64 with version (= 9.0.1)

问题分析

经过深入分析，这个问题主要出现在以下两种场景中：

1. 当项目同时针对桌面和Mac Catalyst平台时
2. 当尝试发布自包含部署时

值得注意的是，如果采用框架依赖(Framework dependent)的部署模式，或者仅保留单一目标框架，则不会出现此问题。

解决方案

基础解决方案

对于基本的发布问题，可以通过在命令行中添加特定参数来解决：

dotnet publish --self-contained true /p:PublishSingleFile=true -f net9.0-desktop -p:TargetFrameworks=net9.0-desktop -r linux-x64

这个命令明确指定了目标框架，避免了多框架配置带来的冲突。

macOS平台的特殊处理

对于macOS平台的发布，Uno平台5.6版本后提供了两种支持方式：

1. 使用netXX-desktop：这种方式仅依赖dotnet和Uno平台，不需要额外的MS SDK/工作负载
2. 使用netX.X-maccatalyst：这种方式需要MS Mac Catalyst SDK/工作负载

对于Mac Catalyst发布，推荐使用以下命令：

dotnet publish -f net9.0-maccatalyst -c Release -p:CreatePackage=false -o ./publish

需要注意的是，Debug和Release配置在构建行为上有重要区别：

• Release配置会生成包含x64和arm64架构的"fat app"包
• Debug配置默认只生成当前机器架构的"thin app"包

平台特定依赖处理

对于需要根据不同平台使用不同依赖的情况，可以采用MSBuild的条件判断来实现更优雅的解决方案，替代传统的配置参数方式：

<ItemGroup>
    <Reference Condition="$([MSBuild]::IsOSPlatform('windows'))" Include="BoincSpy.Util">
        <HintPath>..\BoincSpy.Assemblies\Windows\BoincSpy.Util.dll</HintPath>
    </Reference>
</ItemGroup>
<ItemGroup>
    <Reference Condition="!$([MSBuild]::IsOSPlatform('windows'))" Include="BoincSpy.Util">
        <HintPath>..\BoincSpy.Assemblies\Unix\BoincSpy.Util.dll</HintPath>
    </Reference>
</ItemGroup>

这种方式能够自动识别当前构建平台，选择正确的依赖项，避免了手动指定配置参数的麻烦。

最佳实践建议

1. 命令行发布：推荐使用命令行工具进行发布，可以获得更精确的控制
2. 架构考虑：针对macOS发布时，理解x64和arm64架构的区别以及Rosetta转换的影响
3. 配置选择：Debug配置适合开发调试，Release配置适合最终发布
4. 依赖管理：使用平台检测而非配置参数来管理平台特定依赖

通过遵循这些实践，开发人员可以更顺利地完成Uno平台应用的跨平台发布工作。