.NET MAUI发布时TypeScript编译的JS文件丢失问题咨询

问题原因 #

1. MSBuild目标绑定差异：Microsoft.TypeScript.MSBuild默认将编译任务绑定到Build目标，而dotnet publish执行的是Publish目标集合，发布流程中未触发TypeScript编译，导致生成的JS文件未同步到发布临时目录。
2. 资源标记缺失：编译生成的wwwroot/js/scriptfiles.js未被标记为AndroidAsset，MAUI Android打包APK时只会将标记为该类型的文件纳入assets目录，发布时自然不会包含未标记的文件。
3. 发布流程清理机制冲突：发布阶段会先清理obj/Release下的临时目录，若TS编译任务在清理之后执行，生成的JS文件无法被后续打包步骤捕获。

为什么Release构建正常但发布失效？ #

dotnet build -c Release仅执行项目编译逻辑，TS编译任务会触发并生成JS文件到输出目录；而dotnet publish包含清理、编译、打包、签名等多阶段流程，若TS编译未绑定到发布阶段的关键目标，或者生成的文件未被正确标记为资源，就会出现构建正常但发布时文件丢失的情况。

解决方法 #

方法1：强制发布时触发TypeScript编译 #

在项目csproj文件中添加以下配置，将TS编译任务绑定到Publish目标之前：

<Target Name="TriggerTypeScriptOnPublish" BeforeTargets="Publish">
  <MSBuild Projects="$(MSBuildProjectFile)" Targets="CompileTypeScript" />
</Target>

方法2：标记JS文件为Android资源 #

在csproj中显式将wwwroot/js下的所有JS文件标记为AndroidAsset，确保打包时被纳入APK：

<ItemGroup>
  <AndroidAsset Include="wwwroot\js\**\*.js" />
</ItemGroup>

方法3：优化TS编译输出配置 #

确保tsconfig.json中的outDir正确指向wwwroot/js，并开启必要编译配置，同时保证输出目录的文件被项目识别：

{
  "compilerOptions": {
    "outDir": "./wwwroot/js",
    "target": "ES2020",
    "strict": true
  },
  "include": ["Scripts/**/*"]
}

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