Jak używać IronPrint z GitHub Copilot
Magazyn załadunkowy drukuje dokument przekazania dla każdej naczepy opuszczającej jego wiaty. Portal internetowy magazynu zapisuje każdy formularz jako wypełniony PDF z polami dla kierowcy, numeru pieczęci, liczby palet i materiałów niebezpiecznych, a usługa .NET w rozwiązaniu Visual Studio drukuje dwie kopie każdego z nich. Asystent, który edytuje usługę, musi pracować wewnątrz tego rozwiązania, we wtyczce, której zespół już używa.
GitHub Copilot oferuje tryb czatu i agenta w Visual Studio i VS Code, Copilot CLI dla terminala oraz agenta w chmurze GitHub, który odpowiada na przypisane zadanie za pomocą pull request. IronPrint wysyła PDF-y i obrazy do drukarki z .NET, z ustawieniem rozmiaru papieru, kopiami, rozdzielczością i spłaszczeniem formularzy na pojedynczym obiekcie PrintSettings. Każdy z tych interfejsów Copilot odczytuje zasady IronPrint z plików instrukcji w repozytorium.
Poniższe polecenia proszą Copilot o kod drukowania oparty na IronPrint. Wybór sprzętu drukującego lub konfiguracja serwera wydruku to zadanie osobne, którego żaden asystent nie może wykonać z repozytorium. Przewodnik po spłaszczaniu opisuje ustawienie IronPrint, od którego zależą te formularze.
Szybki startUruchomić copilot z folderu rozwiązania i wysłać polecenie. W CLI, @ przed ścieżką dołącza ten plik. W Visual Studio, Copilot Chat używa # do tego samego celu.
Fill in @src/Depot.Printing/HandoverPrinter.cs so the depot can print its handover forms.
Use IronPrint 2026.10.1, the version Directory.Packages.props already pins.
Give the class three public static members:
- InstalledPrinters() returns the names from Printer.GetPrinterNames.
- BuildSettings(string printerName) returns the PrintSettings that @docs/print-profile.md describes.
- PrintAsync(string pdfPath, string printerName) checks the name first, then sends the job.
An unknown name throws an ArgumentException whose message lists the installed printers.
Build the solution and fix every error.
Then list the files you changed.
Polecenie nie określa żadnego indywidualnego ustawienia. Profil druku w docs/print-profile.md wymienia każde z nich, a wśród nich jest Flatten.
Klucz licencyjny znajduje się w IRONPRINT_LICENSE_KEY, ustawionym w środowisku, w którym działa Copilot. Sam IronPrint nie odczytuje tej zmiennej. W naszym teście, License.IsLicensed pozostawało fałszywe z ustawioną zmienną, aż do momentu przypisania wartości do License.LicenseKey. Inne obsługiwane miejsca dla klucza znajdują się w przewodniku po kluczach licencyjnych.
Minimalny proces (5 kroków)
- Pobierz bibliotekę drukowania C# z NuGet
- Zapisz zasady IronPrint w .github/copilot-instructions.md plus jeden plik z instrukcjami specyficzny dla ścieżki
- Ustawić Flatten w każdej pracy formularza i sprawdzić każdą nazwę drukarki na tle zainstalowanej listy
- Przetestować PrintSettings, które buduje kod, zamiast wysyłać prawdziwe zadania
- Przypisać kolejną zmianę do agenta chmurowego jako zadanie i zweryfikować pull request na tle dokumentacji API IronPrint
Jak ustalić konwencje IronPrint dla Copilot?
Zasady obejmujące całe projekty należą do .github/copilot-instructions.md. Macierz wsparcia GitHub pokazuje wsparcie dla tego pliku w Copilot Chat na Visual Studio, VS Code i IDE JetBrains, dla Copilot CLI, przeglądu kodu Copilot oraz agenta w chmurze. Visual Studio dodaje plik do żądań Copilot Chat tylko wtedy, gdy zaznaczone jest pole wyboru niestandardowych instrukcji, w sekcji Opcje, pod GitHub, Copilot, Copilot Chat.
These rules apply to printing code in this repository:
- Handover forms print through IronPrint. The NuGet package and the namespace are both IronPrint.
- Add no other printing library and no System.Drawing.Printing code.
- Keep the IronPrint version that Directory.Packages.props sets. Only an upgrade task changes it.
- IRONPRINT_LICENSE_KEY holds the license key.
- IronPrint does not read that variable, so Program.cs copies its value into License.LicenseKey.
- Never print the value, and don't dump environment variables either.
- docs/print-profile.md is the print contract. Leave it as it is and suggest changes in your reply.
- https://ironsoftware.com/print/csharp/llms.txt indexes IronPrint's docs for agents.
- No printer on this machine finishes a job without someone answering a dialog.
- Don't send a print job from a session, a test or a dry run.
Printing tests follow these rules:
- Test the PrintSettings the code builds.
- A test never calls Printer.Print or Printer.PrintAsync with a printer name that exists.
Ostatnia zasada drukowania pochodzi z maszyny testowej. Tam, Microsoft Print do PDF prosi o nazwę pliku, a Adobe PDF otworzył okno Tworzenia Adobe PDF, więc zadanie wysłane do obu drukarek czeka na odpowiedź osoby.
Jak przydzielić kodowi drukującemu własne zasady?
Wzorce applyTo pliku .github/instructions/printing.instructions.md ograniczają jego zasady do części drzewa, w tym przypadku projektów źródłowych i testowych. Dokumentacja CLI GitHub stwierdza, że CLI dodaje plik specyficzny dla ścieżki do swojego kontekstu tylko podczas pracy nad plikiem, który pasuje do wartości applyTo. W naszym przebiegu, printing.instructions.md był pierwszym plikiem, który Copilot otworzył w pierwszym poleceniu.
---
applyTo: "src/**,tests/**"
---
Source and test code here follow these IronPrint rules:
- Set Flatten = true for every handover form.
- With Flatten false, IronPrint sends the page with four empty boxes.
- Those boxes are Driver, SealNumber, PalletCount and Hazmat.
- Check a printer name against Printer.GetPrinterNames before a job.
- IronPrint throws nothing for a name it cannot match, even by case or a trailing space.
- It prints on the Windows default printer instead.
- GetPrinterTrays returns an empty list for an unknown name, as it does for some real printers.
- So an empty tray list cannot prove that a printer exists.
- NumberOfCopies reaches the driver as a copy count.
- The job itself holds one page per PDF page.
- With no key, Printer.Print throws an AggregateException that wraps a LicensingException.
- PrintAsync throws the LicensingException itself.
- Margins takes millimeters, in the order left, top, right, bottom.
Każda z tych zasad była mierzona z IronPrint 2026.10.1. Sekcje Flatten i nazwa drukarki poniżej przedstawiają pomiary za pierwszą z nich.
Dlaczego pola formularza drukują się puste bez Flatten?
Te pomiary używały symulowanej drukarki. Na systemie Windows IronPrint przesyła każde zadanie przez wywołanie PrintDocument dialogu drukowania WPF. Hak na tym wywołaniu zapisywał strony i bilet drukarski każdego zadania do pliku XPS, a żadna kolejka drukowania nie otrzymała zadania. Cztery formularze przekazania przeszły przez nie z ustawieniami z przykładu połączonego przewodnika spłaszczającego. Wyniki opisują stronę, którą IronPrint przekazuje sterownikowi drukarki, a nie papier z drukarki fizycznej.
Poniższe porównanie wykorzystuje formularz przekazania HO-1001, zapisany z wartością w każdym polu.
- Przy pozostawieniu
Flattenna domyślne ustawienie false, pola Kierowca, Numer pieczęci, Liczba palet i Skrzynka Hazmat były puste we wszystkich czterech formularzach. Trzy formularze zawierały strumienie wyglądu dla swoich pól, a skrzynki też były puste. - Przy
Flatten = truekażda wartość została wydrukowana. Formularz zapisany bez strumieni wyglądu wydrukował też swoje wartości. - Każda strona PDF stała się jednym obrazem o rozdzielczości 2479 na 3508 pikseli na stronie portretowej formatu ISO A4, co odpowiada A4 przy 300 DPI. Formularz dwustronicowy wyprodukował dwie strony.
- Bilet drukarski zawierał dwa razy kopii, podczas gdy dokument zawierał jedną stronę na stronę PDF.
- Marginesy 10 mm z przykładu nie przesunęły obrazu, który wypełnił stronę od lewego górnego narożnika.
Wynik
HO-1001 przeszło przez hak dwa razy, najpierw przy ustawieniu Flatten na false, a potem przy Flatten na true. Każdy PDF poniżej to obraz strony jednej przechwytywanej pracy, niezmodyfikowany i w oryginalnym rozmiarze.
HO-1001 z Flatten false, jak IronPrint zbudował zadanie, przechwycony do pliku zamiast drukarki.
HO-1001 z Flatten true, jak IronPrint zbudował zadanie, przechwycony do pliku zamiast drukarki.
Przewodnik spłaszczania przypisuje puste pola do sterowników drukarek, które pomijają warstwy formularza. W przechwytywaniu wartości były już brakujące na stronie, zanim otrzymał je jakikolwiek sterownik.
Jak drukować folder formularzy bez wysyłania zadania?
Zadanie wsadowe potrzebuje testowego uruchomienia, aby można je było przetestować bez drukarki. Testowe uruchomienie rejestruje ustawienia, jakie otrzymałby każdy formularz, a recenzent może porównać ten log z profilem drukowania.
Turn @src/Depot.PrintJob/Program.cs into the batch job that prints forms/inbox.
It accepts two options:
- --printer <name> picks the printer for every form.
- --dry-run writes the log and sends nothing.
The job runs in this order:
1. Exit with code 2 when the printer isn't installed, and list the installed ones on the console.
2. Read every PDF in forms/inbox in file name order.
3. Get each form's settings from HandoverPrinter.BuildSettings.
4. Append a line per form to out/print-log.csv, then print the form unless it's a dry run.
Paths are relative to the solution root.
The log is semicolon-delimited, with this header line:
Form;Printer;Flatten;Copies;PaperSize;Orientation;Dpi;Grayscale
Run the job twice with --dry-run.
Use --printer "Adobe PDF" the first time and --printer "Depot Laser 2" the second.
Show me both exit codes and the log.
Adobe PDF to drukarka na maszynie testowej. Użyć nazwy z własnej listy drukarek.
Co się dzieje, gdy nazwa drukarki nie pasuje?
IronPrint porównuje PrinterName z nazwami zgłaszanymi przez Windows, znak po znaku, i nie generuje błędu, gdy porównanie się nie powiedzie. Przechwycone zadania były adresowane do "NoSuchPrinter 7", do nazwy "adobe pdf" pisanej małymi literami oraz do "Adobe PDF" z spacją na końcu. Microsoft Print to PDF, domyślna drukarka Windows, otrzymał wszystkie trzy, a tylko dokładna nazwa trafiła do Adobe PDF. Licencjonowane zadanie na nieznaną nazwę nie wygenerowało wyjątku i zakończyło się tylko po odpowiedzi na Zapisz jako w programie Microsoft Print to PDF.
GetPrinterTrays nie może zastąpić sprawdzania nazwy, ponieważ zwrócił pustą listę dla nieznanej nazwy oraz dla Fax i Microsoft Print to PDF. GetPrinterNames zwrócił wszystkie cztery drukarki bez klucza licencyjnego, więc sprawdzenie działa także w testach, które go nie używają.
Jak przetestować ustawienia drukowania?
Nacisnąć Shift+Tab w Copilot CLI, aż tryb planowania będzie aktywny, a następnie wysłać poniższe polecenie.
Plan an xUnit project in tests/Depot.Printing.Tests and add it to the solution.
Hold off on code until I approve the plan.
Its tests cover these cases:
- Every setting BuildSettings fills in matches @docs/print-profile.md.
- PaperMargins and Tray stay null, so the printer's own defaults apply.
- PrintAsync refuses a name with the wrong case or a trailing space.
- That refusal names every printer InstalledPrinters() returns.
Once the plan is approved, add the tests and run dotnet test.
Then give me the pass and fail counts.
Przegląd planu najpierw pokazuje, jak pakiet uzyska prawdziwą nazwę drukarki zanim jakikolwiek test zależy od listy drukarek maszyny.
Jak naprawić ponowny druk, który pozostawia pola formularza puste?
Ścieżka ponownego drukowania napisana poza główną usługą może pominąć ustawienie, które główna usługa stosuje. W tym scenariuszu, usługa ReprintService kolegi buduje własny PrintSettings bez Flatten, a sterowniki otrzymują ponowne wydruki z pustymi skrzynkami.
Drivers say reprinted handover forms have empty Driver, Seal number and Pallet count boxes.
First prints look right. The reprint code is @src/Depot.Printing/ReprintService.cs.
Work out the cause before you edit anything:
1. Compare ReprintService.BuildSettings with HandoverPrinter.BuildSettings.
2. Open IronPrint.xml inside the IronPrint package in the NuGet cache.
3. Quote its summary for the setting that explains the empty boxes.
Then fix ReprintService.cs, and keep a reprint at one copy.
Leave the other source files alone.
Add a test for the reprint settings and run dotnet test.
Tell me the cause you found and the test result.
Odsprzedawany plik IronPrint.xml łączy ustawienie z objawem w jednym zdaniu, które opisuje Flatten jako użyteczne do wyświetlania wartości pól formularza. Nie stwierdza, że wartości są brakujące bez niego.
Co sprawia, że temat jest działaniem, które agent chmurowy może realizować?
Copilot otrzymuje tytuł problemu, opis i istniejące komentarze, gdy problem jest przypisany, wraz ze wszystkimi tekstami w opcjonalnym polu podpowiedzi. Dokumentacja GitHub stwierdza, że agent nie jest świadomy komentarzy zamieszczonych po przypisaniu, więc treść problemu musi określać, kiedy praca jest ukończona.
Title: Log the printer each reprint was sent to
The work involves these files and settings:
- Files: src/Depot.Printing/ReprintService.cs, tests/Depot.Printing.Tests
- IronPrint version: unchanged from Directory.Packages.props
- Framework: net9.0-windows
After the change, reprints behave like this:
- Every reprint appends a line to out/reprint-log.csv.
- The line holds the form, the printer name, the time and the copy count.
- A printer name that Windows does not report stops the reprint before anything is sent.
Today, reprints leave no record, and ReprintAsync sends a job to any name it receives.
Keep to these limits:
- Keep the ReprintAsync signature.
- Follow .github/instructions/printing.instructions.md.
- Add no packages.
Acceptance means these checks pass:
- Every existing test passes.
- A new test passes "adobe pdf" in lower case and expects an ArgumentException before any job.
Ponieważ test używa nazwy, która różni się od zainstalowanej drukarki tylko wielkością liter, kontrola, która pomija wielkość liter, nie powiedzie się.
Dlaczego testy agenta chmurowego nie powiodły się w projekcie IronPrint?
Jeśli repozytorium nie konfiguruje innego hosta, środowisko agenta to Ubuntu Linux. Strona produktu IronPrint wymienia Windows, macOS, iOS i Androida, ale nie Linux, a każdy projekt w tym rozwiązaniu jest przeznaczony na net9.0-windows. GitHub wspiera 64-bitowych hostów na Windows dla agenta chmurowego. Zintegrowana zapora nie jest kompatybilna z Windows, więc GitHub zaleca hostowane przez własnych użytkowników hostów albo większe hosty zarządzane przez GitHub z prywatnymi sieciami Azure w takim przypadku.
Bez tajemnicy Agents, to środowisko nie zawiera również klucza licencyjnego. Podczas próby, każdy niezlicencjonowany wywołanie druku wykryło "Wymagana licencja produkcyjna" w ciągu 0,2 s, zanim jakiekolwiek zadanie zostało utworzone.
Praca copilot-setup-steps w .github/workflows/copilot-setup-steps.yml uruchamia się przed rozpoczęciem pracy agenta, a GitHub ją wyzwala jedynie po wprowadzeniu pliku do domyślnej gałęzi.
The cloud agent has to build this solution, so add a setup workflow for it.
Its path is .github/workflows/copilot-setup-steps.yml.
Copilot looks for one job, and it has to be named copilot-setup-steps.
The job works like this:
- Run it on windows-latest, because every project targets net9.0-windows.
- Its only permission is contents: read.
- Start it from workflow_dispatch and from pull requests that edit this workflow file.
- Its steps are a checkout, a .NET 9 SDK install, a restore and a Release build.
Printing calls need IRONPRINT_LICENSE_KEY, which is stored as an Agents secret.
The job sees that secret as an environment variable.
Add a step that tests whether the key is set:
- For pull_request and workflow_dispatch events, a missing key is a warning and the step passes.
- For every other event, a missing key fails the step with a message that names the secret.
That step goes last, since Copilot skips every setup step after one that fails.
Create the file and show me the YAML.
Użyj tajemnicy Agents dla klucza: agent chmurowy nie może odczytać tajemnic Actions, Codespaces lub Dependabot. Dodaj IRONPRINT_LICENSE_KEY na stronie Agenci Tajemnic i Zmiennych, znajdowanej w grupie Bezpieczeństwo w Ustawieniach repozytorium. Agent otrzymuje następnie klucz jako zmienną środowiskową.
Co należy sprawdzić przed scaleniem?
Przesłać recenzję jako osobne polecenie copilot -p. Bez --continue lub --resume, to polecenie rozpoczyna nową sesję bez historii z sesji kodowania.
/review the changes made since this branch's first commit.
Compare each IronPrint call with .github/instructions/printing.instructions.md.
Then compare it with the IronPrint.xml that ships in the IronPrint NuGet package.
Name every place where the code and those two sources disagree.
Flag any of these as well:
- a PrintSettings for a handover form that leaves Flatten unset or false
- a print call whose printer name was never checked against Printer.GetPrinterNames
- a test that sends a real print job
- a catch block that would miss the LicensingException a print call throws
- any line that writes IRONPRINT_LICENSE_KEY to the console or a log
Report what you find and leave every file unchanged.
Co wyprodukowały zapytania w rzeczywistym uruchomieniu?
Sześć poleceń zostało zaplanowanych do uruchomienia jedno po drugim w Copilot CLI, bez osoby przy klawiaturze, w rozwiązaniu magazynu zbudowanym dla tego przewodnika. Po każdym poleceniu, budowę ponownie przywracano i uruchamiano na niej pracę wsadową. Ustawienia dla każdego formularza przeszły następnie przez IronPrint z przechwyceniem wywołania druku, dzięki czemu żadne zadanie nie dotarło do drukarki.
- Przed uruchomieniem HandoverPrinter była pustą klasą statyczną, a zadanie wsadowe było złudzeniem, które wyszło z kodem 1.
- Pierwsza podpowiedź zmieniła tylko HandoverPrinter.cs.
- Po pierwszej podpowiedzi BuildSettings zwrócił Flatten wł., 2 kopie, A4, portret, 300 DPI i skalę szarości.
- Podajnik i marginesy pozostały nieustawione, więc zastosowano domyślne ustawienia drukarki.
- PrintAsync sprawdził nazwę drukarki za pomocą porównania liczbowego, które jest rozróżniające między małymi a dużymi literami.
- Każda wartość pola pojawiła się na przechwyconych stronach wszystkich czterech formularzy.
- Bilet drukarski dla każdego formularza zawierał 2 kopie, ISO A4 portret, monochromatyczny wydruk i 300 DPI.
- Przechwycony zestaw zadań dla formularza dwustronicowego zawierał dwie strony, a każdy inny zadanie jedną.
- Rozwiązanie zbudowane z 0 błędów po każdym z dwóch poleceń.
- Po drugiej podpowiedzi zakończono suche uruchomienie dla Adobe PDF z kodem 0 i zarejestrowano jedną linię na formularz.
- Każda zarejestrowana linia odpowiadała profilowi drukowania, z Flatten i Grayscale jako True.
- Suche uruchomienie dla Depot Laser 2 zakończyło się z kodem 2, a jego wyjście konsolowe wymieniło cztery zainstalowane drukarki.
- Żadne suche uruchomienie nie wywołało wywołania druku.
- Żadne zlecenie druku nie pojawiło się na żadnej kolejce w trakcie uruchomienia.
- Niektóre kroki uruchomiono inaczej niż na stronie. Miesięczna kwota Copilot wyczerpała się w drugim poleceniu, po tym jak Copilot zbudował zadanie i przed jego suchymi uruchomieniami. Zamiast tego obie suche uruchomienia zostały uruchomione poza Copilot. Podpowiedzi od 3 do 6 nie uruchomiły się, więc tryb planowania, naprawa ponownego druku, konfiguracja pracy i recenzja nie mają wyników uruchomień na tej stronie. Zadanie, agent chmurowy i tajemnica Agents wymagają hostowanego repozytorium, więc żadne z nich nie zostało przetestowane.
Cursor także ogranicza swoje zasady do wzorców plików, a Claude Code również czeka na zatwierdzony plan przed wprowadzeniem jakichkolwiek zmian w kodzie. Udostępniany zapis uruchomień zawiera wersję CLI, model wybrany przez Auto, całkowity czas uruchomienia i sprzęt.
Rozwiązywanie problemów
- Jak spłaszczać PDF-y przed drukowaniem dla pustych pól formularza
- Jak uzyskać nazwy drukarek dla nazw raportów Windows
- Jak określić nazwę drukarki dla zadań, które trafiają do złej drukarki
- Metoda Print() zawiesza się w WPF i WinForms dla wywołania wydruku, które zawiesza interfejs
- Stosowanie kluczy licencyjnych dla każdej lokalizacji, w której można ustawić klucz
Pytania?
Jeśli są jakiekolwiek pytania, należy skontaktować się z support@ironsoftware.com
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.