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 API | Introduced / Deprecated In | Modern Replacement | Reference |
|---|---|---|---|
Color.withOpacity(o) | Deprecated in Flutter 3.22 | Color.withValues(alpha: o) | Widget Deprecations |
MaterialState / MaterialStateProperty | Deprecated in Flutter 3.22 | WidgetState / WidgetStateProperty | Widget Deprecations |
WillPopScope | Deprecated in Flutter 3.12+ | PopScope(canPop: ..., onPopInvokedWithResult: ...) | Widget Deprecations |
FlatButton, RaisedButton, OutlineButton | Deprecated in Flutter 2.0 | TextButton, ElevatedButton, OutlinedButton | Widget Deprecations |
TextTheme.headline1...6, bodyText1/2 | Deprecated in Flutter 3.7+ | displayLarge...small, bodyLarge/Medium | Widget Deprecations |
ThemeData.accentColor | Deprecated in Flutter 2.5+ | ColorScheme.secondary | Widget Deprecations |
Scaffold.of(context).showSnackBar() | Deprecated in Flutter 2.0 | ScaffoldMessenger.of(context).showSnackBar() | Widget Deprecations |
package:flutter/material.dart | Monolithic Flutter SDK | package:material_ui/material_ui.dart | Material & Cupertino Migration |
package:flutter/cupertino.dart | Monolithic Flutter SDK | package:cupertino_ui/cupertino_ui.dart | Material & Cupertino Migration |
BottomNavigationBar | Legacy M2 Navigation | NavigationBar (Material 3) | Material 3 Guide |
ToggleButtons | Legacy M2 Toggle | SegmentedButton<T> (Material 3) | Material 3 Guide |
PopupMenuButton | Legacy popup menu | MenuAnchor / SubmenuButton | Material 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_widgetsto 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
WillPopScopewithPopScopefor zero-stutter predictive back gestures on Android 14+ and iOS. - Wide-Gamut Colors: Replace
withOpacitywithwithValues(alpha: ...)to eliminate 8-bit precision loss and color clipping. - Unified State Management: Replace
MaterialStatewith universalWidgetState. 👉 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
BottomNavigationBartoNavigationBar,ToggleButtonstoSegmentedButton, and M2 buttons toFilledButton. 👉 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
| Document | Focus Area | Description |
|---|---|---|
material-ui-and-cupertino-ui-migration.md | Package Decoupling | Complete runbook for migrating from SDK-bundled material/cupertino to standalone material_ui and cupertino_ui. |
flutter-to-dart-version-matrix.md | Version Mapping | Full mapping of Flutter 1.0–3.27+ to bundled Dart SDKs and engine milestones. |
widget-deprecations-and-replacements.md | Widget Dictionary | Before/After code snippets for all deprecated Flutter widgets and properties. |
material-2-to-material-3-guide.md | UI & Th |