初心者でもわかるFlutter環境構築ガイド

モバイル開発•2025/1/24

はじめに

Flutterは1つのコードベースからモバイルアプリやWebアプリ、デスクトップアプリまで作成できることで注目を集めています。特にモバイル向けのアプリ開発では、AndroidとiOSの両プラットフォームに対応できるため、効率の良さが魅力的ではないでしょうか。ただし、初めてFlutterを使う方は、環境構築のステップで戸惑うことがあるかもしれません。この記事では、Windows、macOS、Linuxといった主要なOSでFlutter開発をスタートするために必要な手順を解説します。具体的なコマンド例を交えつつ、初心者が疑問に感じやすい部分も整理します。実務での活用シーンを意識しながら、どういった場面で使われるかをイメージできるように進めていきます。

Flutterの概要

FlutterはGoogleが中心となって開発しているUIフレームワークです。 Dartという言語を使い、AndroidとiOSの両方で動作するアプリが作れます。さらにWebやデスクトップへの展開も可能なので、多彩なプラットフォームにアプリを提供したい場合に便利ですね。

たとえば、企業の社内業務向けアプリをFlutterで開発すれば、Android端末を使っている社員とiPhoneを使っている社員の両方に同じ機能を届けられます。個人開発でも同様に、初期コストや手間を抑えながら、幅広いユーザーにアプリを配信できるのがメリットです。こうした幅の広さが注目され、実務でも導入する企業が増えています。

必要となる開発ツールと前提条件

Flutterの開発には、ソースコードを記述するエディタやIDEが必要です。代表的なものにAndroid StudioやVisual Studio Codeなどが挙げられます。また、iOSアプリを開発したい場合はmacOS上でXcodeも必要になります。

OS別で見ると、それぞれの環境に合わせた事前準備が若干異なります。ただし、基本的には以下のような流れで進めるイメージです。

Flutter SDKのダウンロードとインストール
パス設定などの基本的な環境変数の設定
Android Studioまたは必要なツールの導入
エミュレータや実機でテストするための設定

ビジネスシーンを意識すると、すでに社内に導入しているツールがある場合は、それらと整合性を取る必要もあるかもしれません。しかし、まずは実際のアプリが動くことを目指して、ベーシックな構成を作ると良いでしょう。

Windows環境でのセットアップ

Windowsユーザーにとって、最初の大きなハードルはAndroid向けの開発ツールです。しかし、一度設定してしまえば、Windows PC上でAndroidアプリをどんどん開発できるようになります。

Flutter SDKのインストール（Windows）

1つ目に、Flutterの公式サイトから最新のFlutter SDKをダウンロードします。 ZIPファイルを解凍したら、Cドライブ直下や任意のフォルダに配置してください。

解凍先のパス例：

C:\src\flutter

その後、パスを通す必要があります。「システムの詳細設定」から「環境変数」を開き、「ユーザー環境変数」もしくは「システム環境変数」にPATHを追加していきます。具体的には以下のように設定を行います。

;C:\src\flutter\bin

設定を反映させたら、コマンドプロンプトやPowerShellを新たに起動し、以下のコマンドを実行してください。正常にコマンドが実行できればインストールは完了です。


flutter --version

Android StudioやSDKの準備（Windows）

FlutterではAndroid向けビルドを行うために、Android SDKが必須です。 Android Studioをインストールすると、セットアップウィザードを通してSDKがインストールされます。インストール完了後、Android StudioのSDK Managerから必要なAPIレベルのSDKをダウンロードしておきましょう。

実務で運用する際は、開発対象のAndroidバージョンに合わせてSDKをダウンロードする必要があります。企業内の端末が古いOSバージョンを使っている場合は、そのバージョンに対応したSDKを揃えるなど、運用方針を決めておくとスムーズに進められます。

macOS環境でのセットアップ

macOSはAndroidとiOSの両方に対応した開発が行えるので、Macユーザーにとっては利便性が高いですね。特にiOSアプリをビルドする場合はXcodeが必須なので、App Storeから事前にダウンロードしてください。

Flutter SDKのインストール（macOS）

公式サイトからFlutter SDKをダウンロードして解凍します。解凍したフォルダを任意のディレクトリに置き、ターミナルで以下のようにパスを通します。たとえば、ホームディレクトリ配下の.zshrcや.bashrcに追記します。


export PATH="$PATH:/Users/ユーザー名/flutter/bin"

設定ファイルを保存したら、ターミナルを再起動して以下のコマンドが使用できるか確認します。


flutter --version

エラーが出ない場合はパス設定が反映されています。社内Macでの業務利用を想定するときは、複数台の開発者が同じ設定を利用できるようにドキュメント化しておくと良いでしょう。

XcodeやAndroid Studioの導入（macOS）

iOS向けビルドはXcodeが必須です。 Xcodeをインストールしたら、追加コンポーネントのインストールも行います。具体的には、初回起動時やアップデート時に案内が表示されるので、それに従ってセットアップを進めます。

Androidアプリの開発も並行するならAndroid Studioもインストールしてください。 Android SDKのパスなどは「SDK Manager」から簡単に確認できます。 Flutterを使ってビルドするときは、XcodeとAndroid Studioの両方がインストール済みであれば、同一のプロジェクトでiOS版とAndroid版を切り替えながら開発できる点が便利です。

Linux環境でのセットアップ

Linuxは軽量な環境で開発したい方に向いています。また、CI環境でLinuxマシンを使う企業も多いので、自動ビルドのパイプラインを整備する際にも役立ちます。

Flutter SDKのインストール（Linux）

パッケージマネージャー経由でFlutterがインストールできるディストリビューションもありますが、公式サイトから直接ダウンロードする方法が一般的です。ダウンロードした.tar.xzファイルを解凍し、任意のディレクトリに配置します。

環境変数PATHの設定をシェルの設定ファイルに追記します。たとえば、~/.bashrcや~/.zshrcに以下のように追加します。


export PATH="$PATH:/home/ユーザー名/flutter/bin"

設定を反映後、Flutterコマンドを実行してみて、バージョン情報が表示されるか確かめてください。


flutter --version

大規模なプロジェクトでサーバーサイドの自動テストやビルドをLinuxで行うケースもあるため、Linux環境でのFlutterセットアップは実務にも直結する場面があります。

Android Studioやその他ツールの導入（Linux）

Android StudioをLinuxで導入する場合は、ディストリビューションに合わせたインストール方法を選択します。 UbuntuなどのDebian系ではSnapやAPTで入手できることもありますが、公式サイトから直接ダウンロードして展開する方式が一番確実です。

Android SDKについてはAndroid Studio内部の「SDK Manager」からインストールできます。 Android Emulatorsを利用するには追加の設定やKVMの有効化などが必要な場合もあるため、OSのバージョンやディストリビューションの特性に合わせて作業してください。

企業のCIパイプラインではGUI不要のヘッドレス環境を使うことが多いため、エミュレータを使わずに接続された端末や特定のテストフレームワークだけで動かすケースもあります。その場合は最低限のSDKインストールで運用可能です。

Flutter CLIの基本コマンド

Flutter CLIには便利なコマンドが多数存在します。慣れるとGUIをあまり使わずに進めることもできます。

flutter doctor

環境に不足しているものがあれば警告を出してくれる便利なコマンドです。初回セットアップ後やSDKのアップデート後などに実行すると、足りないコンポーネントを一覧で確認できます。


flutter doctor

警告が出た場合は、足りないツールのインストールやパス設定を見直して、問題を解消します。

flutter create

新しいFlutterプロジェクトを作成します。以下のコマンドでサンプルアプリの雛形が自動生成されます。


flutter create my_first_app

実務では、この雛形をプロジェクト固有の構成に合わせてカスタマイズします。後ほど機能を追加する際にも、雛形が整っているとプロジェクトが整理されやすいですね。

flutter run

アプリを実行するコマンドです。実機やエミュレータが認識された状態で以下を実行すると、アプリが起動します。


flutter run

このコマンドでホットリロード・ホットリスタートが試せるのもFlutterの特徴です。画面を見ながらコードを編集し、反映の速さを体感することで効率的に開発が進められます。

iOS開発のポイント

FlutterでiOSアプリを開発する場合は、macOS上での作業が必須です。 Apple Developer Programへの登録や実機デバッグを行うための証明書管理が必要になり、WindowsやLinuxのみではiOS向けビルドができません。

実務でiOSアプリを運用する際には、App Storeへの配信プロセスやテストフライトなどの知識も必要です。アプリのアイコンやバンドルID、証明書の署名など、環境構築とは別の要素も絡んできます。しかし、Flutter側の設定はAndroid StudioからでもXcode上でも共通する部分が多いため、一度覚えれば効率よくビルドを切り替えられます。

実務での活用シーン

Flutterは企業内で使われる管理ツールや顧客向けのネイティブアプリなど、多岐にわたる場面で活用されています。 1つのコードベースを共有できるメリットから、AndroidアプリとiOSアプリの開発チームを統合し、リリースサイクルを短縮したケースもあります。

また、同一のコンポーネントをWebアプリで再利用できるため、サービス全体の運用コストを下げる取り組みにもつながります。ただし、実機のセンサー系やカメラ機能など、ハードウェア依存の機能を使う際には、プラグイン選択やテストが重要です。

プラットフォームごとの制限を忘れがちな場合は、早めにサンプルコードを実行してデバイス依存の機能が正しく動くか確認しておきましょう。

プロジェクト構成の概要

Flutterで生成されるプロジェクトは、基本的にlib配下にDartのソースコードを配置する構造になっています。プラットフォーム別のフォルダとして、androidやios、linux、macos、windowsなどが用意されており、それぞれネイティブ向けの設定やコードを管理します。

ビジネスロジックや画面UIは基本的にDartで書くので、マルチプラットフォーム化を意識した設計がしやすいです。ただし、特定のOSだけで使う機能を呼び出すときは、プラットフォームチャネルを利用してネイティブコードと連携します。実務で拡張性や保守性を高めるには、この仕組みを理解しておくことが大切です。

デバッグとテスト

Flutterはホットリロードを使ってUIを素早く反映できるので、UIの調整や小規模な機能追加には便利です。また、ユニットテストやウィジェットテストも標準機能として用意されています。

たとえば、以下のようにテストファイルを作成して実行できます。


import 'package:flutter_test/flutter_test.dart';

void main() {
  test('サンプルテスト', () {
    final result = 2 + 3;
    expect(result, 5);
  });
}

このようにシンプルなテストから始めて、プロジェクト全体の品質を保つ仕組みを導入できます。実際のプロダクションアプリでは、ユーザー操作に関連する画面テストも組み合わせ、アップデート時の不具合を早期発見できるようにします。

CI/CDとの連携

大規模なプロジェクトやチーム開発では、コードの品質や動作を自動でチェックする仕組みが求められます。 CI/CDツールと連携させることで、Gitにプッシュするたびに自動ビルドとテストを走らせることも可能です。

Linuxサーバー上でAndroid向けのビルドを行い、macOSサーバー上でiOS向けのビルドを行うパイプラインを構築する企業も存在します。このような仕組みを整えることで、手動でのビルド作業を減らし、開発の効率と信頼性を向上できます。

CIを使ってビルドするときは、Flutter SDKのバージョンや依存パッケージの管理方法を明確にしておきましょう。複数のFlutterバージョンが混在する状況はトラブルの元になりやすいです。

プロジェクトのメンテナンス

Flutterで作られたプロジェクトは、DartのバージョンやFlutter本体のバージョンアップに伴って変更が必要になる場合があります。特にメジャーアップデートの際は、新しいSDK機能が追加されたり、非推奨になったメソッドが削除されたりすることがあるからです。

実務では、頻繁にバージョンを上げるか、それとも安定したバージョンで運用するか、チーム内で方針を決める必要があるでしょう。社内サービスの場合はリリースの頻度や使用しているプラグインの状況を見極めて、アップデートのタイミングを調整するとスムーズに管理できます。

エミュレータと実機テスト

Flutter開発では、AndroidエミュレータやiOSシミュレータを使って素早く動作確認ができます。 UIのちょっとした変更やロジックのテスト程度ならエミュレータで十分ですが、カメラやGPSなどのセンサー系機能を使う際は、実機テストが欠かせません。

社内アプリを扱う場合などは、複数種類の実機を用意するのが難しいケースもあります。そういった状況では、主要な端末だけでも確保し、最低限の動作確認をする段取りを作っておくと良いですね。

まとめ

FlutterはAndroidとiOS向けアプリを一度に開発できるだけでなく、Webやデスクトップにも応用しやすいのが特徴です。環境構築の手順はOSごとに若干異なりますが、公式サイトからFlutter SDKをダウンロードしてパスを通し、Android StudioやXcodeなどのツールをインストールするという大枠は共通しています。

初心者の方は、まずはスモールスタートでアプリをビルドし、ホットリロードやテストの仕組みに慣れるところから始めてみると良いでしょう。一度仕組みを把握してしまえば、実務での管理ツールや本格的な顧客向けアプリ開発に発展させることも十分可能です。

Flutterの柔軟さは開発コストや時間を最適化したい場面で役立つため、今後も多くの開発者や企業が採用すると考えられます。ぜひご自身の環境でFlutterをインストールし、簡単なアプリを動かして、そのメリットを体感してみてください。