Flutterの基本的な概念とプロジェクトの構造について学びます。前編では、Flutterプロジェクトの作成方法、ディレクトリ構成、そしてmain.dartファイルの内容を理解することに焦点を当てます。

1. プロジェクトの作成

「2.6 動作確認：最初のFlutterアプリを実行」で、VS Codeを使ってFlutterプロジェクトを作成する手順を簡単に説明しました。ここでは、より詳細な作成方法を見ていきましょう。

Flutterプロジェクトを作成するには、主に2つの方法があります。

1. VS Codeのコマンドパレットを使用する方法
2. ターミナルでflutter createコマンドを使用する方法

1.1 VS Codeのコマンドパレットを使用する方法

1. VS Codeを開きます。
2. コマンドパレットを開きます（Ctrl+Shift+P / Cmd+Shift+P）。
3. 「Flutter: New Project」と入力し、選択します。
4. プロジェクトのテンプレートとして「Application」を選択します。
5. プロジェクトの保存先フォルダを選択し、プロジェクト名（例：my_app）を入力します。
   • プロジェクト名には、スネークケース（小文字とアンダースコア）を使用します。
6. プロジェクトが作成され、VS Codeで開かれます。

1.2 ターミナルでflutter createコマンドを使用する方法

1. ターミナルを開きます。

2. プロジェクトを作成したいディレクトリに移動します。

3. 以下のコマンドを実行します。

   flutter create my_app

   • my_appの部分は、作成したいプロジェクト名に置き換えてください。

4. プロジェクトが作成されたら、VS Codeでプロジェクトフォルダを開きます。

どちらの方法でも、Flutterプロジェクトの基本的な構造が作成されます。

2. プロジェクトのディレクトリ構成

作成されたFlutterプロジェクトには、以下のようなディレクトリとファイルが含まれています。

my_app/
├── android/       # Android用のネイティブコードが含まれる
├── ios/           # iOS用のネイティブコードが含まれる
├── lib/           # Dartのソースコードが含まれる
│   └── main.dart  # アプリのエントリーポイント
├── test/          # テストコードが含まれる
├── .gitignore     # Gitの管理対象外ファイルを設定
├── .metadata      # Flutterが使用するメタデータファイル
├── .packages      # Dartのパッケージ管理ファイル（非推奨）
├── my_app.iml     # IntelliJ IDEA用のプロジェクトファイル
├── pubspec.lock   # 使用パッケージのバージョン情報
└── pubspec.yaml   # プロジェクトの設定ファイル

主要なディレクトリとファイルについて説明します。

• android/: Android用のネイティブコードが含まれるディレクトリです。Android固有の設定や、Java/Kotlinで書かれたコードを配置します。
• ios/: iOS用のネイティブコードが含まれるディレクトリです。iOS固有の設定や、Objective-C/Swiftで書かれたコードを配置します。
• lib/: Dartで書かれたFlutterアプリのソースコードが含まれるディレクトリです。ほとんどのアプリ開発は、このディレクトリ内で行います。
• main.dart: アプリのエントリーポイントとなるファイルです。このファイルからアプリが起動します。
• test/: テストコードが含まれるディレクトリです。ユニットテストやウィジェットテストを記述します。
• pubspec.yaml: プロジェクトの設定ファイルです。アプリ名、説明、依存パッケージなどを記述します。

3. main.dart を理解する

main.dartファイルは、Flutterアプリのエントリーポイントです。このファイルに記述されたmain関数から、アプリの実行が開始されます。

デフォルトで作成されたmain.dartファイルの内容を見てみましょう。

import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        // This is the theme of your application.
        //
        // TRY THIS: Try running your application with "flutter run". You'll see
        // the application has a blue toolbar. Then, without quitting the app,
        // try changing the seedColor in the colorScheme below to Colors.green
        // and then invoke "hot reload" (save your changes or press the "hot
        // reload" button in a Flutter-supported IDE, or press "r" if you used
        // the command line to start the app).
        //
        // Notice that the counter didn't reset back to zero; the application
        // state is not lost during the reload. To reset the state, use hot
        // restart instead.
        //
        // This works for code too, not just values: Most code changes can be
        // tested with just a hot reload.
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  // This widget is the home page of your application. It is stateful, meaning
  // that it has a State object (defined below) that contains fields that affect
  // how it looks.

  // This class is the configuration for the state. It holds the values (in this
  // case the title) provided by the parent (in this case the App widget) and
  // used by the build method of the State. Fields in a Widget subclass are
  // always marked "final".

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      // This call to setState tells the Flutter framework that something has
      // changed in this State, which causes it to rerun the build method below
      // so that the display can reflect the updated values. If we changed
      // _counter without calling setState(), then the build method would not be
      // called again, and so nothing would appear to happen.
      _counter++;
    });
  }

  @override
  Widget build(BuildContext context) {
    // This method is rerun every time setState is called, for instance as done
    // by the _incrementCounter method above.
    //
    // The Flutter framework has been optimized to make rerunning build methods
    // fast, so that you can just rebuild anything that needs updating rather
    // than having to individually change instances of widgets.
    return Scaffold(
      appBar: AppBar(
        // TRY THIS: Try changing the color here to a specific color (to
        // Colors.amber, perhaps?) and trigger a hot reload to see the AppBar
        // change color while the other colors stay the same.
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        // Here we take the value from the MyHomePage object that was created by
        // the App.build method, and use it to set our appbar title.
        title: Text(widget.title),
      ),
      body: Center(
        // Center is a layout widget. It takes a single child and positions it
        // in the middle of the parent.
        child: Column(
          // Column is also a layout widget. It takes a list of children and
          // arranges them vertically. By default, it sizes itself to fit its
          // children horizontally, and tries to be as tall as its parent.
          //
          // Column has various properties to control how it sizes itself and
          // how it positions its children. Here we use mainAxisAlignment to
          // center the children vertically; the main axis here is the vertical
          // axis because Columns are vertical (the cross axis would be
          // horizontal).
          //
          // TRY THIS: Invoke "debug painting" (choose the "Toggle Debug Paint"
          // action in the IDE, or press "p" in the console), to see the
          // wireframe for each widget.
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text(
              'You have pushed the button this many times:',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ), // This trailing comma makes auto-formatting nicer for build methods.
    );
  }
}

少し長いですが、重要なポイントに絞って解説します。

1. import 'package:flutter/material.dart';:

   • Flutterのマテリアルデザインライブラリをインポートしています。これにより、MaterialAppやScaffoldなどのウィジェットが使用可能になります。

2. void main() { runApp(const MyApp()); }:

   • アプリのエントリーポイントとなるmain関数です。
   • runApp関数は、引数に渡されたウィジェットをアプリケーションのルートウィジェットとして実行します。

3. class MyApp extends StatelessWidget { ... }:

   • アプリケーションのルートウィジェットを定義しています。
   • StatelessWidgetを継承しているため、このウィジェットは状態を持ちません。

4. class MyHomePage extends StatefulWidget { ... }:

   • アプリケーションのホームページを定義しています。
   • StatefulWidgetを継承しているため、このウィジェットは状態を持つことができます。

5. class _MyHomePageState extends State<MyHomePage> { ... }:

   • MyHomePageの状態を管理するクラスです。
   • _counter変数でカウンターの状態を保持し、_incrementCounterメソッドでカウンターを更新します。
   • buildメソッドで、現在の状態に基づいたUIを構築します。

main.dartファイルには、アプリの基本的な構造と、カウンターアプリのサンプルコードが含まれています。このコードを修正しながら、Flutterアプリの開発方法を学んでいきます。