IronPrint'i GitHub Copilot ile Kullanma

Curtis Chau
Curtis Chau
Güncellendi: 26 Ekim 2026

Bir yük deposu, her römork çıktığında bir taşıyıcı teslim formu basar. Depo web portalı, sürücü, mühür numarası, palet sayısı ve tehlikeli maddeler için alanlar içeren doldurulmuş bir PDF olarak her formu kaydeder ve Visual Studio çözümündeki bir .NET hizmeti her bir formun iki kopyasını basar. Hizmeti düzenleyen bir asistan, ekibin hali hazırda kullandığı editör içinde çalışmak zorundadır.

GitHub Copilot, Visual Studio ve VS Code içinde sohbet ve ajan modu, terminal için Copilot CLI ve bir çekme isteği ile atanmış bir soruyu yanıtlayan bir GitHub bulut ajanı sunar. IronPrint, .NET'ten bir yazıcıya PDF ve görüntüleri gönderir; kağıt boyutu, kopya sayısı, çözünürlük ve form düzleştirme tek bir PrintSettings nesnesinde ayarlanır. Bu Copilot yüzeylerinin her biri, depodaki talimat dosyalarından IronPrint kurallarını okur.

Aşağıdaki istekler, IronPrint üzerine inşa edilen yazdırma kodunu Copilot'tan talep eder. Yazıcı donanımı seçmek veya bir yazdırma sunucusunu yapılandırmak, hiçbir asistanın depodan gerçekleştirebileceği bir iş değildir. düzleştirme kılavuzu bu formların bağlı olduğu IronPrint ayarını tanımlar.

Hızlı Başlangıç
NuGetNuGet ile Yükle

PM > Install-Package IronPrint

Yukarıdaki komutu NuGet Paket Yöneticisi Konsolunda çalıştırarak veya NuGet Paket Yöneticisinde arama yaparak IronPrint'u yükleyin.

Çözüm klasöründen copilot başlatın ve isteği gönderin. CLI'de, bir yolun önündeki @, o dosyayı ekler. Visual Studio'da, Copilot Chat aynı amaç için # kullanır.

Fill in @src/Depot.Printing/HandoverPrinter.cs so the depot can print its handover forms.
Use IronPrint 2026.10.1, the version Directory.Packages.props already pins.

Give the class three public static members:
- InstalledPrinters() returns the names from Printer.GetPrinterNames.
- BuildSettings(string printerName) returns the PrintSettings that @docs/print-profile.md describes.
- PrintAsync(string pdfPath, string printerName) checks the name first, then sends the job.

An unknown name throws an ArgumentException whose message lists the installed printers.
Build the solution and fix every error.
Then list the files you changed.
Text

İstek, hiç bir bireysel ayar adı vermez. docs/print-profile.md dosyasındaki yazdırma profili, her birini listeler ve Düzleştirme de bunların arasındadır.

Lisans anahtarı, Copilot'un çalıştığı ortama ayarlanan IRONPRINT_LICENSE_KEY'ya gider. IronPrint kendi başına bu değişkeni okumaz. Testimizde, değişken ayarlandığında License.IsLicensed yanlış kaldı, program License.LicenseKey'ye değerini atayana kadar. Anahtar için desteklenen diğer yerler lisans anahtarı kılavuzunda listelenmiştir.



IronPrint kurallarını Copilot için nasıl ayarlarsınız?

Proje genelinde kurallar .github/copilot-instructions.md içinde yer alır. GitHub destek matrisi, o dosya için Visual Studio, VS Code ve JetBrains IDE'lerde Copilot Chat ve Copilot CLI, Copilot kod incelemesi ve bulut ajanında destek gösterir. Visual Studio, dosyayı sadece GitHub, Copilot, Copilot Chat altında Seçenekler ayarlarında özel talimat işaret kutusu seçildiğinde, Copilot Chat taleplerine ekler.

These rules apply to printing code in this repository:

- Handover forms print through IronPrint. The NuGet package and the namespace are both IronPrint.
- Add no other printing library and no System.Drawing.Printing code.
- Keep the IronPrint version that Directory.Packages.props sets. Only an upgrade task changes it.
- IRONPRINT_LICENSE_KEY holds the license key.
- IronPrint does not read that variable, so Program.cs copies its value into License.LicenseKey.
- Never print the value, and don't dump environment variables either.
- docs/print-profile.md is the print contract. Leave it as it is and suggest changes in your reply.
- https://ironsoftware.com/print/csharp/llms.txt indexes IronPrint's docs for agents.
- No printer on this machine finishes a job without someone answering a dialog.
- Don't send a print job from a session, a test or a dry run.

Printing tests follow these rules:

- Test the PrintSettings the code builds.
- A test never calls Printer.Print or Printer.PrintAsync with a printer name that exists.
Markdown

Son yazdırma kuralı test makinesinden gelir. Orada, Microsoft Print to PDF bir dosya adı sormakta ve Adobe PDF bir Adobe PDF Oluştur penceresi açmakta, bu yüzden bu duruma gönderilen iş bir kişinin yanıtlamasını beklemektedir.

Yazdırma koduna kendi kurallarını nasıl verirsiniz?

.github/instructions/printing.instructions.md'nin applyTo desenleri, kurallarını ağacın bir kısmında sınırlar, bu durumda kaynak ve test projeleri. GitHub'un CLI belgeleri, CLI'nin yalnızca applyTo değeriyle eşleşen bir dosyada çalışmak için bağlamına bir yol-özel dosya eklediğini belirtir. Çalışmamızda, printing.instructions.md Copilot'un birinci istekte açtığı ilk dosyaydı.

---
applyTo: "src/**,tests/**"
---

Source and test code here follow these IronPrint rules:

- Set Flatten = true for every handover form.
- With Flatten false, IronPrint sends the page with four empty boxes.
- Those boxes are Driver, SealNumber, PalletCount and Hazmat.
- Check a printer name against Printer.GetPrinterNames before a job.
- IronPrint throws nothing for a name it cannot match, even by case or a trailing space.
- It prints on the Windows default printer instead.
- GetPrinterTrays returns an empty list for an unknown name, as it does for some real printers.
- So an empty tray list cannot prove that a printer exists.
- NumberOfCopies reaches the driver as a copy count.
- The job itself holds one page per PDF page.
- With no key, Printer.Print throws an AggregateException that wraps a LicensingException.
- PrintAsync throws the LicensingException itself.
- Margins takes millimeters, in the order left, top, right, bottom.
Markdown

Bu kuralların her biri IronPrint 2026.10.1 ile ölçüldü. Aşağıdaki Düzleştirme ve yazıcı adı bölümleri, ilk kurallar ardındaki ölçümleri verir.

Düzleştirme olmadan form alanları neden boş yazdırılır?

Bu ölçümler simüle edilmiş bir yazıcı kullanılarak yapıldı. Windows'ta, IronPrint her işi WPF yazdırma diyalogunun PrintDocument çağrısından geçirir. Bu çağrıdaki bir kanca, her işin sayfalarını ve yazdırma biletini bir XPS dosyasında kaydetti ve hiçbir yazdırma kuyruğu bir iş almadı. Dört teslim formu, düzleştirme kılavuzunun birleşik örneğinden ayarlamalarla geçti. Sonuçlar, IronPrint'in yazıcı sürücüsüne verdiği sayfayı tanımlar, fiziki bir yazıcının kağıtlarını değil.

Aşağıdaki karşılaştırma, her alanında bir değer olan HO-1001 teslim formunu kullanır.

  • Flatten yanlış olarak varsayılan değerine bırakıldığında, Sürücü, Mühür numarası, Palet sayısı ve Tehlikeli Maddeler kutuları tüm dört formda da boştu. Üç form, alanları için görünüm akışlarına sahipti ve o kutular da onlarda boştu.
  • Flatten = true ile her değer yazdırıldı. Görünüm akışları olmadan kaydedilen form da değerlerini yazdırdı.
  • Her PDF sayfası, 300 DPI 'da A4 portre sayfasında 2479'e 3508 piksel tek bir görüntü haline geldi. İki sayfalık form iki sayfa üretti.
  • Yazdırma bileti, doküman her PDF sayfası başına bir sayfa tutarken, 2 kopya taşıdı.
  • Örnekteki 10 mm kenar boşlukları, görüntüyü taşımadı ve görüntüyü sayfanın sol üst köşesinden doldurdu.

Çıktı

HO-1001 kanca üzerinden iki kez geçti, ilk olarak Düzleştirme yanlış, ardından Düzleştirme doğru. Aşağıdaki her PDF, yakalanmış bir işin sayfa görüntüsüdür, değiştirilmeyen ve orijinal boyutunda.

HO-1001 Düzleştirme yanlış, IronPrint işleri oluşturduğunda, bir yazıcı yerine dosyaya yakalandı.

HO-1001 Düzleştirme doğru, IronPrint işleri oluşturduğunda, bir yazıcı yerine dosyaya yakalandı.

Düzleştirme kılavuzu, form katmanlarını atlayan yazıcı sürücülerine boş alanları atar. Yakalamada, herhangi bir sürücü almadan önce değerler sayfadan zaten kaybolmuştu.

Bir iş göndermeden bir form klasörünü nasıl yazdırırsınız?

Toplu işin, yazıcısız test edilebilmesi için bir kuru çalışmaya ihtiyacı var. Kuru çalışma, her formun alacağı ayarları kaydeder ve bir inceleyici bu kaydı yazdırma profiliyle karşılaştırabilir.

Turn @src/Depot.PrintJob/Program.cs into the batch job that prints forms/inbox.

It accepts two options:
- --printer <name> picks the printer for every form.
- --dry-run writes the log and sends nothing.

The job runs in this order:
1. Exit with code 2 when the printer isn't installed, and list the installed ones on the console.
2. Read every PDF in forms/inbox in file name order.
3. Get each form's settings from HandoverPrinter.BuildSettings.
4. Append a line per form to out/print-log.csv, then print the form unless it's a dry run.

Paths are relative to the solution root.
The log is semicolon-delimited, with this header line:
Form;Printer;Flatten;Copies;PaperSize;Orientation;Dpi;Grayscale

Run the job twice with --dry-run.
Use --printer "Adobe PDF" the first time and --printer "Depot Laser 2" the second.
Show me both exit codes and the log.
Text

Adobe PDF, test makinesinde bir yazıcıdır. Kendi yazıcı listenizden bir ad kullanın.

Bir yazıcı adı eşleşmezse ne olur?

IronPrint, PrinterName ile Windows'un bildirdiği adları karakter karakter karşılaştırır ve karşılaştırma başarısız olduğunda hata yükseltmez. Yakalanmış işler, "NoSuchPrinter 7", küçük harflerle "adobe pdf" ve ardından bir boşlukla "Adobe PDF" olarak adlandırıldı. Microsoft Print to PDF, Windows'un varsayılan yazıcısı, tümünü aldı ve yalnızca tam ad Adobe PDF'ye gitti. Bilinmeyen ada lisanslı bir iş, istisna yükseltmedi ve sadece Microsoft Print to PDF'nin kaydetme diyalogu yanıtlandığında döndü.

GetPrinterTrays adı kontrolü yerine geçemez, çünkü bilinmeyen ad ayrıca Fax ve Microsoft Print to PDF için boş bir liste döndürdü. GetPrinterNames, bir lisans anahtarı olmadan dört yazıcıyı da döndürdü, dolayısıyla kontrol, bir lisans olmadan çalışan testlerde de işe yarar.

Yazdırma ayarlarını nasıl test edersiniz?

Plan modu etkin olana kadar Copilot CLI içinde Shift+Tab tuşuna basın, ardından aşağıdaki isteği gönderin.

Plan an xUnit project in tests/Depot.Printing.Tests and add it to the solution.
Hold off on code until I approve the plan.

Its tests cover these cases:
- Every setting BuildSettings fills in matches @docs/print-profile.md.
- PaperMargins and Tray stay null, so the printer's own defaults apply.
- PrintAsync refuses a name with the wrong case or a trailing space.
- That refusal names every printer InstalledPrinters() returns.

Once the plan is approved, add the tests and run dotnet test.
Then give me the pass and fail counts.
Text

Öncelikle planı gözden geçirmek, paketlerin makinenin yazıcı listesine dayanmadığı bir testten önce, bir gerçek yazıcı isminin nasıl elde edileceğini gösterir.

Form alanlarının boş kalmasına neden olan bir yeniden yazdırmayı nasıl düzeltirsiniz?

Ana hizmetten ayrı olarak yazılmış bir yeniden yazdırma yolu, ana hizmetin uyguladığı bir ayarı atlayabilir. Bu senaryoda, bir ekip arkadaşının ReprintService kendi PrintSettings'sini Flatten olmadan kurar ve sürücüler yeniden yazdırmaları boş kutularla alır.

Drivers say reprinted handover forms have empty Driver, Seal number and Pallet count boxes.
First prints look right. The reprint code is @src/Depot.Printing/ReprintService.cs.

Work out the cause before you edit anything:
1. Compare ReprintService.BuildSettings with HandoverPrinter.BuildSettings.
2. Open IronPrint.xml inside the IronPrint package in the NuGet cache.
3. Quote its summary for the setting that explains the empty boxes.

Then fix ReprintService.cs, and keep a reprint at one copy.
Leave the other source files alone.
Add a test for the reprint settings and run dotnet test.
Tell me the cause you found and the test result.
Text

Gönderilen IronPrint.xml, tek bir cümlede ayarı belirtir ve Flatten form alanı değerlerini göstermek için kullanışlı olarak tanımlar. Değerlerin onsuz eksik olduğunu belirtmez.

Bulut ajanının etkili olduğu bir sorun ne yapar?

Copilot, sorun atandığında başlık, açıklama ve mevcut yorumları ve isteğe bağlı istek alanındaki metni alır. GitHub'un belgeleri, ajanın atamadan sonra gönderilen yorumlardan habersiz olduğunu belirtir, bu nedenle sorun metanı işin tamamlandığını belirtmesi gerekir.

Title: Log the printer each reprint was sent to

The work involves these files and settings:
- Files: src/Depot.Printing/ReprintService.cs, tests/Depot.Printing.Tests
- IronPrint version: unchanged from Directory.Packages.props
- Framework: net9.0-windows

After the change, reprints behave like this:
- Every reprint appends a line to out/reprint-log.csv.
- The line holds the form, the printer name, the time and the copy count.
- A printer name that Windows does not report stops the reprint before anything is sent.

Today, reprints leave no record, and ReprintAsync sends a job to any name it receives.

Keep to these limits:
- Keep the ReprintAsync signature.
- Follow .github/instructions/printing.instructions.md.
- Add no packages.

Acceptance means these checks pass:
- Every existing test passes.
- A new test passes "adobe pdf" in lower case and expects an ArgumentException before any job.
Markdown

Test, kurulu yazıcı ile sadece büyük/küçük harf farkı olan bir ad kullandığı için, büyük/küçük harf ayrımı yapmayan bir kontrol onu başarısız kılar.

Bulut ajanın testleri IronPrint projesinde neden başarısız oluyor?

Depo başka bir çalışma ortamı yapılandırmadıkça, ajanın ortamı Ubuntu Linux'tur. IronPrint ürün sayfası Windows, macOS, iOS ve Android adlı ve Linux isimlendirilmemiştir ve bu çözümdeki her proje net9.0-windows hedeflemiştir. GitHub, bulut ajanı için Windows 64-bit çalışma ortamlarını destekler. Entegre duvarı Windows ile uyumlu değil, bu yüzden GitHub, o durumda kendi barındırılan çalıştırıcıları veya geniş GitHub barındırılan çalıştırıcılarını Azure özel ağı ile önerir.

Bir Agent sırrı olmadan, o çevre bir lisans anahtarına da sahip değildir. Sonda, her lisanssız yazdırma çağrısı "Üretim Lisansı Gerekiyor" ifadesini 0,2 saniye içinde, herhangi bir iş oluşturulmadan önce attı.

.github/workflows/copilot-setup-steps.yml içindeki copilot-setup-steps işi, ajan çalışmaya başlamadan önce çalışır ve GitHub yalnızca varsayılan dal dosyayı içerdiğinde tetikler.

The cloud agent has to build this solution, so add a setup workflow for it.
Its path is .github/workflows/copilot-setup-steps.yml.
Copilot looks for one job, and it has to be named copilot-setup-steps.

The job works like this:
- Run it on windows-latest, because every project targets net9.0-windows.
- Its only permission is contents: read.
- Start it from workflow_dispatch and from pull requests that edit this workflow file.
- Its steps are a checkout, a .NET 9 SDK install, a restore and a Release build.

Printing calls need IRONPRINT_LICENSE_KEY, which is stored as an Agents secret.
The job sees that secret as an environment variable.
Add a step that tests whether the key is set:
- For pull_request and workflow_dispatch events, a missing key is a warning and the step passes.
- For every other event, a missing key fails the step with a message that names the secret.

That step goes last, since Copilot skips every setup step after one that fails.
Create the file and show me the YAML.
Text

Anahtar için bir Agents sırrı kullanın: bulut ajanı, Actions, Codespaces veya Dependabot sırlarını okuyamaz. Secrets ve değişkenler sayfasında, Deposunun Güvenlik grubundaki Gizlilik grubunda bulunan Agents sayfasına IRONPRINT_LICENSE_KEY ekleyin. Ajan daha sonra anahtarı ortam değişkeni olarak alır.

Birleştirmeden önce neyi kontrol etmelisiniz?

İncelemeyi kendi copilot -p komutu olarak gönderin. --continue veya --resume olmadan, bu komut, kodlama oturumundan hiçbir geçmiş olmadan yeni bir oturumu başlatır.

/review the changes made since this branch's first commit.
Compare each IronPrint call with .github/instructions/printing.instructions.md.
Then compare it with the IronPrint.xml that ships in the IronPrint NuGet package.
Name every place where the code and those two sources disagree.

Flag any of these as well:
- a PrintSettings for a handover form that leaves Flatten unset or false
- a print call whose printer name was never checked against Printer.GetPrinterNames
- a test that sends a real print job
- a catch block that would miss the LicensingException a print call throws
- any line that writes IRONPRINT_LICENSE_KEY to the console or a log

Report what you find and leave every file unchanged.
Text

Gerçek bir çalıştırmada istemler ne üretti?

Altı gelişme, Copilot CLI'de arka arkaya çalıştırılmak üzere planlanmıştı, klavyede kimse olmadan, bu kılavuzu oluşturmak için bir depo çözümüne inşa edildi. Her gelişmeden sonra, taahhüt yeniden inşa edildi ve toplu iş onun üzerinde çalıştırıldı. Daha sonra her form için ayarlar IronPrint aracılığıyla geçti ve yazdırma çağrısı kesildi, dolayısıyla hiçbir iş yazıcıya ulaşmadı.

  • Çalıştırmadan önce, HandoverPrinter boş bir statik sınıftı ve toplu iş kod 1 ile sona eren bir yama parçasıydı.
  • İlk istek yalnızca HandoverPrinter.cs'i değiştirdi.
  • İlk öneriden sonra, BuildSettings Düzleştirmeyi açtı, 2 kopya, A4, portre, 300 DPI ve gri tonlama geri döndürdü.
  • Tepsi ve marjinler ayarlanmadan kaldı, dolayısıyla yazıcı varsayılanları uygulandı.
  • PrintAsync, yazıcı adını, büyük/küçük harf ayrımına duyarlı sıradan bir karşılaştırma ile kontrol etti.
  • Tüm dört formun yakalanmış sayfalarında her alan değeri göründü.
  • Her form için yazdırma bileti 2 kopya, ISO A4 portre, monochrome çıktı ve 300 DPI taşıdı.
  • İki sayfalık formun yakalanmış işi iki sayfa tuttu ve her bir diğer iş bir sayfa tuttu.
  • Her iki gelişmeden sonra, çözüm 0 hata ile inşa edildi.
  • İkinci öneriden sonra, Adobe PDF için kuru çalıştırma kod 0 ile sona erdi ve her form için bir satır kaydedildi.
  • Kaydedilen her satır yazdırma profiliyle eşleşti, Düzleştirme ve Gri tonlama her ikisi de doğru.
  • Depot Lazer 2 için kuru çalıştırma kod 2 ile sona erdi ve konsol çıktısı dört kurulu yazıcıyı adlandırdı.
  • Hiçbir kuru çalıştırma yazdırma çağrısı yapmadı.
  • Çalıştırma sırasında hiçbir yazdırma işi hiçbir kuyruğa ulaşmadı.
  • Bazı adımlar sayfadan farklı çalıştı. Aylık Copilot kotası, ikinci öneride tükendi, Copilot iş oluşturduktan sonra ve kuru çalıştırmalarından önce. Her iki kuru çalıştırma da bunun yerine Copilot dışına çalıştırıldı. 3'ten 6'ya kadar olan istekler çalıştırılmadı, dolayısıyla plan modu, yeniden yazdırma düzeltmesi, kurulum iş akışı ve inceleme bu sayfada hiçbir çalışma sonucu yok. Sorun, bulut ajanı ve Agents sırrı barındırılan bir depo gerektirir, bu yüzden hiçbiri test edilmedi.

Cursor da kurallarını dosya desenlerine göre sınırlar ve Claude Code da herhangi bir kod değişikliğinden önce onaylanmış bir plan bekler. paylaşılan çalışma kaydı CLI sürümünü, Auto ile seçilen modeli, toplam çalışma süresini ve donanımı içerir.


Hata Ayıklama


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.

Daha Fazla Oku

Başlamaya Hazır mısınız?

NuGet İndirmeleri 52,106Sürüm:2026.11yeni çıktı