一代态、需求背景
Android Studio 2.2+版本支持使用CMake構(gòu)建native庫,同時調(diào)試器也能對自構(gòu)建的native代碼進行源碼的調(diào)試腕侄,我們可以像調(diào)試java代碼一樣方便地調(diào)試native代碼黔漂。
我們很多的項目都依賴的so庫,有些是我們單獨的庫工程中的慈省,有些是三方提供的。如果想在主工程中調(diào)試這些庫的源碼眠菇,一種方法添加子工程或者CMake子模塊關(guān)聯(lián)源碼边败,作為自身構(gòu)建的一部分袱衷,當然需要所有的子工程都編譯通過。
搭建多工程環(huán)境和構(gòu)建子工程本身就是一個耗時又麻煩的事情笑窜,我們希望和庫工程盡量不要耦合致燥,而且調(diào)試時不需要再去構(gòu)建庫工程。
問題:我們本地有so庫對應(yīng)版本的源碼排截,也有帶符號so文件嫌蚤,如何進行源碼的調(diào)試?
二断傲、工程示例
這里我們示例一個簡單的庫工程mylib搬葬,它的c++代碼中封裝了一個求平均數(shù)的方法,然后java對外暴露了native的接口艳悔。
#include <jni.h>
extern "C"
JNIEXPORT jint JNICALL
Java_smarttime_tsia_com_mylib_MyLibNative_nativeCalAverage(JNIEnv *env, jclass type, jint a, jint b) {
int sum = a+b;
int avg = sum/2;
return avg;
}
MyLibNative.java
package smarttime.tsia.com.mylib;
public class MyLibNative {
static {
System.loadLibrary("test-lib");
}
public static native int nativeCalAverage(int a, int b);
}
然后我們將它打包成一個armeabi-v7a架構(gòu)的so庫(libtest-lib.so):我們APP主工程中,依賴這個三方庫(可以通過fileTree或maven)女仰,有一個按鈕點擊觸發(fā)調(diào)用nativeCalAverage:
public class MainActivity extends AppCompatActivity {
...
void onClick(View v) {
int ret = MyLibNative.nativeCalAverage(3,5);
}
}
三猜年、源碼調(diào)試
要在主工程中進行源碼調(diào)試,首先要有源碼疾忍,這邊要注意要和主工程依賴的版本對應(yīng)乔外。工程依賴的三方庫都是不帶符號的,我們可以解壓APK查看libtest-lib.so一罩,stripped表示調(diào)試信息已經(jīng)去掉了1. 獲取符號文件
符號文件中包含了行號信息杨幼,這樣調(diào)試器就知道符號地址對應(yīng)的行號,也包含源碼文件的信息聂渊,這樣在IDE中調(diào)試器就能調(diào)到對應(yīng)的文件中的某一行了差购。
2. 調(diào)試過程和原理
1)啟動調(diào)試器
可通過Debug 'app'或者Attach Debugger to Process的方式饼暑,后者無需重啟應(yīng)用稳析,注意選擇Debug Type為native,因為我們要調(diào)試的是native代碼弓叛。2)設(shè)置斷點
調(diào)試器連接上進程之后彰居,點擊pause program,然后我們在jni方法Java_smarttime_tsia_com_mylib_MyLibNative_nativeCalAverage設(shè)置一個斷點撰筷,source info可以查看當前堆棧的源碼和行號信息陈惰,但這時候我們還沒有符號文件,所以只能看到一個它的地址闭专。3)添加符號文件
add-dsym可以添加指定的符號文件奴潘,如果這時候libtest-lib.so還沒有加載進來就會添加失敗旧烧,匹配不到對應(yīng)的模塊。4)觸發(fā)斷點
斷點觸發(fā)以后奈虾,source info查看到當前的行號已經(jīng)有了夺谁,源碼信息也指向我們工程中打開的源碼文件,所以IDE就跳到對應(yīng)的斷點上了肉微,然后我們就可以進行單步調(diào)試匾鸥、條件斷點、watch point等調(diào)試了碉纳。實際調(diào)試中只要調(diào)試器連接到進程勿负,然后添加調(diào)試符號就行了,然后Android Studio中在對應(yīng)的源碼文件中直接打斷點調(diào)試即可劳曹,上述過程只是方便分析原理奴愉。
3. 源碼映射
上述的符號文件和源碼是在庫工程里,符號文件是源碼構(gòu)建生成的铁孵,所以我們添加了符號文件就能調(diào)試源碼了锭硼。實際在很多項目中庫構(gòu)建和發(fā)布都是在一臺專門用來打包的服務(wù)器(云端)上進行的,本地只有對應(yīng)版本的源碼蜕劝,為了保證一致性檀头,主工程依賴的是打包機器發(fā)布的庫,我們也用打包機器上生成的符號文件來調(diào)試岖沛。
打包機器和本地生成的符號文件唯一的不同就是構(gòu)建環(huán)境暑始,也就是源碼文件的路徑信息。我們來模擬一下烫止,假設(shè)上述在mylib工程的目錄就是打包發(fā)布的專用目錄蒋荚,而我們要調(diào)試的native代碼放在了另一個目錄里。
符號文件添加后馆蠕,斷點到j(luò)ni方法期升,雖然有行號信息,但IDE中并沒有調(diào)到對應(yīng)的文件互躬,因為這時候調(diào)試器只知道符號文件的源碼信息播赁,它沒有指向本地要調(diào)試的源碼。打包時環(huán)境:/Users/derek/Documents/AndroidProject/jniTest2/mylib/src/main/jni/test.cpp
調(diào)試源碼路徑:/Users/derek/Downloads/src/test.cpp
4. Android Studio Debugger配置
以上我們都是通過執(zhí)行l(wèi)ldb命令來添加符號坎背、源碼映射的替劈,如果覺得麻煩Android Studio也提供了Debugger配置:Symbol Directories為符號目錄,調(diào)試器會遞歸的尋找這個目錄下的文件得滤,直到匹配到需要的符號文件為止陨献;LLDB Post Attach Commands為調(diào)試器連接到進程后執(zhí)行的命令,我們可以在這里添加setting set target.source-map源碼映射的命令懂更。
如果通過Debugger配置來調(diào)試眨业,必須用Debug 'app'的方式,不能使用Attach的方式沮协,因為只有前者才會去執(zhí)行Debugger里的命令龄捡。
參考:
http://lldb.llvm.org/tutorial.html
https://developer.android.com/studio/run/rundebugconfig?hl=zh-cn#definingbefore