iOS平台MAUI应用Debug正常但Release下本地网络权限失效

问题描述 #

开发的.NET MAUI移动应用通过本地网络与桌面端通信，Debug模式下首次执行网络操作会正常弹出本地网络权限请求，且权限显示在应用原生设置中，但部署到iOS真机的Release版本时，权限既不弹出请求，也未在设置里显示。已在Info.plist中添加NSLocalNetworkUsageDescription权限描述。

解决方案 #

1. 调整Release模式的MtouchLink设置 #

Debug模式下你设置了<MtouchLink>SdkOnly</MtouchLink>，但Release模式默认可能使用Full链接模式，这会导致与本地网络权限相关的代码被编译器裁剪。需要在Release的iOS配置中添加相同的MtouchLink设置：

<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Release|net8.0-ios|AnyCPU'">
  <CreatePackage>false</CreatePackage>
  <MtouchLink>SdkOnly</MtouchLink>
</PropertyGroup>

2. 添加Bonjour服务声明 #

iOS要求应用明确声明使用的Bonjour服务类型，否则Release版本不会显示本地网络权限。在Info.plist的<dict>节点内添加NSBonjourServices数组，根据你实际使用的服务类型填写，比如如果使用自定义TCP服务，添加：

<key>NSBonjourServices</key>
<array>
  <string>_your-custom-service._tcp.</string>
</array>

如果使用Zeroconf库进行服务发现，需添加对应服务的标识，比如常见的_http._tcp.。

3. 主动触发权限请求 #

Release模式下的代码优化可能导致第三方库的权限触发逻辑失效，需要在首次执行网络操作前，主动调用系统API请求本地网络权限。可以在iOS平台项目中添加自定义方法：

using Foundation;
using Network;

public static void TriggerLocalNetworkPermission()
{
    var monitor = new NWPathMonitor();
    var queue = DispatchQueue.GlobalQueue(DispatchQueuePriority.Default);
    monitor.Start(queue);
    monitor.Cancel();
}

在应用启动后或首次网络操作前调用此方法，触发系统的权限请求弹窗。

4. 验证Release包中的Info.plist #

打包完成后，解压IPA文件，检查Payload/YourApp.app/Info.plist是否包含NSLocalNetworkUsageDescription和NSBonjourServices条目，确认这些配置被正确嵌入到Release包中。

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