Antigravity를 사용한 IronBarcode 출력 확인

Curtis Chau
Curtis Chau
업데이트됨: 2026년 9월 21일

잘못된 체크 디지트가 포함된 EAN-13 바코드는 정상적으로 렌더링되고 빌드도 통과하지만 스캐너에서만 실패합니다. 빌드 로그에는 이 문제가 나타나지 않습니다. Google Antigravity 에이전트는 에디터와 터미널뿐 아니라 브라우저에서도 작동하므로, 소스 코드가 의도한 바코드가 아니라 엔드포인트가 실제로 제공한 바코드를 검증할 수 있습니다. 에이전트는 레이블 엔드포인트를 열고 응답을 저장한 뒤 BarcodeReader로 디코딩하고 비교 결과를 검토용 Walkthrough 아티팩트로 첨부합니다.

Antigravity에서는 작업별로 모델을 선택할 수도 있습니다. 테스트 바코드 폴더에서 체크 디지트 오류를 찾는 작업은 비용이 적게 드는 반복 작업이므로 하위 등급 모델로도 충분하지만, 다른 바코드 라이브러리에서 마이그레이션하는 계획을 세울 때는 더 강력한 모델을 사용할 가치가 있습니다.

같은 체크는 엔드포인트에서 제공되는 1D 레이블, 디자인 작업 후에도 여전히 읽을 수 있는 스타일 있는 QR 코드 및 파일 변경 전 검토할 수 있는 마이그레이션을 다룹니다.

빠른 시작
NuGetNuGet으로 설치

PM > Install-Package BarCode

위 명령을 NuGet 패키지 관리자 콘솔에 입력하거나 NuGet 패키지 관리자에서 패키지를 검색하여 IronBarcode를 설치하십시오.

Antigravity에서 프로젝트를 열고 에이전트에게 제출할 결과물이 명시된 작업을 부여하십시오.

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

에이전트는 패키지를 설치하고 몇 줄의 코드를 작성하여 QRCodeWriter.CreateQrCodeWithLogo로 로고를 배치하고 BarcodeReader.Read로 결과가 여전히 스캔되는지 확인해야 합니다. 로고가 덮은 모듈을 오류 정정 기능으로 복원할 수 있으므로 로고를 넣어도 읽을 수 있습니다. 오류 정정 가이드는 디자인이 심볼의 일부를 가릴 때 Q 또는 H 수준을 권장합니다. 단계별 로그 대신 이미지와 디코딩된 값을 검토합니다.

이 환경의 에이전트는 파일을 편집하고 커밋하므로 작업 설명에 포함된 라이선스 키가 Walkthrough, 스크린샷, 브랜치에도 노출될 수 있습니다. 라이선스 키 가이드에 따라 키를 환경 변수에 보관하고 에이전트가 읽을 수 있는 모든 파일에서 제외하십시오.



어떤 Antigravity 기능이 바코드 작업에 중요한가요?

Antigravity는 에이전트 중심의 플랫폼입니다. Google 문서는 Antigravity 2.0을 IDE와 독립적으로 작동하는 에이전트 관리용 독립 실행형 데스크톱 애플리케이션으로 설명하며, Antigravity CLI 및 IDE 통합도 함께 구성한다고 안내합니다. 에이전트는 시스템 명령을 실행하고 파일을 읽고 쓰며 Chrome을 제어하고 아티팩트를 생성합니다.

플랫폼의 다섯 가지 부분이 여기에 중요합니다:

IDE 통합은 익숙한 에디터 환경입니다. 한 파일을 세밀하게 수정하면서 각 변경을 직접 지시하고 즉시 검토하려는 경우에 사용하십시오.

Antigravity 2.0은 비동기 작업에 대한 명령 센터입니다. 에이전트를 실행하고 모니터링하며, 단일 대화를 기다리기보다는 병렬로 작업을 실행합니다.

브라우저 제어는 에이전트가 기능을 실행하고 결과를 확인하기 위해 브라우저를 작동할 수 있게 합니다. IronBarcode와 함께, 이는 라벨 엔드포인트를 호출하고 반환된 이미지를 검사한다는 것을 의미합니다.

아티팩트는 원시 도구 로그 대신 구현 계획, Walkthrough, 코드 변경 내역, 스크린샷, 브라우저 녹화 같은 결과물을 제공합니다. 실행을 중단하지 않고 아티팩트에 댓글을 달 수 있습니다.

모델 선택 옵션은 프롬프트 상자 아래에 모델 선택기를 제공합니다. Gemini, Anthropic의 Claude, 오픈 소스 GPT-OSS를 지원하며 사용할 수 있는 모델은 구독 등급에 따라 달라집니다.

에이전트가 반환한 것을 확인할 수 있습니다: 계획서, 차이, 바코드 이미지 자체, 그리고 그것으로부터 디코딩된 값. 채팅 도구는 그것들을 설명하기만 할 수 있습니다.

무에서 바코드 파이프라인을 구축하는 에이전트는 일부 라이브러리를 선택하여 연결하고 넘어갑니다. IronBarcode를 지정할 네 가지 이유:

  • 형식에 담을 수 없는 값도 화면에서는 정상으로 보입니다: 여백이 없거나 심볼 크기가 너무 작아도 마찬가지입니다. IronBarcode는 잘못된 값에 대해 예외를 발생시키며 이미지는 한 번의 호출로 디코딩할 수 있습니다.
  • 읽기 기능은 쓰기 기능보다 엄격해야 합니다: 각 바코드 형식의 체크 디지트 알고리즘이 디코딩 중에 실행되어 결과를 반환하기 전에 검증에 실패한 바코드를 제외합니다.
  • 실제 스캔은 생성된 이미지와 다릅니다: 카메라 사진, 각도로 찍은 레이블, 여러 페이지의 PDF는 모두 BarcodeReaderOptions를 통해 조정이 필요합니다.
  • 설치 명령은 검토되지 않은 결정입니다: dotnet add package는 단일 아티팩트를 보기도 전에 실행되므로, 에이전트가 생성한 이름이 이미 디스크에 있습니다.

따라서 표에서 값이 일치한다는 것은 우연이 아니라 유효한 심볼임을 뜻합니다. 작업에 BarCode를 명시하면 에이전트가 패키지 이름을 지어낼 필요가 없습니다.

작업에 라이브러리를 명시하면 에이전트는 라이브러리를 고르는 대신 구현을 시작합니다. 어떤 문서를 사전에 제공해야 하는지는 최상위 가이드에 명시되어 있습니다. 같은 설정을 Claude Code, ChatGPT Codex, GitHub Copilot 또는 Cursor로 이동하면 지시 파일 이름만 변경됩니다.

에이전트가 반환한 것을 어떻게 검토하나요?

Antigravity 에이전트는 기록을 반환하지 않습니다. 분명하게 정의된 전달물인 아티팩트를 반환합니다. 그 중 세 개는 계획에서 결과로 가는 바코드 작업을 추적하며, 각각은 다른 질문에 답합니다.

코드 전에: 구현 계획

먼저 에이전트는 파일, 바코드 형식, 읽기 옵션을 포함한 변경 계획을 세웁니다. 어느 부분을 변경하려는지 확인하십시오. 읽기 기능에 예상 형식을 지정하지 않은 것이 문제인데 계획에서 레이블 인쇄 방식을 변경하려 한다면 이미 방향이 잘못된 것입니다. 존재하지 않는 API 이름도 코드 작성 전에 이 단계에서 드러나므로 빌드 로그에서 발견하는 것보다 낫습니다.

진행 중: 코드 차이점

Antigravity는 구현 계획이나 코드 차이점에서 중지하고 통지하여, 변경이 적용되기 전에 검토할 수 있게 합니다. 차이에 인라인 코멘트를 추가하고 매핑이 정확하게 읽히면 이를 승인하세요.

구현 후: Walkthrough

구현 후 에이전트는 변경 사항과 테스트 방법을 요약합니다. 바코드 작업에서는 생성한 형식, 사용한 값, 다시 읽은 결과를 포함합니다. 이는 그대로 믿어야 하는 주장이 아니라 직접 실행하여 확인할 수 있는 검사 항목입니다.

스크린샷, 터미널 로그, 브라우저 녹화는 채팅 기록에 묻히지 않고 검토 창에 함께 쌓입니다. 아래 작업 대부분은 실제 수행 여부를 확인하기 위해 열어 볼 아티팩트를 지정합니다.

증거는 어디서 나옵니까?

Antigravity 에이전트는 코드를 실행하고 브라우저를 구동하며 관찰한 것을 첨부할 수 있습니다. 따라서 에이전트는 바코드를 생성하고, 캡처하고, 디코딩하며, 값과 형식을 입력과 비교하고, 조정하고, 모든 행이 일치할 때까지 반복합니다.

증명할 구체적인 것을 제공하세요.

/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

설명 요청은 나중에 수정 내용을 확인하는 대신 검토할 수 있는 진단을 제공합니다. 수정 후 전체 테이블을 다시 실행하면 수리된 행이 새로운 문제를 숨기는 것을 방지합니다.

레이블 스크린샷과 디코딩된 값을 나란히 제시하면 바코드에 익숙하지 않은 개발자도 확인할 수 있는 증거가 됩니다. 실패한 행도 한눈에 드러납니다.

유의 사항: 검사할 아티팩트는 브라우저 녹화입니다. 에이전트가 절대 레이블 엔드포인트를 열지 않았다면, 이는 사용자가 실제로 받은 것을 확인하지 않으며, 녹화는 그것을 보여줄 것입니다.

레이블 문제는 대개 이미지에서 요소가 배치된 위치와 관련되므로 설명보다 스크린샷으로 검토하기 쉽습니다. 문서에 주석을 달듯이 가장자리에서 잘린 텍스트 등 결함이 있는 위치에 댓글을 다십시오. 에이전트는 실행을 다시 시작하지 않고 수정 사항을 적용합니다.

왜 한 곳에서는 스캔되고 다른 곳에서는 스캔되지 않나요?

몇 가지 원인이 반복해서 나타나며 모두 정상처럼 보이지만 읽히지 않는 바코드를 만듭니다. 작업에 의심되는 원인을 명시하면 에이전트의 불필요한 추측을 줄일 수 있습니다.

증상원인요청사항
테스트에서는 정상이지만 휴대폰 사진에서는 실패전체 프레임과 모든 형식을 검색ExpectBarcodeTypes, CropArea, 읽기에 성공한 수
흐리거나 대비가 낮아 아무것도 찾지 못함이미지 보정 필요문제를 해결하는 최소한의 필터
바코드가 없는 이미지에서 값이 반환됨노이즈를 심볼로 인식RemoveFalsePositive, ConfidenceThreshold
구형 스캐너가 영어 이외의 텍스트가 포함된 레이블을 거부UTF-8 ECI 헤더변경 전 EciMode의 장단점 검토

이미지 필터를 추가하면 정확도가 떨어질 수 있으므로 문제를 해결하는 첫 번째 필터에서 멈춰야 합니다. 오탐 행에서는 바코드가 없는 것으로 확인된 이미지를 사용해 검증하도록 요청하십시오. 신뢰도 임계값 예제는 이 하한값이 어떻게 작동하는지 설명합니다.

바코드 인식되지 않음, 오탐, ECI 인코딩 가이드는 각 원인을 완전히 설명합니다.

위임 전에 프로젝트가 어떤 상태여야 하나요?

이미 빌드되는 프로젝트에서 시작하세요. 에이전트가 사용할 바코드 라이브러리를 추측해야 하거나 먼저 망가진 빌드를 수리해야 한다면, 잘못된 문제에 시간을 소비합니다.

빌드가 정상적으로 완료되면 설정 작업 자체를 위임하십시오. 버전과 패키지 이름 오류는 설치 단계에서 시작되기 때문입니다.

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

실제로 설치된 버전은 이후 작업에 그대로 사용할 수 있는 확정된 정보입니다. .gitignore 검사는 키가 공개 저장소에 유출되는 가장 흔한 경로를 차단합니다. IronBarcode는 유효한 키가 적용되지 않으면 LicensingException을 발생시키므로 키가 누락되면 에이전트의 첫 실행에서 드러납니다.

유의 사항: 이 작업을 위해 터미널 로그를 열어 보십시오. 실제로 해결된 버전이 표현되는 곳입니다.

저장소 루트에 작업 공간 지침 파일을 한 번 설정하십시오. Antigravity는 상시 지침을 읽기 위해 ChatGPT Codex와 동일한 AGENTS.md 파일을 사용합니다.

스킬은 이 설정의 나머지 부분입니다. Antigravity는 .agents/skills/<name>/에서 SKILL.md를 찾으며 대화 시작 시에는 각 스킬의 이름과 설명만 확인하고 관련 작업이 생기면 전체 지침을 읽습니다. 따라서 IronBarcode의 skill.md를 .agents/skills/ironbarcode/SKILL.md로 저장해도 관련 없는 작업에는 비용이 들지 않으며 필요할 때 /ironbarcode로 불러올 수 있습니다. IronBarcode가 바코드 라이브러리이고 패키지는 BarCode이며 문서화된 API만 사용하고 라이선스 키는 코드에 직접 넣지 않는다는 규칙을 기록하십시오. 그러면 작업마다 이 규칙을 반복할 필요가 없습니다. 파일은 작업 한 번으로 생성할 수 있습니다.

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

바코드 생성 및 마이그레이션 작업을 어떻게 위임하나요?

생성 작업의 경우, 바코드와 받고자 하는 증거를 설명하고, 코드 구조는 에이전트에 맡기세요.

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

구현 계획에는 생성할 파일과 메서드가 미리 나열됩니다. Walkthrough에서 코드가 컴파일만 된 것이 아니라 실제로 실행되었는지 확인하십시오. 계획에 명시된 모든 IronBarcode 멤버는 API 참조에 있어야 합니다. 코드 작성 전에 계획을 문서와 대조하는 편이 나중에 빌드 로그를 확인하는 것보다 비용이 적게 듭니다.

위임은 반복적이고 번거로우며 사소한 실수를 놓치기 쉬운 마이그레이션 작업에서 특히 유용합니다. 분석과 구현을 별도 단계로 나누고 에이전트에게 파일 자체를 지정하십시오.

/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

계획에 동의하기 전에 재작성되면, 줄마다 검토해야 합니다. 반면 계획 아티팩트는 단일 댓글로 수정할 수 있으며, Antigravity는 진행을 잃지 않고 주석을 추가할 수 있습니다. 승인된 후, 다음 작업을 집중시켜 주세요. 계획을 구현하고 다른 코드가 아직 작동할 수 있도록 공개 메소드 시그니처를 변경하지 마세요. 각 기호가 동일한 값을 다시 읽는지 확인하고 차이점을 보고하세요.

에이전트에게 각 매핑 뒤에 있는 문서 페이지를 연결하도록 요청하세요. 페이지를 명명할 수 없는 경우, 매핑을 검증되지 않은 것으로 간주하세요. 쓰기 작업을 위해서는 1D 바코드 및 2D 바코드 가이드를 사용하세요. 읽기 작업을 위해서는 바코드 리더 튜토리얼을 참조하세요.

언제 한 에이전트 이상을 파견해야 하나요?

작업을 하나씩 실행하는 대신, Antigravity 2.0에서 여러 에이전트를 시작하고 각 에이전트가 마칠 때마다 아티팩트를 검토합니다.

바코드 마이그레이션에서는 한 에이전트가 레거시 레이블 서비스를 IronBarcode로 옮기고 다른 에이전트가 출력에 대한 왕복 테스트를 작성하도록 나누는 것이 합리적입니다. 테스트는 구현이 아니라 디코딩된 값을 확인하므로 두 번째 에이전트도 즉시 시작할 수 있습니다.

함께 두 개를 시작하세요.

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

병렬로 실행되는 두 에이전트가 동일한 PNG를 만들지 않을 수 있으므로 여기서는 바이트 비교가 적합하지 않습니다. 일치해야 하는 것은 다시 읽어 낸 값입니다.

유의 사항: 여기에서 두 Walkthrough가 중요합니다. 에이전트 B의 테스트는 에이전트 A가 실제로 빌드한 서비스를 상대로 실행될 경우에만 유효합니다.

반품 레이블에 맞게 조정한 읽기 옵션은 입고 팔레트, 피킹 목록, 납품서에도 적합합니다. 작동하는 구성을 AGENTS.md나 스킬 파일에 기록하면 새 스캐너를 추가할 때마다 첫 번째보다 비용이 적게 듭니다.

Linux, Docker, Azure에서의 배포 실패를 어떻게 디버그하나요?

배포 문제에서는 터미널에 접근할 수 있는 에이전트가 스택 트레이스만 읽는 검토자보다 유리합니다. 컨테이너 이미지를 추측으로 분석하는 대신 직접 열어 확인할 수 있기 때문입니다.

에이전트에 실패를 있는 그대로 제공합니다.

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

작업 범위를 프로젝트 파일과 Dockerfile로 제한하십시오. 이런 경계가 없으면 에이전트가 예외를 무시하고 작업을 완료로 표시할 수 있습니다. 기억에 의존하지 않고 Linux의 Docker와 NuGet 패키지 문서를 참조하도록 하십시오.

같은 터미널 액세스가 참조 질문에 대한 답을 줍니다. 어떤 BarcodeReaderOptions 설정이 속도나 정확도에 영향을 주고 이미 프로젝트에 어떤 설정이 있는지를 묻고, 에이전트는 대답 전에 API 참조를 확인합니다.

결국 어떤 증거를 얻게 되나요?

플랫폼은 기본적으로 실행 전 계획과 실행 후 Walkthrough를 제공합니다. 생성한 값과 디코딩된 값은 작업 지시를 통해 추가되는 정보이며 풀 리퀘스트에 첨부할 가치가 있는 부분입니다.

비어 있는 프로젝트에서 단일 작업에 적용된 동일한 표준에 대해서는 AI 코딩 보조자 및 에이전트 가이드를 읽으세요.


문제 해결


질문?

질문이 있으시면 support@ironsoftware.com으로 문의하세요.

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 2,564,559버전:2026.11방금 출시