FlutterActivity中日志无法在VS Code调试控制台显示

我正在使用VS Code开发Flutter应用，已在FlutterActivity中添加如下日志代码：

package com.example.package

import android.os.Bundle
import android.util.Log

import io.flutter.embedding.android.FlutterActivity

class MainActivity: FlutterActivity() {
    val TAG = this.javaClass.name

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        Log.d(TAG, "Hello World!")
    }

//...

运行应用时，预期能在VS Code的Debug Console（调试控制台）中看到"Hello World!"输出，以及其余所有Android端日志，但实际未查询到对应日志内容。

已知现象 #

• 相同代码在Android Studio的Logcat标签页中可正常展示日志
• 使用VS Code调试时，若在平板锁屏状态下启动应用后再解锁屏幕，对应日志可正常显示
• 使用adb logcat命令时，日志能否展示取决于所使用的--regex过滤规则，即使正则表达式本身与预期日志匹配，也会出现日志不显示的情况

该问题由VS Code Flutter/Dart插件的日志采集逻辑启动时序差导致：

• Flutter应用冷启动时，Android原生层逻辑最先执行，MainActivity的onCreate生命周期回调会在应用进程创建后立刻触发，编写的Log.d日志此时已经输出到系统logcat缓冲区
• VS Code的调试插件需要等待和Dart VM的调试服务连接建立完成后，才会启动logcat采集进程，且默认仅过滤采集当前调试进程ID对应的日志。插件启动日志采集的时间点晚于原生启动阶段日志的输出时间，这部分早到的日志就被直接漏掉
• 锁屏启动后再解锁能看到日志，是因为锁屏状态会阻塞Flutter引擎加载流程，拉长了整体启动周期，等插件完成调试连接、启动日志采集时，原生onCreate的日志还未执行，刚好落在采集时间窗内
• 手动执行adb logcat偶现匹配不到日志，是因为Android设备默认logcat缓冲区大小通常仅2-4M，启动阶段系统、应用日志输出量极大，手动执行命令抓日志时，最早输出的启动阶段日志已经被新日志挤出缓冲区覆盖。Android Studio的Logcat会在应用启动前就提前绑定设备端口、拉取全量缓冲区日志，因此不会出现这类丢日志问题。

按使用便捷度从高到低选择即可：

• 调整VS Code插件日志配置
  打开VS Code设置，搜索dart logcat，找到Dart: Logcat Logging配置项，关闭默认的按进程ID过滤选项，改为采集全量设备日志，后续在调试控制台直接通过日志TAG关键词过滤需要的内容即可，不会再漏掉启动阶段日志。
• 提前手动启动logcat采集
  点击调试运行前，先在VS Code内置终端执行如下命令，提前挂载日志采集，避开启动时序差问题：

  adb logcat -v time | grep "你的应用包名/日志TAG"
  

  应用启动后该终端会完整输出全生命周期的Android端日志，不会遗漏启动阶段内容。
• 临时延后启动期日志的打印时机
  如果仅为临时排查问题，可以把需要打印的启动期日志挪到configureFlutterEngine回调中执行，该回调触发时VS Code的调试连接已经建立，日志可以正常被捕获：

  override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
      super.configureFlutterEngine(flutterEngine)
      Log.d(TAG, "Hello World!")
  }
  

• 增大logcat缓冲区大小
  执行如下命令调大测试设备的logcat缓冲区容量，避免早期日志被新日志挤出覆盖：

  adb logcat -G 16M
  

内容的提问来源于stack exchange，提问作者Roger Lipscombe