Referensi MSBuild untuk Sistem Proyek JavaScript
Artikel ini menyediakan informasi referensi untuk properti dan item MSBuild yang dapat Anda gunakan untuk mengonfigurasi proyek berdasarkan JavaScript Project System (JSPS), yang menggunakan format .esproj .
Catatan
Properti yang dijelaskan dalam artikel ini memperluas properti yang disediakan MSBuild secara default. Untuk daftar properti MSBuild umum, lihat Properti MSBuild Umum.
Properti ShouldRun
Properti MSBuild berikut ini didokumentasikan di bagian ini:
ShouldRunNpmInstall
Properti ShouldRunNpmInstall menentukan apakah akan berjalan atau tidak dijalankan npm install pada perintah Build dan Restore. Nilai default untuk properti adalah true jika tidak diatur.
<PropertyGroup>
<ShouldRunNpmInstall>false</ShouldRunNpmInstall>
</PropertyGroup>
Dua skenario umum di mana tidak berjalan npm install diinginkan adalah:
- Ketika manajer paket non-npm (seperti yarn atau pnpm) digunakan. Dalam skenario ini, solusi terbaik adalah membuat target yang berjalan sebelum
BeforeRestoremenjalankan penginstalan secara manual. - Ketika mekanisme penginstalan paket global ada dalam solusi yang membuat penginstalan individual berjalan tidak perlu.
ShouldRunBuildScript
Properti ShouldRunBuildScript menentukan apakah akan berjalan npm run build pada perintah Build atau tidak. Nilai default untuk properti adalah true jika tidak diatur.
<PropertyGroup>
<ShouldRunNpmBuildScript>false</ShouldRunNpmBuildScript>
</PropertyGroup>
Untuk proyek yang hanya berisi JavaScript yang tidak memerlukan pembangunan, atur properti ini ke false. Proyek React, Vue, dan Angular yang baru dibuat biasanya termasuk dalam kategori ini. Dalam skenario ini, build digunakan untuk produksi dan bukan untuk penelusuran kesalahan. Perhatikan bahwa Build perintah dan Publish terpisah dalam proyek JSPS, dan Publish masih berjalan meskipun properti ini diatur.
Properti Perintah
Properti perintah adalah properti yang dimaksudkan untuk memetakan skrip package.json umum ke target MSBuild. Nilai default didukung untuk semua properti ini, seperti yang dijelaskan di bagian ini.
Atur properti ini saat menggunakan manajer paket selain npm, atau mesin pembuatan skrip seperti gulp.
Properti MSBuild berikut ini dijelaskan di bagian ini:
BuildCommand
Properti BuildCommand menentukan perilaku untuk build target. Jika package.json terkait berisi build compile atau skrip, nilai default BuildCommand sudah diatur untuk menjalankannya.
Untuk mengubah perintah, sertakan npm run saat menggunakan npm.
<PropertyGroup>
<BuildCommand>npm run build</BuildCommand>
</PropertyGroup>
StartupCommand
Properti StartupCommand menentukan perilaku untuk dotnet run target. Jika yang terkait package.json berisi start, , serveratau dev skrip, nilai default StartupCommand sudah diatur untuk menjalankan skrip ini.
Jika Anda mengubah perintah, sertakan npm run saat menggunakan npm.
<PropertyGroup>
<StartupCommand>npm run serve</StartupCommand>
</PropertyGroup>
TestCommand
Properti TestCommand menentukan perilaku untuk test target. Jika yang terkait package.json berisi test skrip, nilai default TestCommand sudah diatur untuk menjalankan skrip ini.
Jika Anda mengubah perintah, sertakan npm run saat menggunakan npm.
<PropertyGroup>
<TestCommand>ng test</TestCommand>
</PropertyGroup>
CleanCommand
Properti CleanCommand menentukan perilaku untuk clean target. Jika yang terkait package.json berisi clean skrip, nilai default CleanCommand sudah diatur untuk menjalankan skrip ini.
Jika Anda mengubah perintah, sertakan npm run saat menggunakan npm.
<PropertyGroup>
<CleanCommand>npm run clean</CleanCommand>
</PropertyGroup>
PublishCommand
Properti PublishCommand menentukan perilaku untuk publish target. Jika yang terkait package.json berisi publish skrip, nilai default PublishCommand sudah diatur untuk menjalankan skrip ini. Dalam npm, adalah umum untuk memiliki skrip pra-dan pasca-penerbitan, yang juga akan berjalan.
Jika Anda mengubah perintah, sertakan npm run saat menggunakan npm.
<PropertyGroup>
<PublishCommand>npm run publish</PublishCommand>
</PropertyGroup>