2. Native性能分析工具链搭建

Native性能工程的第一步不是抓数据，而是把工具链装对、配对、跑通。Android Native层的分析工具大致分为四类：构建与编译工具（NDK、CMake）、系统级采样与追踪工具（Perfetto、Simpleperf）、内存与正确性检测工具（ASan、HWASan、Valgrind）、调试与图形分析工具（gdb/lldb、GAPID）。它们各自依赖不同的运行环境，装错版本或漏配符号，往往表现为“命令能跑但结果不可信”。本节按“安装—配置—最小验证”的顺序，把这条链搭起来。

NDK与CMake：Native构建的底座

NDK提供交叉编译工具链、系统头文件与各ABI的运行时库。推荐通过Android Studio的SDK Manager安装，或直接下载对应版本压缩包。安装后设置环境变量，便于命令行使用：

export ANDROID_NDK_HOME=$HOME/Android/Sdk/ndk/26.1.10909125
export PATH=$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH
# 验证
aarch64-linux-android33-clang --version

CMake负责组织Native构建。在build.gradle中声明版本与参数，关键是-g保留调试符号、-fno-omit-frame-pointer保留帧指针，这两项直接决定后续Simpleperf与Perfetto能否还原调用栈：

android {
  ndkVersion "26.1.10909125"
  defaultConfig {
    externalNativeBuild {
      cmake {
        arguments "-DANDROID_STL=c++_shared",
                  "-DCMAKE_BUILD_TYPE=RelWithDebInfo"
        cppFlags "-g", "-fno-omit-frame-pointer"
      }
    }
  }
  externalNativeBuild { cmake { path "src/main/cpp/CMakeLists.txt" } }
}

验证方式：编译后执行readelf -S libnative.so | grep debug，若能看到.debug_info段，说明符号已保留。若使用strip或Release裁剪，需单独保存一份带符号的so用于离线符号化。

Perfetto与Simpleperf：系统级采样与追踪

Perfetto是Android 10+的系统级追踪框架，采集CPU调度、频率、Binder、图形等全系统事件。设备端traced与traced_probes通常已内置，主机端通过record_android_trace脚本或Web UI操作：

# 采集10秒，含调度与频率
./record_android_trace -o trace.perfetto-trace -t 10s \
  -b 64mb sched freq idle am wm gfx view binder_driver

Simpleperf是Android自带的CPU采样分析器，适合定位热点函数。它依赖perf_event_open，需在设备上开启perf_event_paranoid或使用simpleperf的--app模式：

adb shell simpleperf record -p $(pidof com.example.app) \
  -g -f 1000 --duration 10 -o /data/local/tmp/perf.data
adb shell simpleperf report -i /data/local/tmp/perf.data --symfs ./symbols

判断结果是否可信：先看采样数是否足够（一般≥1000个样本），再看丢失样本比例（lost字段），若丢失超过5%，应降低采样频率或增大缓冲区。

ASan、HWASan与Valgrind：内存正确性检测

ASan（AddressSanitizer）检测越界、UAF、双重释放，适合x86_64与arm64。在CMake中开启：

set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fsanitize=address -fno-omit-frame-pointer")
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fsanitize=address -fno-omit-frame-pointer")
target_link_libraries(native-lib log android)

HWASan是arm64上的硬件辅助版本，内存开销远低于ASan，适合真机长时间运行。开启方式为-fsanitize=hwaddress，并需在设备上启用wrap.sh或HWASAN_OPTIONS。Valgrind在Android上支持有限，主要用于x86模拟器或桌面端复现，命令为valgrind --tool=memcheck ./binary。三者定位不同：ASan快而全，HWASan省内存，Valgrind慢但无需重编译。

gdb/lldb与GAPID：调试与图形分析

NDK自带lldb与gdb。推荐使用lldb，配合lldb-server在设备端调试：

adb push $ANDROID_NDK_HOME/prebuilt/android-arm64/lldb-server /data/local/tmp/
adb shell /data/local/tmp/lldb-server platform --listen "*:1234" --server
lldb
(lldb) platform select remote-android
(lldb) platform connect connect://localhost:1234
(lldb) attach -p $(pidof com.example.app)

GAPID用于图形API调用追踪，适合分析OpenGL ES/Vulkan渲染问题。安装后通过gapit或gapic连接设备，抓取一帧的调用序列与纹理状态。注意GAPID对Vulkan支持较新，旧设备可能需降级使用。

最小验证闭环

工具装完后，建议用一个最小Native工程跑通全链路：编译带符号so → 用Simpleperf采样10秒 → 用Perfetto抓调度 → 用ASan跑一次越界用例 → 用lldb attach断点。每一步的验证标准是：Simpleperf报告能显示函数名而非地址；Perfetto trace能在UI中看到线程调度；ASan能打印出越界地址与调用栈；lldb能命中main或指定函数。若某一步只显示地址或直接崩溃，优先检查符号是否保留、perf_event_paranoid是否放开、wrap.sh是否正确注入。