JsConstraintsDebug

JSConstraintsDebug (JSConstraintsDebug.exe) to narzędzie wiersza polecenia, które zapewnia obsługę debugowania ograniczeń języka JavaScript podczas opracowywania sterownika drukarki w wersji 4.

Gdzie można pobrać plik JSConstraintsDebug?

JSConstraintsDebug.exe jest dołączony do zestawu Microsoft Windows Driver Kit (WDK). Aby uzyskać informacje na temat pobierania zestawu WDK, zobacz Pobieranie zestawu sterowników systemu Windows.

Narzędzie wykonuje każdy z następujących odpowiednich interfejsów API punktu wejścia na ograniczenia JavaScript docelowego sterownika na podstawie dostarczonego przez użytkownika biletu drukowania.

PTGetPrintCapabilities

PTConvertDevModeToPrintTicket

TConvertPrintTicketToDevMode

PTMergeAndValidatePrintTicket

Podczas działania narzędzie wyświetli monit o odpowiedni debuger IDE, taki jak Visual Studio. Po wybraniu kodu źródłowego ograniczeń zostanie otwarty i zatrzymany w instrukcji debugera języka JavaScript.

Aby debugować pliki ograniczeń JS, wykonaj następujące kroki:

  1. Otwórz okno wiersza polecenia.

  2. Uruchom narzędzie JSConstraintsDebug.exe i określ co najmniej nazwę drukarki oraz ścieżkę do biletu drukowania testowego.

  3. Wybierz narzędzie do debugowania, którego chcesz użyć.

Uruchamianie narzędzia JSConstraintsDebug w trybie użytkownika

Podniesione uprawnienia są wymagane do włączenia debugowania funkcji JS. Aby można było uruchomić w trybie użytkownika, należy ustawić następujący klucz rejestru przed wykonaniem JSConstraintsDebug.exe:

Nazwa klucza

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print

Nazwa wartości

WłączJavaScriptDebugging

Typ

DWORD

Wartość

1

Instrukcje debugera języka JavaScript

Punkty przerwania można tworzyć w źródle języka JavaScript przy użyciu instrukcji debugera. Spowoduje to wstrzymanie operacji w programie Visual Studio, co umożliwi debugowanie krok po kroku. Te instrukcje można wstawić do dowolnego z interfejsów API ograniczeń języka JavaScript.

Przykład:

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

JsConstraintsDebug, składnia polecenia

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

Parametry polecenia

Parametry Opis

Nazwa drukarki

To jest wymagane. Określa nazwę ciągu sterownika wydruku, który zawiera plik źródłowy ograniczeń JS. Ten sterownik będzie używany do wszystkich operacji debugowania.

PrintTicket

To jest wymagane. Określa ścieżkę i nazwę pliku XML biletu drukowania do weryfikacji.

MergePrintTicket

Opcjonalny. Określa ścieżkę i nazwę pliku XML biletu drukowania, który posłuży do walidacji operacji scalania.

Jeśli ten parametr nie zostanie ustawiony, domyślny tryb DevMode zostanie przekonwertowany na bilet drukowania i przekazany do API scalania i weryfikacji.

Ograniczenia

Opcjonalny. Określa ścieżkę i nazwę pliku ograniczeń JavaScript, który zastąpi istniejący plik źródłowy ograniczeń znaleziony w sterowniku drukarki docelowej przed debugowaniem.

Uwaga Określenie pliku ograniczeń z parametrem Constraints spowoduje zastąpienie istniejącego kodu źródłowego w docelowym sterowniku.

przykłady

Debugowanie sterownika drukarki według znanego testowego dokumentu drukowania.

JSConstraintsDebug “Contoso Printer” PrintTicket.xml

Debugowanie sterownika drukarki z użyciem nowego pliku źródłowego ograniczeń w odniesieniu do znanej specyfikacji testowej drukowania.

JSConstraintsDebug “Contoso Printer” PrintTicket.xml Constraints.js

Przetestuj scalanie i weryfikowanie operacji między dwoma niestandardowymi biletami drukowania.

JSConstraintsDebug “Contoso Printer” PrintTicket.xml PrintTicket2.xml