Flutter 3.41 is live! Check out theFlutter 3.41 blog post!
MouseTracker moved to rendering
MouseTracker and related symbols moved to the rendering package.
These breaking change docs are accurate, as of the release under which they are published. Over time, the workarounds described here might become inaccurate. We don't, in general, keep these breaking change docs up to date as of each release.
Thebreaking change index file lists the docs created for each release.
Summary
#MouseTracker and related symbols are moved from thegestures package, resulting in error messages such as undefined classes or methods. Import them fromrendering package instead.
Context
# Prior to this changeMouseTracker was part of thegestures package. This brought troubles when we found out that code related toMouseTracker often wanted to import from therendering package.
SinceMouseTracker turned out to be more connected torendering thangestures, we have moved it and its related code torendering.
Description of change
# The filemouse_tracking.dart has been moved from thegestures package torendering. All symbols in the said file have been moved without keeping backward compatibility.
Migration guide
#If you see error of "Undefined class" or "Undefined name" of the following symbols:
MouseDetectorAnnotationFinderMouseTrackerMouseTrackerAnnotationPointerEnterEventListenerPointerExitEventListenerPointerHoverEventListener
You should add the following import:
import'package:flutter/rendering.dart';Timeline
# Landed in version: 1.16.3
In stable release: 1.17
References
#API documentation:
MouseDetectorAnnotationFinderMouseTrackerMouseTrackerAnnotationPointerEnterEventListenerPointerExitEventListenerPointerHoverEventListener
Relevant issues:
Relevant PR:
Unless stated otherwise, the documentation on this site reflects Flutter 3.38.6. Page last updated on 2025-10-30.View source orreport an issue.