Referencia de MSBuild para el sistema de proyectos de JavaScript

En este artículo se proporciona información de referencia para las propiedades y elementos de MSBuild que puede usar para configurar proyectos basados en javaScript Project System (JSPS), que usan el formato .esproj.

Nota

Las propiedades descritas en este artículo amplían las propiedades que PROPORCIONA MSBuild de forma predeterminada. Para obtener una lista de las propiedades comunes de MSBuild, consulte propiedades comunes de MSBuild.

Propiedades ShouldRun

Las siguientes propiedades de MSBuild se documentan en esta sección:

• ShouldRunNpmInstall
• shouldRunBuildScript

ShouldRunNpmInstall

La propiedad ShouldRunNpmInstall especifica si se ejecutarán o no npm install en los comandos Compilar y restaurar. El valor predeterminado de la propiedad es true si no se establece.

<PropertyGroup>
  <ShouldRunNpmInstall>false</ShouldRunNpmInstall>
</PropertyGroup>

Dos escenarios comunes en los que no se ejecuta npm install es deseable:

1. Cuando se usa un administrador de paquetes que no sea npm (como yarn o pnpm). En este escenario, la mejor solución es crear un destino que se ejecute antes de BeforeRestore para ejecutar manualmente la instalación.
2. Cuando existe un mecanismo de instalación global de paquetes en la solución que hace que la ejecución de instalaciones individuales no sea necesaria.

ShouldRunBuildScript

La propiedad ShouldRunBuildScript especifica si se va a ejecutar npm run build en comandos build. El valor predeterminado de la propiedad es true si no se establece.

<PropertyGroup>
  <ShouldRunBuildScript>false</ShouldRunBuildScript>
</PropertyGroup>

Para los proyectos que solo contienen JavaScript que no requieren compilación, establezca esta propiedad en false. Los proyectos de React, Vue y Angular recién creados suelen estar en esta categoría. En este escenario, la compilación se usa para producción y no para la depuración. Tenga en cuenta que los comandos Build y Publish son independientes en los proyectos de JSPS y Publish todavía se ejecuta incluso si se establece esta propiedad.

Propiedades del comando

Las propiedades de comando son propiedades diseñadas para asignar scripts de package.json comunes a destinos de MSBuild. Los valores predeterminados se admiten para todas estas propiedades, como se describe en esta sección.

Establezca estas propiedades al usar administradores de paquetes distintos de npm o motores de scripting, como gulp.

En esta sección se describen las siguientes propiedades de MSBuild:

• BuildCommand
• startupCommand
• testCommand
• CleanCommand
• PublishCommand

BuildCommand

La propiedad BuildCommand especifica el comportamiento del destino de build. Si el package.json asociado contiene un script de build o compile, el valor de BuildCommand predeterminado ya está establecido para ejecutarlos.

Para modificar el comando, incluya npm run al usar npm.

<PropertyGroup>
  <BuildCommand>npm run build</BuildCommand>
</PropertyGroup>

StartupCommand

La propiedad StartupCommand especifica el comportamiento del destino de dotnet run. Si el package.json asociado contiene un script de start, servero dev, el valor de StartupCommand predeterminado ya está establecido para ejecutar estos scripts.

Si modifica el comando, incluya npm run al usar npm.

<PropertyGroup>
  <StartupCommand>npm run serve</StartupCommand>
</PropertyGroup>

TestCommand

La propiedad TestCommand especifica el comportamiento del destino de test. Si el package.json asociado contiene un script de test, el valor de TestCommand predeterminado ya está establecido para ejecutar este script.

Si modifica el comando, incluya npm run al usar npm.

<PropertyGroup>
  <TestCommand>ng test</TestCommand>
</PropertyGroup>

CleanCommand

La propiedad CleanCommand especifica el comportamiento del destino de clean. Si el package.json asociado contiene un script de clean, el valor de CleanCommand predeterminado ya está establecido para ejecutar este script.

Si modifica el comando, incluya npm run al usar npm.

<PropertyGroup>
  <CleanCommand>npm run clean</CleanCommand>
</PropertyGroup>

PublishCommand

La propiedad PublishCommand especifica el comportamiento del destino de publish. Si el package.json asociado contiene un script de publish, el valor de PublishCommand predeterminado ya está establecido para ejecutar este script. En npm, es habitual tener scripts previos y posteriores a la publicación, que también se ejecutarán.

Si modifica el comando, incluya npm run al usar npm.

<PropertyGroup>
  <PublishCommand>npm run publish</PublishCommand>
</PropertyGroup>

Consulte también

• referencia de esquema de MSBuild
• propiedades comunes de MSBuild
• propiedades de MSBuild para el paquete NuGet
• propiedades de MSBuild para de restauración de NuGet
• Personalizar un de compilación