JSConstraintsDebug

JSConstraintsDebug (JSConstraintsDebug.exe) adalah alat baris perintah yang menyediakan dukungan debugging untuk Batasan JavaScript saat mengembangkan driver printer V4.

Di mana saya dapat mengunduh JSConstraintsDebug?

JSConstraintsDebug.exe disertakan dalam Microsoft Windows Driver Kit (WDK). Untuk informasi cara mendapatkan Windows Driver Kit, lihat Unduhan Windows Driver Kit.

Alat ini menjalankan masing-masing API titik masuk yang relevan berikut pada batasan JavaScript driver yang ditargetkan terhadap tiket cetak yang disediakan pengguna:

PTGetPrintCapabilities

PTConvertDevModeToPrintTicket

TConvertPrintTicketToDevMode

GabungkanDanValidasiTiketCetak

Selama eksekusi, alat akan meminta debugger IDE yang sesuai seperti Visual Studio. Setelah dipilih, kode sumber batasan akan dibuka dan dihentikan pada pernyataan debugger JavaScript.

Untuk men-debug file batasan JS, ikuti langkah-langkah berikut:

  1. Buka jendela Command Prompt.

  2. Jalankan alat JSConstraintsDebug.exe dan tentukan, setidaknya, nama printer dan jalur menuju tiket cetak uji.

  3. Pilih alat debugging yang ingin Anda gunakan.

Menjalankan JSConstraintsDebug dalam mode pengguna

Hak istimewa yang ditingkatkan diperlukan untuk mengaktifkan debugging fungsi JS. Untuk berjalan dalam mode pengguna, kunci registri berikut harus diatur sebelum menjalankan JSConstraintsDebug.exe:

Nama kunci

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print

Nama Parameter

MengaktifkanJavaScriptDebugging

Tipe

DWORD

Nilai

1

Pernyataan debugger JavaScript

Titik henti dapat dibuat di sumber JavaScript dengan menggunakan pernyataan debugger. Ini akan menjeda operasi di Visual Studio untuk memungkinkan penelusuran kesalahan langkah demi langkah. Pernyataan ini dapat disisipkan di salah satu API Batasan JavaScript.

Contohnya:

function validatePrintTicket(PrintTicket, scriptContext)
{
    debugger; // debug tool will pause at this breakpoint
    ...
}

Sintaks Perintah JSConstraintsDebug

JSConstraintsDebug <PrinterName> <PrintTicket> [MergePrintTicket] [Constraints]

Parameter perintah

Parameter-parameternya Deskripsi

PrinterName

Dibutuhkan. Menentukan nama string driver cetak yang berisi file sumber batasan JS. Driver ini akan digunakan untuk semua operasi penelusuran kesalahan.

PrintTicket

Dibutuhkan. Menentukan jalur dan nama file XML tiket cetak yang akan divalidasi.

MergePrintTicket

Fakultatif. Menentukan jalur dan nama file XML tiket cetak yang akan digunakan untuk memvalidasi operasi penggabungan.

Jika parameter ini tidak diatur, DevMode default akan dikonversi ke Tiket Cetak dan akan diteruskan ke API Gabungkan dan Validasi.

Kendala

Fakultatif. Menentukan jalur dan nama file JavaScript pembatas yang akan menggantikan file sumber pembatas yang ada dalam driver printer target sebelum proses debugging.

Nota Menentukan file batasan dengan parameter Batasan akan menimpa kode sumber yang sudah ada pada driver yang dituju.

Contoh

Debug driver cetak dengan tiket uji cetak yang sudah diketahui.

JSConstraintsDebug “Contoso Printer” PrintTicket.xml

Melakukan debug driver pencetak dengan file sumber batasan baru terhadap tiket pengujian cetak yang diketahui.

JSConstraintsDebug “Contoso Printer” PrintTicket.xml Constraints.js

Uji operasi penggabungan dan validasi antara dua tiket cetak kustom.

JSConstraintsDebug “Contoso Printer” PrintTicket.xml PrintTicket2.xml