IronPrint'i Google Antigravity ile Nasıl Kullanılır
Bir otel resepsiyonu, gelen her misafir için imzalanmak üzere kayıt kartı basar. Görevli bir tarayıcıda Yazdır'a tıklıyor, ancak görev web sunucusundan çıktığı için, yanlış yazıcıya veya yanlış kağıt boyutunda gönderilen bir kart bile başarı mesajı döndürüyor. Bu sorunlar derleme günlüklerinde görünmez.
Google Antigravity sayfayı bir görevlinin yapacağı gibi inceleyebilir. Onun /browser komutu, her Yazdır düğmesine tıklayabilen ve sonucu ekran görüntüsü olarak alabilen korumalı bir Chrome alt aracısını başlatır. IronPrint, kart PDF'ini sunucudan bir yazıcıya, IronPrint'in ASP.NET web uygulaması kılavuzunda açıklanan yaklaşımla Printer.PrintAsync ile gönderir. Aşağıdaki adımlar her iki aracı da kullanarak sayfayı oluşturur ve sonuçları bilinen altı gelişe karşı test eder.
Kitle, bir web sunucusundan yazdıran kodları yazan AI aracılarının olduğu .NET geliştiricileridir. Yazıcı donanımı seçimi ve yazdırma kuyruklarının yapılandırılması kapsam dışıdır.
Hızlı BaşlangıçAntigravity'de FrontDesk projesini açın ve geliş sayfasını tanımlayın.
/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.
Başarılı bir derleme üç cevabı test etmez, bu yüzden onaylamadan önce her birini planda kontrol edin.
IronPrint IRONPRINT_LICENSE_KEY okumaz. Testlerimizde değişken ayarlandı, ve License.IsLicensed false kaldı, kod License.LicenseKey atanana kadar. lisans anahtar kılavuzu gibi appsettings.json ve Web.config gibi diğer seçenekleri kapsar.
Asgari İş Akışı (5 adım)
- C# yazıcı kütüphanesini NuGet'ten indirin
- Bir net9.0-windows ASP.NET Core projesi oluşturun
- Her görevden önce yapılandırılan yazıcı adını yüklenmiş yazıcılara karşı kontrol edin
- /browser her Yazdır düğmesine tıklarken, deneme olarak yazdırmayı çalıştırın
- Her kayıtlı görevi beklenen liste ile karşılaştırın ve her IronPrint üyesini API referansı ile kontrol edin
Google Antigravity nedir ve bir sohbet asistanından nasıl farklıdır?
Google'ın genel bakışında, masaüstü Antigravity Uygulaması, bir geliştiricinin bağımsız ajan takımları başlattığı, yönettiği ve incelediği bağımsız bir programdır. Bir sohbet asistanı metinle cevap verirken, Antigravity'nin aracıları, Uygulama Planı, Yürüyüş ve ekran görüntüleri gibi Eserler üretir.
Bellekten bir pakete ad veren bir ajan, slopsquatting olarak bilinen bir teknik kullanarak bir saldırgan tarafından yayınlanmış benzerini yükleyebilir. AD gerçinlenimini kışa bağlayan istemde IronPrint paketin adını ve sürümünü belirleyin. IronPrint'in ajanlar için dökümantasyon dosyaları AI kodlama asistanları kılavuzunda listelenmiştir ve ayrıca tek bir istemle kabul testi de vardır.
Planda, kod değişikliklerinde ve Kılavuzda neyi kontrol etmelisiniz?
IronPrint'in bilinmeyen bir yazıcı adını reddetmesini bekleyen bir plan, ad kontrolünün neden var olduğunu kaçırmıştır. Kod değişikliklerinde, yazıcı adını karşılaştırmayı bulun ve her IronPrint üyesini API referansı içerisinde arayın.
Yürüyüşte her tıklama için bir ekran görüntüsü bekleyin. Masaüstü uygulaması, her ekran görüntüsünü yorumlara açık bir görsel eser olarak kaydeder. Yanlış mesajla ekran görüntüsündeki bir yorum, hangi satırın başarısız olduğunu ajana bildirir ve yeni bir istem gerekmez.
Gerçek bir tarayıcıda yazdırma düğmesini nasıl test edersiniz?
/browser istemi, yalnızca her düğmeye tıklayarak doldurulabilecek bir tablo ister.
/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.
Altı gelişten ikisi tek sayfalık A5 kartına sahiptir ve üçüncüsü ev kurallarının ikinci bir sayfasına sahiptir. Bir grup rezarvasyonu bir A4 yatay kartına sahiptir, bir rezervasyonda kart yoktur ve bir kart dosyası bir PDF yerine başarısız bir dışa aktarmanın metnini içerir.
/Arrivals sayfası, rezervasyon 1047 için tıklandıktan sonra, ajanın son Yürüyüşündeki yedi ekran görüntüsünden biridir.
Yazdırma isteği hangi yazıcıya ulaşır?
IronPrint 2026.10.1 yazıcı adını doğrulamaz. Bilinmeyen bir adla, adobe pdf küçük harfle yazılan ve isim olmadan iş oluşturduk. IronPrint tümünü bir Windows varsayılan yazıcısına, istisna olmadan yönlendirdi. PrintSettings.PrinterName'e herhangi bir dize atanması da başarılı olur. Bu nedenle, yapılandırmada bir yazım hatası kartı sunucunun varsayılan yazıcısında yazdırır.
Test makinesindeyken varsayılan yazıcı Microsoft Print to PDF idi, ki bu da Kaydet olarak diyaloğunda bir dosya adı ister. ASP.NET kılavuzundaki gelişmiş örnek, işini aynı yazıcıya göndermektedir. Bir web sunucusundaki kullanıcılar diyaloga cevap vermemekte, ve o yazıcıya bir iş, bir kişi bir dosya adı yazana kadar bitmedi.
Her işten önce bağlanmış adı Printer.GetPrinterNames ile karşılaştırmak her iki sonucu da önler. Karşılaştırma harf harf olmalıdır, çünkü IronPrint kuyruk adını tam olarak eşsizler.
Antigravity'nin çalışabileceği bir proje nasıl kurulur?
Ajana zaten derinmiş ve bir sayfayı sunan bir depo verin. dotnet new mvc -f net9.0 FrontDesk projesini oluşturdu, ki bu ilk istemden önce bir temiz yapıya sahipti. Properties/launchSettings.json adlı dosyadaki http başlatma profili 5318 portunda dinler, ki bu portu /browser istemi açar.
net9.0-windows'yi hedefle. Basit net9.0 için oluşturulmuş bir konsol kanıtlayıcısı, uyarı olmadan derlendi, ancak farklı kâğıt tablası adları rapor etti, Adobe PDF yazıcısı için "Otomatik Seç" yerine "Otomatik Seç" gibi, ve bir kayıp dosya için PlatformNotSupportedException yükseltti.
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.
Lisans anahtarı olmadan IronPrint 2026.10.1 dört yüklenen yazıcıyı ve kağıtlarını listeledi. Printer.PrintAsync dosyayı okumadan önce "Üretim Lisansı Gereklidir" ile LisanslamaHata verdi, bu yüzden yazdırma kuyruğu hiçbir iş almadı. Test sayfasında ilk keysiz tıklama o mesajı 998 ms içinde dönerken, sonraki tıklamalar 19 ila 30 ms içinde döndü. Hata türü halka açık değil, ve catch (LicensingException) hata CS0122 ile derlenemiyor.
Sayfanın kurallarını sonraki görevlere nasıl uygularsınız?
Her satır geçtiğinde, oturum kararlarını kurallar olarak kaydedin. Antigravity'nın kurallar dökümantasyonu, aracının her klasörde AGENTS.md veya GEMINI.md dosyasını bir köke kadar okuduğu veya düzenlediği bir dosya yolunda okuttuğunu veya düzenlediğini belirtir. /learn oturumda yapılan düzeltmelerden çıkarılan kuralları ve becerileri önerir ve yalnızca onaydan sonra dosyaları yazar.
/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.
Yazdırma işleri sayfadan nasıl kuyruğa alınır?
ASP.NET kılavuzu yüksek hacimli yazdırmalar için bir kuyruğu tavsiye eder.
/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.
İstem, IronPrint 2026.10.1'e karşı derlenen bu örneğe yakın bir hizmet ister.
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.");
}
}
}
Örnek, deneme sapını dışarıda bırakır. Başlıksız kontrol olmadan IronPrint'e iletilmiş kart, rezervasyon 1047 için 'Desteklenmeyen dosya türü' ile InvalidDataException yükseltti.
Her kart için masa yazıcısı ne alır?
Test makinesinin dört yazıcısının hiçbiri işlerini takip etmeden tamamlamamıştır. Bu yüzden kaydedilen her iş, IronPrint'in dahili iş oluşturucusu ile yeniden oluşturuldu ve sayfaları ve yazdırma bileti bir kuyruğa gönderilmek yerine bir XPS dosyasına yazıldı.
| Rezervasyon | Kart dosyası | İşteki sayfalar | Yazıcıya gönderilen sayfa |
|---|---|---|---|
| 1042 | A5 yönlendirme, 1 sayfa | 1 | A5 yönlendirme, 148 x 210 mm |
| 1043 | A5 yönlendirme, 2 sayfa | 2 | A5 yönlendirme, 148 x 210 mm |
| 1044 | A4 yatay, 1 sayfa | 1 | A5 yatay, 210 x 148 mm |
| 1045 | None | 0 | Sayfa tarafından reddedildi |
| 1046 | A5 yönlendirme, 1 sayfa | 1 | A5 yönlendirme, 148 x 210 mm |
| 1047 | Metin, bir PDF değil | 0 | Sayfa tarafından reddedildi |
PaperOrientation.Automatic grup kartını yatay bir A5 sayfasına çevirdi ve sığacak şekilde ölçeklendirdi. PaperOrientation.Portrait ile aynı kart bir portre sayfasının genişliğine küçültüldü ve sayfanın 107,9 mm kısmı boş kaldı. Varsayılan PaperSize.PrinterDefault ile, A5 kartı yazıcının varsayılan A4 sayfasını dolduracak şekilde büyütüldü.
NumberOfCopies yazdırma bileti içinde bir istektir ve iş her sayfayı bir kez içerir. Grayscale PDF sayfalarını gri olarak görüntüledi ve biletin rengini monokromla ayarladı. Dpi'i 300'den 150'ye düşürmek, bir kart için simüle edilmiş işi 170.257 bayttan 74.526 bayta düşürdü.
Rezervasyon 1042 ve 1043 için giriş kartları, App_Data/cards'dan gelir.
Çıktı
Aşağıdaki iki PDF, o kartlar için son uygulamanın simüle edilmiş işlerinden sayfa görüntülerini içerir, değişmeden ve her yazdırma biletinde sayfa boyutunda.
IronPrint'in iş oluşturduğu gibi Kayıt kartı 1042, 300 DPI'da bir A5 portre sayfası, bir yazıcı yerine bir dosyaya yakalandı.
IronPrint'in iş oluşturduğu gibi Kayıt kartı 1043, 300 DPI'da iki A5 portre sayfası, bir yazıcı yerine bir dosyaya yakalandı.
Ne zaman birden fazla ajan gönderilmeli?
Tarayıcıya ihtiyaç duymayan kontroller için ikinci bir ajan ekleyin. Burada bir ajan ayarları kodda test ederken, diğer görevlinin tıklamalarını tekrarlar.
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.
Birleştirmeden önce iki Yürüyüşü yan yana inceleyin.
Sayfa IIS'ye nasıl dağıtılır?
IronPrint'in NuGet sayfasında Linux desteği listelenmiyor, sadece Windows, macOS, iOS ve Android var, bu yüzden ön desk sunucusu Windows çalıştırır. ASP.NET kılavuzu, uygulama havuzu kimliğinin yazıcıya erişmesi gerektiğini ekler.
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.
Yayın klasörü sunucunun aldığı şeyleri tutar, bu yüzden kontrol etmek IIS gerektirmez. Kalibrasyon uygulamasının win-x64 yayını 40 MB boyutunda 235 dosya içeriyordu. Tek yerel kütüphaneler IronPrintInterop.dll (9,926,400 byte) ve qpdf.dll (2,802,432 byte) idi, her ikisi de IronPrint paketinden. Oluşturulan web.config'e herhangi bir lisans anahtarı yazılmadı. IIS 10, anahtarı uygulama havuzunun ortam değişkenleri aracılığıyla işçi sürecine iletebilir. Proje klasöründen yayımlama, yazdırma işleri klasöründen deneme iş dosyalarını da çıktı içine kopyaladı.
Gerçek bir çalıştırmada istemler ne üretti?
Tüm yedi istem, izin istemlerinin hepsini atlayan bir Antigravity CLI konuşması içinde izlemsiz olarak çalıştı. Lisans anahtarının tek kaynağı IRONPRINT_LICENSE_KEY idi. Her tarayıcı geçişi deneme olarak çalıştı ve yazdırma kuyrukları boş kaldı. Her satır ayrıca bağımsız olarak ilk istemden sonra ve son uygulamada tıklanmıştır.
- İlk istemden önce, proje net9.0 hedefliyordu ve hiçbir NuGet paketi referans almıyordu.
- İlk istemden sonra, net9.0-windows hedefliyordu ve IronPrint 2026.10.1 referans alıyordu.
- Uygulama Planı, IronPrint'in bilinmeyen bir yazıcı adı için bir işi varsayılan yazıcıya gönderdiğini belirtiyordu, ölçtüğümüz gibi.
- İlk istemin kodu Printer.PrintAsync'i Bekleme veya Sonuç çağrısı olmadan bekliyordu.
- Sayfa 1045 ve 1047 rezervasyonlarını reddetti ve diğer dört iş hakkında kayıt aldı, her iki kontrolde de.
- Her kayıtlı iş, A5 kağıdı, iki kopya, gri tonlama ve otomatik yönlendirme talebinde bulundu.
- Dört simüle edilmiş iş 5 A5 sayfası içeriyor ve grup kartının sayfası yataydı.
- Tüm kartları yazdırma, dört iş tamamlanmış ve iki reddedilmiş olarak, tüm altı varış işlemi 2 saniye içinde tamamlanmıştır.
- Her istem, 0 hatayla bir yapı bıraktı.
- Son uygulama, 0 uyarıyla Yayın olarak derlendi.
- Anahtarsız başladıktan sonra, son uygulama IRONPRINT_LICENSE_KEY adlı bir uyarı kaydetti.
- Tüm dört xUnit testi lisans anahtarı olmadan geçti.
- Çalışmanın win-x64 yayınında aynı iki yerel kütüphane ve anahtarı olmayan bir web.config vardı.
- Bazı adımlar sayfadan farklı çalıştı. Antigravity'nin /browser alt aracısı Chrome'a bağlanamadı, bu yüzden ajan her tarayıcı geçişinde Chrome'u kendi Puppeteer betiği aracılığıyla kontrol etti. Her iki plan-öncelikli istem de plan sonrası onay bekledi. /learn, Eser içinde altı noktayı önerdi ve AGENTS.md aşamadı. İki-aracılı istemde, ana konuşma Agent A'nın testlerini yürüttü ve Agent B alt aracısı başarısız olduktan sonra satırlara kendisi tıkladı. Ajan depoda Chrome günlüklerini, bir çerez dosyasını ve bir ekran görüntüsünü bıraktı.
ChatGPT Codex, çalışmasını explorer ve worker alt aracılar arasında böler. GitHub Copilot'ta toplu iş ayrıca her formun ayarlarını kaydeden ve hiçbir yazdırma çağrısı yapmayan bir denemeye sahip. Antigravity sürümü, modeli, çalışma zamanı ve test makinesi ortak çalışma kaydında yer alır.
Hata Ayıklama
- Bu sayfanın takip ettiği kontrolör modeli için Bir ASP.NET Web Uygulamasında Yazdır
- İşler yanlış yazıcıya ulaştığında Yazıcı Adlarını Nasıl Alınır
- Kağıt boyutu, yönlendirme, kopyalar ve DPI için Yazdırma Ayarları
- Anahtar sunucuda uygulanmadığında Lisans Anahtarının Web.config'e Ayarlanması
- Bir yazdırma çağrısı çağıran ileti dizisini engellediğinde Print() Yöntemi WPF ve WinForms'da Takıldı
Sorular?
Herhangi bir sorunuz varsa, support@ironsoftware.com adresinden bize ulaşın
Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.