.NET MAUI Blazor App在本地iOS设备启动时崩溃求助

问题概述 #

开发的.NET MAUI Blazor应用在iOS模拟器、Android模拟器及Windows设备上均可正常运行，但连接本地iOS真机启动时直接崩溃。排查后发现是项目引用的类库仅在iOS真机环境下与MAUI应用不兼容，报错信息指向ZstdNet.CompressionOptions类型。尝试将类库迁移至.NET MAUI类库后，其他依赖该类库的项目无法正常工作。

复现步骤 #

• 创建.NET MAUI Blazor App项目
• 创建常规类库项目（非MAUI类库类型）
• 在MAUI应用中添加该类库的项目引用
• 连接iPhone真机至电脑，运行应用

解决方案尝试 #

1. 适配ZstdNet的iOS AOT编译配置 #

iOS真机默认启用AOT编译，ZstdNet可能因未适配AOT导致类型解析失败。在MAUI项目的.csproj中添加iOS平台专属配置，跳过ZstdNet的链接和AOT编译：

<PropertyGroup Condition="'$(TargetFramework)' == 'net8.0-ios'">
  <MtouchExtraArgs>--linkskip=ZstdNet</MtouchExtraArgs>
  <AotAdditionalArguments>--skip-assembly=ZstdNet.dll</AotAdditionalArguments>
</PropertyGroup>

2. 调整类库的目标框架配置 #

确保引用的类库目标框架与MAUI应用一致（比如.NET 8），并添加iOS平台支持。修改类库的.csproj：

<PropertyGroup>
  <TargetFramework>net8.0</TargetFramework>
  <SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'ios'">15.0</SupportedOSPlatformVersion>
</PropertyGroup>

3. 多目标MAUI类库兼容其他项目 #

如果必须使用.NET MAUI类库，可通过多目标框架配置让类库同时支持标准.NET和MAUI平台，避免其他项目无法引用：

<PropertyGroup>
  <TargetFrameworks>net8.0;net8.0-android;net8.0-ios</TargetFrameworks>
  <UseMaui>true</UseMaui>
</PropertyGroup>

其他依赖项目中通过条件编译适配引用：

#if NET8_0
using YourMauiLibraryNamespace;
#endif

4. 验证iOS真机签名与权限 #

确认iOS真机的开发者签名配置正确，同时检查MAUI项目的Entitlements.plist是否包含必要权限（若ZstdNet涉及网络或文件操作）：

<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>

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