詳解ndk-stack

一、簡介

ndk-stack是一個工具，它能夠幫助開發人員通過ndk的堆棧信息進行調試，這個工具通常用於native C/C++應用程序和庫的崩潰調試。

基本操作：當應用崩潰時，將生成一個崩潰日誌文件，日誌文件包括有關崩潰的堆棧跟蹤信息，使用ndk-stack工具可以將該堆棧跟蹤信息轉換為易於理解的格式，以從中了解崩潰的原因。

二、使用方法

1. 環境配置

在使用ndk-stack之前，需要先進行環境配置，將ndk工具鏈添加到系統的PATH環境變數中。假設NDK的根目錄為：/Users/yourname/android-ndk-r9b。

 export PATH=$PATH:/Users/yourname/android-ndk-r9b.

2. 生成ndk-stack腳本

使用ndk-stack的前提是我們需要在ndk的工具目錄下找到ndk-stack腳本，如果找不到此腳本，可以通過下述命令生成：

 cd /Users/yourname/android-ndk-r9b
 ./build/tools/make-standalone-toolchain.sh --platform=android-14 \ #android-14表示生成的so庫支持最低的android版本
 --install-dir=/tmp/my-android-toolchain

運行上述命令將會在/tmp/my-android-toolchain目錄下生成一個ndk-stack腳本：

 /tmp/my-android-toolchain/bin/ndk-stack
 

3. 讀取並使用崩潰日誌

通常，當native應用程序或庫崩潰時，系統都將崩潰信息寫入日誌文件。默認情況下這些日誌文件位於/data/tombstones或/data/anr目錄下，我們只需要使用adb命令將崩潰日誌從設備複製到主機，然後使用ndk-stack命令就可以查看該日誌的堆棧。

adb pull /data/tombstones/tombstone_xxxx
cat tombstone_xxxx | ndk-stack -sym path/to/so/files -dump path/to/symbols/file  #symbols file可以在編譯so庫的時候生成

三、常見問題

1. 如何找到對應的so庫？

在解析崩潰日誌時，找到對應的so庫十分重要。一種方法是可以定義APP_ABI環境變數，並用於指定當前構建的Android應用程序架構類型，具體可以設置為armeabi、armeabi-v7a、x86_64等，從而找到當前架構下使用的so庫。

export APP_ABI=armeabi

2. 如何將特定的so庫編譯成帶調試符號表的版本？

當我們編譯生成so庫時，需要將符號表一起生成，這樣在出現崩潰時，ndk-stack才能夠更加準確地解析堆棧信息。

LOCAL_CFLAGS += -g
LOCAL_LDFLAGS += -g

3. 編譯選項”-O0″與”-O2″的區別

當我們將so庫編譯成帶有調試符號表的版本時，需要注意編譯選項的選擇。編譯選項”-O0″代表著「不優化代碼」，能夠使編譯器在編譯過程中生成更多的符號表，加大代碼體積，但更容易快速診斷出錯誤；而編譯選項”-O2″則代表著「強制優化代碼」，能夠最大化代碼的執行速度，但同時也會縮小代碼體積，不利於錯誤的診斷與排查。

4. 如何調試so庫中的native代碼？

最後，如果我們需要在native代碼中進行調試，可以將so庫與debug信息一起打包，然後使用gdb進行調試。

adb push path/to/so/library /data/local/tmp/                 #將so庫複製到指定目錄下
adb shell
cd /data/local/tmp/                                          #進入到所在目錄下
gdbserver :5039 ./so-library                                 #啟動gdbserver

然後再使用另一個終端窗口啟動gdb，並連接至gdbserver：

gdb
target remote :5039

四、總結

ndk-stack是一個非常實用的工具，可以幫助開發人員更快地發現和解決native代碼的崩潰問題。在使用過程中，我們需要注意so庫的架構類型和編譯選項的設置，以保證ndk-stack能夠正確解析日誌文件。