Verwendung von IronQR mit Google Antigravity

Curtis Chau
Curtis Chau
Aktualisiert: 9. Oktober 2026

Eine Blazor-Upload-Seite kann ohne Warnungen aufgebaut werden, dennoch kann es sein, dass sie Benutzerdateien nicht korrekt verarbeitet. Der Build-Prozess zeigt nicht an, ob der Seite Interaktivität fehlt, ob große Bilder die Upload-Grenzen überschreiten oder ob Bilder mit mehreren Durchgängen nur teilweise verarbeitet werden. Diese Probleme werden erst beim Testen in der realen Welt offensichtlich.

Google Antigravity löst diese Herausforderung. Der Befehl /browser wählt Dateien in der Upload-Steuerung aus. IronQR dekodiert hochgeladene Bilder serverseitig mit QrReader.Read, sodass die Seite keinen JavaScript-Scanner benötigt. Diese Anleitung zeigt, wie man eine Besucher-Check-in-Seite mit beiden Tools erstellt und die Ergebnisse validiert, indem jede hochgeladene Datei mit den erwarteten Werten und den auf der Seite angezeigten Werten verglichen wird.

Ein Hinweis zur Terminologie. IronQR enthält ein maschinelles Lernmodell zur Erkennung von QR-Codes in anspruchsvollen Bildern, wie im Scan-Modus-Leitfaden beschrieben. In diesem Leitfaden bezieht sich 'KI' auf den Programmieragenten, der für das Schreiben und Testen der Seite verantwortlich ist.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package IronQR

Installieren Sie IronQR, indem Sie den obigen Befehl in der NuGet Packet Manager-Konsole ausführen, oder suchen Sie das Paket im NuGet Paket Manager.

Öffnen Sie das Blazor-Projekt in Antigravity und geben Sie die gewünschte Seiteneinstellung mit /plan an.

/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.
Text

Der Plan muss zwei Einstellungen festlegen. Eine Blazor Web App rendert eine Seite statisch, es sei denn, die Seite entscheidet sich für Interaktivität, wie der Render-Modus-Leitfaden erklärt. OpenReadStream lehnt jede Datei über 512.000 Bytes ab, es sei denn, der Aufruf hebt diese Grenze an, laut Microsofts Blazor-Upload-Leitfaden, und Handybilder sind oft viel größer. Wenn Sie agy -p mit --dangerously-skip-permissions ausführen, wird jeder Toolaufruf bestätigt, also überprüfen Sie den Plan und den Unterschied zusammen.

Geben Sie dem Agenten den Variablennamen IRONQR_LICENSE_KEY, niemals den Wert. Ein Agent, der Dateien schreibt und Befehle ausführt, kann einen kopierten Schlüssel in einen Commit oder ein Protokoll einfügen. IronQR liest auch einen IronQr.LicenseKey-Eintrag aus appsettings.json, der leicht versehentlich committet werden kann. Der Lizenzschlüssel-Leitfaden deckt jede Option ab.



Was ist Google Antigravity und wie unterscheidet es sich von einem Chat-Assistenten?

Antigravity führt Agenten aus, die eine Änderung planen, den Code bearbeiten, ein Terminal verwenden und einen Browser steuern, dann in Artefakten berichten, die Sie überprüfen können, anstatt jeden Schritt zu beobachten. Google beschreibt Antigravity 2.0 als eigenständige Desktop-App zur Verwaltung von Agenten, und die CLI wird als agy installiert.

Ein Agent, der eine Paketauswahl übernimmt, kann den Namen erraten, und Angreifer registrieren plausible Namen im Voraus und füllen sie mit Malware, eine Praxis namens Slopsquatting. Benennen Sie das Paket IronQR und den Namensraum IronQr.

Die Dokumentationslinks für Agenten und ein Abnahmetest mit einer Eingabeaufforderung von IronQR befinden sich im KI-Programmierassistenten-Leitfaden.

Was sollten Sie im Plan, dem Unterschied und im Walkthrough überprüfen?

Der Implementierungsplan sollte auch festlegen, was die Seite für ein Bild ohne Code und für ein Bild mit mehreren Codes anzeigt.

Im Code-Unterschied prüfen Sie, wie der Upload zu einem AnyBitmap wird, und suchen Sie jedes IronQR-Mitglied, das der Unterschied verwendet, in der API-Referenz nach.

Für Browseraufgaben sagt Google, dass der Walkthrough oft Screenshots und Aufzeichnungen davon enthält, was der Agent gemacht hat. Bei unserem CLI-Lauf schrieb jede Aufgabe im Gespräch das gleiche walkthrough.md um, sodass es nur den Bericht der letzten Aufgabe enthielt. Kopieren Sie jede Tabelle, die Sie behalten möchten, bevor Sie die nächste Eingabeaufforderung senden.

Wie testen Sie die IronQR-Upload-Seite in einem realen Browser?

Der Befehl /browser startet einen gekapselten Chrome-Unteragenten, der Seiten öffnet und Screenshots aufnimmt, gemäß der Slash-Befehle-Referenz. Fragen Sie nach einer Tabelle, die es nur durch Hochladen von Dateien ausfüllen kann.

/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.
Text

Eine Korrektur in der Ergebnisliste ändert das Markup für jedes Bild, sodass nur ein vollständiger Neuablauf zeigt, dass nichts zurückgegangen ist.

Bitte beachten Sie: Öffnen Sie zuerst den Screenshot für das größte Foto. Ein übergroßer Upload kann ohne eine Zeile im Serverprotokoll fehlschlagen, sodass ein Bericht, der nur aus Protokollen erstellt wurde, diese Zeile als bestanden ansehen würde.

Jeder Screenshot wird als Bild-Artefakt gespeichert. Wenn einer ein Problem zeigt, z. B. eine abgeschnittene Passnummer, kommentieren Sie es, anstatt es in einer neuen Eingabeaufforderung zu beschreiben.

Was verursacht fehlende oder falsche QR-Werte?

Die meisten fehlgeschlagenen Zeilen gehen auf einige wenige Ursachen zurück, und das Benennen der wahrscheinlichen Ursache in einer Folgeaufgabe spart dem Agenten eine Runde Versuch und Irrtum. Wir haben die Seite aus IronQRs Blazor-Scanner-Leitfaden in eine frische .NET 9-Vorlage eingebaut und die sieben Testbilder über kopflosen Chrome mit IronQR 2026.10.1 hochgeladen. Jeder unten stehende Fehler wurde sauber kompiliert. Mit dem hinzugefügten Render-Modus zeigten fünf von sieben Bildern den richtigen Wert.

  • Ein Scan-Button, der für jedes Bild deaktiviert bleibt, benötigt den Render-Modus, den der Quickstart-Plan angibt.
  • Das 48-MP-Foto (17.955.400 Bytes) überschreitet die 10.000.000-Byte-Grenze des Leitfadens und lässt den Button ohne Nachricht deaktiviert. Setzen Sie eine Grenze über Ihrem größten Foto und zeigen Sie eine Nachricht für größere Dateien.
  • Wenn ein Bild mit zwei Durchgängen einen Wert zeigt, listen Sie jedes Ergebnis auf.

Wie richten Sie das Projekt und seine Regeln für Antigravity ein?

Geben Sie dem Agenten ein Projekt, das bereits gebaut und ausgeführt wird. Erstellen Sie es mit dotnet new blazor --interactivity Server --framework net9.0, führen Sie es einmal aus, und notieren Sie die URL in Properties/launchSettings.json. Die Vorlage wählt für jedes Projekt einen anderen Port aus, und die /browser-Eingabeaufforderung benötigt ihn.

Delegieren Sie dann die Paket- und Schlüsselprüfung.

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.
Text

Verwenden Sie die gemeldete Version in jeder späteren Aufgabe. Ohne einen Schlüssel scheitert die Dekodierung mit LicensingException und "Production License Required", also scheitert eine fehlende Variable beim ersten Scan.

Sobald die Upload-Tabelle bestanden ist, schreiben Sie die Regeln auf. Antigravity lädt AGENTS.md und GEMINI.md auf jeder Ordner-Ebene bis zum Workspace-Root, gemäß seiner Regeldokumentation, und /learn verwandelt die Korrekturen einer Sitzung in dauerhafte Regeln.

/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.
Text

Jede spätere Aufgabe lädt diese Datei, sodass Eingabeaufforderungen aufhören, den Render-Modus zu wiederholen. Eine Aufgabe, die eine Regel ändert, muss auch die Datei ändern. Bei unserem Lauf behielt AGENTS.md das 30-MB-Limit aus dem Quickstart-Plan bei, nachdem die Upload-Umstrukturierung den Dienst auf 25 MB verschoben hatte.

Wie dekodieren Sie einen Upload ohne temporäre Datei?

IronQR liest Bilder als AnyBitmap, sodass die Seite den Browser-Upload in eins umwandeln muss. Der Blazor-Scanner-Leitfaden kopiert den Upload in eine temporäre Datei, die nach dem Dateinamen des Clients benannt ist, und öffnet sie von der Festplatte. Zwei Desks, die gleichzeitig Dateien mit demselben Namen hochladen, können kollidieren, und Microsoft sagt, dass man nie einen Upload unter einem vom Client angegebenen Namen speichern sollte.

AnyBitmap.FromStream vermeidet die Datei, aber der Browser-Stream hinter dem Upload kann nicht suchen und lehnt synchrone Lesevorgänge ab. In IronQR 2026.10.1 wirft ein Stream mit diesen Einschränkungen direkt eingereicht NotSupportedException. Das Kopieren des Uploads in einen MemoryStream mit CopyToAsync vor dem Lesen funktioniert. Microsoft rät davon ab, ganze Uploads im Serverspeicher zwischenzuspeichern, daher setzt die Upload-Grenze auch die Puffergrenze.

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.
Text

Suchen Sie nach einem Dienst in diesem Sinne im Unterschied. Wir haben diese Version gegen IronQR 2026.10.1 kompiliert, und eine Seite, die sie aufrief, zeigte die richtigen Werte für alle sieben Testbilder.

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();
    }
}
C#

QrResult.Url wird nur gesetzt, wenn der Wert eine gültige URI ist, was für einen Desk geeignet ist, bei dem einige Durchgänge einen Link und andere eine einfache Passnummer tragen.

Warum ist der erste Scan nach einem Neustart langsam?

Das Paket IronQR enthält IronQrDetection.dll, eine 44 MB Assembly in 2026.10.1, die fast vollständig eine eingebettete Ressource ist und auf Microsoft.ML.OnnxRuntime 1.20.1 angewiesen ist, um das Erkennungsmodell zu betreiben. QrScanMode.Auto versucht, den Detektor vor einem Basis-Scan auszuführen, der nur ausgeführt wird, wenn der Detektor nichts findet.

In drei frischen Konsolenprozessen, die ein sauberes Bild lesen, dauerte der erste Auto-Lesedurchgang 3,1 bis 4,7 Sekunden, und spätere Lesevorgänge dauerten 0,5 bis 1,0 Sekunden. Ein neuer Leser pro Lesevorgang brachte die Verzögerung nicht zurück, daher sind die Kosten pro Prozess. Der erste OnlyBasicScan-Lesedurchgang, das Laden der Datei enthalten, dauerte 0,33 bis 0,56 Sekunden. Auf einem Blazor-Server wartet der erste Besucher nach einem Neustart oder Skalierung, es sei denn, die App lädt den Detektor beim Start.

/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.
Text

Ein IHostedService-Warm-up, das den Start blockiert, tauscht einen langsamen ersten Upload gegen einen langsamen ersten Seitenaufruf ein, und die Zeiten des Agenten zeigen, welches er gebaut hat.

Wann sollten Sie mehr als einen Agenten entsenden?

Ein Testagent und ein Browseragent prüfen unterschiedliche Dinge, die Ergebnisse des Dienstes im Code und was das Personal auf der Seite sieht.

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.
Text

In unseren Tests gab IronQR die zwei Durchgänge in einer anderen Reihenfolge unter Auto als unter OnlyBasicScan zurück, weshalb die Tests Mengen vergleichen.

Bitte beachten Sie: In der Desktop-App geben Sie jedem Agenten seine eigene Aufgabe und vergleichen die beiden Walkthroughs.

Wie stellen Sie den Scanner auf einem Linux-Container bereit?

IronQR 2026.10.1 ist auch auf IronQR.Slim und IronSoftware.ReaderInternals.Windows angewiesen, und IronQR.Linux tauscht die Windows-Internals gegen IronSoftware.ReaderInternals.Linux aus.

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.
Text

Der Veröffentlichungsordner ist der Beweis, und Sie können ihn auf Windows inspizieren. Mit dem Windows-IronQR-Paket führte ein linux-x64-Veröffentlichungslauf die ONNX-Runtime-Bibliotheken, aber nicht ReaderInterop.so, den Linux-nativen Reader. Ein PackageReference, das auf RuntimeIdentifier basiert, wählte das richtige Paket für jeden Build.

Beide nativen Bibliotheken verlinken gegen glibc und keine der Pakete liefert ein musl Build, sodass ein Alpine-Basis-Image nichts zu laden hat. IronSoftware.ReaderInternals.Linux 2026.3.47413 liefert nur ein linux-x64-Build, sodass ARM64 Linux außerhalb dessen liegt, was IronQR.Linux 2026.10.1 abdeckt. Wenn die DLLs des Detektors im Ausgabeordner fehlen, wirft IronQR IronQrRuntimesCopyException, und die Ausnahmen-Seite für das Kopieren von Laufzeiten gibt die Lösung. Der NuGet-Pakete-Leitfaden listet jedes Plattform-Paket auf, und IronQR.Slim allein führt OnlyBasicScan ohne das Erkennungsmodell aus.

Was haben die Aufforderungen in einem realen Lauf erzeugt?

Die acht obigen Eingabeaufforderungen wurden nacheinander in einem Antigravity-CLI-Gespräch ausgeführt, unbeaufsichtigt mit --dangerously-skip-permissions, gegen eine frische .NET 9 Blazor Web App mit interaktivem Server-Render-Modus. Das Repository enthielt sieben Testbilder mit bekannten Werten, aufgelistet in TestData/scans/expected.csv. Es waren ein sauberer Screenshot, ein 12 MP und ein 48 MP Handyfoto, ein Bild mit zwei Durchgängen, ein schräges Foto bei schlechtem Licht, ein Pass, der eine URL trägt, und ein Deskfoto ohne Pass. Der Schlüssel erreichte den Agenten nur über die Umgebung. Nach dem Lauf bauten wir die App im Release erneut auf, führten die Tests durch und luden jedes Bild selbst über kopflosen Chrome hoch.

Da der Quickstart-Plan bereits Uploads über dem 48 MP-Foto begrenzt und jedes Ergebnis aufgelistet hatte, traten die beiden Upload-Fehler auf der Leitfadenseite nie auf.

  • Der erste Upload nach einem Neustart dauerte 3.315 ms vor dem Warm-up und 901 ms danach.
  • In der eigenen Upload-Tabelle des Agenten passierten 6 von 7 Zeilen, dann 7 von 7, sobald die zwei Durchgangswerte sortiert waren.
  • Unser Upload-Check der finalen App war 7 von 7 bestanden, und die xUnit-Tests bestanden 8 von 8.
  • Der Release-Build hat mit 0 Warnungen und 0 Fehlern abgeschlossen.
  • ReaderInterop.so im linux-x64-Veröffentlichung betrug 21.475.192 Bytes.
  • Beide planersten Eingabeaufforderungen schrieben den Plan und änderten Dateien im gleichen Durchgang, und ein Agent erledigte die Arbeit der zwei-Agenten-Eingabeaufforderung.
  • Browserscreenshots und der linux-x64-Veröffentlichungsordner wurden im Repository belassen.

Der Laufrekord des Hubs listet die Antigravity-Version, das Modell und die Laufzeit sowie die Maschine auf, die der Lauf verwendete.


Fehlerbehebung


Fragen?

Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 82,442Version:2026.11gerade veröffentlicht