MAUI iOS分发归档时创建IPA失败：CreateAssetPack缺少source参数

核心排查逻辑 #

发布阶段正常但归档分发（Ad Hoc/App Store）报错，本质是IPA打包时Asset Pack构建任务找不到指定的资源路径，重点锁定.csproj中的Asset Pack配置节点。

1. 检查.csproj中的CreateAssetPack任务配置 #

直接打开你的.csproj文件，搜索所有<CreateAssetPack>节点：

• 确保每个任务都明确指定了Source属性，示例正确配置：

<Target Name="CreateAssetPack">
  <CreateAssetPack
    Source="$(ProjectDir)Assets/MyAssetPack"
    Destination="$(OutputPath)AssetPacks"
    AssetPackId="com.yourcompany.app.assetpack"
  />
</Target>

如果发现某个CreateAssetPack节点缺少Source参数，立即补充正确的资源文件夹路径（建议用$(ProjectDir)这类稳定的项目路径变量，避免硬编码绝对路径）。

• 同时检查<ItemGroup>中的Asset Pack声明，确保Include路径指向真实存在的资源目录：

<ItemGroup>
  <AssetPack Include="Assets/MyAssetPack">
    <Id>com.yourcompany.app.assetpack</Id>
    <DisplayName>Main Asset Pack</DisplayName>
  </AssetPack>
</ItemGroup>

2. 验证资源路径的有效性 #

• 手动确认Source指定的路径下存在完整的Asset Pack结构：必须包含Info.plist（符合Apple Asset Pack配置规范），以及对应的资源文件（图片、音频等）。
• 避免使用不确定的环境变量作为路径，优先用项目相对路径或$(SolutionDir)/$(ProjectDir)这类MSBuild内置变量。

3. 开启详细日志定位具体错误 #

在Visual Studio中开启详细构建日志：

1. 打开「工具」->「选项」->「项目和解决方案」->「构建并运行」
2. 将「MSBuild项目构建输出详细程度」设为「详细」
3. 重新执行归档操作，在输出日志中搜索CreateAssetPack，找到具体是哪个任务触发的缺失参数错误，直接定位对应的配置节点。

4. 清理归档缓存重试 #

缓存损坏可能导致路径解析异常：

• Windows：删除%LOCALAPPDATA%\Xamarin\Cache下的对应项目缓存
• macOS：删除~/Library/Caches/Xamarin/mtbs/builds/[你的App名称]目录
• 清理后重新生成归档，再尝试分发。

5. 检查Asset Pack依赖兼容性 #

如果是Xamarin/.NET MAUI项目，确认已安装对应版本的Asset Delivery相关NuGet包，且包版本与Visual Studio版本兼容，避免因依赖缺失导致的配置解析错误。

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