xcrun simctl logverboseは、シミュレータデバイスの詳細ログ出力(verbose logging)を有効・無効にするサブコマンドである。

基本的な使い方

logverbose [<device>] (enable | disable)の形式で実行する。

$ xcrun simctl logverbose "TIL Logverbose iPhone" enable
Successfully enabled verbose logging

$ xcrun simctl logverbose "TIL Logverbose iPhone" disable
Successfully disabled verbose logging

他の多くのサブコマンドと異なり、成功時にも結果を示すメッセージが標準出力に表示される。

<device>を省略すると起動中の全デバイスが対象になる

ヘルプにも記載されているとおり、<device>は省略可能である。 省略した場合、起動中のデバイスすべてに対して一括で適用される。

$ xcrun simctl logverbose enable
Successfully enabled verbose logging

enabledisable以外を指定するとヘルプが再表示される

enabledisableのどちらでもない値を指定したり、指定を省略したりすると、コマンドの説明とヘルプ全文が再表示され、終了コードは117になる。

$ xcrun simctl logverbose "TIL Logverbose iPhone" foo
enable or disable verbose logging for a device
Usage: simctl logverbose [<device>] (enable | disable)
	<device>         The device. If not provided all booted devices are affected.
	enable           Enables verbose logging
	disable          Disables verbose logging

NOTE: You may need to reboot the affected device before logging changes will be effective.

対象デバイスは起動中(Booted)である必要がある

シャットダウン状態のデバイスを指定すると、他の多くのサブコマンドとは少し異なる文言のエラーになる。

$ xcrun simctl shutdown "TIL Logverbose iPhone"
$ xcrun simctl logverbose "TIL Logverbose iPhone" enable
Device iOS 26.1 (23B86) - iPhone 17 is not booted!
An error was encountered processing the command (domain=com.apple.CoreSimulator.SimError, code=405):
Invalid device state