10. 多言語対応

slang で日本語と英語を切り替える

この章のゴール

1

翻訳ファイル

ja / en の JSON

2

文言を置き換え

context.t で参照

3

言語切り替え

ボタンで即座に反映

準備

flutter pub add 'slang:^4.0.0' 'slang_flutter:^4.0.0'
  • flutter_localizations は1章で入れてあります

slang の設定

プロジェクト直下に slang.yaml を作ります。

slang.yaml
# 多言語対応(slang)の設定。翻訳ファイルを変えたら `dart run slang` で再生成する
base_locale: ja
fallback_strategy: base_locale
input_directory: lib/i18n
output_directory: lib/i18n
output_file_name: strings.g.dart
string_interpolation: braces
lazy: false
timestamp: false

生成は build_runner ではなく dart run slang

slang は build_runner でも生成できますが、生成ファイルをコミットすると clone 直後の build_runner が失敗 します。専用のコマンドで生成すれば、この問題は起きません。

翻訳ファイル

lib/i18n/ja.i18n.json

lib/i18n/ja.i18n.json
{
  "home": {
    "users": "ユーザー",
    "device": "デバイス",
    "language": "言語を切り替え"
  },
  "userList": {
    "title": "ユーザー一覧",
    "name": "名前",
    "add": "追加",
    "inputError": "名前を入力してください"
  },
  "userDetail": {
    "measure": "測定する",
    "history": "測定履歴",
    "noHistory": "まだ測定していません",
    "peakGyro": "最大角速度 {sensor1} / {sensor2} dps",
    "seconds": "{value}秒"
  },
  "measurement": {
    "title": "測定",
    "sensor": "センサ{no}  {value} dps",
    "elapsed": "{value} 秒",
    "start": "測定開始",
    "stopAndSave": "停止して保存",
    "personalBest": "自己ベスト更新!"
  },
  "device": {
    "title": "デバイス",
    "scan": "検索",
    "scanning": "検索中...",
    "fake": "偽物のセンサ(実機なし)",
    "saved": "保存されているデバイス",
    "connectFailed": "接続できませんでした",
    "reconnect": "再接続"
  },
  "connection": {
    "fake": "偽物",
    "connected": "接続済み",
    "battery": "電池 {value}%",
    "connecting": "接続中...",
    "disconnected": "未接続",
    "failed": "接続できません"
  }
}

lib/i18n/en.i18n.json

lib/i18n/en.i18n.json
{
  "home": {
    "users": "Users",
    "device": "Device",
    "language": "Switch language"
  },
  "userList": {
    "title": "Users",
    "name": "Name",
    "add": "Add",
    "inputError": "Please enter a name"
  },
  "userDetail": {
    "measure": "Measure",
    "history": "History",
    "noHistory": "No measurements yet",
    "peakGyro": "Peak angular velocity {sensor1} / {sensor2} dps",
    "seconds": "{value} s"
  },
  "measurement": {
    "title": "Measure",
    "sensor": "Sensor {no}  {value} dps",
    "elapsed": "{value} s",
    "start": "Start",
    "stopAndSave": "Stop and save",
    "personalBest": "New personal best!"
  },
  "device": {
    "title": "Device",
    "scan": "Scan",
    "scanning": "Scanning...",
    "fake": "Fake sensor (no hardware)",
    "saved": "Saved device",
    "connectFailed": "Could not connect",
    "reconnect": "Reconnect"
  },
  "connection": {
    "fake": "Fake",
    "connected": "Connected",
    "battery": "Battery {value}%",
    "connecting": "Connecting...",
    "disconnected": "Not connected",
    "failed": "Cannot connect"
  }
}

翻訳コードを生成する

dart run slang   # lib/i18n/strings.g.dart などが作られる
  • 翻訳ファイルを変更したら、毎回このコマンドを実行する
  • 生成されたコードは context.t.home.users のように、JSON の階層どおりに使える
  • {value} のような埋め込みは context.t.userDetail.seconds(value: ...) のように渡す

アプリに組み込む(main)

lib/main.dart
import 'package:flutter/material.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';
import 'package:motion_app/app.dart';
import 'package:motion_app/i18n/strings.g.dart';
import 'package:motion_app/provider/providers.dart';
import 'package:motion_app/repository/settings/device_settings_repository.dart';
import 'package:shared_preferences/shared_preferences.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized(); // runApp の前に await するときに必要
  LocaleSettings.useDeviceLocaleSync(); // 端末の言語で起動
  // 保存した設定を起動前に読み込んでおく → 以降は await なしで読める
  final prefs = await SharedPreferencesWithCache.create(
    cacheOptions: const SharedPreferencesWithCacheOptions(
      allowList: {DeviceSettingsRepository.deviceIdKey},
    ),
  );
  runApp(ProviderScope(
    overrides: [sharedPreferencesProvider.overrideWithValue(prefs)],
    child: TranslationProvider(child: const App()),
  ));
}
  • 起動時に端末の言語を使う
  • TranslationProvider で囲むと、言語が変わったときに context.t を使う画面が描き直される

アプリに組み込む(MaterialApp)

lib/app.dart
import 'package:flutter/material.dart';
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';
import 'package:motion_app/provider/imu_connection.dart';
import 'package:motion_app/router/router.dart';
import 'package:motion_app/i18n/strings.g.dart';

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

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    // 起動したらすぐにセンサへの接続を始める(どの画面を開いていても接続を保つ)
    ref.listen(imuConnectionProvider, (_, _) {});
    return MaterialApp.router(
      title: 'Motion Note',
      theme: ThemeData(colorSchemeSeed: Colors.teal),
      routerConfig: ref.watch(routerProvider),
      locale: TranslationProvider.of(context).flutterLocale,
      supportedLocales: AppLocaleUtils.supportedLocales,
      localizationsDelegates: GlobalMaterialLocalizations.delegates,
    );
  }
}
  • Flutter 標準部品(日付ピッカーなど)の言語も合わせる

文言を置き換える

// 前
title: const Text('ユーザー'),
// 後
title: Text(context.t.home.users),

// 埋め込み値
Text(context.t.measurement.sensor(no: 1, value: state.gyro1.toStringAsFixed(0))),
  • Widget の中では context.t → 言語が変わると自動で描き直される
  • const は外す(実行時に決まる値になるため)

ViewModel には文言を持たせない

lib/ui/user_list/view_model/user_list_view_model.dart
import 'package:freezed_annotation/freezed_annotation.dart';
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:motion_app/infrastructure/database/app_database.dart';
import 'package:motion_app/provider/providers.dart';

part 'user_list_view_model.g.dart';
part 'user_list_view_model.freezed.dart';

@freezed
abstract class UserListState with _$UserListState {
  const factory UserListState({
    @Default([]) List<User> users,
    @Default(true) bool isLoading,
    @Default(false) bool hasInputError, // 文言は画面側で翻訳する
  }) = _UserListState;
}

@riverpod
class UserListViewModel extends _$UserListViewModel {
  @override
  UserListState build() {
    Future.microtask(load); // 画面表示時に読み込む
    return const UserListState();
  }

  Future<void> load() async {
    final users = await ref.read(userRepositoryProvider).getAll();
    if (!ref.mounted) return; // 待っている間に画面が閉じられていたら何もしない
    state = state.copyWith(users: users, isLoading: false);
  }

  // 追加できたら true
  Future<bool> addUser(String name) async {
    final trimmed = name.trim();
    if (trimmed.isEmpty) {
      state = state.copyWith(hasInputError: true);
      return false;
    }
    await ref.read(userRepositoryProvider).create(name: trimmed);
    if (!ref.mounted) return true;
    state = state.copyWith(hasInputError: false);
    await load();
    return true;
  }
}
  • ViewModel は「エラーがある」という 事実だけ を持つ(errorMessage → hasInputError)
  • 文言は View で翻訳 → 言語を切り替えてもエラー文が正しい言語になる

一覧の画面

lib/ui/user_list/view/user_list_page.dart
import 'package:flutter/material.dart';
import 'package:flutter_hooks/flutter_hooks.dart';
import 'package:go_router/go_router.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';
import 'package:motion_app/router/router.dart';
import 'package:motion_app/ui/user_list/view_model/user_list_view_model.dart';
import 'package:motion_app/i18n/strings.g.dart';

class UserListPage extends HookConsumerWidget {
  const UserListPage({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final state = ref.watch(userListViewModelProvider);
    final notifier = ref.read(userListViewModelProvider.notifier);
    final nameController = useTextEditingController();

    return Scaffold(
      appBar: AppBar(title: Text(context.t.userList.title)),
      body: Column(
        children: [
          Padding(
            padding: const EdgeInsets.all(16),
            child: Row(
              children: [
                Expanded(
                  child: TextField(
                    controller: nameController,
                    decoration: InputDecoration(
                      labelText: context.t.userList.name,
                      errorText: state.hasInputError ? context.t.userList.inputError : null,
                    ),
                  ),
                ),
                const SizedBox(width: 16),
                FilledButton(
                  onPressed: () async {
                    if (await notifier.addUser(nameController.text)) {
                      nameController.clear();
                    }
                  },
                  child: Text(context.t.userList.add),
                ),
              ],
            ),
          ),
          Expanded(
            child: state.isLoading
                ? const Center(child: CircularProgressIndicator())
                : ListView(
                    children: [
                      for (final user in state.users)
                        ListTile(
                          leading: const Icon(Icons.person),
                          title: Text(user.name),
                          onTap: () => context.push(Routes.userDetail(user.id)),
                        ),
                    ],
                  ),
          ),
        ],
      ),
    );
  }
}

詳細の画面

lib/ui/user_detail/view/user_detail_page.dart
import 'package:flutter/material.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';
import 'package:go_router/go_router.dart';
import 'package:intl/intl.dart';
import 'package:motion_app/router/router.dart';
import 'package:motion_app/ui/user_detail/view_model/user_detail_view_model.dart';
import 'package:motion_app/i18n/strings.g.dart';

class UserDetailPage extends ConsumerWidget {
  const UserDetailPage({super.key, required this.userId});

  final String userId;

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final state = ref.watch(userDetailViewModelProvider(userId));

    return Scaffold(
      appBar: AppBar(title: Text(state.user?.name ?? '')),
      floatingActionButton: FloatingActionButton.extended(
        icon: const Icon(Icons.sensors),
        label: Text(context.t.userDetail.measure),
        onPressed: () async {
          // 測定画面で保存したら true が返ってくるので、履歴を読み直す
          final saved = await context.push<bool>(Routes.measurement(userId));
          if (saved == true) {
            ref.read(userDetailViewModelProvider(userId).notifier).load();
          }
        },
      ),
      body: state.isLoading
          ? const Center(child: CircularProgressIndicator())
          : ListView(
              padding: const EdgeInsets.all(16),
              children: [
                Text(context.t.userDetail.history),
                if (state.sessions.isEmpty) Text(context.t.userDetail.noHistory),
                for (final s in state.sessions)
                  ListTile(
                    leading: const Icon(Icons.timeline),
                    title: Text(context.t.userDetail.peakGyro(
                      sensor1: s.peakGyro1.toStringAsFixed(0),
                      sensor2: s.peakGyro2.toStringAsFixed(0),
                    )),
                    subtitle: Text(
                        '${DateFormat('yyyy/MM/dd HH:mm').format(s.recordedAt)}  '
                        '${context.t.userDetail.seconds(value: s.durationSec.toStringAsFixed(1))}'),
                  ),
              ],
            ),
    );
  }
}

測定の画面

lib/ui/measurement/view/measurement_page.dart
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';
import 'package:motion_app/provider/imu_connection.dart';
import 'package:motion_app/ui/common/connection_status_chip.dart';
import 'package:motion_app/ui/measurement/view_model/measurement_view_model.dart';
import 'package:motion_app/i18n/strings.g.dart';

class MeasurementPage extends ConsumerWidget {
  const MeasurementPage({super.key, required this.userId});

  final String userId;

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final state = ref.watch(measurementViewModelProvider(userId));
    final notifier = ref.read(measurementViewModelProvider(userId).notifier);
    // 必要な値だけを select で取り出す → 電池残量が変わっても描き直されない
    final isConnected = ref.watch(imuConnectionProvider
        .select((s) => s.status == ImuConnectionStatus.connected));
    final big = Theme.of(context).textTheme.displaySmall;

    return Scaffold(
      appBar: AppBar(
        title: Text(context.t.measurement.title),
        actions: const [ConnectionStatusChip()],
      ),
      body: Center(
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            Text(context.t.measurement.sensor(no: 1, value: state.gyro1.toStringAsFixed(0)), style: big),
            Text(context.t.measurement.sensor(no: 2, value: state.gyro2.toStringAsFixed(0)), style: big),
            const SizedBox(height: 8),
            Text(context.t.measurement.elapsed(value: (state.sampleCount / 100).toStringAsFixed(1))),
            const SizedBox(height: 32),
            state.isMeasuring
                ? FilledButton.icon(
                    icon: const Icon(Icons.stop),
                    label: Text(context.t.measurement.stopAndSave),
                    onPressed: () async {
                      final result = await notifier.stopAndSave();
                      if (result == null || !context.mounted) return;
                      if (result.isPersonalBest) {
                        ScaffoldMessenger.of(context).showSnackBar(
                          SnackBar(content: Text(context.t.measurement.personalBest)),
                        );
                      }
                      context.pop(true);
                    },
                  )
                : FilledButton.icon(
                    icon: const Icon(Icons.play_arrow),
                    label: Text(context.t.measurement.start),
                    onPressed: isConnected ? notifier.start : null, // つながるまで押せない
                  ),
          ],
        ),
      ),
    );
  }
}

デバイスの画面

lib/ui/device/view/device_page.dart
import 'package:flutter/material.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';
import 'package:motion_app/provider/imu_connection.dart';
import 'package:motion_app/provider/providers.dart';
import 'package:motion_app/ui/common/connection_status_chip.dart';
import 'package:motion_app/ui/device/view_model/device_view_model.dart';
import 'package:motion_app/i18n/strings.g.dart';

class DevicePage extends ConsumerWidget {
  const DevicePage({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final state = ref.watch(deviceViewModelProvider);
    final notifier = ref.read(deviceViewModelProvider.notifier);
    final selectedId = ref.watch(selectedBleDeviceProvider);
    final connection = ref.watch(imuConnectionProvider);
    // 保存されているが、今回の検索結果にないデバイス
    final isSavedOnly = selectedId != null &&
        state.devices.every((d) => d.deviceId != selectedId);

    return Scaffold(
      appBar: AppBar(
        title: Text(context.t.device.title),
        actions: const [ConnectionStatusChip()],
      ),
      floatingActionButton: FloatingActionButton.extended(
        icon: const Icon(Icons.bluetooth_searching),
        label: Text(state.isScanning ? context.t.device.scanning : context.t.device.scan),
        onPressed: state.isScanning ? null : notifier.scan,
      ),
      body: RadioGroup<String?>(
        groupValue: selectedId,
        onChanged: notifier.select,
        child: ListView(
          children: [
            RadioListTile<String?>(
              value: null,
              title: Text(context.t.device.fake),
            ),
            if (isSavedOnly)
              RadioListTile<String?>(
                value: selectedId,
                title: Text(context.t.device.saved),
                subtitle: Text(selectedId),
              ),
            if (connection.hasError)
              ListTile(
                leading: const Icon(Icons.error_outline),
                title: Text(context.t.device.connectFailed),
                trailing: TextButton(
                  onPressed: notifier.reconnect,
                  child: Text(context.t.device.reconnect),
                ),
              ),
            if (state.errorMessage != null)
              ListTile(title: Text(state.errorMessage!)),
            for (final device in state.devices)
              RadioListTile<String?>(
                value: device.deviceId,
                title: Text(device.name ?? ''),
                subtitle: Text('${device.deviceId}  RSSI ${device.rssi ?? '-'}'),
              ),
          ],
        ),
      ),
    );
  }
}

接続状態の表示

lib/ui/common/connection_status_chip.dart
import 'package:flutter/material.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';
import 'package:motion_app/provider/imu_connection.dart';
import 'package:motion_app/provider/providers.dart';
import 'package:motion_app/i18n/strings.g.dart';

// センサの接続状態と電池残量。どの画面の AppBar にも置ける
class ConnectionStatusChip extends ConsumerWidget {
  const ConnectionStatusChip({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final connection = ref.watch(imuConnectionProvider);
    final isFake = ref.watch(selectedBleDeviceProvider) == null;
    final battery = connection.batteryLevel;
    final t = context.t.connection;

    final (icon, label) = switch (connection.status) {
      ImuConnectionStatus.connected => (
          Icons.bluetooth_connected,
          '${isFake ? t.fake : t.connected}${battery == null ? '' : '  ${t.battery(value: battery)}'}',
        ),
      ImuConnectionStatus.connecting => (Icons.bluetooth_searching, t.connecting),
      ImuConnectionStatus.disconnected => (
          Icons.bluetooth_disabled,
          connection.hasError ? t.failed : t.disconnected,
        ),
    };
    return Padding(
      padding: const EdgeInsets.symmetric(horizontal: 8),
      child: Chip(avatar: Icon(icon, size: 18), label: Text(label)),
    );
  }
}
  • context.t.connection のように、途中の階層を変数に入れると短く書ける

ホームと言語切り替えボタン

lib/ui/home/view/home_page.dart
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
import 'package:motion_app/router/router.dart';
import 'package:motion_app/ui/common/connection_status_chip.dart';
import 'package:motion_app/i18n/strings.g.dart';

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Motion Note'),
        actions: [
          const ConnectionStatusChip(),
          IconButton(
            icon: const Icon(Icons.translate),
            tooltip: context.t.home.language,
            // 日本語 ⇔ 英語を切り替える。context.t を使っている画面は自動で再描画される
            onPressed: () => LocaleSettings.setLocaleSync(
              LocaleSettings.currentLocale == AppLocale.ja ? AppLocale.en : AppLocale.ja,
            ),
          ),
        ],
      ),
      body: ListView(
        padding: const EdgeInsets.all(16),
        children: [
          Card(
            child: ListTile(
              leading: const Icon(Icons.people),
              title: Text(context.t.home.users),
              trailing: const Icon(Icons.chevron_right),
              onTap: () => context.push(Routes.users),
            ),
          ),
          Card(
            child: ListTile(
              leading: const Icon(Icons.bluetooth),
              title: Text(context.t.home.device),
              trailing: const Icon(Icons.chevron_right),
              onTap: () => context.push(Routes.device),
            ),
          ),
        ],
      ),
    );
  }
}
dart run slang analyze   # 翻訳漏れの確認

チェックポイント

CHECK 0 / 5