DEV/flutter_flutter
1
0
Fork 0
mirror of https://github.com/flutter/flutter.git synced 2026-02-20 02:29:02 +08:00
Code Issues Packages Projects Releases Wiki Activity

Update "Frame Capture with RenderDoc" docs with instructions for Android (#178138)

Browse Source 
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
This commit is contained in:
b-luk 2025-11-10 12:48:01 -08:00 committed by GitHub
parent 24cf2a32c5
commit 357729910a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 26 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
docs/engine/impeller/docs/renderdoc_frame_capture.md
View File

@ -47,6 +47,31 @@
![Renderdoc Capture](https://raw.githubusercontent.com/flutter/assets-for-api-docs//5da33067f5cfc7f177d9c460d618397aad9082ca/assets/engine/impeller/renderdoc_frame_capture/render-doc-capture.avif)
_See also:_
## RenderDoc on Android
RenderDoc can be used on a debug-mode Flutter app running on Android.
1. First use `flutter run` to build and install the debug-mode app apk onto the Android device.
- The app can use the default engine
or it can [use a local engine](https://github.com/flutter/flutter/blob/main/docs/engine/Debugging-the-engine.md#running-a-flutter-app-with-a-local-engine).
- To debug an app with Impeller explicitly enabled or disabled,
specify an `EnableImpeller` value in your `AndroidManifest.xml` as described
[here](https://github.com/flutter/flutter/blob/main/engine/src/flutter/impeller/README.md#android).
- **Note**: Any `--(no-)enable-impeller` flag used with `flutter run` will not be retained when the app is launched from RenderDoc.
2. Follow the RenderDoc [Android How To](https://renderdoc.org/docs/how/how_android_capture.html)
to connect RenderDoc to your Android device and select your app to debug.
- Click the `...` button at the end of the "Executable Path" input field
to choose from available installed app packages on the device.
3. Click "Launch".
If everything is working, the app should begin running on your device.
Capturing frames works in exactly the same way as described above for
debugging a Linux executable.
## See also
* [Learning to Read GPU Frame Captures](https://github.com/flutter/flutter/blob/main/docs/engine/impeller/docs/read_frame_captures.md)
* The official [RenderDoc documentation](https://renderdoc.org/docs/index.html)
* Particularly the [Quick Start](https://renderdoc.org/docs/getting_started/quick_start.html)
and [How do I...?](https://renderdoc.org/docs/how/index.html) guides