# v3.13 之後移除的已棄用 API > 在達到生命週期終止後，以下已棄用的 API 已從 Flutter 中移除。 ## 摘要 根據 Flutter 的 [棄用政策][Deprecation Policy]， 在 3.13 穩定版發佈後達到生命週期終止的 已棄用 API 已被移除。 所有受影響的 API 已彙整於此主要來源， 以協助您進行遷移。 為了進一步協助您的遷移，請參考這份 [快速參考表][quick reference sheet]。 [Deprecation Policy]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#deprecations [quick reference sheet]: /go/deprecations-removed-after-3-13 ## 變更內容 本節依套件與受影響的類別列出棄用項目。 ### Chip 類別的 useDeleteButtonTooltip 套件：flutter 支援 Flutter Fix：是 以下類別的 `useDeleteButtonTooltip` 屬性自 v2.10 起已被棄用： * `DeletableChipAttributes` * `Chip` * `RawChip` * `InputChip` `deleteButtonTooltipMessage` 取代了 `useDeleteButtonTooltip`。這項變更簡化了 API， 因為對 `deleteButtonTooltipMessage` 提供空字串，效果等同於將原本的 `useDeleteButtonTooltip` 屬性設為 false。 當 `deleteButtonTooltipMessage` 未設定時，預設會使用 `MaterialLocalizations.deleteButtonTooltip`。 [Chips 棄用 `useDeleteButtonTooltip`][Deprecate `useDeleteButtonTooltip` for Chips] 設計文件 更詳細說明了此 chips 與提示工具（tooltips）的更新內容。 如需進一步了解，請參閱 [chips 與 tooltips 遷移指南][chips and tooltips migration guide]。 [Deprecate `useDeleteButtonTooltip` for Chips]: https://docs.google.com/document/d/1wc9ot7T2E7hJubYxEWMX230a79wYSiFey4BHxnEzHtw/edit?usp=sharing&resourcekey=0-Bo7KPqEtkWgZcSuRCqwQ5w [chips and tooltips migration guide]: /release/breaking-changes/chip-usedeletebuttontooltip-migration **遷移指南** 遷移前的程式碼： ```dart Chip(useDeleteButtonTooltip: false); InputChip(useDeleteButtonTooltip: true); RawChip rawChip = RawChip(); rawChip.useDeleteButtonTooltip; ``` 遷移後的程式碼： ```dart Chip(deleteButtonTooltipMessage: ''); InputChip(); RawChip rawChip = RawChip(); rawChip.deleteButtonTooltipMessage; ``` **參考資料** API 文件： * [`DeletableChipAttributes`][] * [`Chip`][] * [`RawChip`][] * [`InputChip`][] * [`MaterialLocalizations.deleteButtonTooltip`][] 相關 PR： * 在 [#96174][] 中標記為已棄用（Deprecated） * 在 [#134486][] 中移除 [`DeletableChipAttributes`]: https://pub.dev/documentation/material_ui/latest/material_ui/DeletableChipAttributes-class.html [`Chip`]: https://pub.dev/documentation/material_ui/latest/material_ui/Chip-class.html [`RawChip`]: https://pub.dev/documentation/material_ui/latest/material_ui/RawChip-class.html [`InputChip`]: https://pub.dev/documentation/material_ui/latest/material_ui/InputChip-class.html [`MaterialLocalizations.deleteButtonTooltip`]: https://pub.dev/documentation/material_ui/latest/material_ui/MaterialLocalizations/deleteButtonTooltip.html [#96174]: https://github.com/flutter/flutter/pull/96174 [#134486]: https://github.com/flutter/flutter/pull/134486 --- ### MaterialButtonWithIconMixin 套件：flutter Flutter Fix 支援：否 `MaterialButtonWithIconMixin` 屬性自 v2.11 起已被標記為已棄用（Deprecated）。 隨著新按鈕類別 `TextButton`、`OutlinedButton` 和 `ElevatedButton` 的推出，這個 mixin 已不再被使用。 更早的版本已經移除了使用此 mixin 的舊按鈕類別。 因此，這個 mixin 現在已不會影響任何可能混入它的類別。 **遷移指南** 遷移前的程式碼： ```dart class MyButtonClass extends StatelessWidget with MaterialButtonWithIconMixin { // ... } ``` 遷移後的程式碼： ```dart class MyButtonClass extends StatelessWidget { // ... } ``` **參考資料** 相關 PR： * 在 [#99088][] 中標記為已棄用（Deprecated） * 在 [#133173][] 中移除 [#99088]: https://github.com/flutter/flutter/pull/99088 [#133173]: https://github.com/flutter/flutter/pull/133173 --- ### PlatformsViewsService.synchronizeToNativeViewHierarchy 套件：flutter Flutter Fix 支援：否 `PlatformsViewsService` 的靜態方法 `synchronizeToNativeViewHierarchy` 自 v2.11 起已被標記為已棄用（Deprecated）。 在棄用期間，此方法變為無操作（no-op）函式，因為已不再需要呼叫此方法來提升效能。 應移除對該方法的引用，這不會影響應用程式的運作。 **遷移指南** 遷移前的程式碼： ```dart await PlatformsViewsService.synchronizeToNativeViewHierarchy(false); ```` 遷移後的程式碼： ```dart ``` **參考資料** API 文件： * [`PlatformViewsService`][] 相關 PR： * 在 [#100990][] 中標記為已棄用（Deprecated） * 在 [#133175][] 中移除 [`PlatformViewsService`]: https://api.flutter.dev/flutter/services/PlatformViewsService-class.html [#100990]: https://github.com/flutter/flutter/pull/100990 [#133175]: https://github.com/flutter/flutter/pull/133175 --- ### TextSelectionOverlay.fadeDuration 套件：flutter 支援 Flutter Fix：是 `TextSelectionOverlay` 的靜態 `fadeDuration` 屬性已於 v2.12 標記為已棄用（Deprecated）。 `SelectionOverlay.fadeDuration` 屬性取代了 `TextSelectionOverlay.fadeDuration`。 隨著 `TextSelectionOverlay` 的重構，`SelectionOverlay` 被新增為一個更通用的元件 (Widget)， 不再特別依賴於 `RenderEditable`。 **遷移指南** 遷移前的程式碼： ```dart TextSelectionOverlay.fadeDuration; ``` 遷移後的程式碼： ```dart SelectionOverlay.fadeDuration; ``` **參考資料** API 文件： * [`TextSelectionOverlay`][] * [`SelectionOverlay`][] 相關 PR： * 在 [#100381][] 中標記為已棄用（Deprecated） * 在 [#134485][] 中移除 [`TextSelectionOverlay`]: https://api.flutter.dev/flutter/widgets/TextSelectionOverlay-class.html [`SelectionOverlay`]: https://api.flutter.dev/flutter/widgets/SelectionOverlay-class.html [#100381]: https://github.com/flutter/flutter/pull/100381 [#134485]: https://github.com/flutter/flutter/pull/134485 --- ### androidOverscrollIndicator 套件：flutter Flutter Fix 支援：否 以下類別的 `androidOverscrollIndicator` 屬性自 v2.13 起已被標記為已棄用（Deprecated）： * `ScrollBehavior` * `MaterialScrollBehavior` * `ThemeData` 此旗標最初是為了讓使用者能夠設定捲動元件 (Widget) 使用 `GlowingOverscrollIndicator` 或 `StretchingOvercrollIndicator`。 隨著框架對 Material 3 風格元件的支援度提升，該屬性已建議改用 `ThemeData.useMaterial3` 旗標。 由於 `ThemeData.useMaterial3` 預設為 `true`， 因此預設會套用 `StretchingOverscrollIndicator`。 若將此值設為 `false`，則會改為套用 `GlowingOverscrollIndicator`。 另外，也可以覆寫 `ScrollBehavior` 或 `MaterialScrollBehavior` 的 `buildOverscrollIndicator` 方法，以進一步自訂 Overscroll 指示器的外觀。 **遷移指南** 遷移前的程式碼： ```dart MaterialApp( scrollBehavior: MaterialScrollBehavior( androidOverscrollIndicator: AndroidOverscrollIndicator.glow, ), //... ); MaterialApp( scrollBehavior: ScrollBehavior( androidOverscrollIndicator: AndroidOverscrollIndicator.glow, ), //... ); MaterialApp( theme: Theme.light().copyWith( androidOverscrollIndicator: AndroidOverscrollIndicator.glow, ), //... ); ``` 遷移後的程式碼： ```dart MaterialApp( theme: Theme.light().copyWith( // defaults to true and stretching indicator, // false results in glowing indicator useMaterial3: false, ), //... ); ``` **參考資料** API 文件： * [`ScrollBehavior`][] * [`MaterialScrollBehavior`][] * [`ThemeData`][] * [`GlowingOverscrollIndicator`][] * [`StretchingOverscrollIndicator`][] 相關 PR： * 在 [#100234][] 中標記為已棄用 * 在 [#133181][] 中移除 [`ScrollBehavior`]: https://api.flutter.dev/flutter/widgets/ScrollBehavior-class.html [`MaterialScrollBehavior`]: https://pub.dev/documentation/material_ui/latest/material_ui/MaterialScrollBehavior-class.html [`ThemeData`]: https://pub.dev/documentation/material_ui/latest/material_ui/ThemeData-class.html [`GlowingOverscrollIndicator`]: https://api.flutter.dev/flutter/widgets/GlowingOverscrollIndicator-class.html [`StretchingOverscrollIndicator`]: https://api.flutter.dev/flutter/widgets/StretchingOverscrollIndicator-class.html [#100234]: https://github.com/flutter/flutter/pull/100234 [#133181]: https://github.com/flutter/flutter/pull/133181 --- ### ImageProvider 與 PaintingBinding 的更新 套件：flutter Flutter Fix 支援：否 `PaintingBinding` 的 `instantiateImageCodec` 方法，以及 `ImageProvider` 的 `load` 方法與相關的 `DecoderCallback`，皆於 v2.13 被標記為已棄用。 對應的替代方法如下： | 已棄用方法 | 目前方法 | |-----------------------------------------|---------------------------------------------------| | `PaintingBinding.instantiateImageCodec` | `PaintingBinding.instantiateImageCodecFromBuffer` | | `ImageProvider.load` | `ImageProvider.loadBuffer` | | `DecoderCallback` | `DecoderBufferCallback` | 此變更透過使用緩衝區（buffer）提升了圖片載入的效能。 **遷移指南** 遷移前的程式碼： ```dart PaintingBinding.instance.instantiateImageCodec ``` 遷移後的程式碼： ```dart PaintingBinding.instance.instantiateImageCodecFromBuffer ``` **參考資料** API 文件： * [`PaintingBinding`][] * [`ImageProvider`][] * [`DecoderBufferCallback`][] 相關 PR： * 在 [#103496][] 中標記為已棄用（Deprecated） * 在 [#132679][] 中移除 [`PaintingBinding`]: https://api.flutter.dev/flutter/painting/PaintingBinding-mixin.html [`ImageProvider`]: https://api.flutter.dev/flutter/painting/ImageProvider-class.html [`DecoderBufferCallback`]: https://api.flutter.dev/flutter/painting/DecoderBufferCallback.html [#103496]: https://github.com/flutter/flutter/pull/103496 [#132679]: https://github.com/flutter/flutter/pull/132679 --- ### TestWindow 屬性 套件：flutter_test Flutter Fix 支援：否 為了支援多視窗（multi-window）， 許多 `TestWindow` 已棄用的屬性已被移除。 雖然 `TestWindow` 已標記為棄用，但目前尚未符合移除條件。 現在遷移這些已過期的屬性，將有助於日後從 `TestWindow` 遷移。 以下屬性已被移除： * `localeTestValue` * `clearLocaleTestValue` * `localesTestValue` * `clearLocalesTestValue` * `initialLifecycleStateTestValue` * `textScaleFactorTestValue` * `clearTextScaleFactorTestValue` * `platformBrightnessTestValue` * `clearPlatformBrightnessTestValue` * `alwaysUse24HourFormatTestValue` * `clearAlwaysUse24HourTestValue` * `brieflyShowPasswordTestValue` * `defaultRouteNameTestValue` * `clearDefaultRouteNameTestValue` * `semanticsEnabledTestValue` * `clearSemanticsEnabledTestValue` * `accessibilityFeaturesTestValue` * `clearAccessibilityFeaturesTestValue` 若想進一步了解本次 `TestWindow` 更新，請參閱 [`TestWindow` 遷移指南][`TestWindow` migration guide]。 [`TestWindow` migration guide]: /release/breaking-changes/window-singleton **遷移指南** 遷移前的程式碼： ```dart testWidgets('My test', (WidgetTester tester) async { // For all instances, replace window with platformDispatcher tester.binding.window.textScaleFactorTestValue = 42; addTearDown(tester.binding.window.clearTextScaleFactorTestValue); // ... }); ``` 遷移後的程式碼： ```dart testWidgets('My test', (WidgetTester tester) async { // For all instances, replace window with platformDispatcher tester.binding.platformDispatcher.textScaleFactorTestValue = 42; addTearDown(tester.binding.platformDispatcher.clearTextScaleFactorTestValue); // ... }); ``` **參考資料** API 文件： * [`WidgetTester`][] * [`TestWidgetsFlutterBinding`][] * [`TestPlatformDispatcher`][] 相關 PR： * 在 [#99443][] 中標記為已棄用 * 在 [#131098][] 中移除 [`WidgetTester`]: https://api.flutter.dev/flutter/flutter_test/WidgetTester-class.html [`TestWidgetsFlutterBinding`]: https://api.flutter.dev/flutter/flutter_test/TestWidgetsFlutterBinding-class.html [`TestPlatformDispatcher`]: https://api.flutter.dev/flutter/flutter_test/TestPlatformDispatcher-class.html [#99443]: https://github.com/flutter/flutter/pull/99443 [#131098]: https://github.com/flutter/flutter/pull/131098 --- ## 時程 於正式版本 3.16 推出