1. プロジェクト作成

パッケージ・コード生成の準備

この章のゴール

1

プロジェクトを作る

macOS / Windows / Android / iOS 向け

2

パッケージを入れる

Riverpod・freezed・go_router・drift

3

コード生成を動かす

build.yaml と build_runner

プロジェクトを作る

flutter create --org com.example --platforms=macos,windows,android,ios motion_app
cd motion_app

macOS でビルドできないとき

新しい Xcode では、作成直後のままだと 対応 macOS バージョン(10.15)が古すぎて ビルドに失敗します。次のスライドの手順で 12.0 に上げます。

macOS の対応バージョンを 12.0 にする

  1. macos/Podfile の1行目を platform :osx, '12.0' にする
  2. 同じファイルの post_install に下の3行を足す
  3. macos/Runner.xcodeproj/project.pbxproj の MACOSX_DEPLOYMENT_TARGET = 10.15; を全部 12.0; に置き換える
macos/Podfile
post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_macos_build_settings(target)
    target.build_configurations.each do |config|
      config.build_settings['MACOSX_DEPLOYMENT_TARGET'] = '12.0'
    end
  end
end

パッケージを入れる

flutter pub add flutter_localizations --sdk=flutter
flutter pub add 'flutter_riverpod:^3.0.0' 'hooks_riverpod:^3.0.0' \
  flutter_hooks riverpod_annotation freezed_annotation go_router \
  drift drift_flutter path_provider uuid intl \
  dev:build_runner dev:riverpod_generator dev:freezed dev:drift_dev

パッケージ追加の落とし穴

Riverpod は 3 系を指定する

バージョンを付けずに追加すると、古い Riverpod 2 系が選ばれ、コード生成のパッケージと衝突することがあります。

flutter_localizations を先に入れる

intl を先に入れると Flutter 本体が固定しているより新しい版が選ばれ、10章で多言語対応のパッケージが入らなくなります。

  • BLE(universal_ble)は8章、shared_preferences は9章、多言語(slang)は10章で追加します

build.yaml を作る

プロジェクト直下に作成。drift の日時の保存形式だけを指定します。

build.yaml
# コード生成(build_runner)の設定
# 対象のフォルダは絞らず lib/ 以下をすべて見る。フォルダ構成を変えても、別のアプリに持っていってもそのまま使える
targets:
  $default:
    builders:
      drift_dev:
        options:
          # DateTime を文字列(ISO 8601)で保存する。タイムゾーンが残り、DB を直接開いても読める
          store_date_time_values_as_text: true

build.yaml のポイント

  • riverpod / freezed / drift のジェネレーターは、lib/ 以下で注釈(@riverpod など)と part があるファイルだけを生成する。フォルダを指定しなくてよい
  • フォルダを指定(generate_for)すると、そこ以外に置いたファイルは何も生成されず、原因に気づきにくい
  • アプリが大きくなって生成が遅くなったら、そのとき generate_for で対象を絞る

起動部分を書く(main)

lib/main.dart
import 'package:flutter/material.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';
import 'package:motion_app/app.dart';

void main() {
  runApp(const ProviderScope(child: App()));
}
  • ProviderScope で囲むと、アプリ全体で Riverpod が使えるようになります
  • 既存の test/widget_test.dart は削除します(11章で作り直します)

起動部分を書く(App)

lib/app.dart
import 'package:flutter/material.dart';

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Motion Note',
      theme: ThemeData(colorSchemeSeed: Colors.teal),
      home: const Scaffold(
        body: Center(child: Text('Motion Note')),
      ),
    );
  }
}

コード生成を動かす

dart run build_runner build   # 1回だけ生成
dart run build_runner watch   # 保存するたびに自動生成(開発中はこちら)
flutter run -d macos

生成がおかしいとき

dart run build_runner clean してから build し直します。

チェックポイント

CHECK 0 / 3