Comment utiliser IronQR avec Google Antigravity
Une page de téléchargement Blazor peut se construire sans avertissements, mais échouer à traiter correctement les fichiers utilisateurs. Le processus de construction n'indique pas si la page manque d'interactivité, si les grandes images dépassent les limites de téléchargement, ou si les images contenant plusieurs passages ne sont que partiellement traitées. Ces problèmes ne deviennent évidents que lors des tests en conditions réelles.
Google Antigravity répond à ce défi. Sa commande /browser sélectionne les fichiers dans le contrôle de téléchargement. IronQR décode les images téléchargées côté serveur en utilisant QrReader.Read, donc la page n'a pas besoin de scanner JavaScript. Ce guide montre comment construire une page de check-in pour les visiteurs en utilisant les deux outils et valide les résultats en comparant chaque fichier téléchargé avec les valeurs attendues et celles affichées sur la page.
Une remarque sur la terminologie. IronQR inclut un modèle d'apprentissage automatique pour détecter les codes QR dans des images difficiles, comme détaillé dans le guide des modes de scan. Dans ce guide, 'IA' se réfère à l'agent de codage responsable de l'écriture et du test de la page.
Démarrage rapideOuvrez le projet Blazor dans Antigravity et spécifiez la configuration de page souhaitée avec /plan.
/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.
Le plan doit indiquer deux réglages. Une application web Blazor rend une page statiquement à moins que la page ne choisisse l'interactivité, comme l'explique le guide des modes de rendu. OpenReadStream rejette tout fichier dépassant 512 000 octets à moins que l'appel n'augmente cette limite, selon le guide de téléchargement de fichiers Blazor de Microsoft, et les photos de téléphone sont souvent bien plus grandes. Lorsque vous exécutez agy -p avec --dangerously-skip-permissions, chaque appel d'outil est approuvé, alors examinez le plan et la différence ensemble.
Donnez le nom de variable IRONQR_LICENSE_KEY à l'agent, jamais la valeur. Un agent qui écrit des fichiers et exécute des commandes peut copier une clé collée dans un commit ou un log. IronQR lit aussi une entrée IronQr.LicenseKey à partir de appsettings.json, qu'il est facile de commettre par accident. Le guide des clés de licence couvre toutes les options.
Flux de travail minimal (5 étapes)
- Télécharger la bibliothèque de code QR C# depuis NuGet
- Commencez avec une application web Blazor qui construit et s'exécute en local.
- Rendez la page de scanner interactive et limitez les téléchargements au-dessus de votre plus grande photo.
- Faites télécharger à
/browserchaque image de test et capturez ce que la page montre. - Comparez chaque valeur affichée avec la liste attendue.
Qu'est-ce que Google Antigravity, et en quoi est-il différent d'un assistant de chat?
Antigravity exécute des agents qui planifient un changement, éditent le code, utilisent un terminal, et contrôlent un navigateur, puis rendent compte dans des artefacts que vous pouvez examiner au lieu de surveiller chaque étape. Google décrit Antigravity 2.0 comme une application de bureau autonome pour gérer les agents, et la CLI s'installe comme agy.
Un agent laissé choisir un package peut deviner son nom, et des attaquants enregistrent à l'avance des noms plausibles et les remplissent de logiciels malveillants, une pratique appelée slopsquatting. Nommez le package IronQR et l'espace de nom IronQr.
Les liens de documentation d'IronQR pour les agents et un test d'acceptation à une invite se trouvent dans le guide des assistants de codage IA.
Que devez-vous vérifier dans le plan, la différence et le guide pas-à-pas?
Le plan d'implémentation doit aussi indiquer ce que la page montre pour une image sans code et pour une image avec plusieurs.
Dans la différence de code, vérifiez comment le téléchargement devient un AnyBitmap, et consultez chaque membre IronQR utilisé dans la différence dans la référence API.
Pour les tâches de navigateur, Google dit que le guide pas-à-pas contient souvent des captures d'écran et des enregistrements de ce que l'agent a fait. Dans notre exécution CLI, chaque tâche dans la conversation a réécrit le même walkthrough.md, donc il ne contenait que le rapport de la dernière tâche. Copiez tout tableau que vous souhaitez conserver avant d'envoyer la prochaine invite.
Comment testez-vous la page de téléchargement IronQR dans un navigateur réel?
La commande /browser démarre un sous-agent Chrome isolé qui ouvre des pages et capture des captures d'écran, selon la référence des commandes slash. Demandez un tableau qu'il ne peut remplir qu'en téléchargeant des fichiers.
/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.
Une correction à la liste des résultats modifie le balisage pour chaque image, donc seule une exécution complète montre que rien n'a régressé.
Chaque capture d'écran est enregistrée en tant qu'artefact d'image. Lorsqu'une montre un problème, comme un numéro de passage tronqué, commentez-le plutôt que de le décrire dans une nouvelle invite.
Quelles sont les causes des valeurs QR manquantes ou incorrectes?
La plupart des lignes échouées remontent à quelques causes, et nommer la plus probable dans une tâche de suivi épargne à l'agent une série d'essais et d'erreurs. Nous avons mis la page du guide du scanner Blazor d'IronQR dans un nouveau template .NET 9 et uploadé les sept images de test via Chrome sans tête avec IronQR 2026.10.1. Tous les défauts ci-dessous se sont compilés proprement. Avec le mode de rendu ajouté, cinq des sept images ont montré la bonne valeur.
- Un bouton de scan qui reste désactivé pour chaque image nécessite le mode de rendu que le plan Quickstart indique.
- La photo de 48 MP (17 955 400 octets) dépasse la limite de 10 000 000 octets du guide et laisse le bouton désactivé sans message. Définissez une limite au-dessus de votre plus grande photo et affichez un message pour les fichiers plus grands.
- Lorsqu'une image de deux passes montre une valeur, listez chaque résultat.
Comment configurez-vous le projet et ses règles pour Antigravity?
Donnez à l'agent un projet qui se construit et s'exécute déjà. Créez-le avec dotnet new blazor --interactivity Server --framework net9.0, exécutez-le une fois, et notez l'URL dans Properties/launchSettings.json. Le template choisit un port différent pour chaque projet, et l'invite /browser en a besoin.
Déléguez ensuite la vérification du package et de la clé.
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.
Utilisez la version rapportée dans chaque tâche ultérieure. Sans clé, le décodage échoue avec LicensingException et "Production License Required", donc une variable manquante fait échouer la première analyse.
Une fois que le tableau de téléchargement est validé, rédigez les règles. Antigravity charge AGENTS.md et GEMINI.md à chaque niveau de dossier jusqu'à la racine de l'espace de travail, selon sa documentation des règles, et /learn transforme les corrections d'une session en règles persistantes.
/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.
Chaque tâche ultérieure charge ce fichier, donc les invites cessent de répéter le mode de rendu. Une tâche qui change une règle doit aussi modifier le fichier. Dans notre exécution, AGENTS.md a conservé la limite de 30 Mo du plan Quickstart après que le refactor de téléchargement ait déplacé le service à 25 Mo.
Comment décodez-vous un téléchargement sans fichier temporaire?
IronQR lit les images en tant que AnyBitmap, donc la page doit transformer le téléchargement du navigateur en une telle instance. Le guide du scanner Blazor copie le téléchargement dans un fichier temporaire nommé d'après le nom de fichier du client et l'ouvre à partir du disque. Deux bureaux qui téléchargent des fichiers portant le même nom en même temps peuvent entrer en collision, et Microsoft dit de ne jamais enregistrer un téléchargement sous un nom fourni par le client.
AnyBitmap.FromStream évite le fichier, mais le flux du navigateur derrière le téléchargement ne peut pas rechercher et rejette les lectures synchrones. Dans IronQR 2026.10.1, un flux avec ces limites passé directement génère NotSupportedException. Copier le téléchargement dans un MemoryStream avec CopyToAsync avant la lecture fonctionne. Microsoft déconseille la mise en mémoire tampon de téléchargements entiers en mémoire serveur, donc le plafond de téléchargement limite également la mémoire tampon.
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.
Recherchez un service de ce genre dans la différence de code. Nous avons compilé cette version contre IronQR 2026.10.1, et une page qui l'appelait montrait les bonnes valeurs pour toutes les sept images de test.
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 est défini uniquement lorsque la valeur est une URI valide, ce qui convient à un bureau où certains passages portent un lien et d'autres un numéro de passage simple.
Pourquoi la première analyse après un redémarrage est-elle lente?
Le package IronQR inclut IronQrDetection.dll, une assembly de 44 Mo en 2026.10.1 qui est presque entièrement une ressource intégrée, et dépend de Microsoft.ML.OnnxRuntime 1.20.1 pour exécuter le modèle de détection. QrScanMode.Auto essaie le détecteur avant une analyse de base, qui ne s'exécute que lorsque le détecteur ne trouve rien.
Dans trois nouveaux processus de console lisant une image propre, la première lecture Auto a pris de 3,1 à 4,7 secondes et les lectures ultérieures ont pris de 0,5 à 1,0 seconde. Un nouveau lecteur par lecture n'a pas ramené le délai, donc le coût est par processus. Le premier OnlyBasicScan, incluant le chargement du fichier, a pris de 0,33 à 0,56 seconde. Sur Blazor Server, le premier visiteur après un redémarrage ou une montée en charge attend, sauf si l'application charge le détecteur au démarrage.
/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.
Un échauffement IHostedService qui bloque le démarrage échange un premier téléchargement lent contre un premier chargement de page lent, et les temps de l'agent montrent lequel il a construit.
Quand devriez-vous dépêcher plus d'un agent ?
Un agent de test et un agent de navigateur vérifient des choses différentes, les résultats du service dans le code et ce que le personnel voit sur la page.
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.
Dans nos tests, IronQR a retourné les deux passages dans un ordre différent sous Auto qu'OnlyBasicScan, c'est pourquoi les tests comparent des ensembles.
Comment déployez-vous le scanner dans un conteneur Linux?
IronQR 2026.10.1 dépend également de IronQR.Slim et IronSoftware.ReaderInternals.Windows, et IronQR.Linux remplace les internes Windows par IronSoftware.ReaderInternals.Linux.
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.
Le dossier de publication est la preuve, et vous pouvez l'inspecter sous Windows. Avec le package Windows IronQR, une publication linux-x64 transportait les bibliothèques Runtime ONNX mais pas ReaderInterop.so, le lecteur natif Linux. Une PackageReference conditionnée par RuntimeIdentifier a choisi le bon package pour chaque construction.
Les deux bibliothèques natives sont liées à glibc, et aucun package n'expédie une construction musl, donc une image de base Alpine n'a rien à charger. IronSoftware.ReaderInternals.Linux 2026.3.47413 expédie seulement une construction linux-x64, donc Linux ARM64 est hors de la couverture de IronQR.Linux 2026.10.1. Si les DLLs du détecteur manquent dans le dossier de sortie, IronQR lance IronQrRuntimesCopyException, et la page d'exception des runtimes copy donne la solution. Le guide des packages NuGet liste chaque package plateforme, et IronQR.Slim seul exécute OnlyBasicScan sans le modèle de détection.
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
Les huit invites ci-dessus ont été exécutées dans l'ordre lors d'une conversation CLI Antigravity, sans surveillance avec --dangerously-skip-permissions, contre une application web Blazor .NET 9 fraîche avec le mode de rendu Interactive Server. Le dépôt contenait sept images de test avec des valeurs connues, listées dans TestData/scans/expected.csv. Il s'agissait d'une capture d'écran propre, d'une photo de téléphone de 12 MP et de 48 MP, d'une image de deux passages, d'une photo inclinée dans une faible luminosité, d'un passage avec une URL, et d'une photo de bureau sans passage. La clé a atteint l'agent uniquement via l'environnement. Après l'exécution, nous avons reconstruit l'application en mode Release, exécuté les tests, et uploadé chaque image via Chrome sans tête nous-mêmes.
Parce que le plan Quickstart avait déjà plafonné les téléchargements au-dessus de 48 MP et listé chaque résultat, les deux défauts de téléchargement de la page de guide n'ont jamais apparu.
- Le premier téléchargement après un redémarrage a pris 3 315 ms avant l'échauffement et 901 ms après.
- Dans le propre tableau de téléchargement de l'agent, 6 des 7 lignes ont réussi, puis 7 sur 7 une fois qu'il a trié les valeurs à deux passages.
- Notre vérification de téléchargement de l'application finale a réussi 7 sur 7, et les tests xUnit ont réussi 8 sur 8.
- La construction de la version Release s'est terminée avec 0 avertissements et 0 erreurs.
ReaderInterop.sodans la publicationlinux-x64est arrivé à 21 475 192 octets.- Les deux invites plan-première ont écrit le plan et modifié les fichiers dans le même tour, et un agent a fait le travail de l'invite à deux agents.
- Les captures d'écran du navigateur et le dossier de publication
linux-x64ont été laissés dans le dépôt.
L'historique d'exécution du hub liste la version Antigravity, le modèle et le temps d'exécution, ainsi que la machine utilisée.
Dépannage
- Blazor QR Code Scanner pour la page de base que ce guide étend
- Appliquer une clé de licence dans IronQR pour vérifier que la clé est appliquée avant le premier scan
- Lire les codes QR avec les modes de scan pour choisir entre Auto et OnlyBasicScan
Des questions ?
Si vous avez des questions, contactez support@ironsoftware.com
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.