.NET MAUI iOS平台因App Center库构建失败及空白屏问题求助

问题分析 #

构建错误核心原因：链接器尝试将针对iOS真机的二进制文件链接到iOS模拟器构建中，这通常是NuGet包版本与.NET 8 MAUI不兼容，或架构配置冲突导致的。另外，Utility类中的递归调用会引发无限循环，大概率是启动空白屏的诱因。

解决方案 #

1. 升级AppCenter NuGet包至兼容版本 #

Microsoft.AppCenter.Analytics和Microsoft.AppCenter.Crashes的5.0.6版本对.NET 8 MAUI的支持存在兼容性问题，建议升级到最新稳定版（如5.0.10或更高）：

• 通过NuGet包管理器卸载旧版本，安装对应最新版
• 或使用.NET CLI执行：

dotnet add package Microsoft.AppCenter.Analytics --version <最新版本号>
dotnet add package Microsoft.AppCenter.Crashes --version <最新版本号>

2. 清理项目缓存与重建 #

1. 删除项目根目录下的bin和obj文件夹
2. 清理NuGet本地缓存：

dotnet nuget locals all --clear

3. 重新还原依赖并针对模拟器构建：

dotnet restore
dotnet build -f net8.0-ios -c Debug /p:RuntimeIdentifier=iossimulator-arm64

3. 调整iOS项目架构配置 #

在项目的.csproj文件中添加或修改以下配置，确保模拟器构建使用正确的架构：

<PropertyGroup Condition="'$(TargetFramework)' == 'net8.0-ios'">
  <RuntimeIdentifier>iossimulator-arm64</RuntimeIdentifier>
  <SupportedOSPlatformVersion>14.0</SupportedOSPlatformVersion>
</PropertyGroup>

4. 修复Utility类的递归死循环问题 #

当前SendCrashReport方法在内部抛出异常时会无限递归调用自身，导致应用启动崩溃或空白屏，修改为：

public static void SendCrashReport(Exception exception)
{
    try
    {
        if (Crashes.IsEnabled)
        {
            Crashes.TrackError(exception);
        }
    }
    catch (Exception ex)
    {
        // 避免递归，改为本地日志输出
        Console.WriteLine($"Crash tracking failed: {ex.Message}");
    }
}

5. 优化AppDelegate启动逻辑 #

移除不必要的try-catch（会掩盖真实启动错误），确保AppCenter.Start调用顺序正确：

public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions)
{
    AppCenter.Start("你的AppSecret", typeof(Analytics), typeof(Crashes));
    return base.FinishedLaunching(application, launchOptions);
}

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