Jak korzystać z IronPrint z Google Antigravity
Recepcja hotelowa drukuje kartę rejestracyjną dla każdego przybywającego gościa do podpisania przy ladzie. Recepcjonista klikać Drukuj w przeglądarce, ale zadanie opuszcza serwer internetowy, więc karta wysłana do niewłaściwej drukarki lub na niewłaściwym rozmiarze papieru nadal zwraca komunikat o powodzeniu. Te problemy nie pojawiają się w logach kompilacji.
Google Antigravity może sprawdzić stronę tak, jak zrobiłby to recepcjonista. Jego polecenie /browser uruchamia sandboxowany podagent Chrome, który może kliknąć każdy przycisk Drukuj i zrobić zrzut ekranu wyniku. IronPrint wysyła kartę w formacie PDF do drukarki z serwera za pomocą Printer.PrintAsync, podejścia opisanego w przewodniku dla aplikacji internetowej ASP.NET IronPrint. Kroki poniżej wykorzystują oba narzędzia do zbudowania strony, a następnie przetestowania jej w sześciu przybyciach z znanymi wynikami.
Grupa docelowa to programiści .NET, których agenci AI piszą kod drukujący z serwera sieciowego. Wybór sprzętu drukarki i konfiguracja kolejek drukowania są poza zakresem.
Szybki startOtworzyć projekt FrontDesk w Antigravity i opisać stronę przybyć.
/plan Add an /Arrivals page to the FrontDesk .NET 9 MVC site.
Each row's Print registration card button prints that card from the server with IronPrint.
Set up the project first:
- Add the IronPrint package, version 2026.10.1. Its namespace is IronPrint.
- Target net9.0-windows.
The page works like this:
- It lists today's guests from App_Data/arrivals.csv.
- Each card is App_Data/cards/<ReservationId>.pdf.
- The Print action awaits Printer.PrintAsync, never Wait or Result.
- Cards print on A5, two copies, grayscale, with PaperOrientation.Automatic.
- Check the printer name in Printing:PrinterName against Printer.GetPrinterNames before any job.
- Refuse a missing card, or a file that doesn't start with %PDF-, before IronPrint opens it.
- Each click shows its outcome on the page.
- Add the page to the nav bar.
Every printer here opens a Save As dialog. Send no real job.
With Printing:DryRunFolder set, write each job to a JSON file there.
The file holds the reservation, card path, printer and every setting.
appsettings.Development.json already sets the folder.
At startup, set IronPrint.License.LicenseKey once from IRONPRINT_LICENSE_KEY.
The app reads the variable itself, so you never need the value.
Check only that it's set and its length.
Don't print, log or save the key, or list the environment variables.
Answer three questions in the Implementation Plan:
- What does IronPrint do with a printer name it can't find?
- How does the name check compare names?
- What does the page show when IronPrint throws?
Stop when dotnet build reports zero errors.
Udana kompilacja nie testuje trzech odpowiedzi, więc należy sprawdzić każdą w planie przed jego zatwierdzeniem.
IronPrint nie czyta IRONPRINT_LICENSE_KEY. W naszych testach zmienna została ustawiona, a License.IsLicensed pozostało fałszywe, dopóki kod nie przypisał License.LicenseKey. Przewodnik po kluczach licencyjnych omawia inne opcje, takie jak appsettings.json i Web.config.
Minimalny proces (5 kroków)
- Pobierz bibliotekę drukowania C# z NuGet
- Utwórz projekt ASP.NET Core net9.0-windows.
- Dopasuj skonfigurowaną nazwę drukarki do zainstalowanych drukarek przed każdym zadaniem.
- Sprawić, aby /browser klikał każdy przycisk Drukuj, gdy drukowanie działa jako próba bezużyteczna.
- Porównaj każde zapisane zadanie z oczekiwaną listą i sprawdź każdego członka IronPrint w dokumentacji API.
Czym jest Google Antigravity i czym różni się od asystenta czatu?
W przeglądzie Google, aplikacja desktopowa Antigravity jest samodzielnym programem, w którym deweloper uruchamia, koordynuje i przeszukuje zespoły autonomicznych agentów. Gdzie asystent czatu odpowiada tekstem, agenci Antigravity produkują Artefakty takie jak Plan Implementacji, Przejście i zrzuty ekranu.
Agent, który nazwie pakiet z pamięci, może zainstalować podobnie wyglądający opublikowany przez atakującego, technika znana jako slopsquatting. Należy podać nazwę pakietu IronPrint i wersję w dowolnym pytaniu, które dodaje zależność. Pliki dokumentacji IronPrint dla agentów są wymienione w przewodniku dla asystentów kodowania AI, który zawiera również test akceptacji z jednym pytaniem.
Co należy sprawdzić w planie, zmianach kodu i Przewodniku?
Plan przewidujący, że IronPrint odrzuci nieznaną nazwę drukarki, przegapił powód istnienia sprawdzania nazw. W zmianach w kodzie znajdź porównanie nazw drukarek i sprawdź każdego członka IronPrint w dokumentacji API.
Oczekuj jednego zrzutu ekranu na klik w Przejściu. Aplikacja desktopowa zapisuje każdy zrzut ekranu jako artefakt obrazu otwarty na komentarze. Komentarz do zrzutu ekranu z niewłaściwym komunikatem informuje agenta, który wiersz się nie powiódł, i nie jest potrzebny nowy monit.
Jak przetestować przycisk drukowania w prawdziwej przeglądarce?
Polecenie /browser prosi o tabelę, którą można wypełnić tylko poprzez kliknięcie każdego przycisku.
/browser Start the site in the background with dotnet run and go to /Arrivals.
The http profile serves it on http://localhost:5318.
Click Print registration card on every row, top to bottom:
1. Click the button.
2. Wait for the outcome message.
3. Take a screenshot.
TestData/expected-jobs.csv says what each click should produce.
A row marked job should leave one new JSON file in print-jobs.
A row marked refused should leave no file, and the page should say why.
Sum up the clicks in a Walkthrough table with these columns:
- reservation
- expected outcome
- message on the page
- job file written
- paper size, orientation, copies and grayscale from that file
- pass or fail
Before you touch the code, find the log line or exception behind each failed row.
Write it under the table, or say nothing was logged.
Fix the cause, restart the site and click every row again.
Stop that dotnet process by its PID at the end.
Z sześciu przybyć, dwa mają karty A5 na jedną stronę, a trzeci ma drugą stronę z zasadami domu. Rezerwacja grupowa ma kartę A4 w orientacji poziomej, jedna rezerwacja nie ma karty, a jeden plik karty zawiera tekst nieudanej eksportu zamiast PDF.
Strona /Arrivals po kliknięciu dla rezerwacji 1047, jednego z siedmiu zrzutów ekranu w końcowym Przejściu agenta.
Do której drukarki dociera żądanie druku?
IronPrint 2026.10.1 nie weryfikuje nazwy drukarki. Zbudowaliśmy zadania z nieznaną nazwą, z adobe pdf napisaną małymi literami i bez nazwy. IronPrint skierował wszystkie trzy do domyślnej drukarki Windows bez wyjątku. Przypisanie dowolnego ciągu do PrintSettings.PrinterName także kończy się sukcesem. W ten sposób błąd typograficzny w konfiguracji drukuje kartę na domyślnej drukarce serwera.
Na maszynie testowej domyślną drukarką był Microsoft Print to PDF, który żąda nazwy pliku w oknie dialogowym Zapisz jako. Zaawansowany przykład w przewodniku ASP.NET wysyła swoje zadanie do tej samej drukarki. Żaden użytkownik na serwerze internetowym nie odpowiada na dialog, a w sondach zadanie do tej drukarki zakończyło się tylko po wpisaniu nazwy pliku przez osobę.
Porównanie skonfigurowanej nazwy z Printer.GetPrinterNames przed każdym zadaniem zapobiega obu wynikom. Porównanie musi być porządkowe, ponieważ IronPrint dokładnie dopasowuje nazwę kolejki, uwzględniając wielkość liter.
Jak skonfigurować projekt, w którym Antigravity może działać?
Udostępnić agentowi repozytorium, które już kompiluje i obsługuje stronę. dotnet new mvc -f net9.0 wygenerował projekt FrontDesk, który miał jedną czystą kompilację przed pierwszym pytaniem. Jego profil uruchamiania http w Properties/launchSettings.json nasłuchuje na porcie 5318, który otwiera polecenie /browser.
Ukierunkuj net9.0-windows. Sonda konsolowa zbudowana dla zwykłego net9.0 skompilowała się bez ostrzeżeń, ale zgłosiła różne nazwy tac, np. "Automatycznie Wybierz" zamiast "AutoSelect" dla drukarki Adobe PDF, i podniosła PlatformNotSupportedException dla brakującego pliku.
Which IronPrint version does FrontDesk.csproj reference? Quote the PackageReference line.
Then tell me where the code applies the key.
Read the code for this, and don't start the app.
Check the project against these rules for the key:
- It reaches the app only through IRONPRINT_LICENSE_KEY at startup.
- No appsettings file has an IronPrint.LicenseKey entry.
- Properties/launchSettings.json holds no key.
- With the variable missing, startup writes a single warning naming the variable, with no value.
Change Program.cs only if that warning isn't there.
Don't edit anything else.
Bez klucza licencyjnego IronPrint 2026.10.1 wypisał cztery zainstalowane drukarki i ich tace. Printer.PrintAsync rzucił LicensingException z "Wymagana Licencja na Produkcję" przed odczytem pliku, więc kolejki druku nie otrzymały żadnego zadania. Na stronie testowej pierwszy niezarejestrowany klik zwrócił tę wiadomość w 998 ms, a późniejsze kliknięcia w 19 do 30 ms. Typ wyjątku nie jest publiczny, a catch (LicensingException) nie kompiluje się z błędem CS0122.
Jak zastosować zasady strony do późniejszych zadań?
Gdy każdy wiersz przejdzie, zapisz decyzje sesji jako zasady. Dokumentacja zasad Antigravity mówi, że agent ładuje plik AGENTS.md lub GEMINI.md w każdym folderze na ścieżce od pliku, który odczytuje lub edytuje, do korzenia przestrzeni roboczej. /learn proponuje zasady i umiejętności zaczerpnięte z poprawek dokonanych w sesji i zapisuje pliki dopiero po zatwierdzeniu.
/learn Write the decisions of this session to a new AGENTS.md in the repository root.
Use the heading "Front desk printing" and cover:
- the target framework IronPrint needs here
- how the printer name is checked, and why
- the settings every registration card prints with
- the dry-run folder, and that no real job goes out from this machine
- where IRONPRINT_LICENSE_KEY comes from, and that it never goes into a file
- that a change is finished only when every row of TestData/expected-jobs.csv passes in /browser
Tell me the rules before you save them.
Jak organizować kolejki zadań druku z tej strony?
Przewodnik ASP.NET zaleca kolejkę dla drukowania o dużej objętości.
/plan Show me the Implementation Plan Artifact and wait for my go-ahead before editing.
Move the printing code out of the controller into Services/CardPrinter.cs.
Register it with dependency injection.
Here's how CardPrinter behaves:
- BuildSettings returns the PrintSettings for a card, so tests can read them without printing.
- A printer name passes only on an exact match with Printer.GetPrinterNames, case included.
- A missing card, a non-PDF file or an unknown printer comes back as a refusal with a reason.
- IronPrint's LicensingException isn't public, so match it by type name.
- That exception becomes a message saying the key is missing.
- With Printing:DryRunFolder set, it still writes the JSON job file and sends nothing.
Then add a Print all cards button to /Arrivals.
The new button works this way:
- It puts one job per arrival on a Channel that a BackgroundService reads.
- Jobs run one at a time.
- The request returns straight away.
- The page lists each job as queued, done or refused.
Finish with the /browser table again, then click Print all cards and add its rows.
Wait until no job shows as queued before that last screenshot.
Monit prosi o usługę zbliżoną do tego przykładu, który kompiluje się w porównaniu do IronPrint 2026.10.1.
using IronPrint;
public sealed record PrintOutcome(bool Printed, string Message);
public sealed class CardPrinter(IConfiguration config, IWebHostEnvironment env)
{
public static PrintSettings BuildSettings(string printerName) => new()
{
PrinterName = printerName,
PaperSize = PaperSize.A5,
PaperOrientation = PaperOrientation.Automatic,
NumberOfCopies = 2,
Grayscale = true,
};
public async Task<PrintOutcome> PrintCardAsync(string reservationId)
{
string card = Path.Combine(env.ContentRootPath, "App_Data", "cards", reservationId + ".pdf");
if (!File.Exists(card))
return new(false, $"No registration card for reservation {reservationId}.");
var header = new byte[5];
using (var stream = File.OpenRead(card))
stream.ReadExactly(header);
if (System.Text.Encoding.ASCII.GetString(header) != "%PDF-")
return new(false, $"Card {reservationId} is not a PDF.");
// IronPrint sends a job for an unknown name to the Windows default printer, so match the name here.
string printer = config["Printing:PrinterName"] ?? "";
List<string> installed = await Printer.GetPrinterNamesAsync();
if (!installed.Contains(printer, StringComparer.Ordinal))
return new(false, $"Printer '{printer}' is not installed on this server.");
try
{
await Printer.PrintAsync(card, BuildSettings(printer));
return new(true, $"Card {reservationId} sent to {printer}.");
}
catch (Exception ex) when (ex.GetType().Name == "LicensingException")
{
return new(false, "IronPrint has no license key. Set IRONPRINT_LICENSE_KEY on the server.");
}
}
}
Przykład pomija gałąź próby bezużytecznej. Przekazana do IronPrint bez sprawdzenia nagłówka, karta dla rezerwacji 1047 podniosła InvalidDataException z "Nieobsługiwanym typem pliku".
Co otrzymuje drukarka w recepcji dla każdej karty?
Żadna z czterech drukarek maszyny testowej nie zakończyła zadania bez nadzoru. Każde zapisane zadanie zostało więc przebudowane z wewnętrznym narzędziem budowy zadań IronPrint, a jego strony i bilet drukowania zapisano do pliku XPS zamiast wysyłać do kolejki.
| Rezerwacja | Plik karty | Strony w zadaniu | Strona wysłana do drukarki |
|---|---|---|---|
| 1042 | A5 portret, 1 strona | 1 | A5 portret, 148 x 210 mm |
| 1043 | A5 portret, 2 strony | 2 | A5 portret, 148 x 210 mm |
| 1044 | A4 pozioma, 1 strona | 1 | A5 pozioma, 210 x 148 mm |
| 1045 | None | 0 | Odrzucona przez stronę |
| 1046 | A5 portret, 1 strona | 1 | A5 portret, 148 x 210 mm |
| 1047 | Tekst, a nie PDF | 0 | Odrzucona przez stronę |
PaperOrientation.Automatic zmienił kartę grupową na stronę A5 w orientacji poziomej i skalował ją, aby pasowała. Z PaperOrientation.Portrait ta sama karta została zmniejszona do szerokości strony w orientacji pionowej i pozostawiła 107,9 mm arkusza puste. Przy domyślnej PaperSize.PrinterDefault, karta A5 została powiększona, aby wypełnić domyślną stronę A4 drukarki.
NumberOfCopies jest żądaniem w bilecie drukowania, a zadanie zawiera każdą stronę raz. Grayscale renderował strony PDF w szarości i ustawił kolor biletu na monochromatyczny. Obniżenie Dpi z 300 do 150 zmniejszyło symulowane zadanie dla jednej karty z 170 257 do 74 526 bajtów.
Karty wejściowe dla rezerwacji 1042 i 1043 pochodzą z App_Data/cards.
Wynik
Dwa poniższe dokumenty PDF zawierają obrazy stron z symulowanych zadań końcowej aplikacji dla tych kart, niezmienione i w rozmiarze strony w każdym bilecie drukowania.
Karta rejestracyjna 1042, jak IronPrint zbudował zadanie, jedna strona w formacie portretu A5 przy 300 DPI zapisana do pliku zamiast drukarki.
Karta rejestracyjna 1043, jak IronPrint zbudował zadanie, dwie strony w formacie portretu A5 przy 300 DPI zapisana do pliku zamiast drukarki.
Kiedy należy wysłać więcej niż jednego agenta?
Dodaj drugiego agenta do sprawdzeń, które nie wymagają przeglądarki. Tutaj jeden agent testuje ustawienia w kodzie, podczas gdy drugi powtarza kliknięcia recepcjonisty.
Agent A: create an xUnit project called FrontDesk.Tests on net9.0-windows, like the web project.
Its tests cover CardPrinter and never send a job:
1. For each job row in TestData/expected-jobs.csv, check the settings BuildSettings returns.
2. Check that reservations 1045 and 1047 are refused, and why.
3. Check that "adobe pdf" in lower case is refused as a printer name.
FrontDesk.csproj is in the repository root, so exclude FrontDesk.Tests from its compile items.
Run them with dotnet test FrontDesk.Tests.
Agent B: wait for Agent A's tests to pass on the current code.
Then use /browser to click every Print button and Print all cards.
Add one screenshot per click to the Walkthrough, and mention there that the tests ran first.
Jak wdrożyć stronę do IIS?
Strona NuGet IronPrint nie wymienia wsparcia dla Linux, tylko Windows, macOS, iOS i Android, więc serwer w recepcji działa na Windows. Przewodnik ASP.NET dodaje, że tożsamość puli aplikacji potrzebuje dostępu do drukarki.
This app will run under IIS on a Windows Server 2022 machine at the front desk.
Leave the C# alone.
IIS isn't installed here, so publish only.
Do these in order:
1. Run dotnet publish -c Release -r win-x64 --self-contained false -o out/iis.
2. List every native DLL in out/iis with the NuGet package that brought it in.
3. Confirm that web.config in out/iis carries no license key.
Then tell me where IIS should set IRONPRINT_LICENSE_KEY for this app.
Folder publikacji przechowuje to, co otrzymuje serwer, więc jego sprawdzenie nie wymaga IIS. Publikacja win-x64 aplikacji kalibracyjnej zawierała 235 plików w 40 MB. Jedynymi natywnymi bibliotekami były IronPrintInterop.dll (9 926 400 bajtów) i qpdf.dll (2 802 432 bajty), obie z pakietu IronPrint. Wygenerated web.config nie zawierał klucza licencyjnego. IIS 10 może przekazać klucz do procesu roboczego za pośrednictwem zmiennych środowiskowych puli aplikacji. Publikacja z katalogu projektu również skopiowała pliki zadań próbnych z print-jobs do wyjścia.
Co wyprodukowały zapytania w rzeczywistym uruchomieniu?
Wszystkie siedem monitów działało bez nadzoru w jednej rozmowie Antigravity CLI, która pominęła każde pytanie o uprawnienia. Jedynym źródłem klucza licencyjnego był IRONPRINT_LICENSE_KEY. Każdy przebieg przeglądarki odbywał się jako próba bezużyteczna, a kolejki drukowania pozostały puste. Każdy wiersz był również klikany niezależnie, po pierwszym pytaniu i w końcowej aplikacji.
- Przed pierwszym pytaniem projekt ukierunkował się na net9.0 i nie odwoływał się do żadnego pakietu NuGet.
- Po pierwszym pytaniu ukierunkował się na net9.0-windows i odnosił się do IronPrint 2026.10.1.
- Plan działania stwierdził, że IronPrint wysyła zadanie dla nieznanej nazwy drukarki do domyślnej drukarki, jak to mierzyliśmy.
- Kod pierwszego pytania oczekiwał na Printer.PrintAsync bez żadnego wywołania Wait ani Result.
- Strona odrzuciła rezerwacje 1045 i 1047 oraz zanotowała zadania dla pozostałych czterech, w obu sprawdzeniach.
- Każde zapisane zadanie prosiło o papier A5, dwie kopie, w skali szarości i automatycznym ustawieniem orientacji.
- Cztery symulowane zadania zawierały 5 stron A5, a strona karty grupowej była pozioma.
- Druk wszystkich kart zakończył wszystkie sześć przybyć w ciągu 2 sekund, z czterema zakończonymi zadaniami i dwoma odrzuconymi.
- Każdy monit zostawił kompilację z 0 błędami.
- Ostateczna aplikacja zbudowana w Release z 0 ostrzeżeniami.
- Uruchomiona bez klucza, ostateczna aplikacja zarejestrowała jedno ostrzeżenie z nazwą IRONPRINT_LICENSE_KEY.
- Wszystkie cztery testy xUnit przeszły bez klucza licencyjnego.
- Publikacja win-x64 uruchomienia zawierała te same dwie natywne biblioteki i web.config bez klucza.
- Niektóre kroki uruchomiono inaczej niż na stronie. /browser subagent Antigravity nie udało się połączyć z Chrome, więc agent kontrolował Chrome przez własny skrypt Puppeteer w każdej przebieganej przeglądarce. Oba monitowania po skonstruowaniu planu czekały na zatwierdzenie po planie. /learn zaproponował sześć punktów w Artefakcie i nie napisał AGENTS.md. W podstawowym monitu dla dwóch agentów, główna rozmowa przeprowadziła testy Agenta A, a po niepowodzeniu subagenta Agenta B, sama klikała wiersze. Agent pozostawił logi Chrome, plik cookie i zrzut ekranu w katalogu głównym repozytorium.
ChatGPT Codex dzieli swoją pracę między eksplorator i pracownik podagentów. W GitHub Copilot zadanie wsadowe również ma próbę bezużyteczną, która loguje ustawienia każdego formularza i nie wykonuje wywołania druku. Wersja Antigravity, model, czas pracy i maszyna testowa są w wspólnym zapisie przebiegu.
Rozwiązywanie problemów
- Drukowanie w aplikacji sieciowej ASP.NET dla wzorca kontrolera, który śledzi ta strona
- Jak uzyskać nazwy drukarek gdy zadania docierają do niewłaściwej drukarki
- Ustawienia druku dla rozmiaru papieru, orientacji, kopii i DPI
- Ustawienie klucza licencyjnego w Web.config gdy klucz nie jest stosowany na serwerze
- Metoda Print() zawiesza się w WPF i WinForms gdy wywołanie druku blokuje wątek wywołujący
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.