IronQRをGoogle Antigravityで使う方法

Curtis Chau
Curtis Chau
更新日: 2026年10月9日

Blazorのアップロードページは警告なしにビルドできるかもしれませんが、ユーザーファイルを正しく処理できないことがあります。 ビルドプロセスは、ページがインタラクティブ性に欠けているか、大きな画像がアップロード制限を超えているか、複数のパスを含む画像が部分的にしか処理されていないかを示しません。 これらの問題は実際のテスト中にのみ明らかになります。

Google Antigravityはこの問題に対応します。 その/browserコマンドはアップロードコントロールのファイルを選択します。 IronQRはサーバーサイドでアップロードされた画像をQrReader.Readを使用してデコードするので、ページにはJavaScriptスキャナーが不要です。 このガイドでは、両ツールを使用して訪問者チェックインページを構築し、アップロードされたファイルを期待される値とページ上に表示されている値と比較して結果を検証する方法を示します。

用語に関する一つの注記。 IronQRは、スキャンモードガイドで詳しく説明されているように、困難な画像でQRコードを検出するための機械学習モデルを含んでいます。 このガイドでは、『AI』はページを記述しテストする責任のあるコーディングエージェントを指します。

クイックスタート
NuGetNuGet でインストール

PM > Install-Package IronQR

NuGetパッケージマネージャーコンソールで上記のコマンドを実行するか、NuGetパッケージマネージャーでパッケージを検索して、IronQRをインストールします。

AntigravityでBlazorプロジェクトを開き、/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.
Text

計画は2つの設定を明示する必要があります。 Blazor Web Appは、インタラクティブ性を選択しない限り、ページを静的にレンダリングします。これはレンダーモードガイドで説明されています。 MicrosoftのBlazorファイルアップロードガイドによると、OpenReadStreamは512,000バイトを超えるファイルを拒否しますが、電話の写真ははるかに大きくなります。 agy -pを--dangerously-skip-permissionsで実行すると、すべてのツール呼び出しは承認されるので、計画と差分を一緒にレビューしてください。

エージェントに変数名IRONQR_LICENSE_KEYを与え、値を与えないでください。 ファイルを書き、コマンドを実行するエージェントは、貼り付けられたキーをコミットやログにコピーすることができます。 IronQRはまた、appsettings.jsonからのIronQr.LicenseKeyエントリーを読み取り、これを誤ってコミットしやすいです。 ライセンスキーガイドにはすべてのオプションが含まれています。



Google Antigravityとは何か、そしてチャットアシスタントとはどう違うのか?

Antigravityは変更を計画し、コードを編集し、ターミナルを使用し、ブラウザを操作して報告するエージェントを実行し、各ステップを監視する代わりに見直し可能な成果物を作成します。GoogleはAntigravity 2.0をエージェント管理のための独立したデスクトップアプリとして説明しており、CLIはagyとしてインストールされます。

パッケージを選ぶことを任されたエージェントはその名前を推測するかもしれず、攻撃者は事前にあり得る名前を登録し、それにマルウェアを含ませるというスロップスクアッティングと呼ばれる手法を使います。 パッケージをIronQR、名前空間をIronQrと名付けてください。

IronQRのドキュメントリンクは、AIコーディングアシスタントガイドにあります。

計画、差分、手順のどこを確認するべきか

実施計画には、コードがない画像といくつかのコードを含む画像のページの表示内容も記載するべきです。

コードの差分には、アップロードがAnyBitmapになる方法、差分で使用されるすべてのIronQRメンバーをAPIリファレンスで検索してください。

ブラウザタスクにおいて、Googleは手順がエージェントが行ったスクリーンショットや録画を保持していることがよくあると述べています。 CLI実行では、会話内のすべてのタスクが同じwalkthrough.mdを書き直したので、最新のタスクのレポートのみを保持していました。 次のプロンプトを送信する前に、保持したいテーブルをコピーしてください。

IronQRアップロードページをリアルブラウザでテストする方法

/browserは、スラッシュコマンドリファレンスに従って、ページを開きスクリーンショットを取得するサンドボックス化されたChromeのサブエージェントを開始します。 ファイルをアップロードすることでのみ埋められるテーブルを要求してください。

/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

結果リストに修正を加えるとすべての画像のマークアップが変更されるので、完全な再実行だけでどの行も後退しなかったことを示します。

注意してください: まず最大の写真のスクリーンショットを開いてください。過度に大きなアップロードは、サーバーログに行がない場合に失敗することがあり、ログだけで作成されたレポートはその行を合格とみなすでしょう。

スクリーンショットはすべて画像成果物として保存されます。 問題が表示された場合、たとえば通過番号が短縮されている場合、新しいプロンプトで説明するのではなくコメントを追加してください。

欠落または誤ったQR値の原因は何か?

ほとんどの失敗した行は少数の原因に起因し、次のタスクで考えられそうな原因を挙げることで、エージェントの試行錯誤を一巡省けます。 IronQRのBlazorスキャナーガイドからのページを新しい.NET 9テンプレートに導入し、IronQR 2026.10.1とヘッドレスChromeを使って7枚のテスト画像をアップロードしました。以下のすべての欠陥はきれいにコンパイルされました。 レンダーモードが追加されると、7枚の画像のうち5枚が正しい値を表示しました。

  • すべての画像に対して無効のままのスキャンボタンは、クイックスタート計画が述べるレンダーモードが必要です。
  • 48 MPの写真(17,955,400バイト)はガイドの10,000,000バイトの上限を超え、メッセージなしでボタンを無効のままにします。 最大の写真よりも大きなファイル用に上限を設定し、メッセージを表示してください。
  • 2つのパスを持つ画像が1つの値を示した場合、すべての結果を一覧表示してください。

Antigravityプロジェクトとそのルールをセットアップする方法

既にビルドと実行ができるプロジェクトをエージェントに与えます。 それをdotnet new blazor --interactivity Server --framework net9.0で作成し、一度実行して、Properties/launchSettings.jsonにURLを注意してください。 テンプレートは各プロジェクトに異なるポートを選択し、/browserプロンプトが必要です。

その後、パッケージとキーのチェックを委譲します。

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

報告されたバージョンを後のすべてのタスクで使用してください。 キーがないと、LicensingExceptionおよび「本番ライセンスが必要」と表示され、変数が不足していると最初のスキャンが失敗します。

アップロードテーブルが合格した後、ルールを記録してください。 Antigravityは毎回のフォルダーレベルで、AGENTS.mdおよびGEMINI.mdをワークスペースルートまで読み込みます、そのルールドキュメントに従い、/learnはセッションの修正を永続的なルールに変えます。

/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

そのファイルは後のすべてのタスクで読み込まれるので、プロンプトはレンダーモードを繰り返す必要が無くなります。 ルールを変更したタスクはファイルも変更しなければなりません。 私たちの実行では、AGENTS.mdはアップロードのリファクタリングがサービスを25 MBに移した後もクイックスタート計画の30 MB上限を保持しました。

一時ファイルなしでアップロードをデコードする方法

IronQRは画像をAnyBitmapとして読み取るので、ページはブラウザのアップロードをそれに変換する必要があります。 Blazorスキャナーガイドはアップロードをクライアントのファイル名にちなんで名付けられた一時ファイルにコピーし、ディスクから開きます。 同時に同じ名前でファイルをアップロードする2つのデスクは衝突する可能性があります、Microsoftはクライアントが供給する名前の下にアップロードを保存しないことを推奨しています。

AnyBitmap.FromStreamはファイルを避けますが、アップロードの後ろにあるブラウザストリームはシークできず、同期読み取りを拒否します。 IronQR 2026.10.1では、その制限を持つストリームを直接通した場合、NotSupportedExceptionを投げます。 読み込みの前にCopyToAsyncを使ってアップロードをMemoryStreamにコピーすることで機能します。 Microsoftはサーバーメモリにアップロード全体をバッファリングしないことを推奨しているので、アップロード制限はバッファも制限します。

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

この方向に沿ったサービスを差分で探してください。 このバージョンはIronQR 2026.10.1に対してコンパイルされ、そのページを呼び出した場合、7枚のテスト画像すべてに正しい値を示しました。

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は、有効なURIである場合にのみ設定され、リンクを持つパスと普通のパス番号を持つ他のパスを組み合わせたデスクに適しています。

再起動後の最初のスキャンが遅いのはなぜか?

IronQRパッケージにはIronQrDetection.dllが含まれており、2026.10.1における44MBのアセンブリで、ほぼ完全に1つの組み込まれたリソースから成り立ち、検出モデルを実行するためにMicrosoft.ML.OnnxRuntime1.20.1に依存しています。 QrScanMode.Autoは、検出器が何も見つからなかった場合にのみ実行される基本スキャンの前に、検出器を試します。

きれいな画像を読み取る新しいコンソールプロセス3つでは、最初のAuto読み取りは3.1〜4.7秒かかり、その後の読み取りは0.5〜1.0秒でした。 読み取りごとに新しいリーダーを作成しても、遅延は戻らず、コストはプロセスごとにかかります。 ファイルの読み込みを含む最初のOnlyBasicScan読み取りは、0.33〜0.56秒かかりました。 Blazorサーバーでは、再起動またはスケールアウト後の最初の訪問者は、アプリが起動時に検出器をロードしない限り待機します。

/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

起動時にブロックするIHostedServiceウォームアップは、最初のアップロードを遅くする代わりに最初のページロードを遅くします、エージェントのタイミングはどちらの構成を作成したか示します。

複数のエージェントを派遣するのはいつですか?

テストエージェントとブラウザエージェントは、サービスの結果をコードでチェックし、スタッフがページで見るものを確認する異なる事柄を検査します。

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

私たちのテストでは、IronQRはAutoの下での順序とは別の順序で2つのパスを返しました、これがテストが集合を比較する理由です。

注意してください: デスクトップアプリでは、各エージェントにタスクを割り当て、2つの手順を比較してください。

スキャナーをLinuxコンテナにデプロイする方法

IronQR 2026.10.1もまた、IronQR.SlimおよびIronSoftware.ReaderInternals.Windowsに依存しており、IronQR.LinuxはWindows内部を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.
Text

公開フォルダーが証拠であり、Windows上で検査できます。 WindowsのIronQRパッケージを使って、linux-x64公開はONNXランタイムライブラリを含んでいましたが、LinuxネイティブリーダーであるReaderInterop.soを含んでいませんでした。 PackageReferenceはRuntimeIdentifierに基づいており、各ビルドの正しいパッケージを選択しました。

両方のネイティブライブラリはglibcにリンクしており、muslビルドを出荷していないため、Alpineベースイメージにはロードするものがありません。 IronSoftware.ReaderInternals.Linux 2026.3.47413はlinux-x64ビルドのみを提供し、IronQR.Linux 2026.10.1がカバーする範囲外です。 もし検出器のDLLが出力フォルダーに見つからない場合、アインQRはIronQrRuntimesCopyExceptionを投げ、ランタイムコピ例外ページが修正を提供します。 NuGetパッケージガイドはすべてのプラットフォームパッケージを一覧しており、IronQR.Slimだけが検出モデルなしでOnlyBasicScanを実行します。

プロンプトが実運用で生成したものは何ですか?

上記の8つのプロンプトは、未監督で--dangerously-skip-permissionsを使用して、一つのAntigravity CLI対話で順番に実行され、新しい.NET 9 Blazor Web Appでインタラクティブサーバーレンダーモードで実行されました。 リポジトリには既知の値を持つ7つのテスト画像が保存され、TestData/scans/expected.csvにリストされていました。 これらはクリーンスクリーンショット、12 MPおよび48 MPの電話写真、2つのパスを持つ画像、悪い照明で傾いた写真、URLを持つパス、パスのないデスク写真でした。 キーは環境を通じてエージェントにのみ届きました。 実行後、私たちはアプリをReleaseで再構築し、テストを実行し、自分たちでヘッドレスChromeを通じてすべての画像をアップロードしました。

クイックスタート計画はすでに48 MPの写真以上でアップロードを制限し、すべての結果をリストしたため、ガイドページの2つのアップロード欠陥は現れませんでした。

  • 再起動後の最初のアップロードは、ウォームアップまでに3,315 ms、ウォームアップ後に901 msでした。
  • エージェント自体のアップロードテーブルでは、7行中6行が合格し、その後7行中7行が通過しました。
  • 最終アプリのアップロードチェックは7行中7行が合格し、xUnitテストは8行中8行が合格しました。
  • リリースビルドは警告0、エラー0で終了しました。
  • ReaderInterop.soをlinux-x64公開で行ったサイズは21,475,192バイトでした。
  • 両方の計画最初のプロンプトは計画を書いてファイルを1周で変更し、一つのエージェントが2エージェントプロンプトの作業を行いました。
  • ブラウザスクリーンショットとlinux-x64公開フォルダーはリポジトリに残されました。

ハブの実行履歴にはAntigravityのバージョン、モデルと実行時間、使用した機械が記載されています。


トラブルシューティング


質問ありますか?

質問がある場合は、support@ironsoftware.com にお問い合わせください。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 82,442バージョン:2026.11ちょうどリリースされました