Como usar IronPrint com Google Antigravity
A recepção de um hotel imprime um cartão de registro para cada hóspede que chega assinar no balcão. O recepcionista clica em Imprimir em um navegador, mas o trabalho sai do servidor web, então um cartão enviado para a impressora errada ou no tamanho de papel errado ainda retorna uma mensagem de sucesso. Esses problemas não aparecem nos logs de compilação.
Google Antigravity pode revisar a página como o faria um recepcionista. Seu comando /browser inicia um subagente Chrome isolado, que pode clicar em cada botão Imprimir e tirar uma captura de tela do resultado. IronPrint envia o PDF do cartão para uma impressora a partir do servidor com Printer.PrintAsync, a abordagem descrita no guia de aplicação web ASP.NET do IronPrint. Os passos abaixo usam ambas as ferramentas para construir a página, depois testá-la contra seis chegadas com resultados já conhecidos.
O público-alvo são desenvolvedores .NET cujos agentes de IA escrevem código que imprime de um servidor web. Escolher o hardware da impressora e configurar filas de impressão estão fora do escopo.
Início RápidoAbra o projeto FrontDesk no Antigravity e descreva a página de chegadas.
/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.
Uma compilação bem-sucedida não testa as três respostas, então verifique cada uma no plano antes de aprová-lo.
IronPrint não lê IRONPRINT_LICENSE_KEY. Em nossos testes, a variável estava configurada, e License.IsLicensed permaneceu falso até o código atribuir License.LicenseKey. O guia de chave de licença cobre outras opções, como appsettings.json e Web.config.
Fluxo de trabalho mínimo (5 etapas)
- Baixe a biblioteca de impressão C# do NuGet
- Crie um projeto .NET Core ASP.NET net9.0-windows
- Verifique o nome da impressora configurada com as impressoras instaladas antes de cada trabalho
- Faça o /browser clicar em todos os botões Imprimir enquanto a impressão é executada como uma execução a seco
- Compare cada trabalho registrado com a lista esperada e verifique cada membro do IronPrint em relação à referência de API
O que é o Google Antigravity e como é diferente de um assistente de chat?
Na visão geral do Google, o aplicativo Antigravity para desktop é um programa autônomo onde um desenvolvedor inicia, orquestra e inspeciona equipes de agentes autônomos. Onde um assistente de chat responde em texto, os agentes do Antigravity produzem Artefatos como o Plano de Implementação, o Guia passo a passo e capturas de tela.
Um agente que nomeia um pacote da memória pode instalar um sósia publicado por um atacante, uma técnica conhecida como slopsquatting. Dê o nome do pacote IronPrint e a versão em qualquer prompt que adicione uma dependência. Os arquivos de documentação do IronPrint para agentes estão listados no guia de assistentes de codificação de IA, que também possui um teste de aceitação de um único prompt.
O que você deve verificar no plano, nas mudanças de código e no Guia Passo a Passo?
Um plano que espera que o IronPrint rejeite um nome de impressora desconhecido perdeu o motivo pelo qual a verificação de nome existe. Nas mudanças de código, encontre a comparação de nome da impressora e procure cada membro do IronPrint na referência de API.
Espere uma captura de tela por clique no Guia passo a passo. O aplicativo desktop salva cada captura de tela como um artefato de imagem aberto para comentários. Um comentário na captura de tela com a mensagem errada informa ao agente qual linha falhou e nenhum novo prompt é necessário.
Como você testa o botão de impressão em um navegador real?
O prompt /browser pede uma tabela que pode ser preenchida apenas clicando em cada botão.
/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.
Das seis chegadas, duas têm cartões A5 de uma página, e uma terceira tem uma segunda página de regras da casa. Uma reserva em grupo tem um cartão paisagem A4, uma reserva não tem cartão, e um arquivo de cartão contém o texto de uma exportação falhada em vez de um PDF.
A página /Arrivals após o clique para a reserva 1047, uma das sete capturas de tela no Guia passo a passo final do agente.
Para qual impressora uma solicitação de impressão é enviada?
IronPrint 2026.10.1 não valida o nome da impressora. Construímos trabalhos com um nome desconhecido, com adobe pdf escrito em minúsculas e sem nome. IronPrint endereçou todos os três à impressora padrão do Windows sem uma exceção. Atribuir qualquer string a PrintSettings.PrinterName também tem sucesso. Um erro de digitação na configuração, portanto, imprime o cartão na impressora padrão do servidor.
Na máquina de teste, a impressora padrão era Microsoft Print to PDF, que solicita um nome de arquivo em um diálogo Salvar Como. O exemplo avançado no guia ASP.NET envia seu trabalho para a mesma impressora. Nenhum usuário em um servidor web responde ao diálogo, e nas sondagens um trabalho para aquela impressora terminou apenas depois que uma pessoa digitou um nome de arquivo.
Comparar o nome configurado com Printer.GetPrinterNames antes de cada trabalho previne ambos os resultados. A comparação deve ser ordinal, porque IronPrint corresponde exatamente ao nome da fila, incluindo o caso.
Como você configura um projeto no qual Antigravity pode trabalhar?
Forneça ao agente um repositório que já compila e serve uma página. dotnet new mvc -f net9.0 gerou o projeto FrontDesk, que teve uma compilação limpa antes do primeiro prompt. Seu perfil de inicialização http em Properties/launchSettings.json ouve na porta 5318, que o prompt /browser abre.
Alvo net9.0-windows. Uma sondagem de console construída para plain net9.0 compilou sem avisos, mas relatou nomes de bandejas diferentes, como "Seleção Automática" em vez de "AutoSelect" para a impressora Adobe PDF, e levantou PlatformNotSupportedException para um arquivo ausente.
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.
Sem uma chave de licença, o IronPrint 2026.10.1 listou as quatro impressoras instaladas e suas bandejas. Printer.PrintAsync lançou LicensingException com "Licença de produção necessária" antes de ler o arquivo, então as filas de impressão não receberam nenhum trabalho. Na página de teste, o primeiro clique sem licença retornou aquela mensagem em 998 ms e os cliques posteriores em 19 a 30 ms. O tipo de exceção não é público, e catch (LicensingException) falha ao compilar com erro CS0122.
Como você aplica as regras da página a tarefas posteriores?
Uma vez que cada linha passar, salve as decisões da sessão como regras. A documentação de regras do Antigravity diz que o agente carrega o arquivo AGENTS.md ou GEMINI.md em cada pasta no caminho de um arquivo que lê ou edita até a raiz do workspace. /learn propõe regras e habilidades a partir das correções feitas na sessão, e escreve arquivos apenas após a aprovação.
/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.
Como você coloca na fila trabalhos de impressão a partir da página?
O guia ASP.NET recomenda uma fila para impressão em alto 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.
O prompt pede um serviço próximo a este exemplo, que compila contra o 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.");
}
}
}
O exemplo deixa de fora o ramo de execução a seco. Passado para o IronPrint sem a verificação de cabeçalho, o cartão para a reserva 1047 gerou InvalidDataException com "Tipo de arquivo não suportado".
O que a impressora de mesa recebe para cada cartão?
Nenhuma das quatro impressoras da máquina de teste finalizou um trabalho sem supervisão. Cada trabalho registrado foi, portanto, reconstruído com o construtor de trabalho interno do IronPrint, e suas páginas e bilhete de impressão foram escritos em um arquivo XPS em vez de enviados para uma fila.
| Reserva | Arquivo do cartão | Páginas no trabalho | Página enviada para a impressora |
|---|---|---|---|
| 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 paisagem, 1 página | 1 | A5 paisagem, 210 x 148 mm |
| 1045 | None | 0 | Recusado pela página |
| 1046 | A5 retrato, 1 página | 1 | A5 retrato, 148 x 210 mm |
| 1047 | Texto, não um PDF | 0 | Recusado pela página |
PaperOrientation.Automatic transformou o cartão do grupo em uma página paisagem A5 e redimensionou para caber. Com PaperOrientation.Portrait, o mesmo cartão foi encolhido para a largura de uma página retrato e deixou 107,9 mm da folha em branco. Com o padrão PaperSize.PrinterDefault, o cartão A5 foi ampliado para preencher a página padrão A4 da impressora.
NumberOfCopies é um pedido no bilhete de impressão, e o trabalho contém cada página uma vez. Grayscale renderizou as páginas do PDF em cinza e definiu a cor do bilhete para monocromático. Reduzir Dpi de 300 para 150 reduziu o trabalho simulado para um cartão de 170.257 para 74.526 bytes.
Os cartões de entrada para as reservas 1042 e 1043 vêm de App_Data/cards.
Saída
Os dois PDFs abaixo contêm as imagens das páginas dos trabalhos simulados da aplicação final para esses cartões, inalteradas e no tamanho de página em cada bilhete de impressão.
Cartão de registro 1042 como o IronPrint construiu o trabalho, uma página retrato A5 a 300 DPI capturada para um arquivo em vez de uma impressora.
Cartão de registro 1043 como o IronPrint construiu o trabalho, duas páginas retrato A5 a 300 DPI capturadas para um arquivo em vez de uma impressora.
Quando você deve despachar mais de um agente?
Adicione um segundo agente para as verificações que não precisam de navegador. Aqui, um agente testa as configurações no código enquanto o outro repete os cliques do 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.
Como você implanta a página no IIS?
A página do NuGet do IronPrint não lista suporte para Linux, apenas Windows, macOS, iOS e Android, então o servidor de recepção roda Windows. O guia ASP.NET adiciona que a identidade do pool de aplicativos precisa de acesso à impressora.
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.
A pasta de publicação contém o que o servidor recebe, então verificá-la não precisa de IIS. Uma publicação win-x64 do aplicativo de calibração continha 235 arquivos em 40 MB. As únicas bibliotecas nativas eram IronPrintInterop.dll (9.926.400 bytes) e qpdf.dll (2.802.432 bytes), ambas do pacote IronPrint. O web.config gerado não continha chave de licença. O IIS 10 pode passar a chave para o processo de trabalho através das variáveis de ambiente do pool de aplicativos. Publicar a partir da pasta do projeto também copiou os arquivos de trabalho de execução a seco de print-jobs para a saída.
O que os prompts produziram em uma execução real?
Todos os sete prompts rodaram sem supervisão em uma conversa no Antigravity CLI que pulou todo prompt de permissão. A única fonte da chave de licença era IRONPRINT_LICENSE_KEY. Cada passagem de navegador rodou como uma execução a seco, e as filas de impressão permaneceram vazias. Cada linha também foi clicada de forma independente, após o primeiro prompt e na aplicação final.
- Antes do primeiro prompt, o projeto direcionou net9.0 e não referenciava nenhum pacote NuGet.
- Após o primeiro prompt, ele direcionou net9.0-windows e referenciou IronPrint 2026.10.1.
- O Plano de Implementação afirmou que IronPrint envia um trabalho para um nome de impressora desconhecido para a impressora padrão, como medimos.
- O código do primeiro prompt aguardava Printer.PrintAsync sem chamada de Wait ou Result.
- A página recusou as reservas 1045 e 1047 e registrou trabalhos para as outras quatro, em ambas as verificações.
- Cada trabalho registrado solicitou papel A5, duas cópias, escala de cinza e orientação automática.
- Os quatro trabalhos simulados continham 5 páginas A5, e a página do cartão do grupo era paisagem.
- Imprimir todos os cartões completou todas as seis chegadas em 2 segundos, com quatro trabalhos concluídos e dois recusados.
- Cada prompt deixou uma compilação com 0 erros.
- A aplicação final foi compilada em Release com 0 avisos.
- Iniciada sem uma chave, a aplicação final registrou um aviso que nomeava IRONPRINT_LICENSE_KEY.
- Todos os quatro testes xUnit passaram sem uma chave de licença.
- A publicação win-x64 do run manteve as mesmas duas bibliotecas nativas e um web.config sem chave.
- Alguns passos foram executados de forma diferente da página. O subagente /browser do Antigravity falhou em se conectar ao Chrome, então o agente controlou o Chrome através de seu próprio script do Puppeteer em cada passagem de navegador. Ambos os prompts plan-first aguardaram aprovação após o plano. /learn propôs os seis pontos em um Artefato e não escreveu AGENTS.md. No prompt de dois agentes, a conversa principal executou os testes do Agente A e, após o subagente Agente B falhar, clicou nas linhas por conta própria. O agente deixou logs do Chrome, um arquivo de cookie e uma captura de tela na raiz do repositório.
ChatGPT Codex divide seu trabalho entre subagentes exploradores e de trabalho. No GitHub Copilot, o trabalho em lote também tem uma execução a seco que registra as configurações de cada formulário e não faz nenhuma chamada de impressão. A versão do Antigravity, modelo, tempo de execução e máquina de teste estão no registro de execução compartilhado.
Solução de problemas
- Imprimir em um aplicativo web ASP.NET para o padrão do controlador que esta página segue
- Como obter nomes de impressoras quando trabalhos chegam à impressora errada
- Configurações de impressão para tamanho de papel, orientação, cópias e DPI
- Configuração de chave de licença em Web.config quando a chave não é aplicada no servidor
- Método Print() trava em WPF e WinForms quando uma chamada de impressão bloqueia o thread chamador
Questões?
Se você tiver dúvidas, entre em contato com support@ironsoftware.com
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.