https://gkzz.dev/tags/maestro/ Recent content in Maestro on gkzz.dev Hugo en Mon, 20 Jul 2026 00:00:00 +0900 https://gkzz.dev/posts/maestro-test-output-log-artifact-capture/ Mon, 20 Jul 2026 00:00:00 +0900 https://gkzz.dev/posts/maestro-test-output-log-artifact-capture/ <h2 id="はじめに">はじめに</h2> <p>Maestro の <code>maestro test</code> コマンドでは、<code>--test-output-dir</code> と <code>--debug-output</code> などのオプションで、スクリーンショットやログなどの artifact が出力されます。両者はどちらも「artifact の保存先を指定するオプション」に見えるのですが、実際には扱うファイルがやや異なります。</p> <p>この違いを意識しないと、落ちたテストの調査で「あるはずの artifact が見つからない」ということが起こりえます。 たとえば、スクリーンショットを探していたら <code>maestro.log</code> しか入っていなかったり、逆にログだけ別ディレクトリに出ていたり。</p> <p>そこで、この記事では <code>maestro test</code> の artifact 周りを整理します。また、ドキュメントとサンプルコードを頼りに、これらのオプションの違いや使用例を探ってみます。</p> <p>この記事で最初に押さえたいのは、次の4点です。</p> <ul> <li><code>--test-output-dir</code> はスクリーンショットや動画の主な置き場</li> <li><code>--debug-output</code> は <code>maestro.log</code> の主な置き場</li> <li><code>commands-*.json</code> は artifact 調査で見ることになる主要なファイル</li> <li><code>--flatten-debug-output</code> は <code>--debug-output</code> の artifact 群のディレクトリ階層をフラットにする</li> </ul> <p>レポート系のフォーマットは下記の2つです。</p> <ul> <li><code>--format</code> : レポートのフォーマット。 <ul> <li>例：<code>--format junit</code> , <code>--format html</code> , <code>--format html-detailed</code></li> </ul> </li> <li><code>--output</code> : 上記のレポートの出力場所。省略した場合はカレントディレクトリに出力。 <ul> <li>例：<code>--output build/report.xml</code></li> </ul> </li> </ul> <p>なお、AI 系のレポートは生成条件が別なのでこの記事では深追いしません。</p> <p>参考：<a href="https://docs.maestro.dev/maestro-flows/workspace-management/ai-test-analysis">https://docs.maestro.dev/maestro-flows/workspace-management/ai-test-analysis</a></p> <h2 id="1---test-output-dir----debug-output----flatten-debug-output-オプションの早見表">1. <code>--test-output-dir</code> / <code>--debug-output</code> / <code>--flatten-debug-output</code> オプションの早見表</h2> <p><code>--test-output-dir</code> / <code>--debug-output</code> / <code>--flatten-debug-output</code> オプションの早見表をご覧ください。ここでは「flag の役割」と「実際に目に入る artifact」を分けて書きます。実際の挙動を見ると、<a href="https://github.com/mobile-dev-inc/maestro-docs/blob/3c44ca2c6d6b11056e2164ac177ee9674139fde2/flows/workspace-management/test-reports-and-artifacts.md?plain=1#L111-L125">ドキュメント</a> のように、<code>Yes / No</code> の二値だけで読むと誤解しやすいので、まずは役割ベースで整理するほうがよいかと思います。</p>