v3.13 之後移除的已棄用 API

根據 Flutter 的 棄用政策， 在 3.13 穩定版發佈後達到生命週期終止的 已棄用 API 已被移除。

所有受影響的 API 已彙整於此主要來源， 以協助您進行遷移。 為了進一步協助您的遷移，請參考這份 快速參考表。

本節依套件與受影響的類別列出棄用項目。

套件：flutter 支援 Flutter Fix：是

以下類別的 useDeleteButtonTooltip 屬性自 v2.10 起已被棄用：

• DeletableChipAttributes
• Chip
• RawChip
• InputChip

deleteButtonTooltipMessage 取代了 useDeleteButtonTooltip。這項變更簡化了 API， 因為對 deleteButtonTooltipMessage 提供空字串，效果等同於將原本的 useDeleteButtonTooltip 屬性設為 false。 當 deleteButtonTooltipMessage 未設定時，預設會使用 MaterialLocalizations.deleteButtonTooltip。

Chips 棄用 useDeleteButtonTooltip 設計文件 更詳細說明了此 chips 與提示工具（tooltips）的更新內容。 如需進一步了解，請參閱 chips 與 tooltips 遷移指南。

遷移指南

遷移前的程式碼：

Chip(useDeleteButtonTooltip: false);
InputChip(useDeleteButtonTooltip: true);
RawChip rawChip = RawChip();
rawChip.useDeleteButtonTooltip;

遷移後的程式碼：

Chip(deleteButtonTooltipMessage: '');
InputChip();
RawChip rawChip = RawChip();
rawChip.deleteButtonTooltipMessage;

參考資料

API 文件：

• DeletableChipAttributes
• Chip
• RawChip
• InputChip
• MaterialLocalizations.deleteButtonTooltip

相關 PR：

• 在 #96174 中標記為已棄用（Deprecated）
• 在 #134486 中移除

套件：flutter Flutter Fix 支援：否

MaterialButtonWithIconMixin 屬性自 v2.11 起已被標記為已棄用（Deprecated）。

隨著新按鈕類別 TextButton、OutlinedButton 和 ElevatedButton 的推出，這個 mixin 已不再被使用。 更早的版本已經移除了使用此 mixin 的舊按鈕類別。 因此，這個 mixin 現在已不會影響任何可能混入它的類別。

遷移指南

遷移前的程式碼：

class MyButtonClass extends StatelessWidget with MaterialButtonWithIconMixin {
  // ...
}

遷移後的程式碼：

class MyButtonClass extends StatelessWidget {
  // ...
}

參考資料

相關 PR：

• 在 #99088 中標記為已棄用（Deprecated）
• 在 #133173 中移除

套件：flutter Flutter Fix 支援：否

PlatformsViewsService 的靜態方法 synchronizeToNativeViewHierarchy 自 v2.11 起已被標記為已棄用（Deprecated）。

在棄用期間，此方法變為無操作（no-op）函式，因為已不再需要呼叫此方法來提升效能。 應移除對該方法的引用，這不會影響應用程式的運作。

遷移指南

遷移前的程式碼：

await PlatformsViewsService.synchronizeToNativeViewHierarchy(false);

遷移後的程式碼：

參考資料

API 文件：

• PlatformViewsService

相關 PR：

• 在 #100990 中標記為已棄用（Deprecated）
• 在 #133175 中移除

套件：flutter 支援 Flutter Fix：是

TextSelectionOverlay 的靜態 fadeDuration 屬性已於 v2.12 標記為已棄用（Deprecated）。

SelectionOverlay.fadeDuration 屬性取代了 TextSelectionOverlay.fadeDuration。 隨著 TextSelectionOverlay 的重構，SelectionOverlay 被新增為一個更通用的元件 (Widget)， 不再特別依賴於 RenderEditable。

遷移指南

遷移前的程式碼：

TextSelectionOverlay.fadeDuration;

遷移後的程式碼：

SelectionOverlay.fadeDuration;

參考資料

API 文件：

• TextSelectionOverlay
• SelectionOverlay

相關 PR：

• 在 #100381 中標記為已棄用（Deprecated）
• 在 #134485 中移除

套件：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 指示器的外觀。

遷移指南

遷移前的程式碼：

MaterialApp(
  scrollBehavior: MaterialScrollBehavior(
    androidOverscrollIndicator: AndroidOverscrollIndicator.glow,
  ),
  //...
);
​
MaterialApp(
  scrollBehavior: ScrollBehavior(
    androidOverscrollIndicator: AndroidOverscrollIndicator.glow,
  ),
  //...
);
​
MaterialApp(
  theme: Theme.light().copyWith(
    androidOverscrollIndicator: AndroidOverscrollIndicator.glow,
  ),
  //...
);

遷移後的程式碼：

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 中移除

套件：flutter Flutter Fix 支援：否

PaintingBinding 的 instantiateImageCodec 方法，以及 ImageProvider 的 load 方法與相關的 DecoderCallback，皆於 v2.13 被標記為已棄用。

對應的替代方法如下：

此變更透過使用緩衝區（buffer）提升了圖片載入的效能。

遷移指南

遷移前的程式碼：

PaintingBinding.instance.instantiateImageCodec

遷移後的程式碼：

PaintingBinding.instance.instantiateImageCodecFromBuffer

參考資料

API 文件：

• PaintingBinding
• ImageProvider
• DecoderBufferCallback

相關 PR：

• 在 #103496 中標記為已棄用（Deprecated）
• 在 #132679 中移除

套件：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 遷移指南。

遷移指南

遷移前的程式碼：

testWidgets('My test', (WidgetTester tester) async {
  // For all instances, replace window with platformDispatcher
  tester.binding.window.textScaleFactorTestValue = 42;
  addTearDown(tester.binding.window.clearTextScaleFactorTestValue);
  // ...
});

遷移後的程式碼：

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 中移除

於正式版本 3.16 推出