Cómo verificar la salida de IronBarcode con Google Antigravity
Un código de barras EAN-13 con un dígito de control incorrecto se renderiza claramente, pasa la compilación y falla solo en el escáner. Ningún registro de compilación lo reportará. Los agentes de Google Antigravity operan en el navegador, así como en el editor y la terminal, lo que les permite verificar el código de barras que un endpoint realmente sirvió en lugar del que el código fuente debía producir. El agente abre el endpoint de la etiqueta, guarda la respuesta, la decodifica con BarcodeReader, y adjunta la comparación como un artefacto de recorrido para revisión.
Antigravity también le permite elegir el modelo para cada tarea. Escanear una carpeta de códigos de barras de prueba para errores de dígito de control es trabajo barato y repetitivo que funciona bien en un nivel inferior, mientras que planificar una migración desde otra biblioteca de códigos de barras requiere uno más fuerte.
La misma verificación cubre etiquetas 1D servidas desde un endpoint, códigos QR estilizados que aún se leen después del trabajo de diseño, y migraciones que puede revisar antes de cualquier cambio de archivo.
Inicio rápidoAbra un proyecto en Antigravity y dele al agente una tarea con un entregable adjunto.
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.
El agente debe instalar el paquete y escribir algunas líneas de código, utilizando QRCodeWriter.CreateQrCodeWithLogo para colocar el logotipo y BarcodeReader.Read para demostrar que el resultado aún se escanea. Un logotipo sobrevive porque la corrección de errores puede reconstruir los módulos que cubre, y la guía de corrección de errores recomienda el nivel Q o H cuando un diseño oscurece parte del símbolo. Revisas la imagen y el valor decodificado en lugar de un registro paso a paso.
Los agentes aquí editan y crean commits, por lo que una clave de licencia que llega a una descripción de tarea puede alcanzar un Walkthrough, una captura de pantalla y una rama. Mantengagala en una variable de entorno y fuera de cada archivo que el agente pueda leer, siguiendo la guía de claves de licencia.
Flujo de trabajo mínimo en 5 pasos
- Descargue la biblioteca de códigos de barras C# desde NuGet
- Abra el proyecto en Antigravity y confirme que compila
- Añada IronBarcode y aplique la clave de licencia desde la configuración, no desde el código
- Describa la tarea con el framework, las rutas de archivo, la simbología y el resultado esperado
- Deje que el agente genere, decodifique, y compare, luego verifique los nombres de la API contra la referencia de API
¿Qué características de Antigravity importan para el trabajo con códigos de barras?
Antigravity pone a los agentes primero. La documentación de Google describe Antigravity 2.0 como una aplicación de escritorio independiente para gestionar agentes, trabajando de manera independiente de un IDE, con un CLI de Antigravity y una integración de IDE configurada junto a ella. Un agente allí ejecuta comandos del sistema, lee y escribe archivos, maneja Chrome y produce artefactos.
Cinco partes de la plataforma importan aquí:
La integración de IDE es el editor que ya conoce. Úselo para trabajar en detalle en un solo archivo, cuando quiere dirigir cada edición y revisarla a medida que ocurre.
Antigravity 2.0 es el centro de comando para el trabajo asincrónico. Lance agentes, monitoréelos y ejecute trabajos en paralelo en lugar de esperar una sola conversación.
Control de navegador permite que un agente opere un navegador para probar una función y confirmar el resultado. Con IronBarcode, eso significa llamar a un endpoint de etiqueta e inspeccionar la imagen que devuelve.
Los artefactos reemplazan los registros de herramientas sin procesar con entregables como planes de implementación, recorridos, diferencias de código, capturas de pantalla y grabaciones de navegador. Puede comentar sobre un artefacto sin detener la ejecución.
Selección de modelo coloca un selector de modelo bajo el campo del prompt, cubriendo Gemini, Claude de Anthropic y el GPT-OSS de código abierto, con disponibilidad establecida por su nivel de suscripción.
Lo que un agente devuelve se puede verificar: un plan, una diferencia, la propia imagen del código de barras y los valores que decodificó de esa imagen. Una herramienta de chat solo puede describirlos.
Un agente construyendo una canalización de códigos de barras desde cero elegirá alguna biblioteca, la conectará y continuará. Cuatro razones para nombrar IronBarcode en su lugar:
- Un valor que el formato no puede contener se ve perfectamente bien en pantalla: lo mismo ocurre con una zona de silencio faltante y un símbolo de tamaño insuficiente, donde IronBarcode lanza una excepción ante un valor no válido y decodificar la imagen requiere una sola llamada.
- El lector necesita ser más estricto que el escritor: el algoritmo de dígito de control de cada simbología se ejecuta mientras se decodifica y descarta los códigos de barras que fallan antes de que se devuelvan los resultados.
- Los escaneos reales no se comportan como las imágenes generadas: las fotos de cámara, las etiquetas tomadas en ángulo y los PDFs de varias páginas necesitan ajuste a través de
BarcodeReaderOptions. - Un comando de instalación es una decisión no revisada:
dotnet add packagese ejecuta antes de que vea un solo artefacto, por lo que un nombre que el agente inventó ya está en el disco.
Una coincidencia en la tabla por lo tanto significa un símbolo válido y no una simple casualidad. Escriba BarCode en la tarea y no hay nada que inventar.
Una vez que la tarea lo nombra, el agente deja de elegir y comienza a construir. Qué documentación proporcionar de antemano se establece en la guía principal. Solo el nombre del archivo de instrucciones cambia si traslada la misma configuración a Claude Code, ChatGPT Codex, GitHub Copilot o Cursor.
¿Cómo revisa lo que el agente devuelve?
Los agentes de Antigravity no devuelven transcripciones. Devuelven artefactos, entregables nombrados. Tres de ellos rastrean una tarea de código de barras desde el plan hasta el resultado, y cada uno responde a una pregunta diferente.
Antes del código: el Plan de Implementación
Primero, el agente diseña el cambio, incluyendo los archivos, las simbologías y las opciones de lectura. Verifique qué lado planea cambiar. Si nunca se le dijo al lector qué formatos esperar, pero el plan edita cómo se imprimen las etiquetas, el agente ya está fuera de curso. Cualquier nombre de API inventado también aparece aquí, antes de que exista cualquier código, lo cual es mejor que encontrarlo en un registro de compilación.
Durante: la diferencia de código
Antigravity se detiene en un plan de implementación o una diferencia de código y le notifica, para que el cambio sea revisable antes de que se asiente. Agregue comentarios en línea sobre la diferencia y apruébelo una vez que el mapeo se lea correctamente.
Después: el Recorrido
Después de la implementación, el agente resume qué cambió y cómo probarlo. Para los códigos de barras, eso cubre los formatos escritos, los valores usados y los resultados de lectura de verificación, todo como verificaciones que puede realizar en lugar de afirmaciones en las que debe confiar.
Capturas de pantalla, registros de terminal y grabaciones de navegador se acumulan junto a estos en el panel de revisión, no perdidos en un desplazamiento de chat. La mayoría de las tareas a continuación nombran el único artefacto para abrir para confirmar que el trabajo ocurrió.
¿De dónde proviene la prueba?
Los agentes de Antigravity pueden ejecutar código, conducir un navegador y adjuntar lo que observaron. Entonces el agente genera un código de barras, lo captura, lo decodifica, compara el valor y el formato con la entrada, ajusta y repite hasta que cada fila coincida.
Dele algo concreto para probar.
/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.
Pedir una explicación primero le da un diagnóstico para revisar, en lugar de una solución para verificar más tarde. Ejecutar la tabla completa nuevamente después de cualquier reparación también evita que una fila reparada oculte un nuevo problema.
Una captura de pantalla de la etiqueta junto a sus valores decodificados es evidencia que un desarrollador nuevo en códigos de barras puede verificar, y una fila fallida es obvia a simple vista.
Los problemas de etiquetas suelen estar relacionados con dónde se encuentra algo en la imagen, lo que hace que una captura de pantalla sea más fácil de revisar que una descripción. Comente en la captura de pantalla dónde está el fallo, como texto recortado en el borde, como lo haría en un documento. El agente aplica la corrección sin reiniciar la ejecución.
¿Por qué se escanea en un lugar y no en otro?
Las mismas pocas causas aparecen, todas ellas produciendo un código de barras que se ve bien y no se lee. Nombrar la causa probable en la tarea ahorra al agente una ronda de adivinanzas.
| Síntoma | Causa | Solicite |
|---|---|---|
| Bien en pruebas, falla en fotos de teléfono | Imagen completa, todos los formatos | ExpectBarcodeTypes, CropArea, un conteo de lecturas |
| Borroso o bajo contraste, nada encontrado | La imagen necesita corrección | El filtro más pequeño que funciona |
| Valores de imágenes sin código de barras | Ruido leído como un símbolo | RemoveFalsePositive, ConfidenceThreshold |
| Escáneres antiguos rechazan etiquetas no inglesas | Un encabezado ECI UTF-8 | Las ventajas y desventajas de EciMode, antes de cualquier cambio |
Los filtros de imagen adicionales cuestan precisión, por lo que el agente debe detenerse en el primero que despeje el fallo. En la fila de falsos positivos, pida prueba contra imágenes que sabe que no llevan códigos de barras. El ejemplo de umbral de confianza cubre cómo se comporta ese umbral.
Las guías Código de barras no reconocido, falsos positivos, y codificación ECI explican cada causa completamente.
¿En qué estado debe estar el proyecto antes de delegar?
Comience con un proyecto que ya compile. Si el agente tiene que adivinar qué biblioteca de código de barras usar o reparar una compilación fallida primero, gasta su ejecución en el problema equivocado.
Una vez que el proyecto compila sin errores, entregue la propia configuración, porque los errores de versión y nombre de paquete comienzan durante la instalación.
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.
La versión resuelta es un hecho que puede pegar en tareas posteriores. El chequeo .gitignore cierra la ruta más común para claves en repositorios públicos. Y dado que IronBarcode lanza LicensingException cuando no se aplica una clave válida, una clave faltante aparece en la primera ejecución del agente.
Configure un archivo de instrucciones de espacio de trabajo en la raíz del repositorio una vez. Antigravity lee AGENTS.md para instrucciones permanentes, el mismo archivo que utiliza ChatGPT Codex.
Las habilidades son la segunda mitad de esa configuración. Antigravity busca en .agents/skills/<name>/ un SKILL.md, y al comienzo de una conversación solo ve el nombre y descripción de cada habilidad, leyendo las instrucciones completas cuando una tarea parece relevante. Guardar skill.md de IronBarcode como .agents/skills/ironbarcode/SKILL.md por lo tanto no cuesta nada en tareas no relacionadas, y /ironbarcode lo trae bajo demanda. Registre que IronBarcode es la biblioteca de códigos de barras, su paquete es BarCode, el código debe usar solo APIs documentadas, y la clave de licencia nunca debe escribirse directamente en el código. Así evita repetir esas reglas en cada tarea. Una tarea crea el archivo.
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.
¿Cómo delega el trabajo de generación y migración de códigos de barras?
Para las tareas de generación, describa los códigos de barras y la prueba que quiere de regreso, y deje la estructura del código al agente.
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.
El Plan de Implementación enumera los archivos y métodos antes de que se creen. Use el Recorrido para confirmar que el código se ejecutó en lugar de solo compilarse. Cada miembro de IronBarcode que el plan nombre debe aparecer en la referencia de API, y verificar el plan contra ella antes de que exista el código es más barato que verificar un registro de compilación después.
Delegar es más útil para migraciones, que son repetitivas, tediosas y fáciles de hacer casi bien. Mantenga el análisis y la implementación como pasos separados, y señale al agente el archivo en sí.
/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.
Si obtiene una reescritura antes de acordar un plan, tendrá que revisarla línea por línea. Un artefacto de plan, por otro lado, se puede corregir con un solo comentario, y Antigravity le permite anotarlo sin perder su progreso. Una vez aprobado, mantenga la siguiente tarea enfocada. Implemente el plan y deje las firmas de los métodos públicos sin cambios para que el otro código siga funcionando. Asegúrese de que cada simbología todavía lea los mismos valores y reporte las diferencias.
Pida al agente que enlace la página de documentación detrás de cada mapeo. Donde no se pueda nombrar ninguna página, trate el mapeo como no verificado. Para escribir, utilice las guías de código de barras 1D y código de barras 2D. Para leer, consulte el tutorial del lector de códigos de barras.
¿Cuándo deberías enviar más de un agente?
En lugar de ejecutar tareas una a la vez, inicie varios agentes desde Antigravity 2.0 y revise sus artefactos a medida que cada uno termina.
Una división sensata para una migración de códigos de barras tiene a un agente moviendo el servicio de etiquetas heredado a IronBarcode, y otro escribiendo las pruebas de ida y vuelta para su salida. El segundo agente puede comenzar de inmediato, porque las pruebas verifican los valores decodificados en lugar de la implementación.
Lance ambos juntos.
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.
La comparación byte a byte falla aquí, porque dos agentes ejecutándose en paralelo pueden no producir PNGs idénticos. Lo que tiene que coincidir es el valor que vuelve a salir.
Las opciones del lector ajustadas para etiquetas de devolución también son adecuadas para paletas entrantes, listas de selección y notas de entrega. Registre la configuración de trabajo en AGENTS.md o el archivo de habilidades, y cada nuevo escáner cuesta menos que el primero.
¿Cómo depura fallas de despliegue en Linux, Docker o Azure?
El despliegue es donde un agente con acceso a la terminal supera a un revisor leyendo un rastreo de pila, porque puede abrir la imagen y mirar en lugar de razonar sobre ella.
Dele al agente la falla tal como es.
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.
Limite la tarea al archivo de proyecto y al Dockerfile. Sin este límite, un agente podría ignorar la excepción y marcar la tarea como completa. Envíelo a Docker en Linux y paquetes NuGet en lugar de confiar en la memoria.
El mismo acceso de terminal responde a preguntas de referencia. Pregunte qué configuraciones BarcodeReaderOptions afectan la velocidad o precisión y cuáles ya establece su proyecto, y el agente verifica la referencia de API antes de responder.
¿Qué evidencias obtiene?
Un plan antes de la ejecución y un recorrido después de ella son lo que la plataforma le da por defecto. Los valores escritos y decodificados son lo que su tarea agrega, y son la parte que vale la pena adjuntar a la solicitud de extracción.
Para el mismo estándar aplicado a una sola tarea desde un proyecto vacío, lea la guía de asistentes de codificación de IA y agentes.
Solución de problemas
- Aplique una clave de licencia en IronBarcode cuando el registro de terminal muestra que la primera ejecución falla.
- Código de barras no reconocido cuando una fila en la tabla del agente se niega a coincidir.
- Paquetes NuGet de IronBarcode para fijar el paquete que sus tareas y
AGENTS.mdnombran. - Ejecute IronBarcode en Docker en Linux cuando una etiqueta verificada por navegador falla una vez contenedorizada.
¿Preguntas?
Si tiene alguna pregunta, contacte a support@ironsoftware.com
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.