My Tech Blog

【Flutter】Android license status unknown が直らない時の対処法！

公開日: 2026年08月25日

Flutterで開発環境を構築・確認する際、flutter doctor を実行したところ 「Android license status unknown」 というエラーが表示され、指示通りに flutter doctor --android-licenses を実行しても解消しないトラブルに遭遇しました。

今回は、この問題の原因と、Android SDK Command-line Tools をダウングレードすることで簡単に解決した手順 をまとめました。

発生した事象・エラー内容

Flutter環境を確認するため flutter doctor を実行したところ、以下の警告が発生しました。

> flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel stable, 3.47.0, on Microsoft Windows [Version 10.0.xxxxx.xxxx], locale ja-JP)
[√] Windows Version (Windows 11 or higher, 25H2, 2009)
[!] Android toolchain - develop for Android devices (Android SDK version 36.0.0)
    X Android license status unknown.
      Run `flutter doctor --android-licenses` to accept the SDK licenses.
      See https://flutter.dev/to/windows-android-setup for more details.
[√] Chrome - develop for the web
[√] Visual Studio - develop Windows apps (Visual Studio Community 2026 18.9.1)
[√] Connected device (3 available)
[√] Network resources

! Doctor found issues in 1 category.

指示に従い、ライセンス承諾コマンド flutter doctor --android-licenses を実行したところ、以下のような警告が出てしまい、従来の「y/N」によるライセンス同意プロンプトが表示されませんでした。

> flutter doctor --android-licenses
WARNING: The SDK Manager CLI tool (sdkmanager) is deprecated. Android CLI will be used instead.
The 'android' binary can also be found in the cmdline-tools directory, and 'android sdk' is the replacement for 'sdkmanager'.
To learn more about the Android CLI and how to use it, see the documentation (https://d.android.com/tools/agents/android-cli)

Warning: The --licenses option is no longer needed.

警告メッセージには Warning: The --licenses option is no longer needed. と表示されるものの、再度 flutter doctor を実行しても Android license status unknown のままで、チェックマーク（[✓]）になりませんでした。

原因

原因は、最新の Android SDK Command-line Tools（v23.0 など） において Android CLI の仕様刷新が行われ、従来の sdkmanager --licenses コマンドが非推奨・仕様変更されたことにあります。

Flutter側が内部で呼び出しているライセンス検証処理が最新ツールの挙動と噛み合っていないため、ライセンスの判定が unknown のままになってしまっていました。

解決手順：Command-line Tools をダウングレードする

この問題は、最新バージョン（v23.0）を削除し、1つ前の安定バージョン（v22.0）をインストールすることで簡単に解消できます。

手順 1: Android Studio の SDK Manager を開く

  1. Android Studio を起動します。
  2. 上部メニューまたはウェルカム画面から Settings（Windows: File > Settings / macOS: Settings）を開きます。
  3. Languages & Frameworks > Android SDK（または Appearance & Behavior > System Settings > Android SDK）を開きます。

手順 2: SDK Tools の詳細表示を有効にする

  1. SDK Tools タブを選択します。
  2. 画面右下にある 「Show Package Details」（パッケージ詳細の表示）にチェックを入れます。

手順 3: バージョンを切り替える

  1. リスト内の Android SDK Command-line Tools を展開します。
  2. 現在インストールされている最新版（例: 23.0）のチェックを外します。
  3. 1つ前の安定バージョン（例: 22.0）にチェックを入れます。
  4. 右下の Apply（適用）をクリックし、変更を確定します（古いバージョンのダウンロードと最新版の削除が行われます）。

動作確認

入れ替え完了後、再度ターミナルで flutter doctor を実行します。

> flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel stable, 3.47.0, on Microsoft Windows [Version 10.0.xxxxx.xxxx], locale ja-JP)
[√] Windows Version (Windows 11 or higher, 25H2, 2009)
[√] Android toolchain - develop for Android devices (Android SDK version 36.0.0)
[√] Chrome - develop for the web
[√] Visual Studio - develop Windows apps (Visual Studio Community 2026 18.9.1)
[√] Connected device (3 available)
[√] Network resources

• No issues found!

もしライセンス未承認のメッセージが残っている場合は、再度 flutter doctor --android-licenses を実行すると通常の規約同意画面が表示されるので、すべて y を入力して承認してください。

無事に [√] Android toolchain となり、すべてグリーンで問題が解消しました。

まとめ

  • flutter doctor --android-licenses で Warning: The --licenses option is no longer needed. が出て進まない場合は、SDK Command-line Tools の最新版による仕様変更 が原因。
  • Android Studio の SDK Manager から 「Show Package Details」 を有効にし、Command-line Tools を v23.0 から v22.0 などの安定バージョンへ切り替える ことで綺麗に解決可能。

同じ問題で詰まっている方の参考になれば幸いです。

#Flutter