MAUI环境下Mobile.BuildTools V2配置问题求助

一、补全MAUI项目.csproj配置 #

你得确保appsettings.json的构建操作设置正确，不然BuildTools找不到文件也没法处理：
在项目的.csproj里添加这段配置：

<ItemGroup>
  <None Remove="appsettings.json" />
  <EmbeddedResource Include="appsettings.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <BuildToolsTransform>True</BuildToolsTransform>
  </EmbeddedResource>
</ItemGroup>

这段配置的作用是告诉MSBuild把appsettings.json作为嵌入资源，同时指定让Mobile.BuildTools对它执行转换操作。

二、配置buildtools.json核心功能 #

你之前创建的buildtools.json，得确保AppSettings功能处于启用状态，还要指定MAUI适配的输出路径（MAUI中静态资源通常放在Resources/Raw目录方便读取），给你一个参考配置：

{
  "AppSettings": {
    "Enabled": true,
    "BaseDirectory": ".",
    "OutputDirectory": "Resources/Raw",
    "TransformFiles": [
      "appsettings.json",
      "appsettings.*.json" // 支持环境专属配置，比如测试环境用appsettings.Staging.json
    ],
    "VariablePrefix": "BUILDTOOLS_" // 对应CI/CD中的环境变量前缀，后续Azure DevOps会用到
  },
  "Secrets": {
    "Enabled": true, // 如果仍需使用旧版Secrets功能，保持开启即可
    "BaseDirectory": ".",
    "OutputFileName": "secrets.json"
  }
}

三、Azure DevOps流水线前置准备 #

• 流水线中需要配置对应的环境变量，比如如果appsettings.json里有ApiUrl占位符，就得在Azure DevOps的变量组或流水线变量中添加BUILDTOOLS_ApiUrl（和上面配置的VariablePrefix对应），BuildTools会自动替换这些占位符的值。
• 确保流水线的MSBuild任务先执行NuGet包恢复，并且指定正确的项目/解决方案路径，这样Mobile.BuildTools的构建目标才能正常运行。

四、常见排查点 #

• 确认安装的是Mobile.BuildTools.Maui包？V2版本有专门适配MAUI的包，别装成通用版的Mobile.BuildTools。
• buildtools.json要放在解决方案根目录，文件属性设为“不复制”即可，无需拷贝到输出目录。
• 本地测试时，手动执行dotnet build命令，查看输出日志中是否有Mobile.BuildTools的相关记录，以此判断转换操作是否正常执行。

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