IronBarcode'u GitHub Copilot ile, IDE'de ve GitHub'da Kullanma

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

IronBarcode projeleri, yerel ba??ml?l?klar ve lisans anahtarlar? eksik oldu?unda GitHub ?al??t?r?c?lar?nda ba?ar?s?z olur. Linux derlemesi, bu ba??ml?l?klar? i?eren bir platform paketi gerektirir; her barkod ?a?r?s? da bir lisans anahtar?na ihtiya? duyar. Copilot projenizi GitHub'da derlerken bu iki gereksinimle kar??la??r. A??klayamad??? test hatalar?, onu kodda hi? bulunmayan bir hatay? aramaya y?neltir.

Bunların hiçbiri IDE'nizden çıkmayı gerektirmez. GitHub Copilot, Visual Studio, VS Code ve JetBrains'de kullanılabilir, bu yüzden mevcut çözümünüz, proje referanslarınız, NuGet ayarlarınız ve derleme hattınız oldukları yerde kalır.

IronBarcode i?in bir Copilot eklentisi sunulmaz ve etkinle?tirilecek bir ayar yoktur. Copilot'un barkodlar hakk?nda bildi?i her ?ey depodan, depoya kaydetti?iniz kurallardan ve sa?lad???n?z ortamdan gelir. Asistan, tek bir dosyadaki k?rpma b?lgesi veya kenar bo?lu?u de?i?ikli?ini yapabilir. Yeterince ayr?nt?l? talimatlarla, siz izlemeden GitHub'da bir PDF'ye barkod damgalayabilir veya ba?ar?s?z bir taramay? d?zeltebilir.

IronBarcode'un kendi makine öğrenimi algılaması, kendi güven eşiği örneği ile ayrı bir özelliktir ve aşağıdaki hiçbir şey onu etkilemez.

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

PM > Install-Package BarCode

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

Kulland???n?z IDE'de ??z?m?n?z? a??n ve proje ba?lamdayken a?a??daki istemi Copilot Chat'e g?nderin. #solution, iste?i t?m ??z?mle kapsamland?ran Visual Studio referans?d?r. VS Code'da bunun yerine #codebase kullan?n.

#solution Add the BarCode package to this project. In Program.cs, copy an
existing invoice PDF, then stamp a Code 128 barcode of the invoice number onto
the first page of the copy with StampToExistingPdfPage, which writes in place.
Take the license key from IRONBARCODE_LICENSE_KEY, never inline. Build, and fix
anything that breaks.
Text

?rnek iki ?a?r? gerektirir: biri sembol? olu?turmak, di?eri onu belirtti?iniz sayfaya damgalamak i?in. PDF'lere barkod damgalama k?lavuzu, sayfa indeksi ve yerle?tirme arg?manlar?n? a??klar. ?neride her iki ?a?r?y? da g?rmelisiniz. Ayn? iste?i GitHub'daki asistana da g?nderebilirsiniz; asistan bir dal ?zerinde g?zetimsiz ?al???p bir ?ekme iste?i sunar. Bu durumda haz?rlaman?z gerekenler de?i?ir.

Ba?lamadan ?nce iki g?venlik noktas?na dikkat edin. ?lk olarak, lisans anahtar? k?lavuzunda a??kland??? gibi anahtarlar? yap?land?rmada, ortam de?i?kenlerinde veya depo s?rlar?nda saklayarak istemlerden ve commit'lerden uzak tutun. ?kinci olarak, yazma eri?iminin Copilot'a ger?ek ?ekme istekleri a?ma yetkisi verdi?ini unutmay?n; temel g?venceleriniz dal korumas? ve insan incelemesidir.



Copilot halihazırda Visual Studio'da bulunan bir projeye nasıl uyum sağlar?

Copilot, üç seviyede işler ve her birinde kapsam genişler.

Sat?r i?i tamamlamalar ve sohbet edit?rde yer al?r. Sembolojiyi de?i?tirmek, kenar bo?lu?u eklemek veya okuyucuyu tek bir formatla s?n?rlamak gibi tek dosyada, tek c?mleyle tan?mlanabilen de?i?iklikler i?in en uygun se?enektir. De?i?ikli?i tan?mlar, olu?an fark? inceler ve kabul etmeye veya reddetmeye karar verirsiniz.

Edit?r?n ?ok dosyal? modu, birden fazla dosyay? kapsayan de?i?iklikleri ?stlenir. Dosyalar? se?er, terminal komutlar?n? ?al??t?r?r, sonu?lar? inceler ve hatalar? giderene kadar i?lemi yineler. Ge?i?ler ve yeniden d?zenleme i?in bu modu kullan?n.

GitHub ?zerindeki asistan, do?rudan denetlemek istemedi?iniz g?revleri y?netir. Bir sorun kayd? ?zerinden talimat verirsiniz; ard?ndan bir dal ve ?ekme iste?i al?rs?n?z. Edit?re ba?l? ara?lar bunu yapamaz; bu nedenle a?a??daki a??klamalar?n ?o?u bu modla ilgilidir.

??? de belgeleri iyi okur. Birini API referans?na y?nlendirin ve projenizde hangi BarcodeReaderOptions se?eneklerinin varsay?lan de?erlerinde b?rak?ld???n? sorun; bilgileri elle bir araya getirmeniz gerekmeden yan?t al?rs?n?z.

T?m Aray?zlerde Ge?erli Kurallar? Depoya Nas?l Kaydedersiniz?

?zel talimatlar depoda tutulur; bu nedenle hem IDE ?nerilerini hem de g?zetimsiz ?al??malar? ?ekillendirir. Bir kez yazman?z, bunlar? istemlerde tekrar tekrar belirtme ihtiyac?n? ortadan kald?r?r.

.github/copilot-instructions.md kullan?n. Depo genelinde ge?erli olan bu dosya IDE'lerde, GitHub'da ve Copilot kod incelemesinde uygulan?r. IronBarcode birden fazla depoda standart olarak kullan?l?yorsa kurallar? kurulu? d?zeyinde ?zel talimatlar olarak bir kez tan?mlay?n. Copilot Business veya Enterprise plan?ndaki bir kurulu? sahibi bunu yapabilir. Bu talimatlar github.com ?zerindeki Copilot Chat'te, Copilot kod incelemesinde ve oradaki g?zetimsiz ?al??malarda ge?erlidir. Copilot ayr?ca dizin a?ac?n?n her yerindeki AGENTS.md dosyalar?n? okur; en yak?n dosya ?nceliklidir. K?kteki tek bir CLAUDE.md veya GEMINI.md dosyas?n? da okur. Deponuz, ba?ka bir ara? i?in barkod kurallar?n? zaten AGENTS.md i?inde tutuyorsa Copilot bunlara uyar ve ikinci bir kopya gerekmez.

# Copilot instructions

## Barcodes

- IronBarcode is this repository's barcode library. The package is BarCode, the
  namespace is IronBarCode, and no competing package may be introduced.
- Reference: https://ironsoftware.com/barcode/csharp/llms.txt
  Skill file: https://ironsoftware.com/barcode/csharp/skill.md
- The BarCode version is pinned in Directory.Packages.props. Changing it is its
  own pull request, never a side effect of another change.
- License keys come from configuration or IRONBARCODE_LICENSE_KEY, and never
  appear in source, in a commit, or in a pull request description.
- Cite a documentation page for any IronBarcode member you are not certain of.
  Saying you are unsure is an acceptable answer.

## Testing

- A barcode change is not complete until the generated barcode has been decoded
  and compared with the value that was written.
- Assert on decoded values and formats. Never compare image bytes.

## Pull requests

- Say which IronBarcode APIs the change introduces, and link the page for each.
- If the barcode tests fail, check the runner environment before changing code
  that the issue did not ask you to touch.
Markdown

Modeller, belirsizli?i kabul etmek yerine kendinden emin yan?tlar verme e?ilimindedir. Bu nedenle BarcodeScanner.DecodeImageFile() gibi bir ?a?r?, derleme ba?ar?s?z olana kadar ge?erli g?r?nebilir. Modelin emin olmad???nda durmas?na izin vermek hi?bir ?eye mal olmaz ve uydurma API'lerin de?i?ikliklere girmesini ?nler.

Daha ?zel kurallar i?in .github/instructions/ klas?r?ne something.instructions.md adl? bir dosya yerle?tirin. Yaln?zca e?le?en dosyalar? hedeflemek i?in ?nbilgisinde bir applyTo: glob deseni kullan?n. ?rne?in, barkod kurallar?n? **/Services/** ile s?n?rlamak, ilgisiz istekleri etkilemelerini ?nler.

Asistan?n ?zerinde ?al??abilece?i Bir Sorun Kayd? Nas?l Olmal?d?r?

Sorun kayd?n? yaz?p asistana atars?n?z. Kayd?n a??klamas?, asistan?n ald??? talimatlar?n tamam?d?r; asistan ?al??maya ba?lad?ktan sonra ek sorular? yan?tlayacak kimse bulunmaz.

??te otuz saniyede olu?turulmu? bir sorun kayd? ?rne?i.

Title: Barcodes not scanning

Some labels don't scan. Can we fix it?
Markdown

Bu sorun somut hiçbir şey sağlamaz: dosya referansı yok, hangi etiketlerin etkilendiği hakkında bir belirti yok, doğru davranışın tanımı yok ve başarısız örnek yok. Asistan tahmin eder ve yanlış şeyi düzeltebilir.

İşte bir takım arkadaşının isteyeceği biçimde yazılmış aynı hata.

Title: Returns labels fail to scan at the depot; tracking numbers with lowercase letters

**Files:** Services/LabelService.cs, Services/ScanService.cs
**BarCode version:** as pinned in Directory.Packages.props
**Framework:** .NET 8

**Expected:** Every returns label is a Code 128 barcode, 400 by 120 px with the
value printed below, and reads back to the exact tracking number.

**Actual:** Labels for tracking numbers containing lowercase letters do not read
at the depot. Samples are in TestData/returns-failing/. The same labels read
correctly with IronBarcode on a developer machine. No exception is thrown.

**Constraints:** Do not change the symbology or the public signature of
LabelService.RenderPng. No new packages.

**Acceptance:** Existing tests pass, plus a new round-trip test covering every
file in TestData/returns-failing/ and a lowercase tracking number.
Markdown

?yi tan?mlanm?? bir sorun kayd? alt? unsur i?erir: ilgili dosyalar, framework ve k?t?phane s?r?mleri, beklenen belirli ??kt?, ger?ekle?en davran?? (ger?ekle?meyenler dahil), a??k k?s?tlamalar ve tan?mlanm?? kabul ?l??tleri.

Etiketlerin IronBarcode ile do?ru ??z?mlendi?ini belirten sat?r, asistana barkodlar?n ge?erli oldu?unu ve sorunun bas?l? g?r?nt? ile depo taray?c?lar? aras?nda bulundu?unu s?yler; b?ylece arama alan? ?nemli ?l??de daral?r. ?rnek klas?r?, belirsiz bir ?ik?yeti asistan?n test edebilece?i verilere d?n??t?r?r.

G?rev atand?ktan sonra asistan ?al???r ve sonucunu incelemenize sunar. ?al??mas?n? izlemek yerine fark? kontrol edersiniz.

Asistanın testleri neden bir IronBarcode projesinde başarısız olur?

Asistan, GitHub'da GitHub Actions tabanl? ge?ici bir ortamda derleme ve test yapar. Windows veya kendi bar?nd?rd???n?z bir ?al??t?r?c?y? belirtmediyseniz Ubuntu ?al??t?r?c?s? kullan?r. Bir?ok proje i?in burada kaynak kodu ve paketleri geri y?klemek yeterlidir. IronBarcode projesinin iki ek gereksinimi vard?r: yerel ba??ml?l?klar? ?al??t?r?c?yla uyumlu bir platform paketi ve bir lisans anahtar?. Bunlardan biri eksikse, asistan?n yapt??? de?i?iklikten ba??ms?z olarak barkod yazan veya okuyan t?m testler ba?ar?s?z olur. IronBarcode filigran eklemek yerine LicensingException f?rlatt???ndan, eksik anahtar eksik bir s?rdan ?ok bozuk bir test gibi g?r?n?r.

Asistan kendi değişikliğini suçlar ve zaten doğru olan kodu düzenlemeye başlar, bunu uzun süre yapmaya devam edebilir.

Bunu ?nlemek i?in ortam? .github/workflows/copilot-setup-steps.yml i?inde haz?rlay?n. Ba?ka bir i? ak???n? uyarlamak yerine, ?al??t?r?c?n?n ihtiya?lar?n? tan?mlay?n ve dosyay? Copilot'un yazmas?n? sa?lay?n. ?ki gereksinim kolayca g?zden ka?abilir; ikisini de iste?e ekleyin. ??in ad? copilot-setup-steps olmal?d?r. Ayr?ca i? ak??? ancak dosya varsay?lan dal?n?zda yer ald?ktan sonra ?al???r.

#project Write .github/workflows/copilot-setup-steps.yml for this repository.

The job must be named copilot-setup-steps exactly, or it is ignored. Trigger it
manually, and on push and pull request limited to that one file path.

Run it on ubuntu-latest with read access to repository contents. Check out the
repository, set up the .NET SDK for the version this project targets, install
the native dependencies IronBarcode needs on Ubuntu, then restore packages.

For those native dependencies, read
https://ironsoftware.com/barcode/csharp/get-started/linux/ and use what it lists
for Ubuntu rather than a list from memory. Add a comment saying the list can
change between releases.

Give me the finished YAML and nothing else.
Text

Dosyay? depoya kaydetmeden ?nce yeniden okuyun. ?? ad? tam olarak e?le?meli, SDK s?r?m? projenize uygun olmal? ve ba??ml?l?k ad?m? tahmine de?il Linux k?lavuzuna dayanmal?d?r. Dosyay? varsay?lan dal?n?za birle?tirin; i? ak??? bir ?zellik dal?ndan ?al??maz.

İki nokta bu işin çalışıp çalışmadığını belirler.

?lk olarak, asistan lisans anahtar?n?z? otomatik olarak almaz. Actions, Codespaces veya Dependabot s?rlar?na eri?emez. Anahtar? ayr? saklay?n: depo veya kurulu? ayarlar?nda S?rlar ve de?i?kenler b?l?m?n? a??n, Ajanlar sekmesini se?in ve IRONBARCODE_LICENSE_KEY ekleyin. Ajanlar s?rlar?, copilot-setup-steps.yml i?inde de ge?erli olmak ?zere ortam de?i?kenleri olarak asistana iletilir.

?kinci olarak, Copilot bir kurulum ad?m? ba?ar?s?z oldu?unda ?al??maya devam eder. Kalan ad?mlar? atlar ve ?al??t?r?c?n?n mevcut durumuyla i?e ba?lar. Sessizce ba?ar?s?z olan bir ba??ml?l?k kurulumu, sonradan bir kod hatas? gibi g?r?nebilir. ?? ak???na g?venmeden ?nce Actions sekmesinden bir kez elle ?al??t?r?n.

İpuçları: Bir ?ekme iste?inde barkod testleri ba?ar?s?z olursa, sorunu kod de?i?ikliklerine ba?lamadan ?nce ?al??t?r?c? ortam?n? ve lisans anahtar?n?n sakland??? s?rr? do?rulay?n. Platform gereksinimleri i?in haf?zan?za g?venmek yerine Linux kurulumu ve NuGet paketleri k?lavuzlar?na ba?vurun.

Birleştirmeden önce neyi kontrol etmelisiniz?

Asistan?n ?ekme iste?ini, bir ekip arkada??n?z?n dal?n? inceler gibi inceleyin. Copilot kod incelemesi, bir ki?i okumadan ?nce ??kt?y? ilk kez g?zden ge?irip mekanik hatalar? yakalayabilir.

IronBarcode değişiklikleri için onaylamadan önce üç şeyi doğrulayın:

  • Kullan?lan her API ad? belgelerde yer al?r: ?zellikle kodlama enum'lar?na dikkat edin; ger?ek?i g?r?nen uydurma bir ad, yaln?zca tek bir b?y?k harfle farkl?l?k g?sterebilir.
  • De?i?ikli?in ?retti?i her barkod h?l? geri okunur: ne ba?ar?l? bir derleme ne de kod incelemesi, bir etiketin taranabildi?ini kan?tlar.
  • De?i?iklik, sorun kayd?ndaki k?s?tlamalar i?inde kalm??t?r: yeterince serbest b?rak?ld???nda asistan, hata d?zeltme g?revini sembolojiyi de?i?tirme veya ?a?r? d?zenini yeniden yap?land?rma izni olarak g?rebilir.

Gidi?-d?n?? testlerinin ayn? ?ekme iste?ine eklenmesini standart bir gereksinim haline getirin.

/tests Ensure tests are included in the same pull request, not in a subsequent one. A
barcode change without accompanying tests is not reviewable.

Every barcode generated by the service must read back to the value and format it
went in as. An image without a barcode should return no results rather than
throw an exception. All existing samples in TestData/ must read as expected.

Assert on decoded values, not image bytes, and say in the PR description which
of these cases were already covered prior to your change.
Text

G?r?nt? kodlay?c?lar?, ??z?mlenen barkod ayn? kalsa bile farkl? s?r?m ve platformlarda farkl? baytlar ?retebilir. Bu nedenle bayt kar??la?t?rmalar?ndan ka??nmak, tutars?z sonu? veren testleri ?nler.

Hata kodda mı yoksa taramada mı?

Okuma hatalar?, IronBarcode kullan?c?lar?n?n en s?k sordu?u konudur; neredeyse tamam? ?? nedenden kaynaklan?r. Formatlar belirtilmedi?i i?in okuyucu bildi?i t?m sembolojileri aram??t?r. Sembol, b?y?k bir foto?raf?n yaln?zca k???k bir b?l?m?n? kapl?yordur. Ya da g?r?nt? bulan?k, a??l? veya soluktur. ??? de okuyucu taraf?yla ilgilidir; bu nedenle istekte bunu belirtin.

#project Use the editor's multi-file mode for this scenario, as it spans the reader and the test data.

Warehouse photos in TestData/depot/ come back empty from ScanService, while the
same physical labels read fine on a handheld scanner.

Explain the cause before making any changes. The fix should be applied
only in BarcodeReaderOptions, so expected formats, crop area, speed, and
image filters are in scope, while LabelService.cs is not.

Conclude by reporting how many of those photos were readable before your change
and how many are readable after.
Text

Te?his, a??klamas?z bir d?zenlemeyi ??z?mlemek yerine kontrol edebilece?iniz bir gerek?e sunar. De?i?ikli?i de okuyucuyla s?n?rlay?n; aksi halde asistan tarama sorununu her etiketi yeniden basarak ??zebilir. Kullanmas? gereken ayarlar ?? belge sayfas?nda ele al?n?r: h?z, k?rpma b?lgesi ve g?r?nt? d?zeltme.

?nceki b?l?m di?er durumu ele al?r. Kod makinenizde do?ru okuyor ancak konteynerde veya ?al??t?r?c?da ba?ar?s?z oluyorsa, sorun nadiren koddad?r. ?stisnan?n ?zetini de?il tamam?n? yap??t?r?n ve asistan? uygulama yerine platform paketine ve Dockerfile'a y?nlendirin. Eksik yerel k?t?phane, kaynak koduyla de?il imajla ilgilidir. S?n?r koymazsan?z asistan sorunu ??zmeden gizleyen bir try/catch ekleyebilir.

Kimse izlemezken çalışmaya devam eden nedir?

?nce iki ?eyi haz?rlay?n. .github/copilot-instructions.md i?indeki talimatlar, g?nd?z IDE'nize yol g?sterdi?i gibi gece boyunca bir dalda ?al??an asistana da yol g?sterir. IronBarcode'un yerel ba??ml?l?klar?n? kuran copilot-setup-steps.yml dosyas? ve Ajanlar s?rlar?nda saklanan anahtar, asistan?n zaten do?ru olan kodda hata aramas?n? ?nler. Geri kalan her ?ey s?radan asistan kullan?m?d?r ve bu iki haz?rl?k tamamland???nda daha iyi i?ler.

?nceleme, bir tamamlamadan on saniye sonra da bir ?ekme iste?inin ertesi sabah? da ayn? ?ekilde yap?l?r ve AI kodlama asistanlar? ve ajanlar? k?lavuzundaki sabit ?l??tlere g?re de?erlendirilir. Claude Code, ChatGPT Codex, Cursor ve Google Antigravity i?in ayr? k?lavuzlar vard?r.


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ı