Comment utiliser IronPrint avec Google Antigravity

Curtis Chau
Curtis Chau
Mis à jour : 26 octobre 2026

Un réceptionniste d'hôtel imprime une carte d'enregistrement pour chaque client qui arrive pour signer au comptoir. Le réceptionniste clique sur Imprimer dans un navigateur, mais le travail part du serveur web, donc une carte envoyée à la mauvaise imprimante ou sur le mauvais format de papier renvoie toujours un message de réussite. Ces problèmes n'apparaissent pas dans les journaux de construction.

Google Antigravity peut examiner la page comme le ferait un réceptionniste. Sa commande /browser lance un sous-agent Chrome en mode sandbox, qui peut cliquer sur chaque bouton Imprimer et prendre une capture d'écran du résultat. IronPrint envoie le PDF de la carte à une imprimante depuis le serveur avec Printer.PrintAsync, l'approche décrite dans le guide des applications web ASP.NET d'IronPrint. Les étapes ci-dessous utilisent les deux outils pour construire la page, puis la tester avec six arrivées aux résultats connus.

Le public visé est les développeurs .NET dont les agents IA écrivent du code qui imprime depuis un serveur web. Le choix du matériel d'impression et la configuration des files d'impression ne sont pas du ressort de ce guide.

Démarrage rapide
NuGetInstaller avec NuGet

PM > Install-Package IronPrint

Installez IronPrint en exécutant la commande ci-dessus dans la console du gestionnaire de packages NuGet, ou recherchez le package dans le gestionnaire de packages NuGet.

Ouvrez le projet FrontDesk dans Antigravity et décrivez la page des arrivées.

/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

Une construction réussie ne teste pas les trois réponses, alors vérifiez chacune dans le plan avant de l'approuver.

IronPrint ne lit pas IRONPRINT_LICENSE_KEY. Dans nos tests, la variable a été définie, et License.IsLicensed est restée fausse jusqu'à ce que le code attribue License.LicenseKey. Le guide des clés de licence couvre d'autres options, comme appsettings.json et Web.config.



Qu'est-ce que Google Antigravity, et en quoi est-il différent d'un assistant de chat?

Dans l'aperçu de Google, l'application de bureau Antigravity est un programme autonome dans lequel un développeur lance, orchestre et inspecte des équipes d'agents autonomes. Là où un assistant de chat répond en texte, les agents d'Antigravity produisent des artéfacts tels que le plan de mise en œuvre, le démo-guidée et des captures d'écran.

Un agent qui nomme un paquet de mémoire peut installer un sosie publié par un attaquant, une technique connue sous le nom de slopsquatting. Donnez le nom du paquet IronPrint et la version dans toute invite qui ajoute une dépendance. Les fichiers de documentation d'IronPrint pour les agents sont listés dans le guide des assistants de codage AI, qui contient également un test d'acceptation en une seule invite.

Que devriez-vous vérifier dans le plan, les modifications du code et le guide pas-à-pas ?

Un plan qui attend d'IronPrint qu'il rejette un nom d'imprimante inconnu a manqué la raison pour laquelle le contrôle du nom existe. Dans les changements de code, trouvez la comparaison des noms d'imprimante et consultez chaque membre IronPrint dans la référence d'API.

Attendez-vous à une capture d'écran par clic dans le démo-guidée. L'application de bureau enregistre chaque capture d'écran comme un artefact d'image ouvert aux commentaires. Un commentaire sur la capture d'écran avec le mauvais message indique à l'agent quelle ligne a échoué, et aucune nouvelle invite n'est nécessaire.

Comment testez-vous le bouton imprimer dans un navigateur réel ?

L'invite /browser demande une table qui ne peut être remplie qu'en cliquant sur chaque bouton.

/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

Parmi les six arrivées, deux ont des cartes A5 d'une seule page, et une troisième a une deuxième page de règles de maison. Une réservation de groupe a une carte paysage A4, une réservation n'a pas de carte, et un fichier de carte contient le texte d'une exportation échouée au lieu d'un PDF.

Page des arrivées FrontDesk listant six réservations avec un statut et un bouton Imprimer carte d'enregistrement sur chaque ligne

La page /Arrivals après le clic pour la réservation 1047, l'une des sept captures d'écran dans le démo-guidée finale de l'agent.

Veuillez noter: Lisez d'abord les lignes pour les réservations 1045 et 1047. Les deux doivent être refusées par la page elle-même.

Quelle imprimante reçoit une demande d'impression ?

IronPrint 2026.10.1 ne valide pas le nom de l'imprimante. Nous avons créé des travaux avec un nom inconnu, avec adobe pdf écrit en minuscules et sans nom. IronPrint a adressé les trois à l'imprimante par défaut de Windows sans exception. Attribuer n'importe quelle chaîne à PrintSettings.PrinterName réussit également. Une erreur de frappe dans la configuration imprime donc la carte sur l'imprimante par défaut du serveur.

Sur la machine de test, l'imprimante par défaut était Microsoft Print to PDF, qui demande un nom de fichier dans une boîte de dialogue Enregistrer sous. L'exemple avancé dans le guide ASP.NET envoie son travail à la même imprimante. Aucun utilisateur sur un serveur web ne répond à la boîte de dialogue, et dans les essais, un travail pour cette imprimante s'est terminé seulement après qu'une personne ait tapé un nom de fichier.

Comparer le nom configuré avec Printer.GetPrinterNames avant chaque travail empêche les deux issues. La comparaison doit être ordinale, car IronPrint fait correspondre exactement le nom de la file d'attente, casse incluse.

Comment configurez-vous un projet dans lequel Antigravity peut travailler?

Donnez à l'agent un dépôt qui compile déjà et sert une page. dotnet new mvc -f net9.0 a généré le projet FrontDesk, qui avait une construction propre avant la première invite. Son profil de lancement http dans Properties/launchSettings.json écoute sur le port 5318, que l'invite /browser ouvre.

Ciblez net9.0-windows. Une sonde console construite pour un simple net9.0 compilé sans avertissements mais a signalé différents noms de bac, comme 'Sélection Automatique' au lieu de 'AutoSelect' pour l'imprimante PDF Adobe, et a soulevé PlatformNotSupportedException pour un fichier manquant.

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

Sans clé de licence, IronPrint 2026.10.1 a listé les quatre imprimantes installées et leurs bacs. Printer.PrintAsync a lancé LicensingException avec 'Licence de production requise' avant de lire le fichier, donc les files d'impression n'ont reçu aucun travail. Sur la page de test, le premier clic non licencié a renvoyé ce message en 998 ms et les clics suivants entre 19 et 30 ms. Le type d'exception n'est pas public, et catch (LicensingException) échoue à compiler avec l'erreur CS0122.

Comment appliquez-vous les règles de la page aux tâches ultérieures ?

Une fois que chaque ligne est validée, enregistrez les décisions de la session comme règles. La documentation des règles d'Antigravity indique que l'agent charge le fichier AGENTS.md ou GEMINI.md dans chaque dossier sur le chemin à partir d'un fichier qu'il lit ou modifie jusqu'à la racine de l'espace de travail. /learn propose des règles et des compétences tirées des corrections effectuées dans la session, et n'écrit les fichiers qu'après approbation.

/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

Comment mettez-vous en file d'attente les travaux d'impression à partir de la page ?

Le guide ASP.NET recommande une file d'attente pour l'impression à fort volume.

/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

L'invite demande un service proche de cet exemple, qui compile contre 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.");
        }
    }
}
C#

L'exemple omet la branche en mode essai. Passée à IronPrint sans contrôle d'en-tête, la carte pour la réservation 1047 a levé InvalidDataException avec 'Type de fichier non pris en charge'.

Que reçoit l'imprimante de bureau pour chaque carte ?

Aucune des quatre imprimantes de la machine de test n'a terminé un travail sans surveillance. Chaque travail enregistré a donc été reconstruit avec le générateur de travaux interne d'IronPrint, et ses pages et son billet d'impression ont été écrits dans un fichier XPS plutôt que d'être envoyés à une file d'attente.

RéservationFichier de cartePages dans le travailPage envoyée à l'imprimante
1042A5 portrait, 1 page1A5 portrait, 148 x 210 mm
1043A5 portrait, 2 pages2A5 portrait, 148 x 210 mm
1044A4 paysage, 1 page1A5 paysage, 210 x 148 mm
1045None0Refusé par la page
1046A5 portrait, 1 page1A5 portrait, 148 x 210 mm
1047Texte, pas un PDF0Refusé par la page

PaperOrientation.Automatic a transformé la carte de groupe en une page A5 paysage et l'a redimensionnée pour s'adapter. Avec PaperOrientation.Portrait, la même carte a été réduite à la largeur d'une page portrait et a laissé 107,9 mm de la feuille vide. Avec la PaperSize.PrinterDefault par défaut, la carte A5 a été agrandie pour remplir la page A4 par défaut de l'imprimante.

NumberOfCopies est une demande dans le billet d'impression, et le travail contient chaque page une fois. Grayscale a rendu les pages PDF en gris et a défini la couleur du billet en monochrome. Réduire Dpi de 300 à 150 a réduit le travail simulé pour une carte de 170,257 à 74,526 octets.

Les cartes d'entrée pour les réservations 1042 et 1043 proviennent de App_Data/cards.

Sortie

Les deux PDF ci-dessous contiennent les images de page des travaux simulés de l'application finale pour ces cartes, inchangées et à la taille de page dans chaque billet d'impression.

Carte d'enregistrement 1042 telle que IronPrint a construit le travail, une page A5 portrait à 300 DPI capturée dans un fichier à la place d'une imprimante.

Carte d'enregistrement 1043 telle que IronPrint a construit le travail, deux pages A5 portrait à 300 DPI capturées dans un fichier à la place d'une imprimante.

Quand devriez-vous dépêcher plus d'un agent ?

Ajoutez un deuxième agent pour les vérifications qui ne nécessitent pas de navigateur. Ici, un agent teste les paramètres dans le code pendant que l'autre répète les clics du réceptionniste.

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
Veuillez noter: L'application de bureau peut exécuter Agent A et Agent B comme des sessions d'agent distinctes. Lisez les deux démos-guidées côte à côte avant de fusionner.

Comment déployez-vous la page sur IIS ?

La page NuGet d'IronPrint ne liste pas de support Linux, seulement Windows, macOS, iOS et Android, donc le serveur de réception fonctionne sous Windows. Le guide ASP.NET ajoute que l'identité du pool d'applications a besoin d'accès à l'imprimante.

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

Le dossier de publication contient ce que le serveur reçoit, donc le vérifier ne nécessite pas IIS. Une publication win-x64 de l'application de calibration contenait 235 fichiers dans 40 MB. Les seules bibliothèques natives étaient IronPrintInterop.dll (9,926,400 octets) et qpdf.dll (2,802,432 octets), toutes deux issues du paquet IronPrint. Le web.config généré ne contenait pas de clé de licence. IIS 10 peut passer la clé au processus de travail via les variables d'environnement du pool d'applications. Publier depuis le dossier du projet a également copié les fichiers de travaux en mode essai de print-jobs vers la sortie.

Qu'est-ce que les messages ont produit lors d'une réelle exécution ?

Les sept invites ont fonctionné sans surveillance lors d'une conversation CLI Antigravity qui a sauté chaque invite de permission. La seule source de la clé de licence était IRONPRINT_LICENSE_KEY. Chaque passage du navigateur s'est fait en mode essai, et les files d'impression sont restées vides. Chaque ligne a également été cliquée indépendamment, après la première invite et dans l'application finale.

  • Avant la première invite, le projet ciblait net9.0 et ne référençait aucun paquet NuGet.
  • Après la première invite, il ciblait net9.0-windows et référençait IronPrint 2026.10.1.
  • Le plan de mise en œuvre a indiqué qu'IronPrint envoie un travail pour un nom d'imprimante inconnu à l'imprimante par défaut, comme nous l'avons mesuré.
  • Le code de la première invite attendait Printer.PrintAsync sans appel Wait ou Result.
  • La page a refusé les réservations 1045 et 1047 et a enregistré des travaux pour les quatre autres, dans les deux vérifications.
  • Chaque travail enregistré demandait du papier A5, deux copies, niveaux de gris et orientation automatique.
  • Les quatre travaux simulés contenaient 5 pages A5, et la page de la carte de groupe était en paysage.
  • Imprimer toutes les cartes a complété les six arrivées en moins de 2 secondes, avec quatre travaux effectués et deux refusés.
  • Chaque invite a laissé une construction avec 0 erreur.
  • L'application finale a été construite en Release avec 0 avertissement.
  • Démarrée sans clé, l'application finale a enregistré un avertissement nommant IRONPRINT_LICENSE_KEY.
  • Les quatre tests xUnit ont passé sans clé de licence.
  • La publication win-x64 du run contenait les mêmes deux bibliothèques natives et un web.config sans clé.
  • Certaines étapes ont été exécutées différemment de la page. Le sous-agent /browser d'Antigravity n'a pas pu se connecter à Chrome, donc l'agent a contrôlé Chrome à travers son propre script Puppeteer à chaque passage de navigateur. Les deux invites plan-premier ont attendu l'approbation après le plan. /learn a proposé les six points dans un artéfact et n'a écrit aucun AGENTS.md. Dans l'invite à deux agents, la conversation principale a exécuté les tests de l'Agent A et, après l'échec du sous-agent Agent B, a cliqué elle-même les lignes. L'agent a laissé les journaux Chrome, un fichier de cookies et une capture d'écran à la racine du dépôt.

ChatGPT Codex divise son travail entre explorateur et sous-agents travailleurs. Dans GitHub Copilot, le travail de lot a également un essai à sec qui consigne les paramètres de chaque formulaire et ne fait aucun appel d'impression. La version, le modèle, le temps d'exécution et la machine de test Antigravity sont dans le journal d'exécution partagé.


Dépannage


Des questions ?

Si vous avez des questions, contactez support@ironsoftware.com

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 52,106Version :2026.11tout juste publié