README_CN.md

android-flutter-engine-debugger

English README

Android调试Flutter Engine的 VSCode插件

Features

1. 根据官方拉取flutter engine的源码 && 编译Flutter engine

   拉取引擎代码： Setting-up-the-Engine-development-environment

   编译引擎：compiling-for-android-from-macos-or-linux

   比如使用命令 ： ./flutter/tools/gn --android --debug --unoptimized 最后将得到 out/android_debug_unopt_arm64

2. 使用local engine启动flutter工程

   Setting-up-the-Engine-development-environment

   fluter run --local-engine=android_debug_unopt_arm64 --local-engine-src-path={YourflutterEngineSrcPath}

3. 使用VSCode打开src/flutter源码目录

   重要！重要！：请保持2步骤运行的Android进程在前台

   · local-engine-src-path: flutter源码的中src目录，同步骤2中的 --local-engine-src-path 参数

   · local engine: out目录里面的，引擎输出目录，根据编译参数的不同而不同，比如android_debug_unopt_arm64

   · package name : Android应用的packagename

   点击start后，如果一切正常，最后提示You can use press F5 to debug!! 就表示成功。

   

4. 万事俱备，按F5就可以开始调试了

   添加断点，就可以调试了

   

Requirements

1. 安装 CodeLLDB 插件
2. 获取flutter engine源码
3. 编译flutter源码
4. 使用local engine方式运行Android应用

Issues

1. ANDROID_HOME is empty. Please set the ANDROID_HOME environment variable

   请在.zshrc或者.bash_profile等配置环境成功设置了ANDROID_HOME环境变量。如果你确认了设置成功却依然报错，这可能是因nodejs环境导致的，可以尝试重启vscode

2. Configured debug type 'lldb' is not supported.

   请安装 CodeLLDB 插件

Enjoy!