¿Cómo utilizar IronPrint con Google Antigravity?
Un recepcionista de hotel imprime una tarjeta de registro para que cada huésped que llega la firme en el mostrador. El recepcionista hace clic en Imprimir en un navegador, pero el trabajo sale del servidor web, por lo que una tarjeta enviada a la impresora incorrecta o en el tamaño de papel incorrecto todavía devuelve un mensaje de éxito. Estos problemas no aparecen en los registros de construcción.
Google Antigravity puede revisar la página como lo haría un recepcionista. Su comando /browser inicia un subagente Chrome aislado, que puede hacer clic en cada botón de Imprimir y tomar una captura de pantalla del resultado. IronPrint envía el PDF de la tarjeta a una impresora desde el servidor con Printer.PrintAsync, el enfoque descrito en la guía de aplicación web ASP.NET de IronPrint. Los pasos a continuación utilizan ambas herramientas para construir la página y luego probarla contra seis llegadas con resultados conocidos.
El público son desarrolladores .NET cuyos agentes de IA escriben código que imprime desde un servidor web. La elección del hardware de impresora y la configuración de colas de impresión están fuera del alcance.
Inicio rápidoAbra el proyecto FrontDesk en Antigravity y describa la página de llegadas.
/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.
Una construcción exitosa no prueba las tres respuestas, así que verifique cada una en el plan antes de aprobarlo.
IronPrint no lee IRONPRINT_LICENSE_KEY. En nuestras pruebas la variable se estableció, y License.IsLicensed permaneció falsa hasta que el código asignó License.LicenseKey. La guía de claves de licencia cubre otras opciones, como appsettings.json y Web.config.
Flujo de trabajo mínimo (5 pasos)
- Descargue la biblioteca de impresión C# desde NuGet
- Crear un proyecto ASP.NET Core net9.0-windows
- Compare el nombre de la impresora configurada con las impresoras instaladas antes de cada trabajo
- Haga que /browser haga clic en cada botón de Imprimir mientras la impresión se ejecuta como una prueba en seco
- Compare cada trabajo registrado con la lista esperada y verifique cada miembro de IronPrint con la referencia de API
¿Qué es Google Antigravity y en qué se diferencia de un asistente de chat?
En la visión general de Google, la Aplicación de Escritorio Antigravity es un programa autónomo donde un desarrollador inicia, orquesta e inspecciona equipos de agentes autónomos. Donde un asistente de chat responde en texto, los agentes de Antigravity producen Artefactos como el Plan de Implementación, el Recorrido y las capturas de pantalla.
Un agente que nombra un paquete de memoria puede instalar un símil publicado por un atacante, una técnica conocida como slopsquatting. Indique el nombre y la versión del paquete IronPrint en cualquier solicitud que agregue una dependencia. Los archivos de documentación de IronPrint para agentes están listados en la guía de asistentes de codificación de IA, que también tiene una prueba de aceptación de un solo aviso.
¿Qué deberías verificar en el plan, los cambios de código y la guía?
Un plan que espera que IronPrint rechace un nombre de impresora desconocido ha perdido la razón por la que existe la verificación del nombre. En los cambios de código, encuentre la comparación de nombres de impresora y busque cada miembro de IronPrint en la referencia de API.
Espere una captura de pantalla por clic en el Recorrido. La aplicación de escritorio guarda cada captura de pantalla como un artefacto de imagen abierto a comentarios. Un comentario en la captura de pantalla con el mensaje incorrecto le dice al agente qué fila falló, y no se necesita un nuevo aviso.
¿Cómo se prueba el botón de impresión en un navegador real?
La solicitud /browser pide una tabla que solo puede llenarse haciendo clic en cada botón.
/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.
De las seis llegadas, dos tienen tarjetas A5 de una sola página, y una tercera tiene una segunda página de reglas de la casa. Una reserva de grupo tiene una tarjeta apaisada A4, una reserva no tiene tarjeta, y un archivo de tarjeta contiene el texto de una exportación fallida en lugar de un PDF.
La página /Arrivals después del clic para la reserva 1047, una de las siete capturas de pantalla en el Recorrido final del agente.
¿A qué impresora llega una solicitud de impresión?
IronPrint 2026.10.1 no valida el nombre de la impresora. Construimos trabajos con un nombre desconocido, con adobe pdf escrito en minúsculas y sin nombre. IronPrint dirigió los tres a la impresora predeterminada de Windows sin una excepción. Asignar cualquier cadena a PrintSettings.PrinterName también tiene éxito. Por lo tanto, un error de escritura en la configuración imprime la tarjeta en la impresora predeterminada del servidor.
En la máquina de prueba, la impresora predeterminada era Microsoft Print to PDF, que solicita un nombre de archivo en un diálogo Guardar como. El ejemplo avanzado en la guía ASP.NET envía su trabajo a la misma impresora. Ningún usuario en un servidor web responde al diálogo, y en las pruebas un trabajo a esa impresora terminó solo después de que una persona escribió un nombre de archivo.
Comparar el nombre configurado con Printer.GetPrinterNames antes de cada trabajo previene ambos resultados. La comparación debe ser ordinal, porque IronPrint coincide exactamente con el nombre de la cola, inclusivo de mayúsculas y minúsculas.
¿Cómo configuras un proyecto en el que Antigravity pueda trabajar?
Dé al agente un repositorio que ya compila y sirve una página. dotnet new mvc -f net9.0 generó el proyecto FrontDesk, que tuvo una construcción limpia antes del primer aviso. Su perfil de lanzamiento http en Properties/launchSettings.json escucha en el puerto 5318, que el aviso /browser abre.
Objetivo net9.0-windows. Una sonda de consola construida para net9.0 simple compilada sin advertencias pero reportó diferentes nombres de bandeja, como "Seleccionar automáticamente" en lugar de "AutoSelect" para la impresora Adobe PDF, y generó PlatformNotSupportedException por un archivo faltante.
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.
Sin una clave de licencia, IronPrint 2026.10.1 listó las cuatro impresoras instaladas y sus bandejas. Printer.PrintAsync lanzó LicensingException con "Se requiere licencia de producción" antes de leer el archivo, por lo que las colas de impresión no recibieron trabajo. En la página de prueba, el primer clic sin licencia devolvió ese mensaje en 998 ms y clics posteriores en 19 a 30 ms. El tipo de excepción no es público, y catch (LicensingException) no compila con error CS0122.
¿Cómo se aplican las reglas de la página a tareas posteriores?
Una vez que pasa cada fila, guarde las decisiones de la sesión como reglas. La documentación de reglas de Antigravity dice que el agente carga el archivo AGENTS.md o GEMINI.md en cada carpeta del camino desde un archivo que lee o edita hasta la raíz del espacio de trabajo. /learn propone reglas y habilidades derivadas de las correcciones realizadas en la sesión, y escribe archivos solo después de la aprobación.
/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.
¿Cómo se filan los trabajos de impresión desde la página?
La guía ASP.NET recomienda una cola para impresión de alto volumen.
/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.
La solicitud pide un servicio cercano a este ejemplo, que compila contra 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.");
}
}
}
El ejemplo omite la rama de prueba en seco. Pasada a IronPrint sin la verificación de cabecera, la tarjeta para la reserva 1047 generó InvalidDataException con "Tipo de archivo no soportado".
¿Qué recibe la impresora de mostrador para cada tarjeta?
Ninguna de las cuatro impresoras de la máquina de prueba terminó un trabajo sin supervisión. Por lo tanto, cada trabajo registrado fue reconstruido con el constructor interno de trabajos de IronPrint, y sus páginas y ticket de impresión fueron escritos en un archivo XPS en lugar de ser enviados a una cola.
| Reservación | Archivo de tarjeta | Páginas en el trabajo | Página enviada a la impresora |
|---|---|---|---|
| 1042 | A5 retrato, 1 página | 1 | A5 retrato, 148 x 210 mm |
| 1043 | A5 retrato, 2 páginas | 2 | A5 retrato, 148 x 210 mm |
| 1044 | A4 apaisada, 1 página | 1 | A5 apaisada, 210 x 148 mm |
| 1045 | None | 0 | Rechazado por la página |
| 1046 | A5 retrato, 1 página | 1 | A5 retrato, 148 x 210 mm |
| 1047 | Texto, no un PDF | 0 | Rechazado por la página |
PaperOrientation.Automatic convirtió la tarjeta de grupo en una página apaisada A5 y la ajustó a la medida. Con PaperOrientation.Portrait, la misma tarjeta se redujo al ancho de una página retrato y dejó 107.9 mm de la hoja en blanco. Con el PaperSize.PrinterDefault predeterminado, la tarjeta A5 se agrandó para llenar la página A4 predeterminada de la impresora.
NumberOfCopies es una solicitud en el ticket de impresión, y el trabajo contiene cada página una vez. Grayscale renderizó las páginas PDF en gris y estableció el color del ticket en monocromo. Reducir Dpi de 300 a 150 redujo el trabajo simulado para una tarjeta de 170,257 a 74,526 bytes.
Las tarjetas de entrada para las reservaciones 1042 y 1043 provienen de App_Data/cards.
Resultado
Los dos PDF a continuación contienen las imágenes de las páginas de los trabajos simulados de la aplicación final para esas tarjetas, sin cambios y en el tamaño de página en cada ticket de impresión.
Tarjeta de registro 1042 como IronPrint construyó el trabajo, una página A5 retrato a 300 DPI capturada a un archivo en lugar de a una impresora.
Tarjeta de registro 1043 como IronPrint construyó el trabajo, dos páginas A5 retrato a 300 DPI capturadas a un archivo en lugar de a una impresora.
¿Cuándo deberías enviar más de un agente?
Agregue un segundo agente para los chequeos que no necesitan navegador. Aquí un agente prueba la configuración en código mientras el otro repite los clics del recepcionista.
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.
¿Cómo se despliega la página en IIS?
La página de NuGet de IronPrint no lista soporte para Linux, solo Windows, macOS, iOS y Android, por lo que el servidor de recepción utiliza Windows. La guía ASP.NET agrega que la identidad del grupo de aplicaciones necesita acceso a la impresora.
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.
La carpeta de publicación contiene lo que el servidor recibe, por lo que verificarla no necesita IIS. Una publicación win-x64 de la aplicación de calibración contenía 235 archivos en 40 MB. Las únicas bibliotecas nativas eran IronPrintInterop.dll (9,926,400 bytes) y qpdf.dll (2,802,432 bytes), ambas del paquete IronPrint. El web.config generado no contenía una clave de licencia. IIS 10 puede pasar la clave al proceso de trabajo a través de las variables de entorno del grupo de aplicaciones. Publicar desde la carpeta del proyecto también copió los archivos de trabajos de prueba en seco desde print-jobs en la salida.
¿Qué produjeron los prompts en una ejecución real?
Las siete solicitudes se ejecutaron sin supervisión en una conversación de línea de comandos de Antigravity que omitió cada solicitud de permiso. La única fuente de la clave de licencia era IRONPRINT_LICENSE_KEY. Cada paso en el navegador se ejecutó como una prueba en seco, y las colas de impresión se mantuvieron vacías. Cada fila también se hizo clic de manera independiente, después del primer aviso y en la aplicación final.
- Antes del primer aviso, el proyecto tenía como destino net9.0 y no hacía referencia a ningún paquete NuGet.
- Después del primer aviso, tenía como destino net9.0-windows y hacía referencia a IronPrint 2026.10.1.
- El Plan de Implementación indicaba que IronPrint envía un trabajo para un nombre de impresora desconocido a la impresora predeterminada, como medimos.
- El código del primer aviso esperaba Printer.PrintAsync sin llamadas a Wait o Result.
- La página rechazó las reservaciones 1045 y 1047 y registró trabajos para las otras cuatro, en ambas comprobaciones.
- Cada trabajo registrado solicitó papel A5, dos copias, escala de grises y orientación automática.
- Los cuatro trabajos simulados tenían 5 páginas A5, y la página de la tarjeta de grupo era apaisada.
- Imprimir todas las tarjetas completó todas las seis llegadas en 2 segundos, con cuatro trabajos realizados y dos rechazados.
- Cada aviso dejó una construcción con 0 errores.
- La aplicación final se construyó en Release con 0 advertencias.
- Iniciada sin clave, la aplicación final registró una advertencia que nombraba IRONPRINT_LICENSE_KEY.
- Todas las cuatro pruebas xUnit se pasaron sin una clave de licencia.
- La publicación win-x64 de la ejecución retuvo las mismas dos bibliotecas nativas y un web.config sin clave.
- Algunos pasos se ejecutaron de manera diferente a lo esperado. El subagente /browser de Antigravity no pudo conectarse con Chrome, por lo que el agente controló Chrome mediante su propio script de Puppeteer en cada paso del navegador. Ambos avisos de plan primero esperaron aprobación después del plan. /learn propuso los seis puntos en un Artefacto y no escribió AGENTS.md. En la solicitud de dos agentes, la conversación principal ejecutó las pruebas del Agente A y, después de que fallara el subagente del Agente B, hizo clic en las filas ella misma. El agente dejó registros de Chrome, un archivo de cookie y una captura de pantalla en la raíz del repositorio.
ChatGPT Codex divide su trabajo entre agentes subalternos exploradores y trabajadores. En GitHub Copilot, el trabajo por lotes también tiene una prueba en seco que registra la configuración de cada formulario y no realiza ninguna llamada de impresión. La versión de Antigravity, el modelo, el tiempo de ejecución y la máquina de prueba están en el registro de ejecución compartido.
Solución de problemas
- Imprimir en una aplicación web ASP.NET para el patrón de controlador que sigue esta página
- Cómo obtener nombres de impresora cuando los trabajos llegan a la impresora equivocada
- Configuración de impresión para tamaño de papel, orientación, copias y DPI
- Configurar clave de licencia en Web.config cuando la clave no se aplica en el servidor
- El método Print() cuelga en WPF y WinForms cuando una llamada de impresión bloquea el hilo de llamada
¿Preguntas?
Si tienes alguna pregunta, contacta a support@ironsoftware.com
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.