Vérification de la sortie d'IronBarcode avec Google Antigravity

Curtis Chau
Curtis Chau
Mis à jour : 21 septembre 2026

Un code-barres EAN-13 portant une mauvaise clé de contrôle s'affiche clairement, passe la compilation, mais échoue uniquement au scan. Aucun journal de compilation ne le signalera. Les agents Google Antigravity fonctionnent dans le navigateur ainsi que dans l'éditeur et le terminal, ce qui leur permet de vérifier le code-barres réellement fourni par un point d'accès plutôt que celui que la source était censée produire. L'agent ouvre le point d'accès de l'étiquette, enregistre la réponse, la décode avec BarcodeReader, et joint la comparaison en tant qu'artefact Walkthrough pour examen.

Antigravity vous permet également de choisir le modèle pour chaque tâche. Scanner un dossier de codes-barres de test pour y détecter les erreurs de chiffre de contrôle est un travail bon marché et répétitif qui fonctionne bien sur un niveau inférieur, tandis que planifier une migration d'une autre bibliothèque de codes-barres mérite un modèle plus puissant.

Le même contrôle couvre les étiquettes en 1D fournies par un point d'accès, les codes QR stylisés que l'on peut encore lire après le travail de conception, et les migrations que vous pouvez revoir avant tout changement de fichier.

Démarrage rapide
NuGetInstaller avec NuGet

PM > Install-Package BarCode

Installez IronBarcode en exécutant la commande ci-dessus dans la console du gestionnaire de packages NuGet, ou recherchez le package dans le gestionnaire de packages NuGet.

Ouvrez un projet dans Antigravity et donnez à l'agent une tâche avec un livrable.

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

L'agent doit installer le paquet et écrire quelques lignes de code, en utilisant QRCodeWriter.CreateQrCodeWithLogo pour placer le logo et BarcodeReader.Read pour prouver que le résultat est encore scannable. Le code reste lisible malgré le logo, car la correction d'erreur peut reconstruire les modules qu'il couvre, et le guide de correction d'erreurs recommande le niveau Q ou H lorsqu'un élément graphique masque une partie du symbole. Vous examinez l'image et la valeur décodée plutôt qu'un journal pas-à-pas.

Les agents ici modifient et valident, donc une clé de licence qui atteint une description de tâche peut atteindre un Walkthrough, une capture d'écran et une branche. Gardez-la dans une variable d'environnement et hors de tout fichier que l'agent pourrait lire, en suivant le guide des clés de licence.



Quelles fonctionnalités d'Antigravity sont importantes pour le travail avec les codes-barres ?

Antigravity met les agents en avant. La documentation de Google décrit Antigravity 2.0 comme une application de bureau autonome pour gérer les agents, travaillant indépendamment d'un IDE, avec un Antigravity CLI et une intégration IDE configurés à côté. Un agent y exécute des commandes système, lit et écrit des fichiers, pilote Chrome et produit des artefacts.

Cinq parties de la plateforme sont importantes ici :

L'intégration IDE est l'éditeur que vous connaissez déjà. Utilisez-le pour un travail minutieux dans un fichier, lorsque vous souhaitez diriger chaque modification et la revoir au fur et à mesure.

Antigravity 2.0 est le centre de commande pour le travail asynchrone. Lancez des agents, surveillez-les et exécutez des tâches en parallèle au lieu d'attendre une seule conversation.

Le contrôle du navigateur permet à un agent d'utiliser un navigateur pour tester une fonctionnalité et confirmer le résultat. Avec IronBarcode, cela signifie appeler un point d'accès d'étiquettes et inspecter l'image qu'il renvoie.

Les artefacts remplacent les journaux d'outils bruts par des livrables tels que des plans de mise en œuvre, des comptes rendus détaillés, des différences de code, des captures d'écran et des enregistrements de navigateur. Vous pouvez commenter un artefact sans interrompre l'exécution.

Le choix du modèle place un sélecteur de modèle sous le champ de saisie de l’invite, couvrant Gemini, Claude d'Anthropic et GPT-OSS open-source, avec une disponibilité définie par votre niveau d'abonnement.

Ce qu'un agent remet peut être vérifié : un plan, un diff, l'image du code-barres elle-même, et les valeurs qu'il a décodées à partir de cette image. Un outil de chat ne peut que les décrire.

Un agent construisant un pipeline de codes-barres à partir de zéro choisira une bibliothèque, la connectera et passera à autre chose. Quatre raisons d'indiquer IronBarcode à la place :

  • Une valeur que le format ne peut contenir semble parfaitement correcte à l'écran : il en va de même lorsqu'une zone de silence manque ou qu'un symbole est trop petit. IronBarcode lève une exception pour une valeur invalide, et décoder l'image ne nécessite qu'un appel.
  • Le lecteur doit être plus strict que l'encodeur : l'algorithme de chiffre de contrôle de chaque symbologie s'exécute lors du décodage et rejette les codes-barres qui échouent avant que les résultats ne soient retournés.
  • Les vrais scans ne se comportent pas du tout comme les images générées : les photos prises par caméra, les étiquettes prises sous un angle, et les PDF de plusieurs pages nécessitent tous un ajustement via BarcodeReaderOptions.
  • Une commande d'installation est une décision non examinée : dotnet add package s'exécute avant de voir un seul Artifact, donc un nom inventé par l'agent est déjà sur le disque.

Une correspondance dans le tableau signifie donc un symbole valide plutôt qu'une coïncidence. Écrivez BarCode dans la tâche et il n'y a rien à inventer.

Une fois que la tâche le nomme, l'agent cesse de choisir et commence à construire. La documentation à fournir à l'avance est présentée dans le guide parent. Seul le nom du fichier d'instructions change si vous reprenez la même configuration dans Claude Code, ChatGPT Codex, GitHub Copilot ou Cursor.

Comment passez-vous en revue ce que l'agent remet ?

Les agents Antigravity ne retournent pas de transcriptions. Ils renvoient des artefacts, des livrables nommés. Trois d'entre eux suivent une tâche de code-barres depuis le plan jusqu'au résultat, et chacun répond à une question différente.

Avant le code : le plan de mise en œuvre

D'abord, l'agent conçoit le changement, y compris les fichiers, les symbologies et les options du lecteur. Vérifiez quel côté il compte changer. Si le lecteur n'a jamais été informé des formats attendus mais que le plan modifie la façon dont les étiquettes sont imprimées, l'agent est déjà sur une mauvaise piste. Tout nom d'API inventé apparaît ici aussi, avant que tout code n'existe, ce qui est mieux que de le trouver dans un journal de compilation.

Pendant : le diff de code

Antigravity fait une pause sur un plan de mise en œuvre ou un diff de code et vous informe, afin que le changement puisse être vérifié avant d'être appliqué. Ajoutez des commentaires en ligne sur le diff et approuvez-le une fois que la correspondance est correcte.

Après : le Walkthrough

Après la mise en œuvre, l'agent résume ce qui a changé et comment le tester. Pour les codes-barres, cela couvre les formats écrits, les valeurs utilisées et les résultats de relecture : autant de vérifications que vous pouvez effectuer, plutôt que des affirmations à croire sur parole.

Les captures d'écran, les journaux de terminal et les enregistrements de navigateur sont regroupés avec ces livrables dans le panneau de révision, au lieu de se perdre dans l'historique du chat. La plupart des tâches ci-dessous nomment l'unique Artifact à ouvrir pour confirmer que le travail a été effectué.

D'où provient la preuve ?

Les agents Antigravity peuvent exécuter du code, piloter un navigateur et joindre ce qu'ils ont observé. Ainsi, l'agent génère un code-barres, le capture, le décode, compare la valeur et le format avec l'entrée, ajuste et répète jusqu'à ce que chaque ligne corresponde.

Donnez-lui quelque chose de concret à prouver.

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

Demander une explication d'abord vous donne un diagnostic à revoir, au lieu d'une correction à vérifier plus tard. Exécuter à nouveau le tableau complet après toute correction empêche également une ligne réparée de masquer un nouveau problème.

Une capture d'écran de l'étiquette à côté de ses valeurs décodées est une preuve qu'un développeur débutant en codes-barres peut vérifier, et une ligne en échec se repère immédiatement.

Veuillez noter: L'Artifact à vérifier est l'enregistrement du navigateur. Si l'agent n'a jamais ouvert le point d'accès de l'étiquette, il n'a jamais vérifié ce que vos utilisateurs reçoivent réellement, et l'enregistrement le montrera.

Les problèmes d'étiquettes concernent généralement l'emplacement de quelque chose sur l'image, ce qui fait qu'une capture d'écran est plus facile à examiner qu'une description. Commentez sur la capture d'écran où se trouve le problème, comme du texte coupé sur le bord, comme vous le feriez sur un document. L'agent applique la correction sans redémarrer l'exécution.

Pourquoi un scan fonctionne dans un endroit et pas un autre ?

Les mêmes quelques causes reviennent, toutes produisant un code-barres qui semble correct mais ne sera pas lu. Nommer la cause probable dans la tâche évite à l'agent une série de suppositions.

SymptômeCauseDemander
Bien dans les tests, échoue sur les photos de téléphoneAnalyse de l'image entière et de tous les formatsExpectBarcodeTypes, CropArea, un nombre de lectures
Flou ou faible contraste, rien trouvéL'image a besoin de correctionLe filtre minimal qui résout le problème
Valeurs provenant d'images sans code-barresBruit lu comme un symboleRemoveFalsePositive, ConfidenceThreshold
Les anciens scanners rejettent les étiquettes non anglaisesUn en-tête ECI UTF-8Le compromis EciMode, avant tout changement

Les filtres d'image supplémentaires coûtent en précision, donc l'agent devrait s'arrêter au premier qui résout le problème. Sur la ligne des faux positifs, demandez une vérification sur des images dont vous savez qu'elles ne portent pas de code-barres. L'exemple de seuil de confiance explique la manière dont agit cette limite.

Les guides Code-barres non reconnu, faux positifs, et encodage ECI expliquent chaque cause en détail.

Dans quel état le projet doit-il être avant que vous ne le délégiez ?

Commencez avec un projet qui compile déjà. Si l'agent doit deviner quelle bibliothèque de codes-barres utiliser ou corriger d'abord une erreur de compilation, il consacre son exécution au mauvais problème.

Une fois que la compilation réussit, confiez-lui la configuration elle-même, car les erreurs de version et de nom de paquet commencent lors de l'installation.

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

La version résolue est un fait que vous pouvez copier dans des tâches ultérieures. Le contrôle de .gitignore ferme la route la plus courante pour les clés dans les dépôts publics. Et comme IronBarcode lève LicensingException lorsqu'aucune clé valide n'est appliquée, une clé manquante apparaît à la première exécution de l'agent.

Veuillez noter: Ouvrez le journal de terminal pour celui-ci. C'est là que s'affiche la version réellement résolue.

Configurez un fichier d'instructions pour l'espace de travail à la racine du dépôt une fois. Antigravity lit AGENTS.md pour des instructions permanentes, le même fichier utilisé par ChatGPT Codex.

Les compétences représentent la seconde moitié de cette installation. Antigravity cherche dans .agents/skills/<name>/ pour un SKILL.md, et au début d'une conversation, il ne voit que le nom et la description de chaque compétence, lisant les instructions complètes lorsqu'une tâche semble pertinente. Inclure skill.md d'IronBarcode en tant que .agents/skills/ironbarcode/SKILL.md ne coûte donc rien pour les tâches non liées, et /ironbarcode le charge à la demande. Enregistrez qu'IronBarcode est la bibliothèque de codes-barres, que son package est BarCode, que le code doit utiliser uniquement des APIs documentées, et que la clé de licence n'est jamais inscrite en dur dans le code. Ensuite, vous cessez de répéter ces règles à chaque tâche. Une tâche crée le fichier.

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

Comment déléguez-vous le travail de génération et de migration de codes-barres ?

Pour les tâches de génération, décrivez les codes-barres et la preuve que vous souhaitez récupérer, et laissez la structure du code à l'agent.

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

Le plan de mise en œuvre répertorie les fichiers et méthodes avant qu'ils ne soient créés. Utilisez le Walkthrough pour confirmer que le code a été exécuté plutôt que seulement compilé. Chaque membre IronBarcode que le plan nomme devrait apparaître dans la référence API, et vérifier le plan avant que le code n'existe coûte moins cher que de consulter un journal de compilation après.

Déléguer est surtout utile pour les migrations, qui sont répétitives, fastidieuses et faciles à réaliser de façon incomplète. Gardez l'analyse et la mise en œuvre en tant qu'étapes distinctes, et dirigez l'agent vers le fichier lui-même.

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

Si vous obtenez une réécriture avant d'accepter un plan, vous devrez la réviser ligne par ligne. Un Artifact de plan, en revanche, peut être corrigé avec un seul commentaire, et Antigravity vous permet de l'annoter sans perdre vos progrès. Une fois approuvé, gardez la tâche suivante ciblée. Implémentez le plan et laissez les signatures de méthode publique inchangées afin que le reste du code fonctionne encore. Assurez-vous que chaque symbologie continue de lire les mêmes valeurs et rapportez les différences.

Demandez à l'agent de lier la page de documentation à chaque correspondance. Lorsqu’aucune page ne peut être nommée, traitez la correspondance comme non vérifiée. Pour écrire, utilisez les guides codes-barres en 1D et codes-barres en 2D. Pour lire, consultez le tutoriel de lecteur de codes-barres.

Quand devriez-vous dépêcher plus d'un agent ?

Au lieu d'exécuter les tâches une à une, démarrez plusieurs agents à partir d'Antigravity 2.0 et examinez leurs artefacts au fur et à mesure que chaque tâche se termine.

Une division raisonnable pour une migration de codes-barres a un agent pour déplacer le service d'étiquettes hérité vers IronBarcode, et un autre écrit les tests aller-retour pour sa sortie. Le second agent peut démarrer immédiatement, car les tests vérifient les valeurs décodées plutôt que la mise en œuvre.

Lancez les deux ensemble.

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

La comparaison d'octets échoue ici, car deux agents exécutés en parallèle peuvent ne pas produire des PNG identiques. Ce qui doit correspondre est la valeur restituée.

Veuillez noter: Les deux Walkthroughs sont importants ici. Les tests d'Agent B ne comptent que s'ils ont été exécutés contre le service qu'Agent A a réellement construit.

Les options de lecteur réglées pour les étiquettes de retour conviennent également aux palettes entrantes, aux listes de préparation et aux bons de livraison. Enregistrez la configuration de travail dans AGENTS.md ou dans le fichier de compétences, et chaque nouveau scanner coûte moins que le premier.

Comment déboguez-vous les échecs de déploiement sur Linux, Docker, ou Azure ?

Le déploiement est là où un agent avec accès au terminal bat un évaluateur lisant une trace de pile, car il peut ouvrir l'image et regarder au lieu de raisonner dessus.

Donnez à l'agent l'échec tel quel.

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

Limitez la tâche au fichier projet et au Dockerfile. Sans cette limite, un agent pourrait ignorer l'exception et marquer la tâche comme terminée. Envoyez-le à Docker sous Linux et les packages NuGet plutôt que de compter sur la mémoire.

Le même accès au terminal répond aux questions de référence. Demandez quels réglages BarcodeReaderOptions affectent la vitesse ou la précision et lesquels sont déjà définis par votre projet, et l'agent vérifie la référence API avant de répondre.

Quelle preuve obtenez-vous finalement ?

Un plan avant l'exécution et un Walkthrough ensuite, c'est ce que la plateforme vous donne par défaut. Les valeurs écrites et décodées sont ce que votre tâche ajoute, et elles sont la partie qu'il vaut la peine de joindre à la pull request.

Pour la même norme appliquée à une seule tâche à partir d'un projet vide, lisez le guide des assistants de codage AI et des agents.


Dépannage


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.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 2,564,559Version :2026.11tout juste publié