Android StudioのDevice ManagerにAVDが1台もない状態で、ツールバーを非表示にしたまま「Add a new device…」を押すと、作成ウィザードが開かず、IDEログへIllegalArgumentException: component must be shown on the screenが記録されることがあります。これはAVD設定やAndroid SDKの破損ではなく、非表示のツールバーボタンを空状態リンクからクリックしようとするAndroid Studio側の既知不具合です。
表示されるエラー
Unhandled exception in EDT
com.intellij.openapi.diagnostic.UnhandledException:
component must be shown on the screen
(com.android.tools.adtui.actions.DropDownAction$1[...])
Caused by: java.lang.IllegalArgumentException:
component must be shown on the screen
at com.intellij.openapi.actionSystem.impl.ActionPopupMenuImpl$MyMenu.show(...)
at com.intellij.openapi.ui.JBPopupMenu.showBelow(...)
at com.android.tools.adtui.actions.DropDownAction.showPopupMenu(...)
at com.android.tools.idea.devicemanagerv2.DeviceManagerPanel.emptyStatePanel$lambda$0$0(...)画面上ではリンクを押しても何も起きないように見えます。詳細はAndroid Studioの「Help」→「Show Log in Explorer/Finder」または「Collect Logs and Diagnostic Data」で確認できます。
原因
Device Managerの空状態にある「Add a new device…」リンクは、AVD作成処理を直接呼ばず、ツールバーの「＋」ドロップダウンボタンをプログラムからクリックしていました。ツールバーが非表示だとボタンは画面上に配置されていないため、ポップアップメニューを表示できず例外になります。
重要：このエラーは、エミュレーターイメージ、SDKパス、仮想化機能の不備を示すものではありません。例外にDropDownAction.showPopupMenuやDeviceManagerPanel.emptyStatePanelが含まれ、ツールバー非表示時だけ再現するかを確認してください。
発生条件と対象バージョン
- Device ManagerにAVDがなく、空状態パネルが表示されている
- Device Managerツールウィンドウの「Show Toolbar」がオフ
- 空状態の「Add a new device…」リンクをクリックする
- 公式報告ではAndroid Studio Quail 3（2026.1.3、Windows 11）で再現
Google Issue Trackerの問題 #541776384 はFixedです。Android Studio Rabbit 1（2026.2.1）Canary 4の公式修正一覧に同問題が掲載されています。Canary 3がターゲットとして記録されていますが、利用者が確認できる公式リリース一覧上の収録版はCanary 4です。安定版への個別バックポートは、公式情報で確認できるまで断定できません。
推奨する解決手順
- Device Manager右上のツールウィンドウオプション（「…」）を開きます。
- 「Show Toolbar」をオンにして、ツールバーを表示します。
- 表示された「＋」ボタンから「Create Virtual Device」を選びます。
- Device Definition、System Image、AVD設定を順に選択して作成します。
- 可能であればAndroid Studio Rabbit 1（2026.2.1）Canary 4以降へ更新し、同じ操作を再確認します。
安定版運用が必要な環境では、修正版の安定チャネル提供を待ちながら「Show Toolbar」を有効にする回避策を使うのが安全です。プレビュー版へ更新する場合は、既存プロジェクトと設定をバックアップし、チームのバージョン方針に従ってください。
代替策
コマンドラインでAVDを作成する
UI回避が難しい場合は、SDK Command-Line Toolsのavdmanagerを利用できます。先に必要なsystem imageをSDK Managerまたはsdkmanagerで導入してください。
sdkmanager "platform-tools" "emulator" "system-images;android-36;google_apis;x86_64"
echo no | avdmanager create avd --name Pixel_API_36 --package "system-images;android-36;google_apis;x86_64" --device "pixel"Apple Siliconでは、利用可能なsystem imageに合わせてABIを選択してください。上記のパッケージ名をそのまま使えるとは限りません。
修正を確認する方法
- 「Help」→「About」でAndroid Studioのバージョンを確認します。
- Device Managerのツールバーをいったん非表示にします。
- AVDがない状態で「Add a new device…」をクリックします。
- 修正版では作成画面が開き、
component must be shown on the screenがIDEログに追加されないことを確認します。 - 作成したAVDを起動し、一覧に正常表示されることも確認します。
注意点
- 「Invalidate Caches」やSDKの再インストールは根本原因に対応しません。
- 例外文が同じでも、スタックに
DeviceManagerPanel.emptyStatePanelがない場合は別のUI不具合の可能性があります。 - Canary版は検証用です。業務環境では安定版と並行インストールし、プロジェクトを不用意に移行しないでください。
- ツールバーを再表示しても作成画面が開かない場合は、IDEログを添えてIssue Trackerへ報告してください。
まとめ
IllegalArgumentException: component must be shown on the screenは、Device Managerの空状態リンクが非表示ツールバー上の「＋」ボタンを呼び出すことで発生します。まず「Show Toolbar」をオンにし、表示された「＋」からAVDを作成してください。恒久対応として、公式修正一覧に問題 #541776384が含まれるAndroid Studio Rabbit 1（2026.2.1）Canary 4以降を検討します。
公式情報
