Unity CLIを自動更新した直後に、コマンド名の互換性問題が起きた話
個人開発中のスマホゲーム「MineEmpire3D」（Unity製）で、Unity CLIをユーザー承認のもと最新版へ更新した直後に、既存パイプラインとのコマンド名の互換性問題が発覚した記録です。2026年11月2日の実際の開発記録（devlog）に基づいており、架空の体験や感想は含んでいません。
ユーザー承認に従ってUnity CLIのみを最新版へ更新する
Unity CLIを最新版へ更新する作業で、まず以下のエラーが発生しました。
helper_unknown_error: setup refresh had errors
通常のPowerShellでの初期化は失敗したため、承認付きの実行でCLIの更新通知と更新の有無を確認し、そのうえでユーザーに更新してよいかを確認しました。
承認を得たうえでself-updateを実行し、バージョン確認コマンドでbeta.15になったことを確認しました。既存のEditorのstatus・eval応答はいずれも成功し、Unity Editor自体の再起動は行っていません。所要時間は約4分でした。
更新後に発覚した、コマンド名の互換性問題
Unity CLIの更新後、既存のパイプラインとのコマンド名の互換性を調査したところ、以下のエラーが発生しました。
ExecuteCommandByName: No command named 'script recompile_status' is available.
承認済みのbeta.15への更新後、高位のrecompileコマンドで未登録のものが44件増えていることが分かりました。該当するエラーの原文はすべて保管し、旧名であるrecompile_statusを直接呼び出して動作を確認しました。
その結果、旧名での呼び出しはstatusがcompleted、errorsは空の配列で成功し、通常のロードも成功しました。これを踏まえて、高位recompileの呼び出しを繰り返さない方針を引き継ぎ用の記録として残しました。なお、Packageそのものは未更新で、コマンド名の互換性問題自体は未修正のままです。所要時間は約3分でした。
まとめ：発生したエラーと対応
| 作業 | 起きたこと | 対応 | 結果 | 所要時間 |
|---|---|---|---|---|
| Unity CLIの更新 | helper_unknown_error: setup refresh had errors |
承認付き実行で更新有無を確認し、ユーザー承認後にself-update | beta.15に更新、既存Editorのstatus・eval成功 |
約4分 |
| 互換性調査 | ExecuteCommandByName: No command named 'script recompile_status' is available.（未登録44件） |
旧名recompile_statusを直接呼び出して確認 |
status=completed、errors=[]、通常ロードも成功 | 約3分 |
Unity CLIの更新自体は承認フローに従って問題なく完了しましたが、更新後に既存パイプラインの一部コマンド名が変わっていたことが分かりました。今回は旧名を直接呼び出すことで作業を継続できましたが、Packageの更新や高位recompileコマンドの互換性問題自体はこの時点では解決していません。
この記事は運営者の実際の開発記録をもとに、AIの支援を受けて作成しています。
