JavaScript Proje Sistemi için MSBuild başvurusu
Bu makalede, .esproj biçimini kullanan JavaScript Proje Sistemi(JSPS) temelinde projeleri yapılandırmak için kullanabileceğiniz MSBuild özellikleri ve öğeleri için başvuru bilgileri sağlanır.
Dekont
Bu makalede açıklanan özellikler, MSBuild'in varsayılan olarak sağladığı özellikleri genişletir. Yaygın MSBuild özelliklerinin listesi için bkz . Ortak MSBuild özellikleri.
ShouldRun özellikleri
Aşağıdaki MSBuild özellikleri bu bölümde belgelenmiştir:
ShouldRunNpmInstall
özelliği, ShouldRunNpmInstall
Derleme ve Geri Yükleme komutlarında çalıştırılıp çalıştırılmayacağını npm install
belirtir. Özelliğin varsayılan değeri ayarlanmamışsa değeridir true
.
<PropertyGroup>
<ShouldRunNpmInstall>false</ShouldRunNpmInstall>
</PropertyGroup>
Çalıştırılmaması npm install
istenen iki yaygın senaryo şunlardır:
- Npm olmayan bir paket yöneticisi (yarn veya pnpm gibi) kullanıldığında. Bu senaryoda en iyi çözüm, yüklemeyi el ile çalıştırmak için önce
BeforeRestore
çalışan bir hedef oluşturmaktır. - Çözümde tek tek yüklemelerin çalıştırılmasını gereksiz hale getiren genel bir paket yükleme mekanizması mevcut olduğunda.
ShouldRunBuildScript
özelliği, ShouldRunBuildScript
Derleme komutlarında çalıştırılıp çalıştırılmayacağını npm run build
belirtir. Özelliğin varsayılan değeri ayarlanmamışsa değeridir true
.
<PropertyGroup>
<ShouldRunNpmBuildScript>false</ShouldRunNpmBuildScript>
</PropertyGroup>
Yalnızca JavaScript içeren ve oluşturulmasını gerektirmeyen projeler için bu özelliği olarak false
ayarlayın. Yeni oluşturulan React, Vue ve Angular projeleri genellikle bu kategoriye girer. Bu senaryoda derleme, hata ayıklama için değil üretim için kullanılır. ve Publish
komutlarının Build
JSPS projelerinde ayrı olduğunu ve Publish
bu özellik ayarlanmış olsa bile çalışmaya devam ettiğini unutmayın.
Komut Özellikleri
Komut özellikleri, ortak package.json betiklerini MSBuild hedefleriyle eşlemeye yönelik özelliklerdir. Varsayılan değerler, bu bölümde açıklandığı gibi bu özelliklerin tümü için desteklenir.
npm dışındaki paket yöneticilerini veya gibi gulp
betik altyapılarını kullanırken bu özellikleri ayarlayın.
Bu bölümde aşağıdaki MSBuild özellikleri açıklanmıştır:
BuildCommand
BuildCommand
özelliği, hedef için build
davranışı belirtir. İlişkili package.json bir build
veya compile
betiği içeriyorsa, varsayılan BuildCommand
değer zaten bunları çalıştıracak şekilde ayarlanmıştır.
komutunu değiştirmek için kullanırken npm
ekleyinnpm run
.
<PropertyGroup>
<BuildCommand>npm run build</BuildCommand>
</PropertyGroup>
StartupCommand
StartupCommand
özelliği, hedef için dotnet run
davranışı belirtir. İlişkili package.json
bir start
, server
veya dev
betiği içeriyorsa, varsayılan StartupCommand
değer zaten bu betikleri çalıştıracak şekilde ayarlanmıştır.
komutunu değiştirirseniz, kullanırken npm
ekleyinnpm run
.
<PropertyGroup>
<StartupCommand>npm run serve</StartupCommand>
</PropertyGroup>
Test Komutu
TestCommand
özelliği, hedef için test
davranışı belirtir. İlişkili package.json
bir test
betik içeriyorsa, varsayılan TestCommand
değer zaten bu betiği çalıştıracak şekilde ayarlanmıştır.
komutunu değiştirirseniz, kullanırken npm
ekleyinnpm run
.
<PropertyGroup>
<TestCommand>ng test</TestCommand>
</PropertyGroup>
CleanCommand
CleanCommand
özelliği, hedef için clean
davranışı belirtir. İlişkili package.json
bir clean
betik içeriyorsa, varsayılan CleanCommand
değer zaten bu betiği çalıştıracak şekilde ayarlanmıştır.
komutunu değiştirirseniz, kullanırken npm
ekleyinnpm run
.
<PropertyGroup>
<CleanCommand>npm run clean</CleanCommand>
</PropertyGroup>
PublishCommand
PublishCommand
özelliği, hedef için publish
davranışı belirtir. İlişkili package.json
bir publish
betik içeriyorsa, varsayılan PublishCommand
değer zaten bu betiği çalıştıracak şekilde ayarlanmıştır. npm'de, aynı zamanda çalışacak olan ön ve son yayımlama betiklerinin olması yaygın bir durumdur.
komutunu değiştirirseniz, kullanırken npm
ekleyinnpm run
.
<PropertyGroup>
<PublishCommand>npm run publish</PublishCommand>
</PropertyGroup>