Flutter インストール
Flutter アプリの構築を学ぶ前に、まずローカルマシンに Flutter SDK と必要な依存関係をすべてインストールする必要があります。このセクションでは、Windows、macOS、Linux システムでのインストール手順を詳しく説明します。
システム要件
Flutter をインストールする前に、開発環境が次の基本要件を満たしていることを確認してください:
| 要件項目 | Windows | macOS | Linux |
|---|---|---|---|
| オペレーティングシステム | Windows 10 以降 | macOS 10.14 以降 | Ubuntu 18.04 以降 |
| ディスク容量 | 最低 2.8 GB | 最低 2.8 GB | 最低 2.8 GB |
| ツール | Git for Windows | Git (Xcode 経由) | Git、curl、unzip |
Windows インストール手順
ステップ1: Git for Windows のインストール
Git はバージョン管理ツールであり、Flutter はコードの管理と SDK のダウンロードに Git を使用する必要があります。
- アクセスGit for Windows ダウンロードページ
- 最新版の Git for Windows をダウンロードします
- インストーラーを実行し、デフォルト設定のままインストールを完了します
ステップ2: Visual Studio Code のインストール(推奨)
Visual Studio Code(略称 VS Code)は、Flutter 開発エディターとして推奨されており、豊富な Flutter 拡張機能をサポートしています。
- アクセスVS Code 公式サイト
- VS Code をダウンロードしてインストールします
- インストール完了後、VS Code を開きます
ステップ3: Flutter SDK のインストール
Flutter SDK をインストールする方法は2つあります:
方法1: VS Code を使用してインストール(推奨)
VS Code の Flutter 拡張機能は、Flutter SDK を自動的にダウンロードして設定できます。
- VS Code で左側の拡張機能アイコンをクリックします(または Ctrl+Shift+X を押します)
- "Flutter" を検索し、"Dart and Flutter extensions" 拡張機能を見つけます
- "Install" をクリックして拡張機能をインストールします
- インストール完了後、Ctrl+Shift+P を押してコマンドパレットを開きます
- "Flutter: New Project" と入力して選択します
- "Download SDK" を選択し、インストールディレクトリを選択します
方法2: 手動でダウンロードしてインストール
- アクセスFlutter 公式サイトのダウンロードページ
- 最新の Flutter SDK(.zip ファイル)をダウンロードします
- ダウンロードしたファイルを任意のディレクトリ(例: C:\flutter)に解凍します
- Flutter の bin ディレクトリをシステム環境変数 PATH に追加します
環境変数の手動設定
Windows で環境変数を設定する手順:
- "PC" を右クリックし、"プロパティ" を選択します
- "システムの詳細設定" をクリックします
- "環境変数" をクリックします
- "システム環境変数" で Path を見つけ、"編集" をクリックします
- "新規" をクリックし、Flutter の bin ディレクトリのパス(例: C:\flutter\bin)を追加します
- "OK" をクリックして保存します
macOS インストール手順
ステップ1: Git のインストール
macOS には通常 Git がプリインストールされています。次のコマンドで確認できます:
$ git --version
インストールされていない場合は、次のコマンドを実行します:
$ xcode-select --install
ダイアログが表示されたら、"インストール" ボタンをクリックします。
ステップ2: VS Code のインストール
からVS Code 公式サイトVS Code をダウンロードしてインストールします。
ステップ3: Flutter SDK のインストール
Windows と同様に、VS Code からインストールするか、手動でインストールするかを選択できます。
手動インストールの手順:
- Flutter SDK をダウンロード:
$ git clone https://github.com/flutter/flutter.git -b stable
- 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 の問題が発生した場合は、次のことができます:
- ダウンロードしてインストールするAndroid Studio
- Android Studio の SDK Manager から Android SDK をインストールする