Flutter 環境のインストール && 実行#
背景#
Flutter 環境の設定から実行までの問題メモ。例えば、Android sdkmanager tool not foundやRunning Gradle task 'assembleDebug'...に遭遇した場合。
Flutter のインストール#
超簡略版#
homebrewを使って直接インストールします。外部ネットワークが必要な場合があります。
brew install flutter
手動で Flutter 環境を構築#
-
まず、Flutter のインストールパッケージをダウンロードします。ダウンロードリンク：https://flutter.dev/docs/development/tools/sdk/releases?tab=macos
-
次に、ダウンロードしたファイルを解凍し、指定のディレクトリに配置します。注意：ユーザーのホームディレクトリに配置することをお勧めします。後で bin ファイルのパスを指定する必要があるため、このディレクトリは頻繁に変更されない方が良いです。
-
その後、環境変数を設定します。
ターミナルを開き、zsh の場合はopen .zshrcと入力します；（bash の場合はopen .bashprofileと入力します）ファイルの末尾に以下のコードを追加します。ここでpwdは先ほど解凍した flutter/bin のパスです。export PATH="$PATH:`pwd`/flutter/bin"また、国内の事情により、以下の 2 つの環境変数を追加することもできます。
export PUB_HOSTED_URL=https://pub.flutter-io.cn export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn以下の図のようになります：
.zshrc（または.bashprofile）ファイルの編集が完了したら、保存して閉じ、次のコマンドを実行します。source .zshrc // 編集したのが.bashprofileの場合は、source .bashprofileと入力しますその後、
flutter doctorを実行して、Flutter が正しくインストールされているかを確認します。
エディタのインストール#
-
Android Studio
Android Studio をダウンロードしてインストールした後、さらに 3 つの場所でインストールが必要です。- SDK Manager で SDK Platforms をインストールし、実際に必要な Android バージョンを追加します。
- AVD Manager で Android エミュレータを追加します。
- Plugins で Flutter と Dart のプラグインを追加します。
以下の図のようになります：
-
Xcode は直接ダウンロードしてインストールし、一度開くだけで大丈夫です。
-
VSCode では、VSCode のプラグイン画面を開き、Flutter を検索してインストールします。
環境の確認#
flutter doctorを入力し、表示された指示に従って環境が正しくインストールされているかを確認します。問題が発生する可能性があるため、以下の問題記録を参考にしてください。
flutter doctor --android-licensesを入力すると、y/N の選択を求められますので、すべて y を選択してください。
プロジェクトの作成#
VSCode を使用して Flutter プロジェクトを作成します。VSCode を開き（Flutter プラグインをインストールしていることを確認してください）、CMD+Shift+Pを同時に押してショートカットコマンドを呼び出し、Flutter と入力して、Flutter: New Application Project を選択します。以下の図のようになります。
その後、プロジェクトの保存場所とプロジェクト名を選択します。
エミュレータの実行#
サポートされているエミュレータを列挙します。
flutter emulator
結果は以下の通りです：
指定されたエミュレータを開きます。
flutter emulators --launch xxx
エミュレータを実行します。
flutter run
その後、実行するエミュレータを選択します。以下のようになります：
問題記録#
-
flutter doctorを実行すると、エラー：Android sdkmanager tool not foundが表示されます。修正：Android Studio を開き、Config->SDK Manager をクリックし、SDK Tools を選択して、下部の
Hide Obsolete Packagesのチェックを外します。すると、Android SDK Tools(Obsolete)が表示されるので、チェックを入れて Apply をクリックし、ダウンロードが完了するのを待ちます。
-
flutter doctor --android-licensesを実行すると、エラー：Failed to install android-sdk: “java.lang.NoClassDefFoundError:が表示されます。修正：Android Studio を開き、Config->SDK Manager をクリックし、SDK Tools を選択して、下部の
Hide Obsolete Packagesのチェックを外します。すると、Android SDK Command-line Tools(latest)が表示されるので、チェックを入れて Apply をクリックし、ダウンロードが完了するのを待ちます。
-
エミュレータの起動が
Running Gradle task 'assembleDebug'...で止まる。背景：Flutter 環境を設定した後、Android エミュレータを選択して起動すると、常に
Running Gradle task 'assembleDebug'...で止まります。原因：Gradle の Maven リポジトリが海外にあるため、Aliyun のミラーアドレスを使用する必要があります。
修正：
andriod/build.gradleファイルの repositories を以下のように変更します。
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/jcenter' }
maven { url 'http://maven.aliyun.com/nexus/content/groups/public' }
以下のようになります：
