Wie man IronPrint mit Google Antigravity verwendet

Curtis Chau
Curtis Chau
Aktualisiert: 26. Oktober 2026

Eine Hotelrezeption druckt für jeden ankommenden Gast eine Anmeldekarte aus, die an der Theke unterschrieben werden muss. Der Mitarbeiter klickt im Browser auf Druck, aber der Auftrag verlässt den Webserver, sodass eine Karte, die an den falschen Drucker oder auf Papier in falscher Größe gesendet wird, dennoch eine Erfolgsmeldung zurückgibt. Diese Probleme erscheinen nicht in den Build-Protokollen.

Google Antigravity kann die Seite überprüfen, wie es ein Mitarbeiter tun würde. Der Befehl /browser startet einen sandboxed Chrome-Subagenten, der jede Schaltfläche Drucken anklicken und einen Screenshot des Ergebnisses machen kann. IronPrint sendet das PDF der Karte mit Printer.PrintAsync von der Serverseite an einen Drucker, wie im ASP.NET-Webanwendungsleitfaden von IronPrint beschrieben. Die folgenden Schritte verwenden beide Tools, um die Seite zu erstellen, und testen sie dann mit sechs Ankünften mit bekannten Ergebnissen.

Die Zielgruppe sind .NET-Entwickler, deren KI-Agenten Code schreiben, der von einem Webserver aus druckt. Die Wahl der Druckerhardware und das Konfigurieren der Druckwarteschlangen sind hier nicht von Belang.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package IronPrint

Installieren Sie IronPrint, indem Sie den obigen Befehl in der NuGet Packet Manager-Konsole ausführen, oder suchen Sie das Paket im NuGet Paket Manager.

Öffnen Sie das FrontDesk-Projekt in Antigravity und beschreiben Sie die Ankunftsseite.

/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.
Text

Ein erfolgreicher Build testet die drei Antworten nicht, also überprüfen Sie jede im Plan, bevor Sie ihn genehmigen.

IronPrint liest IRONPRINT_LICENSE_KEY nicht. In unseren Tests war die Variable gesetzt, und License.IsLicensed blieb falsch, bis der Code License.LicenseKey zugewiesen wurde. Der Lizenzschlüssel-Leitfaden behandelt andere Optionen, wie appsettings.json und Web.config.



Was ist Google Antigravity und wie unterscheidet es sich von einem Chat-Assistenten?

In Googles Übersicht ist die Desktop-Antigravity-App ein eigenständiges Programm, in dem ein Entwickler autonome Agententeams startet, koordiniert und inspiziert. Wo ein Chat-Assistent in Text antwortet, erzeugen die Agenten von Antigravity Artefakte wie den Umsetzungsplan, das Walkthrough und Screenshots.

Ein Agent, der ein Paket aus dem Gedächtnis benennt, kann einen ähnlich aussehenden, von einem Angreifer veröffentlichen, installieren, eine Technik, die als slopsquatting bekannt ist. Geben Sie den Paketnamen und die Version von IronPrint in jede Eingabeaufforderung ein, die eine Abhängigkeit hinzufügt. Die Dokumentationsdateien von IronPrint für Agenten sind im Leitfaden für KI-Programmierungsassistenten aufgeführt, der auch einen Ein-Prompt-Akzeptanztest enthält.

Was sollten Sie im Plan, den Codeänderungen und der Anleitung überprüfen?

Ein Plan, der erwartet, dass IronPrint einen unbekannten Druckernamen ablehnt, hat den Grund für die Namensprüfung übersehen. Suchen Sie in den Codeänderungen den Vergleich des Druckernamens und schauen Sie jedes IronPrint-Mitglied in der API-Referenz nach.

Erwarten Sie einen Screenshot pro Klick im Walkthrough. Die Desktop-Anwendung speichert jeden Screenshot als Bildartefakt, das für Kommentare geöffnet ist. Ein Kommentar zum Screenshot mit der falschen Nachricht teilt dem Agenten mit, welche Zeile fehlgeschlagen ist, und ein neuer Prompt ist nicht erforderlich.

Wie testen Sie die Druck-Schaltfläche in einem echten Browser?

Der /browser-Prompt fragt nach einer Tabelle, die nur durch Klicken auf jede Schaltfläche ausgefüllt werden kann.

/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.
Text

Von den sechs Ankünften haben zwei Einseiter im A5-Format, und eine dritte hat eine zweite Seite mit Hausregeln. Eine Gruppenbuchung hat eine A4-Querformatkarte, eine Reservierung hat keine Karte, und eine Karten-Datei enthält den Text eines fehlgeschlagenen Exports anstelle eines PDFs.

Die Seite Ankünfte mit sechs Reservierungen mit Status und einer Druck-Anmeldekarte-Schaltfläche in jeder Zeile

Die /Arrivals-Seite nach dem Klick für die Reservierung 1047, einer von sieben Screenshots im endgültigen Walkthrough des Agenten.

Bitte beachten Sie: Lesen Sie die Zeilen für die Reservierungen 1045 und 1047 zuerst. Beide müssen selbst von der Seite abgelehnt werden.

Welcher Drucker wird bei einer Druckanfrage erreicht?

IronPrint 2026.10.1 validiert den Druckernamen nicht. Wir haben Aufträge mit einem unbekannten Namen erstellt, mit adobe pdf in Kleinbuchstaben und ohne Namen. IronPrint adressierte alle drei an den Standarddrucker von Windows ohne Ausnahme. Die Zuweisung eines beliebigen Strings an PrintSettings.PrinterName war ebenfalls erfolgreich. Ein Tippfehler in der Konfiguration druckt daher die Karte auf dem Standarddrucker des Servers.

Auf dem Testgerät war der Standarddrucker Microsoft Print to PDF, der in einem Speichern unter-Dialog einen Dateinamen verlangt. Das fortgeschrittene Beispiel im ASP.NET-Leitfaden sendet seinen Auftrag an denselben Drucker. Kein Benutzer auf einem Webserver beantwortet den Dialog, und in den Tests wurde ein Auftrag an diesen Drucker erst abgeschlossen, nachdem eine Person einen Dateinamen eingetippt hatte.

Das Vergleichen des konfigurierten Namens mit Printer.GetPrinterNames vor jedem Auftrag verhindert beide Ergebnisse. Der Vergleich muss ordinal sein, da IronPrint den Warteschlangennamen genau, einschließlich Groß- und Kleinschreibung, übereinstimmt.

Wie richtet man ein Projekt ein, in dem Antigravity arbeiten kann?

Geben Sie dem Agenten ein Repository, das bereits eine Seite kompiliert und bereitstellt. Mit dotnet new mvc -f net9.0 wurde das FrontDesk-Projekt generiert, das einen sauberen Build hatte, bevor der erste Prompt erfolgte. Sein http-Startprofil in Properties/launchSettings.json lauscht auf Port 5318, den der /browser-Prompt öffnet.

Ziel net9.0-windows. Eine Konsolenuntersuchung, die für einfaches net9.0 gebaut wurde, kompilierte ohne Warnungen, meldete jedoch unterschiedliche Tray-Namen, wie "Automatisch auswählen" statt "AutoSelect" für den Adobe PDF-Drucker, und es wurde eine PlatformNotSupportedException für eine fehlende Datei ausgelöst.

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.
Text

Ohne einen Lizenzschlüssel listete IronPrint 2026.10.1 die vier installierten Drucker und ihre Papierfächer auf. Printer.PrintAsync warf LicensingException mit "Production License Required" aus, bevor es die Datei las, also erhielten die Druckwarteschlangen keinen Auftrag. Auf der Testseite gab der erste klick ohne Lizenz die Nachricht in 998 ms zurück und spätere Klicks in 19 bis 30 ms. Der Ausnahme-Typ ist nicht öffentlich, und catch (LicensingException) schlägt beim Kompilieren mit Fehler CS0122 fehl.

Wie wenden Sie die Regeln der Seite auf spätere Aufgaben an?

Sobald jede Zeile erfolgreich gegengeprüft ist, speichern Sie die Entscheidungen der Sitzung als Regeln. Die Regeldokumentation von Antigravity sagt, dass der Agent die Datei AGENTS.md oder GEMINI.md in jedem Ordner auf dem Pfad von einer Datei, die er liest oder bearbeitet, bis zum Arbeitsbereichswurzelverzeichnis lädt. /learn schlägt Regeln und Fähigkeiten vor, die den während der Sitzung vorgenommenen Korrekturen entnommen sind, und schreibt Dateien nur nach Genehmigung.

/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.
Text

Wie reihen Sie Druckaufträge von der Seite ein?

Der ASP.NET-Leitfaden empfiehlt eine Warteschlange für Hochvolumendruck.

/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.
Text

Der Prompt fragt nach einem Service ähnlich diesem Beispiel, welches mit IronPrint 2026.10.1 kompiliert.

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.");
        }
    }
}
C#

Das Beispiel lässt den Zweig des Trockendurchlaufs aus. Ohne die Header-Überprüfung an IronPrint übergeben, löste die Karte für die Reservierung 1047 eine InvalidDataException mit "Nicht unterstützter Dateityp" aus.

Was erhält der Schreibtischdrucker für jede Karte?

Keiner der vier Drucker auf dem Testgerät hat einen Auftrag unbeaufsichtigt abgeschlossen. Jeder aufgezeichnete Auftrag wurde deshalb mit IronPrints internem Auftragsgenerator neu erstellt, und seine Seiten sowie das Druckticket wurden in eine XPS-Datei geschrieben, anstatt in eine Warteschlange gesendet.

ReservierungKarten-DateiSeiten im AuftragSeite an den Drucker gesendet
1042A5 Hochformat, 1 Seite1A5 Hochformat, 148 x 210 mm
1043A5 Hochformat, 2 Seiten2A5 Hochformat, 148 x 210 mm
1044A4 Querformat, 1 Seite1A5 Querformat, 210 x 148 mm
1045None0Von der Seite abgelehnt
1046A5 Hochformat, 1 Seite1A5 Hochformat, 148 x 210 mm
1047Text, kein PDF0Von der Seite abgelehnt

PaperOrientation.Automatic wandelte die Gruppenkarten in eine Seite im A5-Querformat um und skalierte sie, um zu passen. Mit PaperOrientation.Portrait wurde dieselbe Karte auf die Breite einer Hochformatseite verkleinert und ließ 107,9 mm des Blattes leer. Mit der Standardeinstellung PaperSize.PrinterDefault wurde die A5-Karte vergrößert, um die Standard-A4-Seite des Druckers auszufüllen.

NumberOfCopies ist eine Anforderung im Druckticket, und der Auftrag enthält jede Seite einmal. Grayscale rendert die PDF-Seiten in Grau und setzt die Farbe des Tickets auf monochrom. Das Herabsenken von Dpi von 300 auf 150 reduzierte den simulierten Auftrag für eine Karte von 170.257 auf 74.526 Bytes.

Die Eingangskarten für die Reservierungen 1042 und 1043 stammen aus App_Data/cards.

Ausgabe

Die beiden unten angegebenen PDFs enthalten die Seitenbilder aus den simulierten Aufträgen der endgültigen Anwendung für diese Karten, unverändert und in der im Druckticket angegebenen Seitengröße.

Anmeldekarte 1042, wie sie von IronPrint erstellt wurde, eine A5-Hochformatseite bei 300 DPI, die anstelle eines Druckers in eine Datei aufgenommen wurde.

Anmeldekarte 1043, wie sie von IronPrint erstellt wurde, zwei A5-Hochformatseiten bei 300 DPI, die anstelle eines Druckers in eine Datei aufgenommen wurden.

Wann sollten Sie mehr als einen Agenten entsenden?

Fügen Sie einen zweiten Agenten für die Überprüfungen hinzu, die keinen Browser benötigen. Hier testet ein Agent die Einstellungen im Code, während der andere die Klicks des Mitarbeiters wiederholt.

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.
Text
Bitte beachten Sie: Die Desktop-App kann Agent A und Agent B als separate Agentensitzungen ausführen. Lesen Sie beide Walkthroughs nebeneinander, bevor Sie zusammenführen.

Wie stellen Sie die Seite auf IIS bereit?

Die NuGet-Seite von IronPrint listet keine Unterstützung für Linux auf, nur für Windows, macOS, iOS und Android, sodass der Front-Desk-Server mit Windows betrieben wird. Der ASP.NET-Leitfaden fügt hinzu, dass die Identität des Anwendungspools Zugriff auf den Drucker benötigt.

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.
Text

Der Veröffentlichungsordner enthält, was der Server erhält, sodass das Überprüfen keinen IIS benötigt. Ein win-x64-Publish der Kalibrierungs-App umfasste 235 Dateien in 40 MB. Die einzigen nativen Bibliotheken waren IronPrintInterop.dll (9.926.400 Bytes) und qpdf.dll (2.802.432 Bytes), beide aus dem IronPrint-Paket. Die generierte web.config enthielt keinen Lizenzschlüssel. IIS 10 kann den Schlüssel an den Worker-Prozess über die Umgebungsvariablen des Anwendungspools übergeben. Das Veröffentlichen aus dem Projektordner kopierte auch die Trockendurchlauf-Aufgabenfiles von print-jobs in das Zielverzeichnis.

Was haben die Aufforderungen in einem realen Lauf erzeugt?

Alle sieben Prompts liefen unbeaufsichtigt in einem Antigravity CLI-Gespräch, das jede Berechtigungsabfrage übersprang. Die einzige Quelle des Lizenzschlüssels war IRONPRINT_LICENSE_KEY. Jeder Browserdurchlauf wurde als Trockendurchlauf ausgeführt, und die Druckwarteschlangen blieben leer. Jede Zeile wurde auch unabhängig angeklickt, nach dem ersten Prompt und in der endgültigen Anwendung.

  • Vor dem ersten Prompt zielte das Projekt auf net9.0 und referenzierte kein NuGet-Paket.
  • Nach dem ersten Prompt zielte es auf net9.0-windows und referenzierte IronPrint 2026.10.1.
  • Der Umsetzungsplan stellte fest, dass IronPrint einen Auftrag für einen unbekannten Druckernamen an den Standarddrucker sendet, wie wir gemessen haben.
  • Der Code des ersten Prompts wartete Printer.PrintAsync ohne Wait- oder Result-Aufruf.
  • Die Seite lehnte Reservierungen 1045 und 1047 ab und zeichnete für die anderen vier in beiden Überprüfungen Aufträge auf.
  • Jeder aufgezeichnete Auftrag forderte A5-Papier, zwei Kopien, Graustufen und automatische Ausrichtung an.
  • Die vier simulierten Aufträge umfassten fünf A5-Seiten, und die Seite der Gruppenkarte war im Querformat.
  • Alle Karten drucken erledigte alle sechs Ankünfte innerhalb von 2 Sekunden, mit vier ausgeführten Aufträgen und zwei abgelehnten.
  • Jeder Prompt ließ einen Build mit 0 Fehlern zurück.
  • Die endgültige Anwendung baute im Release-Modus mit 0 Warnungen.
  • Ohne Schlüssel gestartet, protokollierte die endgültige Anwendung eine Warnung, die IRONPRINT_LICENSE_KEY benannte.
  • Alle vier xUnit-Tests bestanden ohne Lizenzschlüssel.
  • Der run's win-x64 Publish enthielt dieselben zwei nativen Bibliotheken und eine web.config ohne Schlüssel.
  • Einige Schritte liefen anders als die Seite. Der /browser-Subagent von Antigravity konnte sich nicht mit Chrome verbinden, also steuerte der Agent Chrome bei jedem Browserdurchlauf über sein eigenes Puppeteer-Skript. Beide Plan-First-Prompts warteten nach dem Plan auf Genehmigung. /learn schlug die sechs Punkte in einem Artefakt vor und schrieb keine AGENTS.md. In dem Prompt mit zwei Agenten führte das Hauptgespräch die Tests von Agent A durch, und nachdem der Agent B-Subagent fehlschlug, klickte es selbst die Zeilen. Der Agent hinterließ Chrome-Protokolle, eine Cookie-Datei und einen Screenshot im Wurzelverzeichnis des Repositorys.

ChatGPT Codex teilt seine Arbeit zwischen Entdecker- und Arbeiter-Subagenten. In GitHub Copilot hat das Batch-Job ebenfalls einen Trockendurchlauf, der die Einstellungen jedes Formulars protokolliert und keinen Druckaufruf macht. Die Antigravity-Version, das Modell, die Laufzeit und das Testgerät befinden sich im gemeinsamen Laufprotokoll.


Fehlerbehebung


Fragen?

Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 52,106Version:2026.11gerade veröffentlicht