Flutterアプリを Androidエミュレーターおよび実機でデバッグする-スケ郎のお話

はじめに

Flutterアプリを Androidエミュレーターと実績でデバッグ実行する手順を紹介します。

Android Studioのインストール

以下のサイトからAndroid Studioをダウンロードします。

Android Studio

Android Studioをダウンロード

ダウンロードしたファイルをアプリケーションにインストール（ドラッグ）します。

Android Studioをアプリケーションにインストール

画面の指示に従って、インストールします。

インストーラーの画面に従ってAndroid studioをインストール

インストールできたタイミングで、flutter doctorで確認してみましょう。
次の結果のように、cmdline-toolsが見つからないエラーと、Androidライセンスの承諾が未完了である2件のエラーが出ているはずです。

% flutter doctor

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.19.6, on macOS 14.3 23D2057 darwin-arm64, locale ja-JP)
[!] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
    ✗ cmdline-tools component is missing
      Run `path/to/sdkmanager --install "cmdline-tools;latest"`
      See https://developer.android.com/studio/command-line for more details.
    ✗ Android license status unknown.
      Run `flutter doctor --android-licenses` to accept the SDK licenses.
      See https://flutter.dev/docs/get-started/install/macos#android-setup for more details.
[!] Xcode - develop for iOS and macOS (Xcode 15.3)
    ✗ Unable to get list of installed Simulator runtimes.
[✓] Chrome - develop for the web
[✓] Android Studio (version 2023.3)
[✓] VS Code (version 1.88.1)
[✓] Connected device (2 available)
[✓] Network resources

それでは、この2件のエラーを解消してきましょう。

Android SDK コマンドラインツールのインストール

Android SDK コマンドラインツールをインストールします。

Android Studioを起動しSettings（設定）画面を表示します。
次のイメージのとおり「Android SDK Command-line Tools」のインストールにチェックを入れて「OK」ボタンをクリックします。

Android SDK コマンドラインツールをインストール

インストールが終わったら「Finish」をクリックして画面を閉じます。

Android SDK ライセンスの承認

FlutterでAndroidアプリを実行するためには、Android SDKのライセンス承認が必要です。
次の手順でライセンスに同意する必要があります。

ターミナルを開き、以下のコマンドを実行。

flutter doctor --android-licenses

プロンプトが表示されたら、すべてのライセンス条項に同意します。

もう一度、flutter doctorを確認してみましょう。
今度は、Android toolchainの項目がチェックOKになっているはずです。

flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.19.6, on macOS 14.3 23D2057 darwin-arm64, locale ja-JP)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[!] Xcode - develop for iOS and macOS (Xcode 15.3)
    ✗ Unable to get list of installed Simulator runtimes.
[✓] Chrome - develop for the web
[✓] Android Studio (version 2023.3)
[✓] VS Code (version 1.89.1)