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 .baseprofile
を入力します。)ファイルの末尾に以下のコードを追加します。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 をダウンロードしてインストールし、1 回開いてください。
-
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 リポジトリは海外にあるため、阿里云のミラーアドレスを使用する必要があります。
修正方法:
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' }
以下のようになります: