Google Antigravity ile IronQR Nasıl Kullanılır
Bir Blazor yükleme sayfası uyarı olmadan oluşturulabilir ancak kullanıcı dosyalarını doğru bir şekilde işleyemeyebilir. Oluşturma işlemi, sayfanın etkileşimsiz olup olmadığını, büyük resimlerin yükleme limitlerini aşıp aşmadığını veya birden fazla geçiş içeren resimlerin sadece kısmen işlenip işlenmediğini belirtmez. Bu sorunlar yalnızca gerçek dünya testleri sırasında ortaya çıkar.
Google Antigravity bu zorluğu ele alır. Onun /browser komutu, yükleme kontrolünde dosyaları seçer. IronQR, yüklenen resimleri QrReader.Read kullanarak sunucu tarafında çözer, bu yüzden sayfanın JavaScript tarayıcısına ihtiyacı yoktur. Bu kılavuz, her iki aracı kullanarak bir ziyaretçi giriş sayfası oluşturmayı gösterir ve sonuçları, yüklenen her dosyanın beklenen değerleri ve sayfada gösterilen değerleri ile karşılaştırarak doğrular.
Terminoloji hakkında bir not. IronQR, zorlayıcı görüntülerde QR kodlarını algılamak için bir makine öğrenme modeli içerir, tarama modları kılavuzu'nda ayrıntılı olarak açıklanmıştır. Bu kılavuzda, 'AI', sayfayı yazmaktan ve test etmekten sorumlu kodlama temsilcisine atıfta bulunur.
Hızlı BaşlangıçAntigravity'de Blazor projesini açın ve /plan ile istenen sayfa yapılandırmasını belirtin.
/plan This repo is a .NET 9 Blazor Web App with Interactive Server render
mode. Add a visitor check-in page at /scanner. Staff pick a photo of a visitor
pass with InputFile, the server decodes it with IronQR (NuGet package IronQR,
namespace IronQr) by loading the upload into an AnyBitmap and calling
QrReader.Read, and the page lists every value found. Set
IronQr.License.LicenseKey once in Program.cs, read from IRONQR_LICENSE_KEY in
the environment, and never write the key to a file. Add a NavMenu link.
In the Implementation Plan, state the render mode the page will use and the
largest upload it will accept. Then build until dotnet build is clean.
Plan, iki ayarı belirtmelidir. Bir Blazor Web Uygulaması, sayfa etkileşime izin vermedikçe sayfayı statik olarak oluşturur, render modları kılavuzu'nun açıkladığı gibi. OpenReadStream 512.000 bayt üzerindeki herhangi bir dosyayı, Microsoft'un Blazor dosya yükleme kılavuzu uyarınca, varsayılan limitin arttırılmadıkça reddeder ve telefon fotoğrafları çok daha büyük olabilir. Her araç çağrısının onaylandığı agy -p ve --dangerously-skip-permissions ile çalıştırdığınızda, planı ve farkı birlikte gözden geçirin.
Temsilciye değişken adı IRONQR_LICENSE_KEY verin, asla değeri değil. Dosya yazan ve komut çalıştıran bir temsilci, bir yapıştırılmış anahtarı bir commit veya günlük içine kopyalayabilir. IronQR ayrıca IronQr.LicenseKey girdisini appsettings.json'den okur, bu da yanlışlıkla commit edilebilir. Lisans anahtarı kılavuzu her seçeneği kapsar.
Asgari İş Akışı (5 adım)
- C# QR kod kütüphanesini NuGet'ten indir
- Yerel sunucuda oluşturup çalışan bir Blazor Web Uygulaması ile başlayın.
- Tarayıcı sayfasını etkileşimli hale getirin ve yüklemeleri en büyük fotoğrafınızın üstünde sınırlandırın.
/browser, her test görüntüsünü yükleyin ve sayfanın ne gösterdiğini ekran görüntüsü ile alın.- Her görüntülenen değeri beklenen liste ile karşılaştırın.
Google Antigravity nedir ve bir sohbet asistanından nasıl farklıdır?
Antigravity ajanları bir değişiklik planlayıp kodu düzenleyerek bir terminal kullanır ve bir tarayıcıyı yönlendirir, ardından her adımı izlemek yerine inceleyebileceğiniz Artifacts içinde rapor sunar. Google, Antigravity 2.0'ı ajanları yönetmek için bağımsız bir masaüstü uygulaması olarak tanımlar ve CLI agy olarak yüklenir.
Bir paketi seçmesi için bırakılan bir temsilci, adını tahmin edebilir ve saldırganlar, potansiyel adları önceden kaydeder ve bunları kötü amaçlı yazılımlarla doldurur, bu uygulamaya slopsquatting denir. Pakete IronQR ve isim alanına IronQr adını verin.
IronQR'nin ajanlar için dokümantasyon bağlantıları ve tek soruluk bir kabul testi AI kodlama asistanları kılavuzu'ndadır.
Planda, farkta ve Yürüyüşte ne kontrol etmelisiniz?
Uygulama Planı, kodsuz bir görüntü ve birkaç kod olan bir görüntü için sayfanın ne gösterdiğini de belirtmelidir.
Kod farkında, yüklemenin AnyBitmap'a nasıl dönüştüğünü kontrol edin ve farkın kullandığı her IronQR üyesini API referansında arayın.
Tarayıcı görevleri için, Google Yürüyüşte ajanların ne yaptığını belirten ekran görüntüleri ve kayıtların sıkça bulunduğunu söylüyor. CLI çalışmamızda, sohbetteki her görev aynı walkthrough.md'i yeniden yazdı, bu yüzden o sadece en son görevin raporunu içeriyordu. Göndermek istediğiniz tablolardan herhangi birini bir sonraki istemden önce kopyalayın.
Gerçek bir tarayıcıda IronQR yükleme sayfasını nasıl test edersiniz?
/browser komutu, slash komutları referansına göre sayfaları açan ve ekran görüntüleri yakalayan sandbox'lu bir chrome alt ajanı başlatır. Sadece dosya yükleyerek doldurabileceği bir tablo isteyin.
/browser Run the app with dotnet run (the http profile listens on
http://localhost:5181) and open /scanner. Upload each image in TestData/scans
through the page's file input, one at a time, wait until the page shows a
result or a message, and screenshot it. TestData/scans/expected.csv lists the
values each image carries, separated by | when there are several, and an empty
cell means no code. Return a Walkthrough table of file, bytes, expected values,
values the page displayed, and pass or fail. When a row fails, quote the server
log or browser console line that explains it, or say that neither recorded
anything, before you edit anything. Then fix the page, restart the app, and
upload all seven images again. Stop the app at the end.
Sonuç listesindeki bir düzeltme, her görüntü için işaretlemeyi değiştirir, bu yüzden yalnızca tam bir tekrar, hiçbir şeyin gerilemediğini gösterir.
Her ekran görüntüsü bir resim eseri olarak kaydedilir. Bir problem gösterdiğinde, örneğin kısalan bir geçiş numarası gibi, yeni bir istem yerine ona yorum yapın.
Eksik veya yanlış QR değerlerine ne sebep olur?
Çoğu hatalı satır birkaç nedene geri dönük olarak izlenebilir ve muhtemel olanı bir sonraki takip görevinde isimlendirmek, temsilciyi deneme yanılma turundan kurtarır. IronQR'nin Blazor tarayıcı kılavuzundan sayfayı taze bir .NET 9 şablonuna ekledik ve başsız Chrome ile IronQR 2026.10.1 üzerinden yedi test görüntüsünü yükledik. Aşağıdaki her bir kusur temiz bir biçimde derlendi. Render modu eklendiği zaman, yedi resimden beşi doğru değeri gösterdi.
- Her görüntü için devre dışı kalan bir Tarama butonu, Quickstart planının belirtilen render modunu gerektirir.
- 48 MP fotoğraf (17,955,400 bayt), rehberin 10,000,000 baytlık kapasite sınırını aşar ve bir mesaj olmadan butonu devre dışı bırakır. En büyük fotoğrafınızın üzerinde bir sınır ayarlayın ve daha büyük dosyalar için bir mesaj gösterin.
- İki geçişin gösterildiği bir görüntüde tek bir değer gösterdiğinde, her sonucu listeleyin.
Projeyi ve Antigravity için kurallarını nasıl kurarsınız?
Temsilciye zaten oluşturan ve çalışan bir proje verin. Bunu dotnet new blazor --interactivity Server --framework net9.0 ile oluşturun, bir kez çalıştırın ve Properties/launchSettings.json içinde URL'yi not alın. Şablon her proje için farklı bir port seçer ve /browser istemi onu gerektirir.
Sonra paket ve anahtar kontrolünü devredin.
Tell me which IronQR version the project references and paste its
PackageReference line. Then show me where the license key is applied. It has
to be set once at startup from IRONQR_LICENSE_KEY, appsettings.json and
appsettings.Development.json must carry no IronQr.LicenseKey entry, and when
the variable is missing the app should log one startup warning that names the
variable but prints no value. Change no other file, and touch Program.cs
only if that warning is missing.
Her sonraki görevde bildirilen sürümü kullanın. Anahtar olmadan, lisans hatası ve "Üretim Lisansı Gerekli" uyarısı ile çözümlü yetersiz olur, bu yüzden eksik bir değişken ilk taramada başarısız olur.
Yükleme tablosu geçildiğinde, kuralları yazın. Antigravity AGENTS.md ve GEMINI.md'i her klasör seviyesine kadar yükler, çalışma alanı köküne kadar, kendi kurallar belgesi uyarınca ve /learn, bir oturumun düzeltmelerini kalıcı kurallara dönüştürür.
/learn Write the rules this session established into a new AGENTS.md at the
repository root (the always-on rules file, not .antigravity/rules.md) under a
"QR check-in page" heading. Cover the render mode the scanner page needs, the
upload cap and the reason for its value, showing every decoded value instead
of the first, keeping IRONQR_LICENSE_KEY out of files, and that no scanner
change is done until the /browser upload table passes for every image in
TestData/scans.
Her sonraki görev o dosyayı yükler, bu nedenle istemler render modunu tekrarlamayı durdurur. Bir kural değiştiren bir görev, dosyayı da değiştirmelidir. Çalışmamızda, AGENTS.md, hizmet yüklemeyi 25 MB'a taşıdıktan sonra Quickstart planından 30 MB sınırını korudu.
Geçici dosya olmadan bir yüklemeyi nasıl çözersiniz?
IronQR, resimleri AnyBitmap olarak okur, bu yüzden sayfa tarayıcı yüklemesini birine dönüştürmelidir. Blazor tarayıcı kılavuzu, yüklemeyi müşteri dosya adından sonra adlandırılmış geçici bir dosyaya kopyalar ve diskte açar. Aynı adla dosya yükleyen iki masa çarpışabilir ve Microsoft, bir yüklemenin istemci tarafından sağlanan bir ad altında kaydedilmemesi gerektiğini söylüyor.
AnyBitmap.FromStream dosyayı önler, ancak yüklemenin arkasındaki tarayıcı akışını arayamaz ve eş zamanlı okumaları reddeder. IronQR 2026.10.1'de, bu limitlere sahip bir akış doğrudan geçtiğinde NotSupportedException atar. Yüklemeyi oku öncesi MemoryStream ile CopyToAsync'e kopyalamak işe yarar. Microsoft, tüm yüklemelerin sunucu belleğinde tamponlanmasına karşı uyarır, bu yüzden yükleme kapağı aynı zamanda tamponun sınırıdır.
Open an Implementation Plan Artifact for this refactor before editing. Move
the decoding out of the Razor page into Services/PassScanService.cs,
registered as a singleton. The service takes the IBrowserFile, rejects files
over 25 MB with a message the page shows, copies the upload into a
MemoryStream with CopyToAsync, builds the AnyBitmap from that buffer, reads it
with QrReader.ReadAsync and QrScanMode.Auto, and returns value, QrType and Url
for every result. No temporary files and no client file names on disk. Show
the scan time in milliseconds under the results. Then repeat the /browser
upload table for all seven images.
Farkta bu şekilde bir hizmet arayın. Bu sürümü IronQR 2026.10.1'e karşı derledik ve onu arayan bir sayfa, yedi test görüntüsünün tümü için doğru değerleri gösterdi.
using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Components.Forms;
public sealed class PassScanService
{
public const long MaxUploadBytes = 25 * 1024 * 1024;
public async Task<List<QrResult>> ScanAsync(IBrowserFile file)
{
using var buffer = new MemoryStream();
await using (var upload = file.OpenReadStream(MaxUploadBytes))
{
await upload.CopyToAsync(buffer);
}
buffer.Position = 0;
using var image = AnyBitmap.FromStream(buffer);
var results = await new QrReader().ReadAsync(new QrImageInput(image, QrScanMode.Auto));
return results.ToList();
}
}
QrResult.Url değeri geçerli bir URI olduğunda ayarlanır, bu da bazı geçişlerin bir bağlantı ve diğerlerinin düz bir geçiş numarası taşıdığı bir masaya uygundur.
Yeniden başlatma sonrası ilk tarama neden yavaş?
IronQR paketi, 44 MB'lık bir montaj olan 2026.10.1'de neredeyse tamamen tek bir gömülü kaynak olan IronQrDetection.dll içerir ve model tespitini çalıştırmak için Microsoft.ML.OnnxRuntime 1.20.1'e bağlıdır. QrScanMode.Auto temel bir taramadan önce dedektörü dener, dedektör hiçbir şey bulmadığında çalışır.
Üç yeni konsol işleminde temiz bir görüntüyü okurken, ilk otomatik okuma 3,1 ila 4,7 saniye arasında sürdü ve sonraki okumalar 0,5 ila 1,0 saniye sürdü. Okuma başına yeni bir okuyucu gecikmeyi geri getirmedi, bu nedenle maliyet işlem başına. İlk OnlyBasicScan okuması, dosya yükleme dahil, 0,33 ila 0,56 saniye sürdü. Blazor Server'da, yeniden başlatma veya ölçeklendirmeden sonra ilk ziyaretçi bekler, uygulama başlatırken dedektörü yüklemediği sürece.
/browser Measure the cold-start cost of the detection model. Restart the app,
upload TestData/scans/pass-clean.png three times on /scanner, and note the
scan time the page shows each time. Then add an IHostedService that reads one
small blank AnyBitmap with QrReader at startup, off the request path, restart,
repeat the three uploads, and put both sets of timings side by side in the
Walkthrough with a screenshot of each first upload.
Başlangıcı engelleyen bir IHostedService ısıtma, yavaş bir ilk yükleme için yavaş bir ilk sayfa yüklemesini takas eder ve temsilcinin zamanlamaları hangisini inşa ettiğini gösterir.
Ne zaman birden fazla ajan gönderilmeli?
Bir test ajanı ve bir tarayıcı ajanı farklı şeyleri kontrol eder, hizmetin sonuçları kodda ve personelin sayfada gördükleri şeyde.
Agent A: create an xUnit project QrScanner.Tests that calls PassScanService
for every row of TestData/scans/expected.csv through a test double of
IBrowserFile, and asserts the exact set of values in any order. Add one test
that a file over the cap is rejected before IronQR reads it. Never compare
QR images byte for byte.
Agent B: start only after Agent A's tests pass against the current code. Use
/browser to upload the same seven images on /scanner, attach a screenshot of
each result to the Walkthrough, and state there that the tests passed first.
Testlerimizde, IronQR, Auto altında iki geçişi farklı bir sırada OnlyBasicScan altında geri döndürdü, bu yüzden testler setleri karşılaştırır.
Tarayıcıyı bir Linux konteynerine nasıl dağıtarsınız?
IronQR 2026.10.1, IronQR.Slim ve IronSoftware.ReaderInternals.Windows'e de bağlıdır ve IronQR.Linux, Windows iç yapılarını IronSoftware.ReaderInternals.Linux ile değiştirir.
This app will ship in a linux-x64 container built from
mcr.microsoft.com/dotnet/aspnet:9.0. Do not change any C#. Make the project
reference IronQR for Windows builds and IronQR.Linux when RuntimeIdentifier is
linux-x64, add a Dockerfile that publishes for linux-x64 and passes
IRONQR_LICENSE_KEY in at run time, then run dotnet publish -r linux-x64
--self-contained false -o publish-linux and list every .so file in that
folder with the NuGet package it came from. Docker is not installed on this
machine, so stop before docker build.
Yayın klasörü kanıtıdır ve Windows'ta inceleyebilirsiniz. Windows IronQR paketi ile bir linux-x64 yayın ONNX Runtime kütüphanelerini taşıdı, ancak ReaderInterop.so'ı, Linux doğal okuyucusunu taşımadı. PackageReference, her derleme için doğru paketi seçen RuntimeIdentifier'e göre koşullandırıldı.
Her iki doğal kütüphane glibc'ye karşı bağlantı kurar ve hiçbir paket bir musl yapısını taşımaz, bu yüzden Alpine tabanlı bir görüntü yükleyecek hiçbir şey bulamaz. IronSoftware.ReaderInternals.Linux 2026.3.47413 yalnızca bir linux-x64 yapısı taşır, bu yüzden ARM64 Linux, IronQR.Linux 2026.10.1'in kapsadığı şeyin dışında kalır. Eğer detektörün DLL'leri çıktı klasörünü yetiştirmezse, IronQR, IronQrRuntimesCopyException atar ve çalışma zamanı kopyalama istisna sayfası düzeltmeyi sunar. NuGet paketleri kılavuzu, her platform paketini listeler ve IronQR.Slim, detection model olmadan OnlyBasicScan çalıştırır.
Gerçek bir çalıştırmada istemler ne üretti?
Yukarıdaki sekiz istem üzerine, Antigravity CLI konuşması ile sırayla, insansız --dangerously-skip-permissions ile taze bir .NET 9 Blazor Web Uygulaması ile Etkileşimli Sunucu render modu kullanılarak yürütüldü. Depo, bilinen değerlere sahip yedi test görüntüsünü TestData/scans/expected.csv içinde listeledi. Hepsi, temiz bir ekran görüntüsü, 12 MP ve 48 MP telefon fotoğrafı, iki geçişin görüntüsü, kötü ışıkta eğik bir fotoğraf, bir URL taşıyan bir geçiş ve geçişsiz bir masa fotoğrafıydı. Anahtar yalnızca ortam aracılığıyla temsilciye ulaştı. Çalıştırmanın ardından, uygulamayı yeniden oluşturduk, testleri çalıştırdık ve tüm resimleri kendi kendimize başsız Chrome üzerinden yükledik.
Çünkü Quickstart planı zaten 48 MP fotoğrafın üstünde bir yükleme sınırı koydu ve her sonucu listeledi, kılavuz sayfasının iki yükleme kusuru asla ortaya çıkmadı.
- Yeniden başlatma sonrası ilk yükleme 3.315 ms sürdü, ısınmadan önce ve 901 ms sonra.
- Ajanın kendi yükleme tablosunda, 7 satırdan 6'sı geçti, ardından iki geçiş değerini sıraladığında 7'si de geçti.
- Nihai uygulamamızın yükleme kontrolü 7'den 7'sini geçti ve xUnit testleri 8'den 8'ini geçti.
- Yayın derlemesi 0 uyarı ve 0 hata ile tamamlandı.
ReaderInterop.so,linux-x64yayınında 21.475.192 bayta ulaştı.- Her iki plan-önce istemi de planı yazdı ve aynı anda dosyaları değiştirdi ve bir ajan iki ajan istemi işini yaptı.
- Tarayıcı ekran görüntüleri ve
linux-x64yayın klasörü depoda kaldı.
Hub'un çalıştırma kaydı, Antigravity sürümünü, model ve çalıştırma zamanını ve çalıştırmanın kullandığı makineyi listeler.
Hata Ayıklama
- Blazor QR Kod Tarayıcı bu kılavuzun genişlettiği ana sayfa için
- IronQR'de Bir Lisans Anahtarı Uygula anahtarın ilk taramadan önce uygulandığını kontrol etmek için
- Tarama Modları ile QR Kodlarını Okuyun Auto ve OnlyBasicScan arasında seçim yapmak
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.