AI Kodlama Asistanları ve Ajanları ile IronBarcode Kullanma
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.
AI Kodlama Asistanı veya Ajanı ile IronBarcode Nasıl Kullanılır
- NuGet üzerinden C# barkod kütüphanesini indirin
- Lisans anahtarınızı uygulama başlangıcında, ortam değişkeninden uygulayın
- Aracı IronBarcode'un
llms.txtdokümantasyon dizinine yönlendirin - IronBarcode talimatlarını proje bağlam dosyanıza ekleyin
- Yeni bir oturumda tek seferlik kurulum istemini çalıştırın
- Oluşturulan kodun derlendiğini ve her barkodun geri okunabildiğini doğrulayın
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.Verifygö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.txtiç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.
Alternatif olarak, paketi terminalden güncel sürümü belirterek yükleyin.
dotnet add package BarCode --version 2026.9.2
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.
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");' Read the key from configuration. Never commit it to the repository.
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE_KEY")' 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.
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:
| Kaynak | Açıklama | Ne zaman kullanılmalı |
|---|---|---|
llms.txt | Tüm dokümantasyon sayfalarının dizini, her satırda bir tane | Her oturumun başında |
llms-full.txt | Tek bir dosyada tam rehberler ve örnekler | Araç URL'leri alabilir |
llms-full-catalog.txt | Dizin artı tüm blog makaleleri | Cevap bir blog makalesinde bulunabilir |
| API Referansı | Mevcut sürümdeki tüm sınıflar ve yöntemler | Bir yöntemin var olduğunu doğrulamak |
skill.md | Kurulum, lisanslama, tarifler ve düzeltmeler | Aracı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.
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.
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 Code | CLAUDE.md | .claude/skills/ |
| ChatGPT Codex | AGENTS.md | .agents/skills/ |
| GitHub Copilot | .github/copilot-instructions.md | yok |
| Cursor | .cursor/rules/*.mdc | yok, @Docs kullanın |
| Google Antigravity | AGENTS.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.
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.
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.ReadveBarcodeReaderOptionskullanarak, 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:
- Derlenir: uydurma bir yöntem hemen başarısız olur.
- Lisans anahtarı uygulanır: ilk IronBarcode çağrısından önce ayarlanmış olmalıdır, yoksa o çağrı
LicensingExceptionfırlatır. - Her API yöntemi mevcuttur: başka bir yöntem aramadan önce bilinmeyen bir yöntem için API referansına danışın.
- Her barkod okunabilir: her oluşturulan görüntüyü
BarcodeReaderveyaGeneratedBarcode.Verifyile çö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.DatabarveBarcodeWriterEncoding.DataBarfarklı 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.
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.
İ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.
Çıktı
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.mdiçinde yer alır.
Çalıştırma kaydı
| Öğe | Değer |
|---|---|
| Paket | BarCode 2026.9.2 |
| Hedef çerçeve | .NET 9 |
| Ajan ve model | Claude Code, Opus 5 |
| Makine | Windows 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 tarihi | 16 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:
- IronBarcode'u Claude Code ile Kullanma.
- IronBarcode'u ChatGPT Codex ile Kullanma.
- IronBarcode'u GitHub Copilot ile Kullanma.
- IronBarcode'u Cursor ile Kullanma.
- IronBarcode'u Google Antigravity ile Kullanma.
Sorun Giderme
- IronBarcode'da Lisans Anahtarı Uygulama, ilk barkod çağrısı hata fırlattığında anahtarı ayarlamanın tüm yollarını kapsar.
- Barkod Tanınmıyor, yazılabilen ancak çözümlenemeyen bir sembolün sorununu adım adım ele alır.
- IronBarcode NuGet Paketleri, hangi paketin hangi platforma ait olduğunu listeler.
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.