MAUI iOS Release裁剪过于激进致地图失效，有无解决办法？

1. 确保Leaflet资源正确嵌入与引用 #

iOS Release的资源打包规则更严格，需保证Leaflet的CSS、JS文件被正确处理：

• 将wwwroot/lib/leaflet下的所有资源文件属性设为Embedded resource，并在项目.csproj中添加配置：

  <ItemGroup>
    <EmbeddedResource Include="wwwroot/lib/leaflet/**/*" />
  </ItemGroup>
  

• 组件内引用资源时使用绝对路径，避免相对路径在Release模式下失效：

  <link rel="stylesheet" href="/lib/leaflet/leaflet.css" />
  <script src="/lib/leaflet/leaflet.js"></script>
  

2. 针对Blazor程序集禁用IL裁剪 #

iOS不允许全局关闭裁剪，但可单独保护Blazor相关程序集，在.csproj中添加：

<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)'=='Release|net7.0-ios'">
  <BlazorWebAssemblyEnableLinking>false</BlazorWebAssemblyEnableLinking>
  <LinkerRootAssemblies>Microsoft.AspNetCore.Components.WebView.Maui, 你的应用程序集名称</LinkerRootAssemblies>
</PropertyGroup>

替换你的应用程序集名称为实际项目的程序集名，既保留全局裁剪优化，又避免Blazor核心逻辑被误裁剪。

3. 保护JS互操作相关代码 #

Leaflet Blazor包装器依赖JS互操作，Release裁剪可能移除未显式引用的方法：

• 方法一：在使用地图的组件中添加[DynamicDependency]特性标记需要保留的类型：

  using System.Runtime.CompilerServices;
  
  [DynamicDependency(DynamicallyAccessedMemberTypes.All, typeof(LeafletMap))]
  public partial class MapComponent
  {
      // 组件业务代码
  }
  

• 方法二：创建linker.xml链接器配置文件，指定保留Leaflet包装器程序集：

  <linker>
    <assembly fullname="LeafletBlazor">
      <type fullname="*" preserve="all" />
    </assembly>
  </linker>
  

  然后在.csproj中引用该文件：

  <ItemGroup Condition="'$(Configuration)|$(TargetFramework)'=='Release|net7.0-ios'">
    <LinkerDescriptor Include="linker.xml" />
  </ItemGroup>
  

4. 调整iOS WebView安全策略 #

若使用HTTP地图瓦片，需在Info.plist中添加允许加载的配置（上架建议改用HTTPS瓦片，如OpenStreetMap的https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png）：

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

5. 启用日志定位具体问题 #

在iOS Release模式下开启调试日志，通过Xcode控制台查看错误：

• 在Program.cs中添加日志配置：

  builder.Logging.AddDebug();
  

  运行后查看控制台输出，可快速定位是资源加载失败、JS报错还是Blazor组件初始化异常。

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