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

> 當使用 `package:flutter_localizations` 時，預設產生的位置（最終也將是唯一可用的位置）會在你的原始碼（`lib/`）目錄內，而不是合成套件 `package:flutter_gen` 中。




:::important
這些重大變更文件在其發布的版本時是準確的。隨著時間推移，這裡描述的
因應措施可能會變得不準確。一般而言，我們不會在每個版本發布時同步更新這些重大變更文件。

[重大變更索引檔案](/release/breaking-changes)列出了每個版本所建立的文件。
:::


## 摘要

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

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

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

## 背景說明

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

## 遷移指南

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

```yaml
flutter:
  generate: true
```

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

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

```dart
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`：

    ```yaml title="l10n.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
    ```

 2. **更新 import**。更新你的 Dart import 陳述式，指向產生檔案的新位置：

    ```dart
    // Before
    import 'package:flutter_gen/gen_l10n/app_localizations.dart';

    // After (assuming arb-dir: lib/i18n, importing from lib/main.dart)
    import 'i18n/app_localizations.dart';
    ```

## 時程

Landed in version: 3.28.0-0.0.pre<br>
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][internationalization]，此功能的標準文件。

[`l10n.yaml`]: /ui/internationalization#configuring-the-l10n-yaml-file
[Issue 73870]: https://github.com/flutter/flutter/issues/73870
[Issue 102983]: https://github.com/flutter/flutter/issues/102983
[Issue 157819]: https://github.com/flutter/flutter/issues/157819
[internationalization]: /ui/internationalization#adding-your-own-localized-messages