企业官网建设流程全解析

概述

当 Flutter 应用在 Release 或 Profile 模式下发生卡死（AppFreeze）或崩溃（CppCrash）时，相关日志中通常会包含dart层的堆栈信息（libapp.so部分），但获取到的堆栈地址是十六进制偏移量，无法直接看到具体的 Dart 函数和行号。需要使用flutter symbolize工具将原始堆栈地址转换为可读的 Dart 源代码位置。

工具

• 工具:flutter symbolize
• 输入: 需要符号化的堆栈文件 + 符号文件
• 输出: 符号化后的堆栈文件

命令

flutter symbolize -i<堆栈文件>-d<符号文件>-o<符号化后输出文件>

获取符号文件

符号文件在打包阶段生成。构建 HAP 包时追加--split-debug-info参数（意思是剥离调试信息，需要传入一个文件夹的路径），如：

flutterbuild hap --release --split-debug-info=./debug-info

打包时会将符号信息从libapp.so中分离出来，生成在指定目录下，如：./debug-info/app.ohos-arm64.symbols

生成堆栈文件

AppFreeze 日志、CppCrash 日志或 Hiprofler 抓取的 trace 文件中通常会包含dart层的堆栈信息（libapp.so部分），但需要转换为flutter symbolize工具可识别的格式。

原始堆栈格式（来自日志）：

#00pc0000000000171698/data/storage/el1/bundle/libs/arm64/libapp.so(301f78813ec57f68e57e8d5453ab0d89) #01pc00000000001537b4/data/storage/el1/bundle/libs/arm64/libapp.so(301f78813ec57f68e57e8d5453ab0d89) ...

转换后的堆栈格式：

#00abs0000000000171698virt0000000000171698libapp.so #01abs00000000001537b4virt00000000001537b4libapp.so ...

说明：

• #xx: 调用栈中的帧编号
• pc: 程序计数器 - 表示指令指针地址
• 0000000000xxxxxx: 十六进制地址
• /data/storage/.../libapp.so: 共享库路径
• (301f78813ec57f68e57e8d5453ab0d89): 构建指纹/哈希值

示例：AppFreeze 堆栈符号化

1. 准备输入文件

将转换后的堆栈保存为input.txt：

#00abs0000000000171698virt0000000000171698libapp.so#01abs00000000001537b4virt00000000001537b4libapp.so#02abs0000000000281fe4virt0000000000281fe4libapp.so#03abs000000000023e2b4virt000000000023e2b4libapp.so#04abs000000000022ae88virt000000000022ae88libapp.so#05abs0000000000234b8cvirt0000000000234b8clibapp.so#06abs0000000000237f2cvirt0000000000237f2clibapp.so#07abs0000000000237cd0virt0000000000237cd0libapp.so#08abs0000000000278d3cvirt0000000000278d3clibapp.so#09abs0000000000146204virt0000000000146204libapp.so#10abs000000000024df24virt000000000024df24libapp.so#11abs0000000000146190virt0000000000146190libapp.so#12abs00000000001460f8virt00000000001460f8libapp.so#13abs00000000001458d4virt00000000001458d4libapp.so#14abs000000000027d6a4virt000000000027d6a4libapp.so#15abs0000000000179014virt0000000000179014libapp.so#16abs0000000000178f54virt0000000000178f54libapp.so#17abs0000000000178a40virt0000000000178a40libapp.so#18abs000000000028dadc virt000000000028dadc libapp.so#19abs000000000025bd20virt000000000025bd20libapp.so#20abs00000000000dffc4virt00000000000dffc4libapp.so#21abs00000000000ec878virt00000000000ec878libapp.so#22abs00000000000ec808virt00000000000ec808libapp.so#23abs00000000000ed5d4virt00000000000ed5d4libapp.so#24abs00000000000dca20virt00000000000dca20libapp.so

2. 执行符号化命令

flutter symbolize -iinput.txt-d app.ohos-arm64.symbols-o symbols.txt

3. 查看符号化结果

symbols.txt内容如下：

#0_MyHomePageState._dartFreeze (D:/Flutter/demo/flutter_dfx_sample/lib/main.dart:44:5) #1_MyHomePageState._dartFreeze (D:/Flutter/demo/flutter_dfx_sample/lib/main.dart:41:3) #2_InkResponseState.handleTap (D:/Flutter/flutter_flutter/packages/flutter/lib/src/material/ink_well.dart:1195:3) #3GestureRecognizer.invokeCallback (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/recognizer.dart:345:24) #4TapGestureRecognizer.handleTapUp (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/tap.dart:737:11) #5BaseTapGestureRecognizer._checkUp (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/tap.dart:362:5) #6BaseTapGestureRecognizer.handlePrimaryPointer (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/tap.dart:293:7) #7PrimaryPointerGestureRecognizer.handleEvent (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/recognizer.dart:706:9) #8PrimaryPointerGestureRecognizer.handleEvent (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/recognizer.dart:688:3) #9PointerRouter._dispatch (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/pointer_router.dart:97:12) #10PointerRouter._dispatchEventToRoutes.<anonymous closure> (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/pointer_router.dart:143:9) #11_LinkedHashMapMixin.forEach (third_party/dart/sdk/lib/_internal/vm_shared/lib/compact_hash.dart:764:13) #12PointerRouter._dispatchEventToRoutes (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/pointer_router.dart:141:18) #13PointerRouter.route (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/pointer_router.dart:131:7) #14GestureBinding.handleEvent (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:530:19) #15GestureBinding.dispatchEvent (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:499:22) #16RendererBinding.dispatchEvent (D:/Flutter/flutter_flutter/packages/flutter/rendering/binding.dart:473:11) #17GestureBinding._handlePointerEventImmediately (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:437:7) #18GestureBinding.handlePointerEvent (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:394:5) #19GestureBinding._flushPointerEventQueue (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:341:7) #20GestureBinding._handlePointerDataPacket (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:308:9) #21GestureBinding._handlePointerDataPacket (D:/Flutter/flutter_flutter/packages/flutter/lib/src/gestures/binding.dart:300:3) #22_invoke1 (lib/ui/hooks.dart:347:13) #23PlatformDispatcher._dispatchPointerDataPacket (lib/ui/platform_dispatcher.dart:467:7) #24_dispatchPointerDataPacket (lib/ui/hooks.dart:282:31) #25_dispatchPointerDataPacket (lib/ui/hooks.dart:280:1) #26stub InvokeDartCode+0xd4

符号化后可以清晰看到：

• 崩溃发生在main.dart的_MyHomePageState._dartFreeze方法
• 具体行号：第 41 行和第 44 行
• 调用链完整：从 Dart 层到 Flutter 框架再到 native 层

split-debug-info 参数影响

体积减少

加上--split-debug-info参数后，符号信息从app.so中分离，应用体积略有减小。

DevTools 无法连接

DevTools 依赖符号文件进行调试。添加此参数后会导致 DevTools 无法连接应用。建议在 Release 模式下使用。

性能无影响

测试表明开启和关闭该参数对 UI 和 Raster 性能无明显影响。

相关链接

• Flutter 官方文档:https://docs.flutter.dev/reference/flutter-cli