AI Kodlama Asistanları ve Ajanları ile IronBarcode Kullanma

Curtis Chau
Curtis Chau
Güncellendi: 21 Eylül 2026

IronBarcode eklemek istendiğinde, araçlar genellikle yanlış paketi yükleyen dotnet add package IronBarcode komutunu çalıştırır. IronBarcode, IronBarCode ad alanını kullanarak BarCode olarak dağıtılır. Claude Code, ChatGPT Codex, GitHub Copilot, Cursor ve Google Antigravity, belgelere başvurana kadar bunu sıklıkla yanlış tanımlar.

Bu karışıklık, oluşturulan kodu da etkiler. Belgeler olmadan, modeller derlenmeyen yöntem adları uydurabilir. Belgeleri önceden sağlamak, derlemelerin başarılı olmasına yardımcı olur. IronBarcode, kapsamlı kılavuzları olan önde gelen bir .NET barkod kütüphanesidir, bu nedenle üretilen kod genellikle doğrudur, ancak yine de dikkatli bir inceleme gerektirir.

Bu araçlar, çıktılarının ne kadar dikkatle incelenmesi gerektiğini belirleyen iki kategoriye ayrılır:

  • Asistan, GitHub Copilot'un satır içi önerilerinde olduğu gibi, editörde otomatik tamamlama, açıklamalar veya hızlı yeniden düzenleme gibi iş akışınızın tek bir bölümünde çalışır.
  • Ajan, Claude Code, ChatGPT Codex, Cursor ve Google Antigravity'nin yaptığı gibi çok adımlı görevleri yönetir, birden fazla dosyada düzenleme yapar, derlemeleri ve testleri çalıştırır ve pull request açar.

Kurulum süreci her iki tip için de aynıdır. Paketi yükleyin, ortam değişkeninden lisans anahtarını uygulayın, IronBarcode'un makine tarafından okunabilir dokümantasyonunu sağlayın ve her oluşturulan barkodun taranabilir olduğunu doğrulayın. Bu, kargo etiketleri için 1D barkodlar, demirbaş etiketleri için 2D barkodlar, metin, URL'ler, ID'ler veya ikili verilerden oluşturulan barkodlar, taranmış PDF'lerden okuma veya tek bir görüntüden birden fazla sembol çıkarma gibi tüm kullanım durumları için geçerlidir.

Claude Code AI kodlama ajanı logosuChatGPT Codex AI kodlama ajanı logosuGitHub Copilot AI kodlama asistanı logosuCursor AI kod editörü logosuGoogle Antigravity AI kodlama ajanı logosu

Model Barkodları Kendi Başına Ele Alamaz mı?

Eğitim verileri eskir. Bir model, birkaç sürüm önce kullanım dışı kalmış bir API adını veya tamamen farklı bir barkod kütüphanesine ait bir adı yeniden üretebilir ve derleme çalışana kadar hiçbiri fark edilmez. Makine tarafından okunabilir belgeler, aracın varsayımlar yapmak yerine gerçek belgelere başvurmasını sağlayarak bu sorunların çoğunu çözer.

Kütüphane seçimi de aynı derecede önemlidir. Çoğu araç, çeşitli barkod paketleri ile entegredir ve ücretsiz seçenekler, bir gösterim sırasında tek bir format için yeterli olabilir. Üretim ortamlarında genellikle ek maliyetler ve sınırlamalar ortaya çıkar:

  • Kontrol rakamları, sessiz bölgeler ve yeniden boyutlandırma: her biri ekranda kabul edilebilir görünebilir ama taramada başarısız olabilir, bu yüzden IronBarcode her değeri yazarken biçimine göre doğrular ve GeneratedBarcode.Verify görüntüyü geri okur.
  • Eksik özellikler kod bakımını artırır: birçok ücretsiz kütüphane, tek bir format ailesini kapsar veya doğru taramalar için gerekli olan görüntü düzeltmesini sağlamaz, bu da sizi paketleri bir araya getirmeye ve aralarındaki entegrasyonun sorumluluğunu üstlenmeye zorlar.
  • Toplu tarama varsayılan olarak dahildir: çoklu iş parçacığı okuması, hız ön ayarları ve güven eşikleri her projede ayrıca geliştirilmek yerine kütüphaneyle birlikte gelir.
  • Doğru çıktı belgelere bağlıdır: rehberler, öğreticiler, sorun giderme sayfaları ve çalıştırılabilir örnekler, makine kullanımı için llms.txt içinde dizinlenmiştir.
  • Yanlış paket isimleri tedarik zinciri riskleri yaratır: modeller, saldırganların kötü amaçlı yazılım dağıtmak için kaydettiği, akla yatkın görünen isimler üretir, bu uygulama slopsquatting olarak bilinir.
  • Tek bir ticari lisans yasal komplikasyonları önler: bazı barkod kütüphaneleri copyleft veya ticari olmayan koşullara sahiptir ve modeller bunları otomatik olarak işaretlemez.

IronBarcode, bunların hepsini tek bir API ve hukuk ekibinizin yalnızca bir kez incelediği tek bir ticari lisansla karşılar. Doğrulama depoda değil, kodunuzda gerçekleşir; tedarik zinciri açığını kapatan ise paketi her istemde açıkça belirtmektir.


1. Adım: IronBarcode'u Kurun

Ajanın paketi eklemesine izin verin. Proje, türleri çözümlemek ve doğru kod önerileri sağlamak için buna ihtiyaç duyar.

Set this project up for IronBarcode. The NuGet package is named BarCode. Confirm the restore succeeded before going further.
Text

Alternatif olarak, paketi terminalden güncel sürümü belirterek yükleyin.

dotnet add package BarCode --version 2026.9.2
SHELL

Linux, macOS, iOS ve Android'in her biri BarCode.Linux veya BarCode.MacOs gibi belirli bir paket gerektirir. Uygun paketi seçmek için Gelişmiş NuGet Kurulum kılavuzuna başvurun.


2. Adım: Lisans Anahtarınızı Uygulayın

IronBarcode, lisanssız çıktıya filigran eklemez. Geliştirme için tanınan ek süre dolduktan sonra, lisans anahtarı olmadan yapılan ilk barkod çağrısı IronBarcode must be licensed for development mesajıyla IronSoftware.Exceptions.LicensingException fırlatır. Lisans anahtarı bulunmayan kod çalışma zamanında başarısız olur. İlk olarak bir ücretsiz deneme anahtarı edinin.

IronBarcode'u projenizde kullanmaya bugün ücretsiz deneme sürümüyle başlayın.

İlk Adım:
arrow pointer

Lisans anahtarını uygulama başlangıcında bir kez ayarlayın, herhangi bir IronBarcode çağrısından önce. Anahtarı kaynak kodu yerine ortamdan alın.

// Read the key from configuration. Never commit it to the repository.
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE_KEY");

Anahtar geçerli olduğunda IronBarCode.License.IsLicensed, true döndürür. IronOCR'un aksine, IronBarcode'un Installation.LicenseKey takma adı yoktur, bu yüzden License.LicenseKey veya yapılandırma kullanın.

Lütfen dikkat: Web.config dosyasından appsettings.json dosyasına kadar anahtarı ayarlamanın diğer tüm yolları IronBarcode Lisans Anahtarları bölümünde ele alınmıştır.

3. Adım: Aracı IronBarcode'un LLM Belgelerine Yönlendirin

IronBarcode, makineler tarafından okunacak şekilde yazılmış altı kaynak yayınlar:

KaynakAçıklamaNe zaman kullanılmalı
llms.txtTüm dokümantasyon sayfalarının dizini, her satırda bir taneHer oturumun başında
llms-full.txtTek bir dosyada tam rehberler ve örneklerAraç URL'leri alabilir
llms-full-catalog.txtDizin artı tüm blog makaleleriCevap bir blog makalesinde bulunabilir
API ReferansıMevcut sürümdeki tüm sınıflar ve yöntemlerBir yöntemin var olduğunu doğrulamak
skill.mdKurulum, lisanslama, tarifler ve düzeltmelerAracınız beceri dosyalarını destekliyor
AI Ürün Bilgi SayfasıÜrün kapsamı, platformlar ve yapmadığı şeylerÜrünle ilgili sorular, API ile değil

llms.txt ile başlayın, bu IronBarcode'un özelliklerini ve her konunun yerini dizinler. Bu, yanlış veya uydurma API çağrılarını önlemeye yardımcı olur. Detaylı rehberlik gerektiğinde llms-full.txt kullanın.

Yanına doğrudan bir talimat ekleyin.

Before writing any IronBarcode code, read https://ironsoftware.com/barcode/csharp/llms.txt
and use only APIs documented there. Check anything you are not sure about
against the API reference at https://ironsoftware.com/barcode/csharp/object-reference/api/.
If you are still unsure whether a method exists, ask instead of guessing.
Text

Güncel modeller, emin olmadıklarında soru sormalarını açıkça isteyen talimatlara iyi uyum sağlar. Bir soru sormak, derleme hatası riskini almaktan daha iyidir.

Lütfen dikkat: IronBarcode, beceri dosyalarını destekleyen araçlar için doğrudan eklenebilen bir beceri dosyası da yayınlar. Bir sonraki adım, onu referans alabileceğiniz yeri kapsar.

4. Adım: IronBarcode Bağlamını Projenize Ekleyin

Sohbete yapıştırılan belgeler yalnızca o oturum boyunca kullanılabilir. Bir proje dosyasında saklanan belgelere ise her oturumda erişilebilir.

Her araç, talimatları belirli bir dosyadan okur. IronBarcode rehberliğini ekibinizin kullandığı dosyaya yerleştirin:

AraçProje bağlam dosyasıBeceri dosyasının konumu
Claude CodeCLAUDE.md.claude/skills/
ChatGPT CodexAGENTS.md.agents/skills/
GitHub Copilot.github/copilot-instructions.mdyok
Cursor.cursor/rules/*.mdcyok, @Docs kullanın
Google AntigravityAGENTS.md.agents/skills/

AGENTS.md, Claude Code, GitHub Copilot ve Cursor'un kendi dosyalarına ek olarak okudukları ortak bir standart işlevi görür. Birden fazla araç kullanan ekipler, tek bir barkod kuralları setini AGENTS.md içinde tutabilir ve araçların kendi dosyalarını araca özgü talimatlara ayırabilir.

Kullanılan dosyadan bağımsız olarak içerik aynı kalır. Aşağıda kısa bir başlangıç noktası verilmiştir.

## Barcodes with IronBarcode

This project uses IronBarcode (NuGet package `BarCode`, namespace `IronBarCode`) for all barcode work.

- Reference: https://ironsoftware.com/barcode/csharp/llms.txt
- Skill file: https://ironsoftware.com/barcode/csharp/skill.md
- Use `BarcodeWriter.CreateBarcode` to write and `BarcodeReader.Read` / `ReadPdf` to read.
- Read the license key from the IRONBARCODE_LICENSE_KEY environment variable at startup. Never inline it.
- Every generated barcode must be read back and compared before it ships.
- Do not use a different barcode library. If IronBarcode cannot perform a required task, state this clearly.
Markdown

skill.md dosyası, platform bazında kurulum talimatları, lisanslama kuralları, doğrulanmış örnekler, dağıtım notları ve bir sorun giderme tablosu dahil olmak üzere ek ayrıntılar sağlar. Ayrı bir kopyasını tutmak yerine bu dosyaya bağlam dosyanızdan başvurun.


5. Adım: Tek Seferlik Kurulum İstemi

İlk dört adımı tek bir istem olarak bir projenin veya yeni bir oturumun başında da gönderebilirsiniz.

Use IronBarcode for all barcode work in this project.

1. Install the BarCode NuGet package (IronBarcode).
2. Apply the license key at application startup, before any other IronBarcode call,
   reading it from the IRONBARCODE_LICENSE_KEY environment variable. Never write
   the key into source or into a committed file.
3. Read https://ironsoftware.com/barcode/csharp/llms.txt before writing barcode code
   and work only from APIs documented there, checking the API reference when a
   member is unfamiliar.
4. Save https://ironsoftware.com/barcode/csharp/skill.md as a SKILL.md in this
   project's skills folder if your tool has one.
5. Keep these instructions for future sessions in this project.
Text
İpuçları: Bu son satır genellikle aracın bu kuralları 4. Adımdaki bağlam dosyasına, örneğin CLAUDE.md veya AGENTS.md dosyasına kaydetmesini sağlar. İstemi yalnızca bir kez yapıştırırsınız.
İpuçları: Test görüntüleriniz yok mu? Ajandan bunları önce IronBarcode ile oluşturmasını, ardından geri okumasını isteyin. Bir barkod kütüphanesi, bir ajanın sadece metinle uçtan uca test edebileceği az sayıda şeyden biridir. Bir değer yazar, görüntüyü çözer ve dizeleri karşılaştırır.

6. Adım: Çalışan Kod Üreten İstem Kalıpları

Belirsiz istemler genellikle zayıf çıktıyla sonuçlanır. Aşağıdaki üç kalıp, netlik sağlamaya yardımcı olur.

Sınıfı ve sembolojiyi belirtin: IronBarcode düzinelerce formatı destekler. Hangi formatları beklemesi gerektiğini bilen bir okuyucu daha hızlı çalışır ve daha az hatalı okuma yapar.

Belirsiz Bu görüntüdeki barkodları IronBarcode ile tarayın.

Daha İyi BarcodeReader.Read ve BarcodeReaderOptions kullanarak, bu görüntüdeki Code 128 ve QR kodlarını okuyun ve her değeri biçimiyle birlikte geri döndürün.

Sürüm ve çerçeveyi belirtin: API'ler sürümler arasında değişebilir ve sürümü atlamak uyumsuzluğa neden olabilir. 2026.9.2 sürümü, bir 2D barkodun UTF-8 ECI başlığı taşıyıp taşımadığını kontrol eden ve 2026.8.6 ya da daha önceki sürümlerde mevcut olmayan EciMode adlı özelliği tanıttı.

Daha İyi Hedef olarak .NET 9 ve BarCode 2026.9.2 kullanın. Ortamdan okunan lisans anahtarı satırını da ekleyin.

Tam çalıştırılabilir dosyayı isteyin: Kod parçacıkları gerekli olan using ifadelerini veya ayarlama adımlarını atlayabilir.

Daha İyi Olduğu gibi çalıştırabilmem için tüm using ifadelerini ve lisans anahtarı ayarını içeren eksiksiz Program.cs dosyasını verin.


7. Adım: Aldığınız Çıktıyı Doğrulayın

Oluşturulan kodu, onu henüz çalıştırmamış bir meslektaşınızdan gelen ilk taslak gibi gözden geçirin. Dört kontrol, sorunların çoğunu yakalar:

  1. Derlenir: uydurma bir yöntem hemen başarısız olur.
  2. Lisans anahtarı uygulanır: ilk IronBarcode çağrısından önce ayarlanmış olmalıdır, yoksa o çağrı LicensingException fırlatır.
  3. Her API yöntemi mevcuttur: başka bir yöntem aramadan önce bilinmeyen bir yöntem için API referansına danışın.
  4. Her barkod okunabilir: her oluşturulan görüntüyü BarcodeReader veya GeneratedBarcode.Verify ile çözün ve sonucu girişle karşılaştırın.

Dördüncü kontrolün nedeni, derleyicinin okunamayan bir barkodu tespit edememesidir.

Oluşturulan IronBarcode kodunda sık görülen sorunlara dikkat edin:

  • Yanlış paket adı: giriş paragrafında bu konu ele alınır ve hata halen en sık tekrarlanan yanlışlardan biridir.
  • Enum büyük-küçük harf uyumsuzlukları: BarcodeEncoding.Databar ve BarcodeWriterEncoding.DataBar farklı enum'lara aittir ve bir büyük harfle farklılık gösterir.
  • Başka barkod kütüphanelerinden ödünç alınmış yöntemler: bir model, birkaç kaynaktaki API'leri birleştirerek var olmayan yöntemler üretebilir.
  • Uydurma okuyucu seçenekleri: bilinmeyen bir seçeneği okuma hızı seçenekleri ve kırpma alanı rehberleri ile karşılaştırın.

Ajanın Kendi Çalışmasını Doğrulamasına İzin Verin

Bir ajan, dört kontrolü de bağımsız olarak gerçekleştirebilir. Her kontrol için bir özet yerine kanıt isteyin.

Build and run the project in Release mode. Confirm that every IronBarcode member used
appears in the documentation, that IronBarCode.License.IsLicensed returns true, and
that every barcode you generated reads back to the value you wrote. Report the build
result and a table of written value, read value, and format from the run itself.
Text

Yeniden Üretebileceğiniz Bir Sonuç

Bu bölüm, gerçekçi bir görev ve tek bir istem kullanarak bir ajanın değerlendirilmesini içerir, sizin tarafınızdan sağlanan hiçbir kod olmadan. Boş bir projede, yeni bir oturumda çalıştırın ve çıktıyı aşağıdaki kriterlere göre yargılayın.

Lütfen dikkat: Başlamadan önce .NET 9 SDK, komut çalıştırabilen bir AI kodlama ajanı, internet bağlantısı ve IRONBARCODE_LICENSE_KEY ortam değişkeninde bir IronBarcode deneme ya da üretim anahtarı gerekir. IronBarcode, anahtar olmadığında filigran eklemek yerine hata fırlatır, bu yüzden bu test bir anahtar olmadan geçemez.

İstem

Build a .NET 9 minimal API for shipping labels with two endpoints: GET /label/{trackingNumber} returns a Code 128 PNG with the value printed below the bars, and POST /scan accepts an uploaded image and returns every barcode it contains as JSON (value and format). Work start to finish alone: write, build, run, and fix, making sensible assumptions where anything is unspecified. Save every deliverable to the project root.

1. Install the BarCode NuGet package pinned to version 2026.9.2.
2. Read from https://ironsoftware.com/barcode/csharp/llms.txt and the pages it links to, using only APIs documented there.
3. Read the license key from the IRONBARCODE_LICENSE_KEY environment variable at startup. If IronBarCode.License.IsLicensed is false, stop and report that instead of continuing.
4. Generate a test set of 12 barcodes into a testset folder: 4 Code 128 tracking numbers, 3 QR codes carrying order URLs, 3 DataMatrix codes carrying GS1 element strings, and 2 EAN-13 codes with correct check digits. Name each PNG after its format and index.
5. Implement /scan with BarcodeReaderOptions narrowed to those four formats and ExpectMultipleBarcodes enabled.
6. Build in Release, run the API, call /label for one tracking number, then POST every testset image and the /label output to /scan.
7. Write roundtrip.md: a table of file, written value, read value, format, and match. All 13 must match; if any do not, fix the cause and run again.
8. Finish with a short report: build result, match count, and assumptions made.
Text

Çıktı

Kabul testi çalıştırmasında GET /label tarafından döndürülen, 1Z999AA10123456784 takip numarası için Code 128 kargo etiketi

Bu, kaydedilmiş çalıştırma sırasında GET /label/1Z999AA10123456784 tarafından döndürülen özgün PNG'dir. Aynı çalıştırmadan alınan gidiş-dönüş tablosu, 13 görüntünün tamamını yazılan ve çözümlenen değerleriyle birlikte listeler.

Geçme ölçütleri

  • Release derlemesi, manuel müdahale olmadan tamamlanır.
  • roundtrip.md, 13 satırın 13'ünün de eşleştiğini gösterir; okunan her değer yazılanla eşleşir ve her format doğrudur.
  • Her iki EAN-13 değeri geçerli kontrol rakamları taşır ve GS1 dizeleri değişmeden geri gelir.
  • Lisans anahtarı ortamdan alınır; ne kaynak kodda ne de roundtrip.md içinde yer alır.
Lütfen dikkat: Sürümü kendi projenize göre sabitlemek için 1. adımdaki sürümü hedeflediğiniz sürümle değiştirin. IronBarcode değişiklik kaydı, her sürümde neyin değiştiğini listeler.

Çalıştırma kaydı

ÖğeDeğer
PaketBarCode 2026.9.2
Hedef çerçeve.NET 9
Ajan ve modelClaude Code, Opus 5
MakineWindows 11 x64, Intel Core i9-14900KF, 64 GB RAM
SonuçRelease derlemesi geçti, 13'te 13 gidiş dönüş eşleşti
Referans çıktısılabel.png, roundtrip.md
Son test tarihi16 Eylül 2026

Çalıştırma sırasında bir derleme düzeltmesi gerekiyordu ve hiçbir kod manuel olarak düzenlenmedi.


Ajana Özgü Kılavuzlar

Yukarıdaki kurulum bu araçların hepsiyle çalışır. Aşağıdaki kılavuzların her biri bu kurulumu tek bir araca uyarlar:


Sorun Giderme


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 2,564,559Sürüm:2026.11yeni çıktı