【Flutter】Macで環境構築(VS Code対応)

※本サイトで紹介している商品・サービス等の外部リンクには、プロモーションが含まれています。

【動作環境】

<パソコン>
機種:MacBook Air(13inch)
OS:macOS Sonoma(ver.14.5)
チップ:Apple M3
シェル:zsh

<ソフトウェア>
・Flutter(ver.3.22.3)
・Xcode(ver.15.4)
・CocoaPods(ver.1.15.2)
・Android Studio(ver.2024.1)
・Visual Studio Code(ver.1.92.0)

今回は、MacでFlutterを用いたアプリ開発を行うための環境構築について解説します。

目次

必要なPCは?

最低限必要なスペックとおすすめのパソコン

Flutterの公式ドキュメントに書いてあるスペックは以下の通りです。

スクロールできます
必要スペック最低限おすすめ
CPUコア48
メモリ(GB)816
ディスプレイ解像度
(ピクセル)
1366×768
(1366×768)
フルHD
(1920×1080)
空きディスク容量(GB)44.070.0
ハードウェア要件

おすすめは、「MacBook Air M3 メモリ16GB、ストレージ512GB」です。

Apple Storeで見てみると、値段は、224,800円(税込)でした(2024年11月23日現在)。

Apple silicon搭載のMacで必要な設定

【Apple silicon搭載のMacかどうかを確認する方法】

Macをお持ちの方は、画面上部のメニューバーにある[Apple メニュー]をクリックして、[このMacについて]をクリックしましょう。

表示される画面の[チップ]項目を確認することで、Apple silicon搭載のMacかどうかがわかります。

「Apple M○」と書いてあれば、Apple silicon搭載のMacになります。

Apple silicon搭載のMacを使用している場合は、Rosetta 2をインストールする必要があります。

STEP
[Launchpad]を起動する

1: DockにあるLaunchpadを開きます。

STEP
[その他]をクリックする

2: [その他]をクリックします。

STEP
[ターミナル]を起動する

3: ターミナルを開きます。

STEP
コマンドを入力する

4: ターミナルに以下のコマンドを入力し、[enter]キーを押します。

sudo softwareupdate --install-rosetta --agree-to-license

Flutter SDK をインストールする

Flutter SDKをインストールする

STEP
公式サイトを開く

1: 以下のリンクよりFlutterの公式サイトを開きます。

https://docs.flutter.dev/get-started/install/macos/mobile-ios#install-the-flutter-sdk

STEP
zipファイルをダウンロードする

2: [flutter_macos_arm64_3.22.3-stable.zip]をクリックしmす。

※Apple silicon搭載のMacを使用していない場合は、左側のボタンからzipファイルをダウンロードします。

STEP
ホームディレクトリに「development」ディレクトリを作成する

3: ターミナルを起動して、以下のコマンドを入力し、[enter]キーを押します。

mkdir development
STEP
作成した[development]ディレクトリに移動する

4: 以下のコマンドを入力し、[enter]キーを押します。

cd development
STEP
ダウンロードしたzipファイルを解凍する

5: 以下のコマンドを入力し、[enter]キーを押します。

unzip ~/Downloads/[ダウンロードしたzipファイルの名前]

[ダウンロードしたファイル名]には、ダウンロードしたzipファイルの名前を入力します。

今回僕がダウンロードしたzipファイルの名前は、「flutter_macos_arm64_3.22.3-stable.zip」

でしたので、以下のようになります。

unzip ~/Downloads/flutter_macos_arm64_3.22.3-stable.zip

「PATH(パス)を通す」とは?

今の状態でFlutterのプログラムを実行するには、/(ルートディレクトリ)の中のUsersの中のshima(ホームディレクトリ)の中のdevelopmentの中のflutterの中のbinにあるflutter(実行ファイル)を呼び出す必要があります。

毎回、以下のコマンドを入力するのは非常に大変です。

development/flutter/bin/flutter

そこで、

flutter

と入力すれば、プログラムが実行できるようにしていきます。

この作業を、「PATH(パス)を通す」「PATH(パス)に追加する」といいます。

パスを通すことで、ターミナルにいちいちディレクトリ構造を全て入力しなくてもflutterコマンドが使えるようになります。

Flutterの入っているディレクトリをPATH(パス)に追加する

STEP
.zshenvファイルを開く

1: ターミナルに、以下のコマンドを入力し、[enter]キーを押します。

vim .zshenv
STEP
編集モードに変更する

2: [I](アイ)キーを押して、編集モードに変更します。

STEP
パスを書き込む

3: 以下のように入力します。

export PATH=$HOME/development/flutter/bin:$PATH
STEP
.zshenvファイルを保存して終了する

4: [esc]キーを押して、「:wq」と入力し、[enter]キーを押します。

STEP
ターミナルを閉じて、再度起動する

5: 以下のコマンドを入力し、[enter]キーを押します。

source ~/.zshenv

すると、書き換えたファイルが読み込まれます。

おまけ

STEP
パスが通っているか確認する

1: ターミナルに、以下のコマンドを入力し、[enter]キー押してみましょう。

flutter

はじめてであれば、ターミナルに以下の画面が表示されます。

説明画像5
STEP
コマンドラインデベロッパーツールをインストールする

2: 以下の画面のように表示されたら、[インストール]をクリックします。

説明画像6

iOSアプリの開発環境を整える

Xcodeをインストールする

STEP
[App Store]を起動する

1: AppStoreを開きます。

STEP
[Xcode]をダウンロードする

2: 検索ボックスで「Xcode」と入力し[enter]キーを押します。

3: [入手]をクリックします。

STEP
[ターミナル]を起動する

4: ターミナルを開きます。

STEP
コマンドラインツールの設定を行う

5: 以下のコマンドを入力し、[enter]キーを押します。

sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'

すると、パスワードの入力を求められますので、Macを起動する時のパスワードを入力します。

その後、ライセンスへの同意が求められます。

[enter]キーを押して、ライセンスを表示させたら、「agree」と入力してライセンスに同意していきましょう。

iOSシミュレーターを起動する

STEP
iOSシミュレーターをダウンロードする

1: ターミナルに、以下のコマンドを入力し、[enter]キーを押します。

xcodebuild -downloadPlatform iOS
STEP
iOSシミュレーターを起動する

2: 以下のコマンドを入力し、[enter]キーを押します。

open -a Simulator

すると、以下のようにシミュレーターが立ち上がります。

CocoaPodsをインストールする

STEP
CocoaPodsをインストールする

1: ターミナルに、以下のコマンドを入力し、[enter]キーを押します。

sudo gem install cocoapods

すると、パスワードの入力を求められますので、Macを起動する時のパスワードを入力します。

CocoaPodsをインストールしようするときに、以下のようなエラーメッセージが出る場合があります。

説明画像12

これは、Rubyのバージョンが足りていないときに表示されます。

以下の記事を参考にRubyのバージョンを上げ、再度CocoaPodsをインストールしましょう。

Cocoapodsを利用するためのディレクトリをPATH(パス)に追加する

STEP
.zshenvファイルを開く

1: ターミナルに、以下のコマンドを入力し、[enter]キーを押します。

vim .zshenv
STEP
編集モードに変更する

2: [I](アイ)キーを押して、編集モードに変更します。

STEP
パスを書き込む

3: 以下のように入力します。

export PATH=$HOME/.gem/bin:$PATH

先ほど書き込んだパスの下に、入力するようにしましょう。

説明画像13
STEP
.zshenvファイルを保存して終了する

4: [esc]キーを押して、「:wq」と入力し、[enter]キーを押します。

STEP
変更したファイルを再度読み込む

5: 以下のコマンドを入力し、[enter]キーを押します。

source ~/.zshenv

Androidアプリの開発環境を整える

Android Studioをインストールする

STEP
公式サイトを開く

1: 以下のリンクよりAndroid Studioの公式サイトを開きます。

https://developer.android.com/studio

STEP
[Android Studio]をダウンロードする

2: [Download Android Studio Koala]をクリックします。

3: 下にスクロールします。

4: [I have read and agree with the above terms and conditions]に を入れます。

5: [Mac with Apple chip]をクリックします。

※Apple silicon搭載のMacを使用していない場合は、左側のボタンからzipファイルをダウンロードします。

6: Finderを起動し、[ダウンロード]をクリックします。

7: ダウンロードしたdmgファイルをクリックします。

STEP
アプリケーションフォルダにコピーする

以下のような画面が表示されます。

8: Android Studioのアイコンをアプリケーションにドラッグ&ドロップします。

STEP
[Android Studio]を起動する

9: Finder 起動し、[アプリケーション]をクリックします。

10: [Android Studio.app] をクリックします。

STEP
初期設定を行う

以下のように、初期設定を進めていきます。

11: [Don’t send]をクリックします。

12: [Next]をクリックします。

13: [Standard]をクリックして選択します。

14: [Next]をクリックします。

15: [Next]をクリックします。

16: [android-sdk-arm-dbt-license]をクリックして選択します。

17: [Accept]をクリックして選択します。

18: [android-sdk-license]をクリックして選択します。

19: [Accept]をクリックして選択します。

20: [Finish]をクリックします。

21: [Finish]をクリックします。

Android toolchainの設定を行う

STEP

[SDK Manager]を起動する

1: [More Actions]をクリックします。

2: [SDK Manager]をクリックします。

STEP
[Android SDK Command-line Tools]にチェックをいれる

3: [Android SDK]をクリックします。

4: [SDK Tools]をクリックします。

5: [Android SDK Command-line Tools(latest)]にチェック をいれます。

6: [OK]をクリックします。

Android Emulatorを起動する

STEP
[Virtual Device Manager]を起動する

1: [More Actions]をクリックします。

2: [Virtual Device Manager]をクリックします。

STEP
[Emulator]を起動する

3: [起動]ボタンをクリックします。

4: 以下のようにAndroid Emulatorが起動します。

仮想デバイスを追加する(任意)

STEP
[Virtual Device Manager]を起動して、[追加]ボタンをクリックする

1: [More Actions]から[Virtual Device Manager]を起動して、[追加]ボタンをクリックします。

STEP
追加したい仮装デバイスを選択する

2: [Phone]をクリックします。

3: 具体的な端末をクリックします。

4: [Next]をクリックします。

Androidライセンスに同意する

1: ターミナルに、以下のコマンドを入力し、[enter]キーを押します。

flutter doctor --android-licenses

その後は、「y」と入力して[enter]キーを押し、ライセンスに同意していきます。

VS Code をエディターとして使用する

VS Codeをインストールする

MacにVS Codeをインストールする手順については、以下の記事をご確認ください。

Flutterプラグインをインストールする

STEP
[VS Code]を起動する

1: VS Codeを開きます。

STEP
Flutterの拡張機能をインストールする

2: アクティビティバーの[拡張機能]をクリックします。

3: 検索ボックスに「flutter」と入力します。

4: Flutter 拡張機能にある[インストール]をクリックします。

flutter doctor コマンドで確認する

ここまで行ってきた設定がうまくできているのかを、確認します。

STEP
「flutter doctor」コマンドを入力する

1: ターミナルを起動して、以下のコマンドを入力し、[enter]キーを押します。

flutter doctor
STEP
Doctor summaryを確認する

2: 以下と同じような画面が表示されたら、OKです。

]と[]が表示されている箇所は、まだ設定が完了していない部分です。

すべてが、[]になっていなければ、もう一度設定を行いましょう。


これにて、MacでFlutterを用いたアプリ開発を行うための環境構築についての解説を終わります。

次は、新規プロジェクトの作成方法について解説します。

shimaのおすすめ書籍

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

shimaのアバター shima ライター

IT企業に勤める会社員。
テクニカルライター/プログラマー。
ITやソフトウェアに関することをわかりやすくまとめ、多くの人にそれらを知ってもらおうと活動しています。
ご質問やご要望、お仕事依頼がございましたらお問合せフォームよりお願いいたします。

コメント

コメントする

CAPTCHA



reCaptcha の認証期間が終了しました。ページを再読み込みしてください。

目次