菜单
Use when bumping the flutter_helper_utils package version in a project or auditing an upgrade's impact - detecting the installed version, sequencing migration hops across v7/v8/v8.5/v9, patch-level 9.x bumps, or answering "is it safe to upgrade flutter_helper_utils".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when upgrading a Flutter project from flutter_helper_utils 8.x (or 7.x) to 9.x, or when code hits removed v8 APIs after a version bump - notifier utilities gone, addOpacity/addAlpha undefined, pReplacement/pNamed undefined, dataWhen undefined, core.dart/colors.dart/widgets.dart imports failing, or dart_helper_utils v6 conflicts.
Use when building responsive/adaptive Flutter layouts or list UIs with the flutter_helper_utils package - PlatformTypeProvider setup, Breakpoint detection (watchBreakpoint/readBreakpoint, mobile/tablet/desktop), BreakpointLayoutBuilder, TypedListView/TypedSliverList, buildListView on iterables, pull-to-refresh, infinite scroll (onEndReached), item spacing/separators, empty states, or scrollCacheExtent tuning.
Use when Flutter code parses, converts, or manipulates colors with the flutter_helper_utils package - string-to-Color parsing (hex/rgb/hsl/hwb/named CSS), opacity and channel changes (setOpacity, setAlpha), darken/lighten/shade/tint, WCAG contrast and accessibility checks, color-blindness simulation, color harmonies, toHex output, or reading Colors from JSON/Map config (toColor, tryGetColor).
Use when writing or reviewing Flutter code that uses the flutter_helper_utils package - BuildContext theme/text/colorScheme getters, MediaQuery shortcuts (sizePx, widthPx, textScaler), navigation helpers (pushPage, popPage, forcePopPage, dismissAllPopups, routeArgs), platform detection (PlatformEnv, isMobileWeb), AsyncSnapshot.when pattern matching, focus/scaffold-messenger/directionality helpers, num/Size sugar, or deciding between the main import and sugar.dart.
| name | upgrade-flutter-helper-utils |
| description | Use when bumping the flutter_helper_utils package version in a project or auditing an upgrade's impact - detecting the installed version, sequencing migration hops across v7/v8/v8.5/v9, patch-level 9.x bumps, or answering "is it safe to upgrade flutter_helper_utils". |
Version-aware audit. Determine the CURRENT resolved version first, apply only the hops that cross it, and verify with the project's own tests.
grep -n "flutter_helper_utils" pubspec.yaml # declared constraint
grep -A2 " flutter_helper_utils:" pubspec.lock # resolved version
If the resolved version already equals the target: report "no migration needed" and stop (do not invent work).
| From | To | Size | What changes |
|---|---|---|---|
| 7.x | 8.0 | medium | SingleAxisWrap extracted to the single_axis_wrap package (param renames: preferredDirection to primaryDirection, MainAxisAlignment to WrapAlignment, per-axis params collapsed - table in the repo's migration_guides.md); dart_helper_utils jumped to v5 (Object conversion helpers removed, addOrRemoveYears to addOrSubtractYears) |
| 8.0-8.4 | 8.5 | small | TypedListView.itemBuilder became (context, index, item); headerBuilder/footerBuilder became header/footer widget slots; new spacing, emptyBuilder, showScrollbar, onEndReached, itemKeyBuilder |
| 8.x | 9.x | LARGE | use the dedicated migrate-flutter-helper-utils-v8-to-v9 skill (notifier extraction, color add* to set*, navigation renames, dataWhen to when, dart_helper_utils v6 cascade) |
| 9.0 | 9.1 | none | additive: scrollCacheExtent (ScrollCacheExtent.pixels/.viewport); numeric cacheExtent deprecated but still works |
| 9.1 | 9.2 | none | additive: popPage/forcePopPage; maybePopPage deprecated (rename now, removal planned v10) |
| 9.2.x | 9.2.y | none | patch releases are docs/tooling unless the CHANGELOG says otherwise - read it first |
Shortcut when crossing several majors: pre-8.5 TypedListView call sites
can be rewritten once, directly to the current signature. Versions below
7.x predate the repo's migration guides - diff against the pub.dev
CHANGELOG (https://pub.dev/packages/flutter_helper_utils/changelog) and
treat every "Breaking" bullet as its own hop.
flutter pub get (or
flutter pub upgrade flutter_helper_utils).flutter analyze and run the full test suite; compare failures against
the pre-upgrade baseline (record it first).>=3.11.0, Flutter >=3.41.0, and
dart_helper_utils ^6; a direct dependency pinning dart_helper_utils <6
(or an old SDK) blocks resolution.