leak_detector
flutter Memory leak detection tool
Usage
initialize
In order to prevent the underlying library vm service from crashing, please call before adding the memory leak detection object:
LeakDetector().init(maxRetainingPath: 300); //maxRetainingPath default is 300
Enabling leak detection will reduce performance, and Full GC may drop frames on the page. Initialized by assert in the plugin, so you don't need to turn it off when build on release mode.
Detect
Add LeakNavigatorObserver to navigatorObservers in MaterialApp, it will automatically detect whether there is a memory leak in the page's Widget and its corresponding Element object. If page's Widget is a StatefulWidget, it will also be automatically checked Its corresponding State.
import 'package:leak_detector/leak_detector.dart';
@override
Widget build(BuildContext context) {
return MaterialApp(
navigatorObservers: [
//used the LeakNavigatorObserver
LeakNavigatorObserver(
shouldCheck: (route) {
return route.settings.name != null && route.settings.name != '/';
},
),
],
);
}
Get leaked information
LeakDetector().onLeakedStream can register your listener, and notify the object's reference chain after detecting a memory leak. LeakDetector().onEventStream can monitor internal time notifications, such as start Gc, end Gc, etc.
A preview page of the reference chain is provided. You only need to add the following code. Note that the Bulid Context must be able to obtain theNavigatorState:
import 'package:leak_detector/leak_detector.dart';
//show preview page
LeakDetector().onLeakedStream.listen((LeakedInfo info) {
//print to console
info.retainingPath.forEach((node) => print(node));
//show preview page
showLeakedInfoPage(navigatorKey.currentContext, info);
});
Preview page display:
It contains the class information of the reference chain node, the referenced attribute information, the source code of the attribute declaration, and the location of the source code (line number: column number).
Get memory leak recording
import 'package:leak_detector/leak_detector.dart';
getLeakedRecording().then((List<LeakedInfo> infoList) {
showLeakedInfoListPage(navigatorKey.currentContext, infoList);
});
*Cannot connect to vm_service on real mobile devices
The VM service allows for an extended feature set via the Dart Development Service (DDS) that forward all core VM service RPCs described in this document to the true VM service.
So when we connect to the computer to run, the DDS on the computer will first connect to the vm_service on our mobile end, causing our leak_detector plugin to fail to connect to the vm_service again.
There are two solutions:
-
After the
runis complete, disconnect from the computer, and then it is best to restart the app.If the completed test package is installed on the mobile phone, the above problem does not exist, so this method is suitable for use by testers.
-
Add the
--disable-ddsparameter afterflutter runto turn off theDDS. After testing, this will not cause any impact on debuggingIt can be configured as follows in
Android Studio.
1.7k Dec 28, 2022
3.2k Jan 8, 2023
268 Jan 1, 2023
7.4k Jan 2, 2023
12 Oct 24, 2022
1.8k Dec 30, 2022
7 Nov 2, 2022
35 Oct 22, 2022
356 Dec 16, 2022
3.5k Jan 4, 2023
1k Jan 7, 2023
278 Dec 12, 2022
86 Dec 2, 2022
88 Oct 28, 2022
1.1k Jan 6, 2023
49 Oct 12, 2022
37 Jul 10, 2022
9 Nov 7, 2022
19 Oct 12, 2022