配置一个Flutter的远程Android调试环境

$ ../flutter/bin/flutter build --local-engine-src-path ../src  --local-engine=android_debug_unopt android
......
You are using a locally built engine (--local-engine) but have not specified --local-engine-host.
You may be building with a different engine than the one you are running with. See https://github.com/flutter/flutter/issues/132245 for
details.

Could not execute [class org.jetbrains.kotlin.gradle.plugin.statistics.KotlinBuildStatHandler.buildFinished]
FAILURE: Build failed with an exception.
* Where:
Build file '/data/research/flutter/my_app_1/android/app/build.gradle' line: 4
* What went wrong:
An exception occurred applying plugin request [id: 'dev.flutter.flutter-gradle-plugin', version: '1.0.0']
> Failed to apply plugin 'dev.flutter.flutter-gradle-plugin'.
   > local-engine-out must point to a local engine build
* Try:
> Run with --debug option to get more log output.
> Run with --scan to get full insights.
* Exception is:

../flutter/bin/flutter build --local-engine-src-path=/data/research/flutter/src  --local-engine=android_debug_unopt --local-engine-host=host_debug_unopt apk --debug --verbose

# 错误1：
error: attach failed: Failed to connect port

# 错误2：
error: attach failed: Cannot get process architecture

"add-dsym  ${workspaceFolder}/src/out/android_debug_unopt/libflutter.so"

error: symbol file '/data/research/flutter/src/out/android_debug_unopt/libflutter.so' does not match any existing module

{
    "version": "0.2.0",
    "configurations": [
      {
        "name": "DebugAndroid",
        "type": "lldb",
        "request": "custom",
        "initCommands": [
          "platform select remote-android",
          "platform connect connect://f6d56607:10087",
          "process attach -p xxx",
        ],
        "exitCommands": [
            "platform disconnect",
        ],
      }
    ]
  }

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "DebugAndroid",
      "type": "lldb",
      "request": "custom",
      "preLaunchTask": "start_lldb_server", // 执行脚本
      "initCommands": [
        "version", // use custom build lldb(version > 16) for port forward
        "command source ${workspaceFolder}/launch.sh"
      ],
      "exitCommands": [
        "platform disconnect",
        "shell ${workspaceFolder}/before_lldb_quit.sh",
      ],
    }
  ]
}

{
    "version": "2.0.0",
    "tasks": [
      {
        "label": "start_lldb_server",
        "type": "shell",
        "command": "sh ~/.power_script/android_dev/launch_debuggable_app.sh com.example.my_app 10087",
        "problemMatcher": []
      }
    ]
}

#!/bin/sh
# build & install & launch，比较定制化且相对低频，就不纳入脚本了
if [ "$#" -ne 2 ]; then
    echo "./launch_debuggable_app.sh \$PKG_NAME \$PORT_NUM"
    exit 1
fi
PKG_NAME="$1"
PORT_NUM="$2"
TARGET_PID=$(adb shell pidof ${PKG_NAME})
echo "--->TARGET_PID: $TARGET_PID"
if [ "${TARGET_PID}" = "" ]; then
    echo "Package: ${PKG_NAME} is not running!!!"
    exit 1
fi

function run_in_android() {
 adb shell "run-as ${PKG_NAME} sh -c '${1}'" # 解决权限问题
}

# Step 1 清理之前可能残留的lldb进程
# enable for debug
echo "--->before clear:"
run_in_android ps
echo "--->start clear lldb-server if needed"
# 可能有 lldb-server 和 [lldb-server] ，只需要命中前者并kill即可
CLIENT_LLDB_ID=$(run_in_android ps| grep 'lldb-server$' | awk '{print $2}')
if [ "${CLIENT_LLDB_ID}" != "" ]; then
    echo "--->Kill LLDB: ${CLIENT_LLDB_ID} <---"
    run_in_android "kill -9 ${CLIENT_LLDB_ID}"
fi
echo "--->current process info(after clear):"
run_in_android ps
# Step 2 准备Server
LLDB_DIR="/data/data/${PKG_NAME}/lldb"
SERVER_DIR="${LLDB_DIR}/bin/"
run_in_android "mkdir -p ${SERVER_DIR}"
SERVER_PATH=${SERVER_DIR}/lldb-server
TMP_SERVER="/data/local/tmp/lldb-server"
run_in_android "cp -F ${TMP_SERVER} ${SERVER_PATH} && chmod 700 ${SERVER_PATH}"
# Step 3(如果是还命令行调用，则有必要设置环境变量，VSCode有专门的配置入口: Lldb->Adapter Env)
export ANDROID_PLATFORM_LOCAL_PORT=50012
export ANDROID_PLATFORM_LOCAL_GDB_PORT=50013
#echo "ANDROID_PLATFORM_LOCAL_PORT=${ANDROID_PLATFORM_LOCAL_PORT}"
#echo "ANDROID_PLATFORM_LOCAL_GDB_PORT=${ANDROID_PLATFORM_LOCAL_GDB_PORT}"

# Step 4 开始监听
echo "--->start listen to ${PORT_NUM}"
run_in_android "${SERVER_PATH} platform --listen \"*:${PORT_NUM}\" --server" &
echo "--->current process info(after launch listening):"
run_in_android ps # verbose info
gen=".generated"
if [ ! -d "$gen" ]; then
  mkdir ${gen}
else
  echo "Directory exists: $directory"
fi
CLIENT_LLDB_ID=$(run_in_android ps| grep lldb | awk '{print $2}')
if [ "${CLIENT_LLDB_ID}" != "" ]; then
    # launch.json的exitCommand中调用，每次使用完及时清理lldb server进程
    echo "--->new client lldb id: ${CLIENT_LLDB_ID}"
    echo "#Generated at $(date)" > ${gen}/before_lldb_quit.sh
    echo "adb shell \"run-as ${PKG_NAME} sh -c 'kill -9 ${CLIENT_LLDB_ID}'\"" >> ${gen}/before_lldb_quit.sh
    chmod +x ${gen}/before_lldb_quit.sh
fi

# Step 5 生成lldb命令，让VSCode加载，因为DeviceId / 端口 / 进程id 都在脚本生成，在`launch.json`直接运行lldb其实不方便，
#        这里利用 temp 文件传递了这些信息
launch_file=${gen}/launch.sh
device_id=$(adb devices | head -2 |tail -1 | cut -f 1)
echo "platform select remote-android" > ${launch_file}
echo "platform connect connect://${device_id}:${PORT_NUM}" >> ${launch_file}
echo "process attach -p ${TARGET_PID}" >> ${launch_file}
current_path=$(pwd)
# 这一句衔接在attach后面不会生效，需要研究下......
echo "add-dsym ${current_path}/src/out/android_debug_unopt/libflutter.so" >> ${launch_file}
# from terminal
# lldb -s temp
echo "--->Try Kill in this place"

# VSCode settings -> Clangd: Arguments
--background-index --clang-tidy

I  Timeline: Activity_launch_request time:10635159384
D  initViewContentFetcherClass
I  ViewContentFetcher : ViewContentFetcher
D  createInterceptor took 0ms
E  [ERROR:flutter/shell/platform/android/android_egl_surface.cc(52)] EGL
   Error: EGL_SUCCESS (12288)
A  [FATAL:flutter/shell/platform/android/platform_view_android.cc(143)] Check

    failed: android_context_->IsValid(). Could not create surface from invalid Android context.