本地化訊息將產生於原始碼中，而非合成套件中

flutter 工具將不再產生合成的 package:flutter_gen， 也不會修改應用程式的 package_config.json。

過去參考 package:flutter_gen 的應用程式或工具，應改為直接參考產生於應用程式原始碼目錄中的原始檔案。

此外，當使用產生的 l10n 原始碼時，現在必須指定 generate: true 屬性。

flutter_gen 是一個由 flutter 命令列工具建立的虛擬（合成）套件，讓開發者可以匯入該套件以存取產生的符號與功能，例如用於國際化。 由於該套件並未列在應用程式的 pubspec.yaml 中，且是透過重寫產生的 package_config.json 檔案來建立，因此產生了許多問題。

此變更僅影響在 pubspec.yaml 中包含以下項目的應用程式：

flutter:
  generate: true

如果您的應用程式先前在使用 gen-l10n 時沒有設定這個屬性，現在已經是必須的。

一個合成套件 (synthetic package，package:flutter_gen) 會被建立並由應用程式參考：

import 'package:flutter_gen/gen_l10n/app_localizations.dart';
// ...
const MaterialApp(
  title: 'Localizations Sample App',
  localizationsDelegates: AppLocalizations.localizationsDelegates,
  supportedLocales: AppLocalizations.supportedLocales,
);

有一種方式可以遷移，不再匯入 package:flutter_gen：

1. 在對應的 l10n.yaml 檔案中指定 synthetic-package: false：

   l10n.yaml

   yaml

   synthetic-package: false
   ​
   # The files are generated into the path specified by `arb-dir`
   arb-dir: lib/i18n
   ​
   # Or, specifically provide an output path:
   output-dir: lib/src/generated/i18n
   

   content_copy

Landed in version: 3.28.0-0.0.pre
Stable release: 3.32.0

在此變更納入後的下一個穩定版本中，將移除 package:flutter_gen 的支援。

相關議題：

• Issue 73870，首次發現 package:flutter_gen pub 問題。
• Issue 102983，說明了 package:flutter_gen 的問題。
• Issue 157819，討論了 --implicit-pubspec-resolution。

相關文章：

• Internationalizing Flutter apps，此功能的標準文件。