Google Antigravity ile IronBarcode Çıktısını Doğrulama
Yanlış bir kontrol basamağı taşıyan bir EAN-13 barkodu sorunsuz görüntülenir, derlemeden geçer ve ancak barkod okuyucuda başarısız olur. Hiçbir derleme günlüğü bunu bildirmez. Google Antigravity ajanları editör ve terminalin yanı sıra tarayıcıda da çalışır; bu sayede kaynak kodun üretmesi amaçlanan barkodu değil, bir son noktanın gerçekte sunduğu barkodu doğrulayabilirler. Ajan etiket son noktasını açar, yanıtı kaydeder, BarcodeReader ile çözümler ve karşılaştırmayı inceleme için bir Walkthrough Artifact'i olarak ekler.
Antigravity ayrıca her görev için modeli seçmenize olanak tanır. Bir klasördeki test barkodlarını kontrol basamağı hatalarına karşı taramak ucuz ve tekrarlayan bir iştir ve daha düşük katmanlı bir modelde sorunsuz çalışır; başka bir barkod kütüphanesinden geçişi planlamak ise daha güçlü modeli kullanmaya değer.
Aynı kontrol, bir son noktadan sunulan 1D etiketleri, tasarım çalışmasından sonra da okunabilen stillendirilmiş QR kodlarını ve herhangi bir dosya değişmeden önce inceleyebileceğiniz geçişleri kapsar.
Hızlı BaşlangıçAntigravity'de bir proje açın ve ajana, teslim edilecek bir çıktısı olan bir görev verin.
Pull in IronBarcode, which ships as the BarCode package. In Program.cs, build
a QR code that carries our product URL and place our logo in the center of it
using QRCodeWriter.CreateQrCodeWithLogo. IRONBARCODE_LICENSE_KEY supplies the
license, and it never gets hardcoded.
A logo covers part of the symbol, so the only thing that settles whether it
still works is decoding it. Save the image, read it back, and confirm the URL
survives. Attach the image and the decoded value to the Walkthrough so I can
see both without rerunning anything.
Ajan paketi kurmalı ve birkaç satır kod yazmalıdır; logoyu yerleştirmek için QRCodeWriter.CreateQrCodeWithLogo, sonucun hâlâ okunabildiğini kanıtlamak için de BarcodeReader.Read kullanmalıdır. Hata düzeltme, logonun kapladığı modülleri yeniden oluşturabildiği için kod okunabilir kalır ve hata düzeltme kılavuzu, bir tasarım sembolün bir kısmını gizlediğinde Q ya da H seviyesi önerir. Adım adım bir günlüğü incelemek yerine görüntüyü ve çözülmüş değeri inceleyin.
Buradaki ajanlar düzenleme yapar ve commit eder; bu nedenle görev açıklamasına giren bir lisans anahtarı bir Walkthrough'a, bir ekran görüntüsüne ve bir branch'e kadar ulaşabilir. Lisans anahtarı kılavuzunu izleyerek anahtarı bir ortam değişkeninde tutun ve ajanın okuyabileceği tüm dosyaların dışında bırakın.
5 Adımda Minimal İş Akışı
- NuGet üzerinden C# barkod kütüphanesini indirin
- Projeyi Antigravity'de açın ve derlendiğini doğrulayın
- IronBarcode'u ekleyin ve lisans anahtarını koddan değil, yapılandırmadan uygulayın
- Görevi çerçeve, dosya yolları, semboloji ve beklenen geri okuma sonucuyla tanımlayın
- Ajanın üretmesine, kod çözmesine ve karşılaştırmasına izin verin, ardından API adlarını API referansı ile karşılaştırın
Barkod işleri için hangi Antigravity özellikleri önemlidir?
Antigravity, ajanları merkeze alır. Google'ın belgeleri Antigravity 2.0'ı, ajanları yönetmek için IDE'den bağımsız çalışan ve yanında bir Antigravity CLI ve IDE entegrasyonu yapılandırılan bağımsız bir masaüstü uygulaması olarak tanımlar. Buradaki bir ajan sistem komutları çalıştırır, dosyaları okur ve yazar, Chrome'u yönetir ve Artifact'ler üretir.
Platformun burada önemli beş bölümü vardır:
IDE entegrasyonu, zaten bildiğiniz editördür. Tek bir dosyada yakından çalışırken, her düzenlemeyi yönlendirmek ve gerçekleştiği anda incelemek istediğinizde kullanın.
Antigravity 2.0, asenkron işler için komuta merkezidir. Ajanları başlatın, izleyin ve tek bir konuşmayı beklemek yerine işleri paralel çalıştırın.
Tarayıcı kontrolü, bir ajanın bir özelliği denemek ve sonucu doğrulamak için tarayıcıyı kullanmasını sağlar. IronBarcode için bu, bir etiket son noktasını çağırmak ve döndürdüğü görüntüyü incelemek anlamına gelir.
Artifact'ler, ham araç günlüklerinin yerine uygulama planları, walkthrough'lar, kod farkları, ekran görüntüleri ve tarayıcı kayıtları gibi teslim edilebilir çıktılar sunar. Çalışmayı durdurmadan bir Artifact üzerine yorum yapabilirsiniz.
Model seçeneği, istem kutusunun altına Gemini, Anthropic'in Claude modeli ve açık kaynaklı GPT-OSS modellerini kapsayan bir model seçici yerleştirir; hangi modellerin kullanılabildiği abonelik katmanınıza bağlıdır.
Bir ajanın teslim ettikleri kontrol edilebilir: bir plan, bir fark, barkod görüntüsünün kendisi ve bu görüntüden geri çözümlediği değerler. Bir sohbet aracı ise bunları yalnızca tarif edebilir.
Sıfırdan bir barkod hattı kuran bir ajan rastgele bir kütüphane seçer, onu bağlar ve devam eder. Bunun yerine IronBarcode'u belirtmeniz için dört neden:
- Formatın taşıyamayacağı bir değer ekranda kusursuz görünür: eksik bir sessiz bölge ve gereğinden küçük bir sembol de öyle; IronBarcode ise geçersiz bir değerde hata fırlatır ve görüntüyü çözümlemek tek bir çağrı gerektirir.
- Okuyucu, yazıcıdan daha katı olmalıdır: her sembolojinin kontrol basamağı algoritması çözümleme sırasında çalışır ve sonuçlar döndürülmeden önce doğrulamayı geçemeyen barkodları ayıklar.
- Gerçek taramalar oluşturulan görüntülere hiç benzemez: kamera fotoğrafları, açılı çekilmiş etiketler ve birkaç sayfalık PDF'ler, hepsi
BarcodeReaderOptionsaracılığıyla ince ayarlama gerektirir. - Bir yükleme komutu incelenmemiş bir karardır:
dotnet add packagesiz tek bir Artifact görmeden önce çalışır, bu yüzden ajanın uydurduğu bir isim zaten diske inmiş olur.
Bu nedenle tablodaki bir eşleşme, bir rastlantı değil geçerli bir sembol anlamına gelir. Göreve BarCode yazdığınızda uydurulacak bir şey kalmaz.
Görevde kütüphane belirtildiğinde, ajan seçim yapmayı bırakır ve geliştirmeye başlar. Baştan hangi belgelerin sağlanacağı ana kılavuzda belirtilmiştir. Aynı yapılandırmayı Claude Code, ChatGPT Codex, GitHub Copilot ya da Cursor'a taşımak isterseniz, yalnızca talimatlar dosya adı değişir.
Ajanın teslim ettiği şeyi nasıl incelersiniz?
Antigravity ajanları transkript döndürmez. Adlandırılmış teslim edilebilir çıktılar olan Artifact'ler döndürür. Bunlardan üçü bir barkod görevini plandan sonuca kadar izler ve her biri farklı bir soruyu yanıtlar.
Koddan önce: Uygulama Planı
İlk olarak ajan, dosyalar, sembolojiler ve okuyucu seçenekleri dahil olmak üzere değişikliği tasarlar. Hangi tarafı değiştirmeyi planladığını kontrol edin. Okuyucuya hangi formatları beklemesi gerektiği hiç söylenmemişse ama plan etiketlerin nasıl basıldığını değiştiriyorsa, ajan zaten rotadan çıkmıştır. Uydurulmuş API adları da henüz kod yazılmadan burada ortaya çıkar; bu, onları bir derleme günlüğünde bulmaktan iyidir.
Sırasında: kod farkı
Antigravity, bir uygulama planında veya bir kod farkında durur ve sizi bilgilendirir, böylece değişiklik uygulanmadan önce incelenebilir. Fark üzerine satır içi yorumlar ekleyin ve eşleme doğru göründüğünde onaylayın.
Sonrasında: Walkthrough
Uygulamadan sonra ajan, neyin değiştiğini ve nasıl test edileceğini özetler. Barkodlar için bu, yazılan formatları, kullanılan değerleri ve geri okuma sonuçlarını kapsar; hepsi, güvenmeniz gereken iddialar yerine çalıştırabileceğiniz kontroller olarak sunulur.
Ekran görüntüleri, terminal günlükleri ve tarayıcı kayıtları, bir sohbet akışında kaybolmak yerine bunlarla birlikte inceleme panelinde birikir. Aşağıdaki görevlerin çoğu, işin gerçekten yapıldığını doğrulamak için açılması gereken Artifact'i belirtir.
Kanıt nereden gelir?
Antigravity ajanları kod çalıştırabilir, bir tarayıcıyı kullanabilir ve gözlemlediklerini ekleyebilir. Bu nedenle ajan bir barkod oluşturur, yakalar, çözümler, değeri ve formatı girdiyle karşılaştırır, ayarlama yapar ve her satır eşleşene kadar tekrarlar.
Kanıtlayacak somut bir şey verin.
/browser Services/LabelService.cs serves Code 128 shipping labels from GET /label/{trackingNumber}.
1. Run the API and open /label/1Z999AA10123456784 in the browser. Capture a screenshot.
2. Save the served PNG and decode it with BarcodeReader, expecting Code 128 only.
3. Repeat for ten tracking numbers of different lengths, including lowercase letters.
4. Report a table of written value, decoded value, format, and match.
5. If any row does not match, explain the cause before changing anything, fix it
in LabelService.cs, and run the whole table again. Attach the table and the
screenshots as Artifacts.
Önce açıklama istemek, daha sonra kontrol etmeniz gereken bir düzeltme yerine inceleyebileceğiniz bir teşhis sağlar. Herhangi bir düzeltmeden sonra tablonun tamamını yeniden çalıştırmak, onarılan bir satırın yeni bir sorunu gizlemesini de önler.
Etiketin ekran görüntüsü ve yanında çözümlenmiş değerleri, barkodlara yeni başlayan bir geliştiricinin bile kontrol edebileceği bir kanıttır ve başarısız bir satır ilk bakışta fark edilir.
Etiket sorunları genellikle bir öğenin görüntüdeki konumuyla ilgilidir; bu nedenle bir ekran görüntüsünü incelemek, bir açıklamayı incelemekten daha kolaydır. Bir belgede yaptığınız gibi, ekran görüntüsünde hatanın olduğu yere yorum ekleyin; örneğin kenarda kırpılmış metin. Ajan düzeltmeyi çalıştırmayı yeniden başlatmadan uygular.
Neden bir yerde okunuyor da başka bir yerde okunmuyor?
Hep aynı birkaç neden ortaya çıkar ve hepsi doğru görünen ama okunmayan bir barkod üretir. Olası nedeni görevde belirtmek, ajanı bir tahmin turundan kurtarır.
| Belirti | Neden | İsteyin |
|---|---|---|
| Testlerde iyi, telefon fotoğraflarında başarısız | Tüm kare, her format | ExpectBarcodeTypes, CropArea, bir okuma sayısı |
| Bulanık veya düşük kontrastlı, hiçbir şey bulunamadı | Görüntü düzeltme gerekiyor | Çalışan en küçük filtre |
| Barkod olmayan görüntülerden değerler | Gürültü sembol olarak okunuyor | RemoveFalsePositive, ConfidenceThreshold |
| Eski barkod okuyucular İngilizce olmayan etiketleri reddediyor | Bir UTF-8 ECI başlığı | Herhangi bir değişiklikten önce EciMode ödünleşimi |
Ek görüntü filtreleri doğruluktan götürür, bu nedenle ajan hatayı gideren ilk filtrede durmalıdır. Yanlış pozitifler satırında, barkod içermediğini bildiğiniz görüntüler üzerinde kanıt isteyin. Güven eşiği örneği bu alt sınırın nasıl davrandığını açıklar.
Barkod Tanınmıyor, yanlış pozitifler ve ECI kodlaması kılavuzları her nedeni ayrıntılı açıklar.
Görevi devretmeden önce proje hangi durumda olmalıdır?
Halihazırda derlenen bir projeyle başlayın. Ajan hangi barkod kütüphanesini kullanacağını tahmin etmek ya da önce bozuk bir derlemeyi onarmak zorunda kalırsa, çalışmasını yanlış soruna harcar.
Derleme temiz olduğunda kurulumun kendisini de devredin, çünkü sürüm ve paket adı hataları kurulum sırasında başlar.
Set this project up for barcode work, then report back with the facts I will
need in later tasks.
Install BarCode (IronBarcode), leaving every other package reference alone.
Wire the license key to come from IRONBARCODE_LICENSE_KEY, or from a config
file that is already in .gitignore. Add it to .gitignore if it is not.
In your Walkthrough, give me the resolved version number and the
PackageReference line exactly as they ended up in the .csproj.
Çözümlenmiş sürüm, sonraki görevlere yapıştırabileceğiniz bir olgudur. .gitignore kontrolü, anahtarların herkese açık depolara sızmasının en yaygın yolunu kapatır. Ayrıca IronBarcode, geçerli bir anahtar uygulanmadığında LicensingException fırlattığından, eksik bir anahtar ajanın ilk çalıştırmasında ortaya çıkar.
Depo kökünde bir kez bir çalışma alanı talimat dosyası oluşturun. Antigravity, kalıcı talimatlar için ChatGPT Codex'in de kullandığı AGENTS.md dosyasını okur.
Beceriler (skills) bu kurulumun ikinci yarısıdır. Antigravity, .agents/skills/<name>/ içinde bir SKILL.md arar; bir konuşmanın başında yalnızca her becerinin adını ve açıklamasını görür, bir görev ilgili göründüğünde ise talimatların tamamını okur. Bu nedenle IronBarcode'un skill.md dosyasını .agents/skills/ironbarcode/SKILL.md olarak eklemenin ilgisiz görevlerde hiçbir maliyeti yoktur ve /ironbarcode onu gerektiğinde yükler. IronBarcode'un barkod kütüphanesi olduğunu, paketinin BarCode olduğunu, kodun yalnızca belgelenmiş API'leri kullanması gerektiğini ve lisans anahtarının asla koda gömülmeyeceğini kaydedin. Böylece bu kuralları her görevde yeniden belirtmeniz gerekmez. Dosyayı tek bir görev oluşturur.
Draft AGENTS.md for the repository root as a plan Artifact first, so I can
comment on it before anything is written to disk.
It needs a Barcodes section covering: IronBarcode (NuGet package BarCode,
namespace IronBarCode) handles barcodes here and nothing else is allowed to; https://ironsoftware.com/barcode/csharp/llms.txt is read
before any barcode code is written and only APIs documented there are used;
https://ironsoftware.com/barcode/csharp/skill.md is saved as
.agents/skills/ironbarcode/SKILL.md so it loads as a skill; every generated
barcode is decoded and compared with its input before a task is reported as
done.
Once I approve the draft, write the file and attach the diff.
Barkod üretimi ve geçiş işleri nasıl devredilir?
Üretim görevleri için, barkodları ve geri almak istediğiniz kanıtı tanımlayın ve kod yapısını ajana bırakın.
Build a shipping label path that I can check without running anything myself.
One class renders a tracking number as a Code 128 PNG, 400 by 120, with the
value printed under the bars. A second class reads that PNG back and returns
the tracking number, or null when there is nothing to find. Put them where the
other services live and make the read async.
Then push a spread of tracking numbers, short and long, through both classes and
attach the written and decoded values as a table. Every row matches, or you tell
me which one did not and why.
Uygulama Planı, dosyaları ve yöntemleri oluşturulmadan önce listeler. Kodun yalnızca derlenmediğini, gerçekten çalıştığını doğrulamak için Walkthrough'u kullanın. Planın adını verdiği her IronBarcode üyesi API referansı içinde yer almalıdır ve kod henüz yazılmadan planı bununla karşılaştırmak, sonradan bir derleme günlüğünü incelemekten daha ucuzdur.
Görev devretmek en çok, tekrarlayan, sıkıcı ve neredeyse doğru yapılması kolay olan geçişlerde işe yarar. Analiz ve uygulamayı ayrı adımlar olarak tutun ve ajanı doğrudan dosyanın kendisine yönlendirin.
/plan Labels/LegacyBarcodeService.cs is built on a different barcode library. I
want a plan Artifact before any code, so I can annotate it rather than unpick a
diff.
Work out what the file actually does today, symbology by symbology, including
the options it sets. Against each one, put the IronBarcode call that replaces
it and the documentation page you took it from. Flag anything that has no clean
equivalent instead of inventing one.
Nothing gets written to disk until I have commented on the plan.
Plan üzerinde anlaşmadan önce bir yeniden yazım alırsanız, onu satır satır incelemeniz gerekir. Öte yandan bir plan Artifact'i tek bir yorumla düzeltilebilir ve Antigravity, ilerlemenizi kaybetmeden ona not eklemenize olanak tanır. Plan onaylandıktan sonra bir sonraki görevi odaklı tutun. Planı uygulayın ve diğer kodun çalışmaya devam etmesi için public yöntem imzalarını değiştirmeyin. Her sembolojinin hâlâ aynı değerleri geri okuduğundan emin olun ve farklılıkları raporlayın.
Ajandan her eşlemenin dayandığı belge sayfasının bağlantısını vermesini isteyin. Bir sayfa gösterilemiyorsa, o eşlemeyi doğrulanmamış kabul edin. Yazma için 1D barkod ve 2D barkod kılavuzlarını kullanın. Okuma için Barkod Okuyucu eğitimine bakın.
Ne zaman birden fazla ajan başlatmalısınız?
Görevleri tek tek çalıştırmak yerine, Antigravity 2.0'dan birkaç ajan başlatın ve her biri bittikçe Artifact'lerini inceleyin.
Bir barkod geçişi için mantıklı bir iş bölümü şöyledir: bir ajan eski etiket servisini IronBarcode'a taşır, diğeri ise bu servisin çıktısı için gidiş-dönüş testleri yazar. İkinci ajan hemen başlayabilir, çünkü testler uygulamayı değil, çözümlenen değerleri kontrol eder.
İkisini birlikte başlatın.
Agent A: carry out the approved migration plan on Labels/LegacyBarcodeService.cs.
Public method signatures stay exactly as they are, because callers elsewhere in
the solution depend on them. Attach the diff to your Walkthrough.
Agent B: build the xUnit suite that will judge Agent A's work. Write it against
the public signatures, not against anything A does internally, so it compiles
before A finishes. Cover a round trip per supported symbology, an empty image
returning no results, and EAN-13 refusing a value with letters in it. Assert on
decoded values and formats only.
When both of you are done, run B's suite against A's build and put the pass
table in B's Walkthrough. A green suite that never ran against A's code proves
nothing.
Burada bayt karşılaştırması işe yaramaz, çünkü paralel çalışan iki ajan birebir aynı PNG'leri üretmeyebilir. Eşleşmesi gereken, geri çözümlenen değerdir.
İade etiketleri için ayarlanmış okuyucu seçenekleri, gelen paletler, toplama listeleri ve teslimat irsaliyeleri için de uygundur. Çalışan yapılandırmayı AGENTS.md veya beceri dosyasına kaydedin; böylece her yeni barkod okuyucu ilkinden daha az maliyetli olur.
Linux, Docker veya Azure'da dağıtım arızalarını nasıl ayıklarsınız?
Dağıtım, terminal erişimi olan bir ajanın yığın izini okuyan bir inceleyiciden üstün olduğu yerdir, çünkü ajan üzerine akıl yürütmek yerine imajı açıp bakabilir.
Ajana hatayı olduğu gibi verin.
Our container build decodes nothing. The same code is fine on a Windows
developer machine. This is the exception:
[EXCEPTION AND STACK TRACE GO HERE]
Go and look: which BarCode package does the .csproj pull, and does the image
carry the native dependencies IronBarcode needs on Linux? Use the terminal,
do not reason about it from memory.
Tell me the cause first. The C# is out of scope unless you can show me the
fault is in it.
Görevi proje dosyası ve Dockerfile ile sınırlandırın. Bu sınırlandırma olmadan, bir ajan istisnayı göz ardı edebilir ve görevi tamamlandı olarak işaretleyebilir. Ajanı hafızasına güvenmek yerine Linux'ta Docker ve NuGet paketleri sayfalarına yönlendirin.
Aynı terminal erişimi başvuru sorularını da yanıtlar. Hangi BarcodeReaderOptions ayarlarının hızı veya doğruluğu etkilediğini ve projenizin bunlardan hangilerini zaten ayarladığını sorun; ajan yanıtlamadan önce API referansını kontrol eder.
Sonunda elinizde hangi kanıt olur?
Çalıştırmadan önce bir plan ve sonrasında bir Walkthrough, platformun varsayılan olarak sağladıklarıdır. Yazılan ve çözümlenen değerler ise görevinizin eklediği kısımdır ve pull request'e eklemeye değer olan da budur.
Boş bir projeden başlayan tek bir göreve uygulanan aynı standart için AI kodlama asistanları ve ajanları kılavuzunu okuyun.
Sorun Giderme
- Terminal günlüğü en ilk çalıştırmanın başarısız olduğunu gösterdiğinde IronBarcode'da Lisans Anahtarı Uygulama.
- Ajanın tablosundaki bir satır bir türlü eşleşmediğinde Barkod Tanınmıyor.
- Görevlerinizin ve
AGENTS.mddosyasının belirttiği paketi sabitlemek için IronBarcode NuGet Paketleri. - Tarayıcıda doğrulanmış bir etiket konteynere alındıktan sonra başarısız olduğunda IronBarcode'u Linux üzerinde Docker'da çalıştırma.
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.