Flutter国际化校验插件l10n_lint的使用

l10n_lint 插件为 Flutter 的本地化提供了一套校验规则。它可以帮助你检查本地化的初始化是否正确，并找出应该被本地化的字符串字面量。

特性

• 命令行工具用于初始化、排序和获取未使用的值。
• 校验规则确保本地化的正确初始化。
• 检测应被本地化的字符串字面量。

开始使用

在开始使用 l10n_lint 包之前，请确保已经安装了 Flutter SDK。

要安装 l10n_lint 命令行工具，请运行以下命令：

dart pub global activate l10n_lint

初始化 Flutter 本地化

l10n --init

该命令将执行以下操作：

• 创建 l10n.yaml 文件。
• 创建 lib/l10n 文件夹。
• 创建 lib/l10n/app_en.arb 文件。
• 写入文件内容。
• 在 pubspec.yaml 中添加 intl 和 flutter_localizations 依赖。

其他命令用法

l10n <flags> [arguments]
-h, --help                  打印此帮助信息。
-v, --verbose               显示额外的命令输出。
-s, --sort                  对 ARB 文件按字母顺序进行排序。
-u, --[no-]remove-unused    从 ARB 文件中删除未使用的翻译。
-i, --init                  初始化 l10n 工具。
    --version               打印工具版本。

使用校验功能

要在你的 Flutter 项目中使用 l10n_lint，请遵循以下步骤：

1. 打开项目的 pubspec.yaml 文件。
2. 将 l10n_lint 添加为开发依赖项：

dev_dependencies:
  flutter_lints: ^3.0.0
  custom_lint:
  l10n_lint:

1. 在 analysis_options.yaml 中添加：

include: package:flutter_lints/flutter.yaml

analyzer:
  plugins: 
    - custom_lint

待办事项

• ✅ 显示当运行 l10n unused 时删除的键的数量。
• ❌ 添加测试

完整示例 Demo

以下是一个完整的示例，展示了如何在 Flutter 项目中使用 l10n_lint 插件。

示例代码

import 'package:flutter/material.dart';

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    // no expect_lint: avoid_string_literals_inside_widget
    return const Text('硬编码字符串字面量将不支持本地化！');
  }
}