Flutter インストール

Flutter アプリの構築を学ぶ前に、まずローカルマシンに Flutter SDK と必要な依存関係をすべてインストールする必要があります。このセクションでは、Windows、macOS、Linux システムでのインストール手順を詳しく説明します。


システム要件

Flutter をインストールする前に、開発環境が次の基本要件を満たしていることを確認してください:

要件項目WindowsmacOSLinux
オペレーティングシステムWindows 10 以降macOS 10.14 以降Ubuntu 18.04 以降
ディスク容量最低 2.8 GB最低 2.8 GB最低 2.8 GB
ツールGit for WindowsGit (Xcode 経由)Git、curl、unzip

Windows インストール手順

ステップ1: Git for Windows のインストール

Git はバージョン管理ツールであり、Flutter はコードの管理と SDK のダウンロードに Git を使用する必要があります。

  1. アクセスGit for Windows ダウンロードページ
  2. 最新版の Git for Windows をダウンロードします
  3. インストーラーを実行し、デフォルト設定のままインストールを完了します

ステップ2: Visual Studio Code のインストール(推奨)

Visual Studio Code(略称 VS Code)は、Flutter 開発エディターとして推奨されており、豊富な Flutter 拡張機能をサポートしています。

  1. アクセスVS Code 公式サイト
  2. VS Code をダウンロードしてインストールします
  3. インストール完了後、VS Code を開きます

ステップ3: Flutter SDK のインストール

Flutter SDK をインストールする方法は2つあります:

方法1: VS Code を使用してインストール(推奨)

VS Code の Flutter 拡張機能は、Flutter SDK を自動的にダウンロードして設定できます。

  1. VS Code で左側の拡張機能アイコンをクリックします(または Ctrl+Shift+X を押します)
  2. "Flutter" を検索し、"Dart and Flutter extensions" 拡張機能を見つけます
  3. "Install" をクリックして拡張機能をインストールします
  4. インストール完了後、Ctrl+Shift+P を押してコマンドパレットを開きます
  5. "Flutter: New Project" と入力して選択します
  6. "Download SDK" を選択し、インストールディレクトリを選択します

方法2: 手動でダウンロードしてインストール

  1. アクセスFlutter 公式サイトのダウンロードページ
  2. 最新の Flutter SDK(.zip ファイル)をダウンロードします
  3. ダウンロードしたファイルを任意のディレクトリ(例: C:\flutter)に解凍します
  4. Flutter の bin ディレクトリをシステム環境変数 PATH に追加します

環境変数の手動設定

Windows で環境変数を設定する手順:

  1. "PC" を右クリックし、"プロパティ" を選択します
  2. "システムの詳細設定" をクリックします
  3. "環境変数" をクリックします
  4. "システム環境変数" で Path を見つけ、"編集" をクリックします
  5. "新規" をクリックし、Flutter の bin ディレクトリのパス(例: C:\flutter\bin)を追加します
  6. "OK" をクリックして保存します

macOS インストール手順

ステップ1: Git のインストール

macOS には通常 Git がプリインストールされています。次のコマンドで確認できます:

$ git --version

インストールされていない場合は、次のコマンドを実行します:

$ xcode-select --install

ダイアログが表示されたら、"インストール" ボタンをクリックします。

ステップ2: VS Code のインストール

からVS Code 公式サイトVS Code をダウンロードしてインストールします。

ステップ3: Flutter SDK のインストール

Windows と同様に、VS Code からインストールするか、手動でインストールするかを選択できます。

手動インストールの手順:

  1. Flutter SDK をダウンロード:
$ git clone https://github.com/flutter/flutter.git -b stable
  1. Flutter を PATH に追加:
$ echo 'export PATH="$PATH:/Users/你的用户名/flutter/bin"' >> ~/.zshrc
$ source ~/.zshrc

Linux インストール手順

ステップ1: 必要なツールのインストール

Ubuntu/Debian システムでは、次のコマンドを実行して必要なツールをインストールします:

$ sudo apt-get update
$ sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa

ステップ2: Flutter SDK のクローン

$ git clone https://github.com/flutter/flutter.git -b stable

ステップ3: PATH の設定

$ echo 'export PATH="$PATH:$HOME/flutter/bin"' >> ~/.bashrc
$ source ~/.bashrc

インストールの検証

どのオペレーティングシステムで Flutter をインストールした場合でも、次のコマンドでインストールが成功したかどうかを検証できます:

$ flutter doctor

このコマンドを実行すると、Flutter が開発環境をチェックして問題を報告します。インストールが成功すると、次のような出力が表示されます:

Doctor summary (v3.x.x):
[✓] Flutter (Channel stable, 3.x.x)
[✓] Android toolchain
[✓] iOS toolchain
[✓] Chrome (for web development)
[✓] Windows toolchain
[✓] macOS toolchain
[✓] Linux toolchain
[✓] Web server

flutter doctor を初めて実行すると、Dart SDK がダウンロードされ、初期化操作がいくつか実行されます。これには数分かかる場合があります。


よくある問題の解決

Flutter コマンドが見つからない

ターミナルで flutter コマンドを入力したときに見つからないと表示された場合は、以下を確認してください:

  • 環境変数 PATH が正しく設定されているか
  • 新しいターミナルウィンドウを開いたかどうか(環境変数の変更は新しいウィンドウで有効になります)

Android Studio 未インストール警告

flutter doctor を実行すると、Android Studio がインストールされていないという警告が表示される場合があります。Android アプリを開発しない場合は、この警告は無視できます。

Android SDK の問題

Android アプリを開発する必要があるが SDK の問題が発生した場合は、次のことができます:

  1. ダウンロードしてインストールするAndroid Studio
  2. Android Studio の SDK Manager から Android SDK をインストールする
その他の拡張機能