Share via

Cara: Mengkompilasi Secara Kondisional dengan Pelacakan dan Debug

  • Artikel

Saat Anda men-debug aplikasi selama pengembangan, output penelusuran dan debugging Anda masuk ke jendela Output di Visual Studio. Namun, untuk menyertakan fitur pelacakan dalam aplikasi yang disebarkan, Anda harus mengkompilasi aplikasi berinstrumentasi Anda dengan petunjuk kompilator TRACE diaktifkan. Ini memungkinkan kode pelacakan dikompilasi ke dalam versi rilis aplikasi Anda. Jika Anda tidak mengaktifkan arahan TRACE, semua kode pelacakan diabaikan selama kompilasi dan tidak disertakan dalam kode yang dapat dieksekusi yang akan Anda sebarkan.

Metode pelacakan dan debug memiliki atribut bersyarat terkait. Misalnya, jika atribut bersyarat untuk pelacakan benar, semua pernyataan pelacakan disertakan dalam atribut (file .exe yang dikompilasi atau .dll); jika atribut bersyarat Tracefalse, pernyataan pelacakan tidak disertakan.

Anda dapat mengaktifkan atribut bersyarat Trace atau Debug untuk build, atau keduanya, atau tidak keduanya. Dengan demikian, ada empat jenis build: Debug, Trace, keduanya, atau tidak keduanya. Beberapa build rilis untuk penyebaran produksi mungkin tidak berisi; sebagian besar build debugging berisi keduanya.

Anda dapat menentukan pengaturan kompiler untuk aplikasi Anda dengan beberapa cara:

  • Halaman properti

  • Baris perintah

  • #CONST (untuk Visual Basic) dan #define (untuk C#)

Untuk mengubah pengaturan kompilasi dari kotak dialog halaman properti

  1. Klik kanan simpul proyek di Penjelajah Solusi.

  2. Pilih Properti dari menu pintasan.

    • Di Visual Basic, klik tab Kompilasi di panel kiri halaman properti, lalu klik tombol Opsi Kompilasi Tingkat Lanjut untuk menampilkan kotak dialog Pengaturan Kompiler Tingkat Lanjut. Pilih kotak centang untuk pengaturan kompiler yang ingin Anda aktifkan. Hapus kotak centang untuk pengaturan yang ingin Anda nonaktifkan.

    • Di C#, klik tab Build di panel kiri halaman properti, lalu pilih kotak centang untuk pengaturan kompiler yang ingin Anda aktifkan. Hapus kotak centang untuk pengaturan yang ingin Anda nonaktifkan.

Untuk mengkompilasi kode berinstrumentasi menggunakan baris perintah

  1. Atur sakelar kompiler bersyarat pada baris perintah. Kompiler akan menyertakan kode trace atau debug dalam executable.

    Misalnya, instruksi kompiler berikut yang dimasukkan pada baris perintah akan menyertakan kode pelacakan Anda dalam executable yang dikompilasi:

    Untuk Visual Basic: vbc -r:System.dll -d:TRACE=TRUE -d:DEBUG=FALSE MyApplication.vb

    Untuk C#: csc -r:System.dll -d:TRACE -d:DEBUG=FALSE MyApplication.cs

    Tip

    Untuk mengkompilasi lebih dari satu file aplikasi, biarkan ruang kosong di antara nama file, misalnya, MyApplication1.vb MyApplication2.vb MyApplication3.vb atau MyApplication1.cs MyApplication2.cs MyApplication3.cs.

    Arti dari arahan kompilasi berikut yang digunakan dalam contoh di atas adalah sebagai berikut:

    Direktif Makna
    vbc Kompiler Visual Basic
    csc C# compiler
    -r: Mereferensikan assembly eksternal (EXE atau DLL)
    -d: Menentukan simbol kompilasi bersyarat

    Catatan

    Anda harus mengeja TRACE atau DEBUG dengan huruf besar. Untuk informasi selengkapnya tentang perintah kompilasi bersyarat, masukkan vbc /? (untuk Visual Basic) atau csc /? (untuk C#) di prompt perintah. Untuk informasi selengkapnya, lihat Membangun dari Baris Perintah (C#) atau Memanggil Perintah-Kompiler Baris (Visual Basic).

Untuk melakukan kompilasi bersyarat menggunakan #CONST atau #define

  1. Ketik pernyataan yang sesuai untuk bahasa pemrograman Anda di bagian atas file kode sumber.

    Bahasa Pernyataan Hasil
    Visual Basic #CONST TRACE = true Mengaktifkan pelacakan
    #CONST TRACE = false Menonaktifkan pelacakan
    #CONST DEBUG = true Mengaktifkan debugging
    #CONST DEBUG = false Menonaktifkan debugging
    C# #define TRACE Mengaktifkan pelacakan
    #undef TRACE Menonaktifkan pelacakan
    #define DEBUG Mengaktifkan debugging
    #undef DEBUG Menonaktifkan debugging

Untuk menonaktifkan pelacakan atau debugging

Hapus pedoman kompiler dari kode sumber Anda.

- atau -

Komentari pedoman kompiler.

Catatan

Jika Anda siap untuk mengkompilasi, Anda dapat memilih Build dari menu Build, atau menggunakan metode baris perintah tetapi tanpa mengetik d: untuk menentukan simbol kompilasi bersyarkat.

Lihat juga