IronPrint을 Google Antigravity와 함께 사용하는 방법
호텔 프론트 데스크는 도착한 손님마다 등록 카드를 인쇄하여 카운터에서 서명하도록 합니다. 직원이 브라우저에서 인쇄를 클릭하지만 작업은 웹 서버에서 진행되어 잘못된 인쇄기나 잘못된 용지 크기로 카드가 전송되더라도 성공 메시지가 표시됩니다. 이러한 문제는 빌드 로그에 나타나지 않습니다.
Google Antigravity는 마치 직원처럼 페이지를 검토할 수 있습니다. 그의 /browser 명령어는 샌드박스 처리된 Chrome 하위 에이전트를 시작하며, 각 인쇄 버튼을 클릭하고 결과의 스크린샷을 찍을 수 있습니다. IronPrint는 Sirens의 ASP.NET 웹 애플리케이션 가이드에 설명되어 있는 방법인 Printer.PrintAsync을 사용하여 서버에서 인쇄기로 카드 PDF를 전송합니다. 아래 단계는 두 도구를 사용하여 페이지를 구축한 후, 알려진 결과를 가진 6개의 도착을 테스트합니다.
.NET 개발자를 대상으로 하며, AI 에이전트가 웹 서버에서 인쇄하는 코드를 작성하는 사람들입니다. 프린터 하드웨어를 선택하고 인쇄 큐를 구성하는 것은 범위에서 제외됩니다.
빠른 시작Antigravity에서 FrontDesk 프로젝트를 열고 도착 페이지를 설명하세요.
/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.
성공적인 빌드는 세 개의 응답을 테스트하지 않으므로 승인을 하기 전에 계획에서 각각을 확인하세요.
IronPrint는 IRONPRINT_LICENSE_KEY을 읽지 않습니다. 우리의 테스트에서 변수는 설정되었으며, 코드가 License.LicenseKey을 할당할 때까지 License.IsLicensed는 거짓으로 유지되었습니다. 라이센스 키 가이드는 appsettings.json 및 Web.config와 같은 다른 옵션도 다룹니다.
최소 워크플로우(5단계)
- NuGet에서 C# 인쇄 라이브러리 다운로드
- net9.0-windows ASP.NET Core 프로젝트 만들기
- 각 작업 전에 설치된 프린터와 구성된 프린터 이름을 일치시킵니다
- /browser가 모든 인쇄 버튼을 클릭하게 합니다. 인쇄는 드라이런으로 실행됩니다.
- 기록된 각 작업을 예상 목록과 비교하고 각 IronPrint 멤버를 API 레퍼런스와 대조합니다.
Google Antigravity란 무엇이며 채팅 보조와 어떻게 다른가요?
Google의 개요에서 데스크톱 Antigravity 앱은 개발자가 시작하고, 지휘하고, 자율 에이전트 팀을 검토할 수 있는 독립 실행형 프로그램입니다. 챗봇 보조자가 텍스트로 답변하는 곳에서 Antigravity 에이전트는 아티팩트를 생성합니다. 예를 들어 구현 계획, 설명서 및 스크린샷 등이 있습니다.
메모리에서 패키지 이름을 지정하는 에이전트는 공격자가 게시한 유사한 프로그램을 설치할 수 있습니다. 이것은 slopsquatting이라고 합니다. 의존성을 추가하는 모든 프롬프트에 IronPrint 패키지 이름 및 버전을 제공하세요. IronPrint의 에이전트용 문서 파일은 AI 코딩 보조자 가이드에 나열되어 있으며, 또한 한 번의 프롬프트로 수락 테스트가 있습니다.
계획, 코드 변경, 워크스루에서 무엇을 확인해야 합니까?
IronPrint가 알려지지 않은 프린터 이름을 거부하길 기대하는 계획은 이름 확인이 존재하는 이유를 놓쳤습니다. 코드 변경에서 프린터 이름 비교를 찾고, API 레퍼런스에서 각 IronPrint 멤버를 확인하세요.
설명서에서 클릭당 한 개의 스크린샷을 기대하세요. 데스크톱 앱은 모든 스크린샷을 이미지 아티팩트로 저장하고 이를 코멘트로 열어 놓습니다. 잘못된 메시지가 담긴 스크린샷에 대한 코멘트는 에이전트에게 실패한 행을 알려주며, 새로운 프롬프트가 필요 없습니다.
실제 브라우저에서 인쇄 버튼을 어떻게 테스트합니까?
/browser 프롬프트는 모든 버튼을 클릭해야만 채울 수 있는 테이블을 요구합니다.
/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.
여섯 개의 도착 중 두 개는 단일 페이지 A5 카드가 있으며, 세 번째는 가정 규칙이 있는 두 번째 페이지가 있습니다. 단체 예약은 A4 가로 방향 카드가 있으며, 하나의 예약은 카드가 없고, 하나의 카드 파일은 PDF 대신 잘못된 내보내기 텍스트를 포함합니다.
예약 1047을 위한 클릭 이후 /Arrivals 페이지는 에이전트의 마지막 설명서에 포함된 7개의 스크린샷 중 하나입니다.
인쇄 요청은 어느 프린터에 도달합니까?
IronPrint 2026.10.1은 프린터 이름을 검증하지 않습니다. 알려지지 않은 이름, 소문자로 쓴 adobe pdf 및 이름 없는 작업으로 작업을 구성했습니다. IronPrint는 세 가지 모두 예외 없이 Windows 기본 프린터로 보냈습니다. 문자열을 PrintSettings.PrinterName에 할당해도 성공합니다. 따라서 설정 오류는 서버의 기본 프린터에 카드가 인쇄되게 합니다.
테스트 기기의 기본 프린터는 Microsoft Print to PDF였으며, 이는 파일 이름을 요청하는 저장 대화 상자를 표시합니다. ASP.NET 가이드의 고급 예제는 동일한 프린터로 작업을 보냅니다. 웹 서버의 사용자는 대화창에 응답하지 않으며, 탐사에서는 사람이 파일 이름을 입력한 후에만 해당 프린터에 작업이 완료되었습니다.
구성된 이름과 Printer.GetPrinterNames을 각 작업 전에 비교하면 두 결과를 모두 방지합니다. 비교는 서수여야 하며, IronPrint는 대기열 이름과 정확히 일치합니다. 대소문자를 포함하여.
Antigravity가 작업할 수 있는 프로젝트를 어떻게 설정하나요?
이미 컴파일되어 페이지를 서비스하는 저장소를 에이전트에게 제공하세요. dotnet new mvc -f net9.0은 FrontDesk 프로젝트를 생성했으며, 첫 번째 프롬프트 이전에 한 번의 깨끗한 빌드가 있었습니다. Properties/launchSettings.json의 http 시작 프로필이 포트 5318을 청취하며, /browser 프롬프트가 엽니다.
목표 net9.0-windows. 평범한 net9.0용으로 구축된 콘솔 탐사는 경고 없이 컴파일되었지만 Adobe PDF 프린터에 대해 "자동 선택" 대신 "자동 선택"과 같은 다른 트레이 이름을 보고했으며, 없는 파일에 대해 PlatformNotSupportedException을 제기했습니다.
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.
라이선스 키가 없이 IronPrint 2026.10.1은 네 개의 설치된 프린터와 그 트레이를 나열했습니다. Printer.PrintAsync은 파일을 읽기 전에 "생산 라이선스 필요"라는 LicensingException을 발생시켰으므로 인쇄 큐는 작업을 받지 못했습니다. 테스트 페이지에서 최초의 라이센스 없는 클릭은 998ms에 메시지를 반환했으며 이후 클릭은 19에서 30ms였습니다. 예외 유형은 공개되지 않았으며, catch (LicensingException)은 에러 CS0122로 컴파일에 실패했습니다.
페이지의 규칙을 추후 작업에 어떻게 적용할까요?
모든 행이 통과되면 세션의 결정을 규칙으로 저장하세요. Antigravity의 규칙 문서는 에이전트가 읽는 파일이나 수정하는 파일에서 시작하여 워크스페이스 루트까지 경로의 각 폴더에서 AGENTS.md 또는 GEMINI.md 파일을 로드한다고 말합니다. /learn은 세션에서 수정된 내용을 바탕으로 규칙과 기술을 제안하며, 승인 후에만 파일을 기록합니다.
/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.
페이지에서 인쇄 작업을 어떻게 큐에 배치할까요?
ASP.NET 가이드는 대량 인쇄를 위한 큐를 추천합니다.
/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.
프롬프트는 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.");
}
}
}
예제는 드라이런 분기를 생략합니다. 헤더 확인 없이 IronPrint로 전달된 예약 1047의 카드는 "지원되지 않는 파일 유형"이라는 InvalidDataException을 발생시켰습니다.
각 카드에 대해 데스크 프린터가 받는 것은 무엇입니까?
테스트 머신의 네 개 프린터 중 어느 것도 작업을 완료하지 못했습니다. 각 기록된 작업은 따라서 IronPrint의 내부 작업 빌더로 재구축되었고, 그 페이지와 인쇄 티켓은 큐가 아닌 XPS 파일로 작성되었습니다.
| 예약 | 카드 파일 | 작업의 페이지 | 프린터로 전송된 페이지 |
|---|---|---|---|
| 1042 | A5 세로 방향, 1페이지 | 1 | A5 세로 방향, 148 x 210 mm |
| 1043 | A5 세로 방향, 2페이지 | 2 | A5 세로 방향, 148 x 210 mm |
| 1044 | A4 가로 방향, 1페이지 | 1 | A5 가로 방향, 210 x 148 mm |
| 1045 | None | 0 | 페이지에 의해 거부됨 |
| 1046 | A5 세로 방향, 1페이지 | 1 | A5 세로 방향, 148 x 210 mm |
| 1047 | 텍스트, PDF 아님 | 0 | 페이지에 의해 거부됨 |
PaperOrientation.Automatic은 그룹 카드를 가로 방향 A5 페이지로 변환하고 크기에 맞게 조정했습니다. PaperOrientation.Portrait로 동일한 카드는 세로 페이지의 너비로 축소되었으며, 용지의 107.9mm가 비었습니다. 기본 PaperSize.PrinterDefault로 A5 카드는 프린터의 기본 A4 페이지에 맞게 확대되었습니다.
NumberOfCopies은 인쇄 티켓 내의 요청이며, 작업은 각 페이지를 한 번씩 포함합니다. Grayscale은 PDF 페이지를 회색으로 렌더링하고 티켓의 색상을 단색으로 설정했습니다. 300에서 150으로 Dpi을 낮추면 한 카드의 시뮬레이션된 작업이 170,257 바이트에서 74,526 바이트로 줄어듭니다.
예약 1042와 1043에 대한 입력 카드는 App_Data/cards에서 제공됩니다.
산출
아래의 두 PDF는 해당 카드들에 대한 최종 애플리케이션의 시뮬레이션된 작업의 페이지 이미지를 포함하며, 변경되지 않았고 각 인쇄 티켓의 페이지 크기입니다.
IronPrint가 작업을 생성한 등록 카드 1042는 300 DPI의 A5 세로 방향 페이지 하나로, 프린터 대신 파일에 캡처되었습니다.
IronPrint가 작업을 생성한 등록 카드 1043은 300 DPI의 A5 세로 방향 페이지 두 개로, 프린터 대신 파일에 캡처되었습니다.
언제 한 에이전트 이상을 파견해야 하나요?
브라우저가 필요 없는 확인을 위한 두 번째 에이전트를 추가하세요. 여기에서는 한 에이전트가 코드에서 설정을 테스트하는 동안 다른 에이전트는 직원의 클릭을 반복합니다.
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.
페이지를 IIS에 어떻게 배포하나요?
IronPrint의 NuGet 페이지에는 Windows, macOS, iOS, Android만 지원되며 Linux 지원은 없으므로 프론트 데스크 서버는 Windows에서 실행됩니다. ASP.NET 가이드는 응용 프로그램 풀 ID가 프린터에 대한 접근 권한이 있어야 한다고 추가합니다.
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.
게시 폴더는 서버가 받는 것을 보유하므로 IIS가 필요하지 않습니다. 캘리브레이션 앱의 win-x64 게시에는 40MB 내에 235개의 파일이 들어 있었습니다. 유일한 네이티브 라이브러리는 IronPrintInterop.dll (9,926,400 바이트)과 qpdf.dll (2,802,432 바이트)로, 둘 다 IronPrint 패키지에서 제공되었습니다. 생성된 web.config에는 라이센스 키가 포함되어 있지 않았습니다. IIS 10은 응용 프로그램 풀의 환경 변수를 통해 작업자 프로세스로 키를 전달할 수 있습니다. 프로젝트 폴더에서 게시할 때도 출력으로 print-jobs에서 드라이런 작업 파일을 복사했습니다.
실제 실행에서 프롬프트가 무엇을 생성했습니까?
모든 일곱 프롬프트는 모든 권한 프롬프트를 건너뛰는 하나의 Antigravity CLI 대화에서 무인으로 실행되었습니다. 라이선스 키의 유일한 출처는 IRONPRINT_LICENSE_KEY였습니다. 모든 브라우저 통과는 드라이런으로 실행되었으며, 인쇄 큐는 비어 있었습니다. 각 행은 첫 번째 프롬프트 이후와 최종 응용 프로그램에서 독립적으로 클릭되었습니다.
- 첫 번째 프롬프트 전에는 프로젝트는 net9.0을 대상으로 했으며 프로요 프롬프트를 참조하지 않았습니다.
- 첫 번째 프롬프트 이후에는 net9.0-windows를 대상으로 했으며 IronPrint 2026.10.1을 참조했습니다.
- 시행 계획서에는 IronPrint가 알려지지 않은 프린터 이름에 대한 작업을 기본 프린터로 보낸다고 명시되어 있으며, 이는 우리가 측정한 것과 같습니다.
- 첫 번째 프롬프트의 코드는 Printer.PrintAsync를 대기하며 Wait 또는 Result 호출이 없습니다.
- 페이지는 예약 1045 및 1047을 거부했고, 나머지 네 개의 예약에 대해 작업을 기록했습니다.
- 각 기록된 작업은 A5 용지를 요청했으며, 두 개의 복사본, 회색조 및 자동 방향을 요청했습니다.
- 네 개의 시뮬레이션된 작업은 5 A5 페이지를 보유했으며 그룹 카드의 페이지는 가로 방향이었습니다.
- 모든 카드를 인쇄하는 것은 2초 이내에 여섯 도착을 완료했으며, 네 개의 작업이 완료되고 두 개가 거부되었습니다.
- 각 프롬프트는 0개의 오류로 빌드를 남겼습니다.
- 0개의 경고가 있는 Release로 빌드된 최종 애플리케이션.
- 키 없이 시작된 최종 애플리케이션은 IRONPRINT_LICENSE_KEY라는 한 개의 경고를 기록했습니다.
- 모든 네 xUnit 테스트는 라이선스 키 없이 통과했습니다.
- 실행의 win-x64 게시에는 동일한 두 개의 네이티브 라이브러리와 키 없는 web.config가 포함되어 있었습니다.
- 일부 단계는 페이지와 달리 작동했습니다. Antigravity의 /browser 하위 에이전트는 Chrome에 연결하는 데 실패했으므로, 에이전트는 모든 브라우저 통과에서 자체 Puppeteer 스크립트를 통해 Chrome을 제어했습니다. 양 계획 우선 프롬프트는 계획 후 승인을 기다렸습니다. /learn은 아티팩트에 여섯 개의 포인트를 제안했고 AGENTS.md를 기록하지 않았습니다. 두 에이전트 프롬프트에서 주 대화는 에이전트 A의 테스트를 실행했고, 에이전트 B 하위 에이전트가 실패한 후에 스스로 행을 클릭했습니다. 에이전트는 Chrome 로그, 쿠키 파일 및 스크린샷을 리포지토리 루트에 남겼습니다.
ChatGPT Codex는 작업을 탐색기와 작업자 하위 에이전트로 나눕니다. GitHub Copilot에서 배치 작업도 각 양식의 설정을 기록하고 인쇄 호출을 하지 않는 드라이런을 포함합니다. Antigravity 버전, 모델, 실행 시간 및 테스트 머신은 공유 실행 기록에 포함되어 있습니다.
문제 해결
- 이 페이지가 따르는 컨트롤러 패턴에 대한 ASP.NET 웹 앱에서 인쇄
- 작업이 잘못된 프린터에 도달할 때 프린터 이름 가져오기
- 용지 크기, 방향, 복사본 및 DPI에 대한 인쇄 설정
- 서버에서 키가 적용되지 않았을 때의 Web.config에 라이센스 키 설정
- 인쇄 호출이 호출 스레드를 차단할 때 WPF 및 WinForms에서 Print() 메서드가 중단됩니다
질문?
질문이 있으시면 support@ironsoftware.com으로 문의하세요.
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.