自定义LogicalName的MauiAsset在Mac上构建失败问题

错误原因 #

在Visual Studio for Mac构建iOS项目时，类Unix系统会将配置中的反斜杠路径解析为根目录路径。当%(RecursiveDir)为空（比如文件直接放在Resources/Animations目录下无二级子目录），原配置的\Animations会被解析为/Animations，而iOS应用沙盒的根目录是只读的，无法创建该目录，因此抛出Read-only file system错误。Windows系统的路径解析逻辑不会触发此问题。

方案1：跨平台兼容的统一配置 #

修改LogicalName的路径写法，使用MSBuild内置的$(DirectorySeparatorChar)自动适配平台路径分隔符，同时确保路径为项目相对路径，避免指向根目录：

<ItemGroup>
    <MauiAsset Include="Resources\Animations\*" 
               LogicalName="%(RecursiveDir)Animations$(DirectorySeparatorChar)%(Filename)%(Extension)" />
</ItemGroup>

如果你的动画文件直接放在Resources/Animations下无嵌套子目录，也可以直接指定明确的相对路径：

<ItemGroup>
    <MauiAsset Include="Resources\Animations\*" 
               LogicalName="Resources/Animations/%(Filename)%(Extension)" />
</ItemGroup>

方案2：区分Android和iOS的平台专属配置 #

通过MSBuild的条件判断，为Android保留原有配置，为iOS调整LogicalName路径：

<!-- Android 保留原有路径配置 -->
<ItemGroup Condition="$(TargetFramework.Contains('-android'))">
    <MauiAsset Include="Resources\Animations\*" 
               LogicalName="%(RecursiveDir)\Animations\%(Filename)%(Extension)" />
</ItemGroup>

<!-- iOS 使用相对路径避免根目录写入 -->
<ItemGroup Condition="$(TargetFramework.Contains('-ios'))">
    <MauiAsset Include="Resources\Animations\*" 
               LogicalName="Resources/Animations/%(Filename)%(Extension)" />
</ItemGroup>

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