uloop-launch

uloop launch

プロジェクトに適したバージョンの Unity Editor を起動します。

uloop launch は実行後すぐに終了するコマンドではありません。Unity の起動または再起動が必要な場合、CLI 操作が実際にできる状態になるまで待ってから終了します。

使用方法

uloop launch [project-path] [options]

パラメーター

パラメーター	型	説明
project-path	string	任意。対象の Unity プロジェクトが現在のディレクトリにない場合にのみ指定します。
-r, --restart	flag	起動中の Unity を終了して再起動します
-q, --quit	flag	プロジェクトの既存の Unity プロセスを起動せずに終了します
--editor-version <version>	string	ProjectVersion.txt の代わりに、この Unity Editor バージョンを使用します
-p, --platform <P>	string	ビルドターゲット（例：StandaloneOSX、Android、iOS）
--max-depth <N>	number	project-path を省略した場合の検索深度（デフォルト：3、無制限にする場合は -1）

出力

最終的な JSON ペイロードの前に、プロジェクトパス、検出された Unity のバージョン、準備完了までの待機メッセージなどのステータスや進行状況が出力されることがあります。

最終的な JSON ペイロードには、次の項目が含まれます。

• Success：コマンドが完了したかどうか
• Ready：Unity CLI Loop がコマンドを受け付ける準備ができているかどうか
• ServerReady：Unity CLI Loop サーバーがリクエストを受け付けたかどうか
• ProjectIpcReady：プロジェクトの IPC パスがツールリクエストを受け付けたかどうか
• AlreadyRunning：既存の Unity プロセスを再利用したかどうか
• Launched：このコマンドが Unity プロセスを起動したかどうか
• Restarted：このコマンドが既存のプロセスを終了し、新しいプロセスを起動したかどうか
• Quit：このコマンドが新しいプロセスを起動せずに Unity を終了したかどうか
• PreviousProcessId：再起動または終了によって停止したプロセス ID（取得できる場合）
• CurrentProcessId：現在の Unity プロセス ID（取得できる場合）
• ProjectRoot：解決されたプロジェクトルート
• Message：準備状況の概要

使用しない場合

コマンドが一度失敗、キャンセル、またはビジー状態になった場合（例：ドメインリロードの直後）でも、起動する理由にはなりません。代わりにコマンドを再試行してください。Editor の起動中に launch を実行すると Unity ウィンドウが前面に表示され、ユーザーの作業を妨げます。Unity が起動していない場合、または再試行しても応答しない場合にのみ launch を使用してください。

注意事項

• Unity がすでに起動している場合は、既存のウィンドウを前面に表示し、ツールが使用可能な状態か確認します
• プロセスのスキャンがブロックされる場合（サンドボックス化された ps など）、通常の launch は IPC のプローブにフォールバックします。--restart と --quit はプロセス ID が必要なため、引き続き失敗します
• dispatcher 3.0.1-beta.8 以降から起動された新しい Unity プロセスは、デフォルトで Editor の起動時にプロジェクトのコンパイラーエラーを無視します。古い dispatcher がインストールされている場合は、先に uloop update を実行してください
• --editor-version は新しい Unity プロセスにのみ適用されます。すでに起動している Editor を置き換えるには、--restart と併用してください
• このコマンドは、Unity の起動が完了し、CLI が接続できるようになるまで待ってから戻ります