Flutter国际化检查插件i18n_checker的使用

Flutter国际化检查插件i18n_checker的使用

i18n_checker

由 Very Good CLI 生成 🤖

命令行工具，用于改进不同语言文件的一致性。

开始使用 🚀

如果CLI应用程序在 pub 上可用，可以通过以下方式全局激活：

dart pub global activate i18n_checker

使用方法

# 检查差异
$ i18n_checker diff --arb-folder /path/to/arb/folder --reference-file intl_fr.arb

# 显示CLI版本
$ i18n_checker --version

# 显示使用帮助
$ i18n_checker --help

完整示例 Demo

为了更好地理解如何使用 i18n_checker，我们来看一个完整的示例。

假设你有一个项目结构如下：

my_flutter_project/
├── lib/
│   └── main.dart
├── arb/
│   ├── intl_en.arb
│   ├── intl_fr.arb
│   └── intl_es.arb
└── .gitignore

1. 创建AR文件

首先，你需要创建 .arb 文件。这些文件用于存储各个语言的字符串。例如：

intl_en.arb

{
  "@@locale": "en",
  "appTitle": "My Flutter App",
  "welcomeMessage": "Welcome to my app!"
}

intl_fr.arb

{
  "@@locale": "fr",
  "appTitle": "Mon Application Flutter",
  "welcomeMessage": "Bienvenue dans mon application !"
}

intl_es.arb

{
  "@@locale": "es",
  "appTitle": "Mi Aplicación Flutter",
  "welcomeMessage": "¡Bienvenido a mi aplicación!"
}

2. 在Flutter项目中使用这些AR文件

在你的 main.dart 文件中，你可以通过 Localizations 和 MaterialApp 来使用这些本地化字符串。

lib/main.dart

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      localizationsDelegates: [
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
        GlobalCupertinoLocalizations.delegate,
      ],
      supportedLocales: [
        const Locale('en', ''), // English
        const Locale('fr', ''), // French
        const Locale('es', ''), // Spanish
      ],
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(Localizations.of(context, DemoLocalizations).appTitle),
      ),
      body: Center(
        child: Text(Localizations.of(context, DemoLocalizations).welcomeMessage),
      ),
    );
  }
}

class DemoLocalizations {
  static DemoLocalizations of(BuildContext context) {
    return Localizations.of<DemoLocalizations>(context, DemoLocalizations);
  }

  String get appTitle => Intl.message(
        'My Flutter App',
        name: 'appTitle',
        desc: 'The title of the app',
        args: [],
      );

  String get welcomeMessage => Intl.message(
        'Welcome to my app!',
        name: 'welcomeMessage',
        desc: 'A welcome message for users',
        args: [],
      );
}

3. 使用i18n_checker检查差异

确保你已经安装了 i18n_checker。然后运行以下命令来检查差异：

i18n_checker diff --arb-folder ./arb --reference-file ./arb/intl_en.arb