1. 前言
調(diào)試FFmpeg的方式有很多種氓仲。在macOS上坦仍，使用LLDB調(diào)試鳍烁，功能強(qiáng)大，上手簡(jiǎn)單繁扎，就是相比IDE調(diào)試略顯笨拙幔荒。
能不能像debug iOS工程那樣debug FFmpeg呢？大致有兩種思路：
- 使用External Build
很多人有相關(guān)的嘗試梳玫，建立工程時(shí)選擇Command Line Tool爹梁，被對(duì)應(yīng)FFmpeg添加到工程。最終建立target并用External Build Tool Configuration進(jìn)行build提澎，如果相關(guān)header和Library路徑設(shè)置正確姚垃，這樣也是可以調(diào)試的。 - 使用Source Build
那就是建一個(gè)Cocoa APP盼忌，把需要編譯的FFmpeg文件都添加到工程Compile Sources里面去积糯。然后在ViewController里面調(diào)用main函數(shù)，此時(shí)只能添加對(duì)應(yīng)的fftools谦纱，比如ffplay（因?yàn)槠渌膄ftools都有main函數(shù)）看成。這代替了FFmpeg的Makefile編譯過(guò)程，如果相關(guān)配置正確的話跨嘉，還是可以run起來(lái)的川慌。
總結(jié)就是，工程配置的復(fù)雜度較高，會(huì)出現(xiàn)各種Build Fail情況梦重。
2. Chromium的debug思路
2.1 生成Chromium源碼工程
Chromium使用Ninja進(jìn)行項(xiàng)目編譯兑燥，gn可以生成包含build.ninja等文件的build目錄。
同時(shí)為了更方便調(diào)試忍饰，以下命令會(huì)為chrome target輸出名為all.xcworkspace的xcode工程贪嫂。
gn gen --ide=xcode --filters=//chrome out/Default
打開(kāi)all.xcworkspace工程如下圖，chrome相關(guān)文件都在里面了艾蓝。
2.2 調(diào)試Chromium
Chromium是多進(jìn)程模式力崇，使用LLDB時(shí)，需要attach到需要調(diào)試的進(jìn)程號(hào)赢织。如何在進(jìn)程啟動(dòng)的時(shí)候正確attach呢亮靴？attach到對(duì)應(yīng)進(jìn)程后，錯(cuò)過(guò)了進(jìn)程初始化運(yùn)行的關(guān)鍵點(diǎn)呢于置？
使用以下命令啟動(dòng)Chromium茧吊，當(dāng)啟動(dòng)Render時(shí)，將停留在等待debugger to attach里面：
./out/Default/Chromium.app/Contents/MacOS/Chromium --renderer-startup-dialog
此時(shí)控制臺(tái)輸出：
[81889:775:1217/161254.237552:ERROR:content_switches_internal.cc(198)] Renderer (4586) paused waiting for debugger to attach. Send SIGUSR1 to unpause.
查看content/common/content_switches_internal.cc文件八毯，可以看到void WaitForDebugger(const std::string& label)函數(shù)主要使用pause()等待LLVB attach搓侄。
此時(shí)使用Xcode Attach to Process，并且選中Chromium Helper (4586)：
在Renderer進(jìn)程對(duì)應(yīng)的源碼里面設(shè)置斷點(diǎn)话速，則可以使用我們熟悉的Xcode工具進(jìn)行分步調(diào)試了讶踪。
3. 使用Xcode debug FFmpeg
參考Chromium的調(diào)試方法，首先需要把源碼添加到Xcode工程中泊交。
然后在需要調(diào)試的某個(gè)fftools 里乳讥，在主函數(shù)int main(int argc, char **argv)初始化最前面添加等待attach的接口。具體代碼如下廓俭。
3.1 等待attach
調(diào)用wait_for_debugger ()就會(huì)進(jìn)入到pause()里面去云石。
#include <sys/types.h>
#include <unistd.h>
static int is_waiting_debugger;
//Handler for signal USR1
static void sig_usr1_handler(int signal)
{
av_log(NULL, AV_LOG_WARNING, "Received SIGUSR1 to continue.\n");
}
//Wait for debugger to attach. Send SIGUSR1 to unpause.
static void wait_for_debugger()
{
if( !is_waiting_debugger )
return;
pid_t pid = getpid();
#if defined(__APPLE__) || defined(__FreeBSD__)
const char * appname = getprogname();
#elif defined(_GNU_SOURCE)
const char * appname = program_invocation_name;
#else
const char * appname = argv[0];
#endif
av_log(NULL, AV_LOG_FATAL, "%s (%d) paused waiting for debugger to attach. Send SIGUSR1 to unpause.\n",
appname, pid);
struct sigaction sa;
memset(&sa, 0, sizeof(sa));
sa.sa_handler = sig_usr1_handler;
sigaction(SIGUSR1, &sa, NULL);
pause();
}
在等待LLDB attach時(shí)，會(huì)打印提醒：
ffplay_g (8858) paused waiting for debugger to attach. Send SIGUSR1 to unpause.
如果 LLDB attach了 8858研乒，則會(huì)打斷pause()進(jìn)入后續(xù)代碼流程汹忠。
如果臨時(shí)不想debug，則發(fā)送SIGUSR1繼續(xù)代碼執(zhí)行：
kill -s USR1 8858
3.2 配置attach
并不是每次執(zhí)行ffplay都需要發(fā)送 SIGUSR1來(lái)中止debug雹熬，也是件挺麻煩的事情错维。所以我們需要將 debug開(kāi)啟 寫(xiě)入配置。
3.1章節(jié)已經(jīng)定義了全局靜態(tài)變量 is_waiting_debugger橄唬，這里沒(méi)有賦初始值的原因是靜態(tài)變量默認(rèn)值已經(jīng)是 0。
以FFmpeg代碼分支 n3.4.1 中 ffplay.c 為例子参歹，首先需要在 options 中增加 attach
選項(xiàng)仰楚，啟動(dòng)時(shí)帶上該參數(shù)才能走到 debugger attach 邏輯。
static const OptionDef options[] = {
CMDUTILS_COMMON_OPTIONS
{ "x", HAS_ARG, { .func_arg = opt_width }, "force displayed width", "width" },
{ "y", HAS_ARG, { .func_arg = opt_height }, "force displayed height", "height" },
{ "s", HAS_ARG | OPT_VIDEO, { .func_arg = opt_frame_size }, "set frame size (WxH or abbreviation)", "size" },
{ "fs", OPT_BOOL, { &is_full_screen }, "force full screen" },
{ "attach", OPT_BOOL, { &is_waiting_debugger }, "force waiting for debugger to attach" },
然后在ffplay初始化輸入?yún)?shù)后調(diào)用wait_for_debugger()。
/* Called from the main */
int main(int argc, char **argv)
{
int flags;
VideoState *is;
init_dynload();
av_log_set_flags(AV_LOG_SKIP_REPEATED);
parse_loglevel(argc, argv, options);
/* register all codecs, demux and protocols */
#if CONFIG_AVDEVICE
avdevice_register_all();
#endif
#if CONFIG_AVFILTER
avfilter_register_all();
#endif
av_register_all();
avformat_network_init();
init_opts();
signal(SIGINT , sigterm_handler); /* Interrupt (ANSI). */
signal(SIGTERM, sigterm_handler); /* Termination (ANSI). */
show_banner(argc, argv, options);
parse_options(NULL, argc, argv, options, opt_input_file);
wait_for_debugger();
3.3 FFmpeg的調(diào)試配置
為了debug的順暢僧界，關(guān)閉編譯優(yōu)化和strip是必要的侨嘀。
./configure --enable-debug=3 --disable-optimizations --disable-stripping --disable-asm --assert-level=2
4. 總結(jié)
相比使用 Xcode組織代碼和工程編譯后對(duì) target進(jìn)行調(diào)試，使用 Xcode attach process id 的方式捂襟，可以沿用已有的項(xiàng)目編譯方法咬腕，也無(wú)需添加額外的相關(guān)依賴。個(gè)人認(rèn)為是一種更通用和簡(jiǎn)單的調(diào)試方法葬荷，行文如有出錯(cuò)涨共，歡迎指正。
