Flutterのローカライズ：ARBファイル、intl、gen-l10nを解説

ローカライズのジェネレーターは1つに絞り、その入力先と出力先を明示します。以下の例は、独自のSDK制約と通常のプロジェクト設定を持つ既存のFlutterアプリを前提としています。

関連するエントリをpubspec.yamlにマージします。dependenciesセクションやflutterセクションを重複させないでください：

dependencies:
  flutter:
    sdk: flutter
  flutter_localizations:
    sdk: flutter
  intl: any

flutter:
  generate: true

flutter pub getで依存関係を解決します。intl: anyのエントリは公式のセットアップ手順に従ったもので、Flutter SDKと互換性のあるバージョンを依存関係の解決時に選択できます。アプリのロックファイルと通常の依存関係レビュープロセスは維持してください。

プロジェクトのルートにl10n.yamlを作成します：

arb-dir: lib/l10n
template-arb-file: app_en.arb
output-localization-file: app_localizations.dart

SDK固有のセットアップには、最新のFlutter国際化ガイドを参照してください。現在のワークフローでは、生成されたローカライズファイルはアプリのソースツリーに配置します。この例ではlib/l10nからインポートしています。古い合成パッケージpackage:flutter_genのインポートを新しいセットアップにコピーしないでください。詳しくは生成ソースの移行に関する注記をご覧ください。

lib/l10n/app_en.arbを作成します：

{
  "@@locale": "en",
  "appTitle": "Reading room",
  "@appTitle": {
    "description": "Title of the sample reading application"
  },
  "welcomeName": "Welcome, {name}",
  "@welcomeName": {
    "description": "Greeting on the home screen",
    "placeholders": {
      "name": {"type": "String", "example": "Sam"}
    }
  },
  "savedBooks": "{count, plural, =0{No saved books} one{1 saved book} other{{count} saved books}}",
  "@savedBooks": {
    "description": "Number of books saved to the user's library",
    "placeholders": {
      "count": {"type": "int"}
    }
  },
  "readingState": "{state, select, active{Reading now} paused{Reading paused} other{Ready to read}}",
  "@readingState": {
    "description": "Reading status; state is active, paused or another value",
    "placeholders": {
      "state": {"type": "String"}
    }
  }
}

lib/l10n/app_es.arbを作成します：

{
  "@@locale": "es",
  "appTitle": "Sala de lectura",
  "welcomeName": "Te damos la bienvenida, {name}",
  "savedBooks": "{count, plural, =0{No hay libros guardados} one{1 libro guardado} other{{count} libros guardados}}",
  "readingState": "{state, select, active{Leyendo ahora} paused{Lectura en pausa} other{Todo listo para leer}}"
}

テンプレートには、ジェネレーターが使用するプレースホルダーのメタデータが含まれます。ローカライズファイルでは、ユーザー向けの文言を変更しつつ、メッセージキー、プレースホルダー名、select識別子を保持します。これらのスペイン語の例は仕組みを示すためのもので、本番の文言は実際の製品の文脈でネイティブレビューを受ける必要があります。

リソースを追加または変更したらflutter gen-l10nを実行します。ジェネレーターのエラーは対処すべきリソースの問題として扱い、ファイルをリリースに組み込む前に解決してください。

生成後、次の例をlib/main.dartに記述します：

import 'package:flutter/material.dart';
import 'l10n/app_localizations.dart';

void main() => runApp(const ReadingApp());

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      localizationsDelegates: AppLocalizations.localizationsDelegates,
      supportedLocales: AppLocalizations.supportedLocales,
      home: const ReadingHome(),
    );
  }
}

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

  @override
  Widget build(BuildContext context) {
    final messages = AppLocalizations.of(context)!;
    return Scaffold(
      appBar: AppBar(title: Text(messages.appTitle)),
      body: Padding(
        padding: const EdgeInsetsDirectional.all(16),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text(messages.welcomeName('Sam')),
            Text(messages.savedBooks(3)),
            Text(messages.readingState('active')),
          ],
        ),
      ),
    );
  }
}

生成されたAPIでは、単純なメッセージと引数付きメッセージの違いがコード上で明確になります。appTitleは値としてアクセスし、welcomeName、savedBooks、readingStateはメッセージの組み立てに必要な値を受け取ります。

選定前に、最新のeasy_localizationのドキュメントとGetXのドキュメントを確認してください。フォールバックの動作、パラメーター、複数形のカテゴリー、抽出ワークフローを実際のメッセージでテストしましょう。英語の文字列で使いやすいAPIだからといって、リリース予定のすべての言語に対応できるとは限りません。

intlは、翻訳管理プラットフォームと競合するものではありません。ローカライズのワークフローで使われる国際化ユーティリティを提供します。gen-l10nはARBリソースからアプリのアクセサーを生成します。別のintl_utilsパッケージもローカライズ用のコードを生成しますが、2026年10月30日の確認時点でパッケージページに開発終了と表示されていました。新しいプロジェクトで採用する前に、保守状況を確認してください。

実用的なテストマトリクスを使用します：

FlutterのWeb FAQでは、アプリケーション体験に重点を置いていることが説明されており、静的でテキスト中心のWebコンテンツにはドキュメント指向のアプローチが推奨されています。マーケティング、ヘルプ、編集記事のページがオーガニック検索で成果を上げる必要がある場合は、HTMLベースの別ページを検討してください。

アプリとこれらの公開ページの間で用語をそろえてください。2つの画面が異なるレンダリング方式を使っていても、検索から訪れたユーザーがローカライズされたランディングページからアプリに移ったときに、機能名を認識できるようにします。

Smartcatのドキュメントに記載されたソフトウェアプロジェクト形式には、JSON、YAML、Android XML、iOS .strings、LocJSONのインポートが含まれます。本ガイドで確認したドキュメントでは、ARBのネイティブサポートや、テスト済みのARBからJSONへの変換ワークフローは確認されていません。ファイル拡張子を変えるだけで互換性が証明されるとは考えないでください。ソフトウェアプロジェクトのドキュメントをご覧ください。

以下はテスト済みのコネクター手順ではなく、実装チームと進める検証手順の提案としてご活用ください：