Android 模拟器下载、编译及调试

Android 模拟器源码下载

Android 模拟器源码的下载与 Android AOSP 源码库的下载过程类似，可以参考 Google 官方提供的 Android 源码下载文档 来了解这个过程。

不同的地方在于，下载 Android 源码，在初始化 repo 客户端，初始化对某个分支的下载时，通过如下的命令指定该 Android 分支：

$ repo init -u https://android.googlesource.com/platform/manifest -b android-4.0.1_r1

而在下载模拟器源码时，则需要指定一个模拟器的分支。在 https://android.googlesource.com/platform/manifest/+refs 可以看到所有可以指定的分支，包括 Android 分支和模拟器分支，其中模拟器分支主要有如下这些：

emu-1.4-releaseemu-1.5-releaseemu-2.0-releaseemu-2.2-releaseemu-2.3-releaseemu-2.4-arcemu-2.4-releaseemu-2.5-releaseemu-master-dev

在初始化时，需要通过如下命令初始化对模拟器的下载，比如要下载最新的 2.5 版的 Release 版：

$ repo init -u https://android.googlesource.com/platform/manifest -b emu-2.5-release

后面同样通过 repo sync 命令下载整个源码树。

可以将模拟器源码分支理解为特殊的 Android 源码分支。

Android 模拟器编译

得到了 Android 模拟器的源码之后，进入下面的文件夹：

$ cd external/qemu/android/

执行如下命令编译源码：

./rebuild.sh --no-tests

其中的 --no-tests 告诉编译系统，编译完成之后不要执行测试程序，以节省时间，提高效率。

编译完成之后，产生的模拟器可执行文件及库文件都位于 external/qemu/objs/ 目录下：

~/emu-2.4-release/external/qemu/android$ ../objs/~/emu-2.4-release/external/qemu/objs$ lsandroid_emu64_unittests           emulator64-mipsandroid_emu_metrics64_unittests   emulator64_simg2imgbin64                             emulator64_test_crasherbuild                             emulator64-x86emugl64_common_host_unittests     emulator-checkemulator                          libemulator64-arm                    lib64emulator64_crashreport_unittests  lib64GLcommon_unittestsemulator64-crash-service          lib64OpenglRender_unittestsemulator64_img2simg               qemuemulator64_libui_unittests        resourcesemulator64_make_ext4fs

后面就可以像执行 SDK 中的模拟器那样，执行我们编译的模拟器了：

~/emu-2.4-release/external/qemu/objs$ ./emulator -avd Nexus_5_API_21_arm

Android 模拟器调试

要想调试 Android 模拟器，就需要生成带有调试符号等信息的可执行文件和库。这需要对我们前面执行的编译脚本程序 rebuild.sh 做一点微小的修改，在这个文件中会调用 android/configure.sh 程序来多编译过程做配置：

run android/configure.sh --out-dir=$OUT_DIR "$@" ||    panic "Configuration error, please run ./android/configure.sh to see why."

默认情况下，这个配置程序生成的配置文件，指导编译过程生成不含调试符号信息的可执行文件和库。但可以为 android/configure.sh 程序的执行加上 --symbols 以生成带有调试符号信息的可执行文件和库。

rebuild.sh 修改之后，大概就像下面这样：

run android/configure.sh --symbols --out-dir=$OUT_DIR "$@" ||    panic "Configuration error, please run ./android/configure.sh to see why."

修改之后，重新进入 external/qemu/android/ 目录下并执行 rebuild.sh。

这次将产生带有调试符号信息的可执行文件和库文件，这些文件位于 external/qemu/objs/build/debug_info 目录下：

~/emu-2.4-release/external/qemu/objs/build/debug_info$ lsandroid_emu64_unittests           emulator64_img2simg         emulator-checkandroid_emu_metrics64_unittests   emulator64_libui_unittests  lib64emugl64_common_host_unittests     emulator64_make_ext4fs      lib64GLcommon_unittestsemulator                          emulator64-mips             lib64OpenglRender_unittestsemulator64-arm                    emulator64_simg2img         qemuemulator64_crashreport_unittests  emulator64_test_crasheremulator64-crash-service          emulator64-x86

原来不带调试符号信息的文件依然位于 external/qemu/objs/ 目录下。

然后就可以通过 GDB 来调试带符号信息的可执行文件和库了。进入 external/qemu/objs/build/debug_info 目录下，执行如下命令：

~/emu-2.4-release/external/qemu/objs/build/debug_info$ gdb ./emulatorGNU gdb (Ubuntu 7.11.1-0ubuntu1~16.5) 7.11.1Copyright (C) 2016 Free Software Foundation, Inc.License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>This is free software: you are free to change and redistribute it.There is NO WARRANTY, to the extent permitted by law.  Type "show copying"and "show warranty" for details.This GDB was configured as "x86_64-linux-gnu".Type "show configuration" for configuration details.For bug reporting instructions, please see:<http://www.gnu.org/software/gdb/bugs/>.Find the GDB manual and other documentation resources online at:<http://www.gnu.org/software/gdb/documentation/>.For help, type "help".Type "apropos word" to search for commands related to "word"...Reading symbols from emulator...done.

该命令用于加载可执行文件。随后，在 GDB 的调试会话中，为可执行文件设置命令行参数，并设置端点：

(gdb) set args -avd Nexus_5_API_21_arm(gdb) break Thread_pthread.cpp:66(gdb) break emug::RenderThread::main

需要注意的是，为一个类函数设置端点时，需要带上它的命名空间。

然后启动可执行程序：

(gdb) run

随后在程序执行到我们加端点的位置时，程序将被断下来。

Done.