升级Flutter至3.10后Gesture Detectors相关构建问题求助

以下是针对你遇到的Flutter 3.7升3.10后手势检测器构建报错的具体解决步骤：

1. 核对手势回调参数类型 #

Flutter 3.10对TextSelectionGestureDetector的部分手势回调参数类型做了细分调整，核心变化集中在ForcePress相关回调：

• 原onForcePressStart接收的ForcePressDetails参数，现在需要替换为ForcePressStartDetails
• 原onForcePressEnd接收的ForcePressDetails参数，现在需要替换为ForcePressEndDetails

检查你代码中对应的onForcePressStart、onForcePressEnd方法签名，修改为匹配新类型的参数：

// 修改前
void onForcePressStart(ForcePressDetails details) {
  // 原有逻辑
}

// 修改后
void onForcePressStart(ForcePressStartDetails details) {
  // 原有逻辑
}

2. 使用官方Builder类适配最新API #

Flutter 3.10推荐使用TextSelectionGestureDetectorBuilder来构建文本选择手势检测器，它会自动处理回调签名的适配，避免手动绑定的错误。修改你的buildGestureDetector方法：

// 先初始化Builder（可在类中声明）
final TextSelectionGestureDetectorBuilder _gestureBuilder = TextSelectionGestureDetectorBuilder(delegate: delegate);

TextSelectionGestureDetector buildGestureDetector({
    Key? key,
    HitTestBehavior? behavior,
    required Widget child,
  }) =>
      TextSelectionGestureDetector(
        key: key,
        onTapDown: _gestureBuilder.onTapDown,
        onForcePressStart: delegate.forcePressEnabled ? _gestureBuilder.onForcePressStart : null,
        onForcePressEnd: delegate.forcePressEnabled ? _gestureBuilder.onForcePressEnd : null,
        onSingleTapUp: _gestureBuilder.onSingleTapUp,
        onSingleTapCancel: _gestureBuilder.onSingleTapCancel,
        onSingleLongTapStart: _gestureBuilder.onSingleLongTapStart,
        onSingleLongTapMoveUpdate: _gestureBuilder.onSingleLongTapMoveUpdate,
        onSingleLongTapEnd: _gestureBuilder.onSingleLongTapEnd,
        onDoubleTapDown: _gestureBuilder.onDoubleTapDown,
        onDragSelectionStart: _gestureBuilder.onDragSelectionStart,
        onDragSelectionUpdate: _gestureBuilder.onDragSelectionUpdate,
        onDragSelectionEnd: _gestureBuilder.onDragSelectionEnd,
        behavior: behavior,
        child: child,
      );

3. 排查第三方依赖问题 #

如果报错代码来自第三方依赖包，按以下方式处理：

• 优先升级该依赖包到支持Flutter 3.10的最新版本，查看包的CHANGELOG确认是否修复了兼容问题
• 若无适配版本，可手动修改依赖包代码（参考你之前修复accentColor的方式）：调整手势回调的参数类型，或替换为TextSelectionGestureDetectorBuilder的使用方式

4. 彻底清理缓存后重建 #

执行以下命令确保缓存完全更新：

flutter clean
flutter pub get

之后重启IDE再尝试构建项目。

内容的提问来源于stack exchange，提问作者Jason Wandby