Share via

Membangun Halaman Peristiwa, Perancang Proyek (C#)

  • Artikel

Gunakan halaman Peristiwa Build dari Perancang Proyek untuk menentukan instruksi konfigurasi build. Anda juga dapat menentukan kondisi di mana setiap peristiwa pasca-build dijalankan. Untuk informasi selengkapnya, lihat Cara: Menentukan Peristiwa Build (C#) dan Cara: Menentukan Peristiwa Build (Visual Basic).

Daftar UIElement

Konfigurasi

Kontrol ini tidak dapat diedit di halaman ini. Untuk deskripsi kontrol ini, lihat Halaman Build, Perancang Proyek (C#).

Platform

Kontrol ini tidak dapat diedit pada halaman ini. Untuk deskripsi kontrol ini, lihat Halaman Build, Perancang Proyek (C#).

Baris perintah peristiwa pra-build

Menentukan perintah apa pun yang akan dijalankan sebelum build dimulai. Untuk mengetik perintah panjang, klik Edit Pra-build untuk menampilkan Kotak Dialog Baris Perintah Peristiwa Pra-build/Pasca-build.

Catatan

Peristiwa pra-build tidak berjalan jika proyek sudah diperbarui dan tidak ada build yang dipicu.

Baris perintah peristiwa pasca-build

Menentukan perintah apa pun yang akan dijalankan setelah build berakhir. Untuk mengetik perintah panjang, klik Edit Pasca-build untuk menampilkan Kotak Dialog Baris Perintah Peristiwa Pra-build/Pasca-build.

Catatan

call Tambahkan pernyataan sebelum semua perintah pasca-build yang menjalankan file .bat. Misalnya, call C:\MyFile.bat atau call C:\MyFile.bat call C:\MyFile2.bat.

Jalankan peristiwa pasca-build

Menentukan kondisi berikut agar peristiwa pasca-build berjalan, seperti yang diperlihatkan dalam tabel berikut.

Opsi Hasil
Selalu Peristiwa pasca-build akan berjalan terlepas dari apakah build berhasil.
Pada build yang berhasil Peristiwa pasca-build akan berjalan jika build berhasil. Dengan demikian, acara akan berjalan bahkan untuk proyek yang diperbarui, selama build berhasil.
Saat build memperbarui output proyek Peristiwa pasca-build hanya akan berjalan ketika file output kompilator (.exe atau .dll) berbeda dari file output kompilator sebelumnya. Dengan demikian, peristiwa pasca-build tidak dijalankan jika proyek sudah diperbarui.

Dalam file proyek

Di versi Visual Studio sebelumnya, saat Anda mengubah pengaturan PreBuildEvent atau PostBuildEvent di IDE, Visual Studio menambahkan PreBuildEvent properti atau PostBuildEvent ke file proyek. Jadi misalnya, jika pengaturan baris perintah PreBuildEvent Anda di IDE adalah sebagai berikut:

"$(ProjectDir)PreBuildEvent.bat" "$(ProjectDir)..\" "$(ProjectDir)" "$(TargetDir)"

kemudian pengaturan file proyek adalah:

<PropertyGroup>
    <PreBuildEvent>"$(ProjectDir)PreBuildEvent.bat" "$(ProjectDir)..\" "$(ProjectDir)" "$(TargetDir)" />
</PropertyGroup>

Untuk proyek .NET Core, Visual Studio 2019 (dan Visual Studio 2017 dalam pembaruan yang lebih baru) menambahkan target MSBuild bernama PreBuild atau PostBuild untuk pengaturan PreBuildEvent dan PostBuildEvent . Target ini menggunakan atribut BeforeTargets dan AfterTargets , yang dikenali MSBuild. Misalnya, untuk contoh sebelumnya, Visual Studio sekarang menghasilkan kode berikut:

<Target Name="PreBuild" BeforeTargets="PreBuildEvent">
    <Exec Command="&quot;$(ProjectDir)PreBuildEvent.bat&quot; &quot;$(ProjectDir)..\&quot; &quot;$(ProjectDir)&quot; &quot;$(TargetDir)&quot;" />
</Target>

Untuk peristiwa pasca-build, gunakan nama PostBuild dan atur atribut AfterTargets ke PostBuildEvent.

<Target Name="PostBuild" AfterTargets="PostBuildEvent">
   <Exec Command="echo Output written to $(TargetDir)" />
</Target>

Catatan

Perubahan file proyek ini dilakukan untuk mendukung proyek bergaya SDK. Jika Anda memigrasikan file proyek dari format lama ke format gaya SDK secara manual, Anda harus menghapus PreBuildEvent properti dan PostBuildEvent dan menggantinya dengan PreBuild target dan PostBuild seperti yang ditunjukkan dalam kode sebelumnya. Untuk mengetahui cara mengetahui apakah proyek Anda adalah proyek bergaya SDK, lihat Memeriksa format proyek.

Baca juga