跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

flutter-sdk-changelog

Authoritative guide for Flutter framework APIs, widget lifecycle deprecations, design package unbundling, and version changelogs from Flutter 1.0 through Flutter 3.x+. Use this skill whenever authoring Flutter widgets, inspecting flutter sdk constraints, handling deprecated widgets (WillPopScope, withOpacity, MaterialState, FlatButton), migrating to standalone design libraries (material_ui, cupertino_ui), verifying widget API availability against the project's Flutter minSdk, or upgrading legacy Flutter applications.

RandalSchwartz · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add RandalSchwartz/dart-sdk-skills --skill flutter-sdk-changelog

技能说明


name: flutter-sdk-changelog description: >- Authoritative guide for Flutter framework APIs, widget lifecycle deprecations, design package unbundling, and version changelogs from Flutter 1.0 through Flutter 3.x+. Use this skill whenever authoring Flutter widgets, inspecting flutter sdk constraints, handling deprecated widgets (WillPopScope, withOpacity, MaterialState, FlatButton), migrating to standalone design libraries (material_ui, cupertino_ui), verifying widget API availability against the project's Flutter minSdk, or upgrading legacy Flutter applications.

Flutter SDK Changelog & Widget Migration Guide (Flutter 1.0 to Modern Flutter)

This skill provides an authoritative, structured reference for Flutter framework releases, widget deprecations, API replacements, Material 3 design migrations, the decoupling of standalone material_ui and cupertino_ui packages, and legacy Flutter codebase rescue runbooks.


🎯 Fast Flutter Widget & API Replacement Matrix

Deprecated / Obsolete APIIntroduced / Deprecated InModern ReplacementReference
Color.withOpacity(o)Deprecated in Flutter 3.22Color.withValues(alpha: o)Widget Deprecations
MaterialState / MaterialStatePropertyDeprecated in Flutter 3.22WidgetState / WidgetStatePropertyWidget Deprecations
WillPopScopeDeprecated in Flutter 3.12+PopScope(canPop: ..., onPopInvokedWithResult: ...)Widget Deprecations
FlatButton, RaisedButton, OutlineButtonDeprecated in Flutter 2.0TextButton, ElevatedButton, OutlinedButtonWidget Deprecations
TextTheme.headline1...6, bodyText1/2Deprecated in Flutter 3.7+displayLarge...small, bodyLarge/MediumWidget Deprecations
ThemeData.accentColorDeprecated in Flutter 2.5+ColorScheme.secondaryWidget Deprecations
Scaffold.of(context).showSnackBar()Deprecated in Flutter 2.0ScaffoldMessenger.of(context).showSnackBar()Widget Deprecations
package:flutter/material.dartMonolithic Flutter SDKpackage:material_ui/material_ui.dartMaterial & Cupertino Migration
package:flutter/cupertino.dartMonolithic Flutter SDKpackage:cupertino_ui/cupertino_ui.dartMaterial & Cupertino Migration
BottomNavigationBarLegacy M2 NavigationNavigationBar (Material 3)Material 3 Guide
ToggleButtonsLegacy M2 ToggleSegmentedButton<T> (Material 3)Material 3 Guide
PopupMenuButtonLegacy popup menuMenuAnchor / SubmenuButtonMaterial 3 Guide

⚡ Subskill Spotlights

Subskill: Standalone material_ui & cupertino_ui Package Migration

  • Decoupled Architecture: Transition from monolithic framework design libraries to standalone pub packages with independent release cadences.
  • Automated Fix: Run dart fix --apply --code=migrate_design_widgets to update imports and dependencies automatically.
  • Headless Core Support: Construct purely custom design systems directly against package:flutter/widgets.dart. 👉 Read the full Material & Cupertino UI Migration Guide.

Subskill: Widget Deprecations & Modernization

  • Predictive Back Navigation: Replace WillPopScope with PopScope for zero-stutter predictive back gestures on Android 14+ and iOS.
  • Wide-Gamut Colors: Replace withOpacity with withValues(alpha: ...) to eliminate 8-bit precision loss and color clipping.
  • Unified State Management: Replace MaterialState with universal WidgetState. 👉 Read the full Widget Deprecations & Replacements Guide.

Subskill: Material 2 to Material 3 Migration

  • Seed-Based Theming: Generate tonal palettes with ColorScheme.fromSeed(seedColor: ...).
  • Component Modernization: Migrate from BottomNavigationBar to NavigationBar, ToggleButtons to SegmentedButton, and M2 buttons to FilledButton. 👉 Read the full Material 2 to Material 3 Guide.

Subskill: Rescuing Legacy Flutter Apps (Flutter 1.x / 2.x to Modern 3.x)

  • 5-Phase Upgrade Pipeline: Baseline toolchain check → null safety bridge → widget deprecation fixes → Material 3 update → modern state & routing. 👉 Read the full Legacy Flutter App Rescue Runbook.

📚 Table of Contents & Reference Archive

DocumentFocus AreaDescription
material-ui-and-cupertino-ui-migration.mdPackage DecouplingComplete runbook for migrating from SDK-bundled material/cupertino to standalone material_ui and cupertino_ui.
flutter-to-dart-version-matrix.mdVersion MappingFull mapping of Flutter 1.0–3.27+ to bundled Dart SDKs and engine milestones.
widget-deprecations-and-replacements.mdWidget DictionaryBefore/After code snippets for all deprecated Flutter widgets and properties.
material-2-to-material-3-guide.mdUI & Th
阅读完整来源 ↗