Android 模拟器源码下载
Android 模拟器源码的下载与 Android AOSP 源码库的下载过程类似,可以参考 Google 官方提供的 Android 源码下载文档 来了解这个过程。
<!--more-->不同的地方在于,下载 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 分支和模拟器分支,其中模拟器分支主要有如下这些:
1emu-1.4-release 2emu-1.5-release 3emu-2.0-release 4emu-2.2-release 5emu-2.3-release 6emu-2.4-arc 7emu-2.4-release 8emu-2.5-release 9emu-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/ 目录下:
1~/emu-2.4-release/external/qemu/android$ ../objs/ 2~/emu-2.4-release/external/qemu/objs$ ls 3android_emu64_unittests emulator64-mips 4android_emu_metrics64_unittests emulator64_simg2img 5bin64 emulator64_test_crasher 6build emulator64-x86 7emugl64_common_host_unittests emulator-check 8emulator lib 9emulator64-arm lib64 10emulator64_crashreport_unittests lib64GLcommon_unittests 11emulator64-crash-service lib64OpenglRender_unittests 12emulator64_img2simg qemu 13emulator64_libui_unittests resources 14emulator64_make_ext4fs
后面就可以像执行 SDK 中的模拟器那样,执行我们编译的模拟器了:
~/emu-2.4-release/external/qemu/objs$ ./emulator -avd Nexus_5_API_21_arm
Android 模拟器调试
要想调试 Android 模拟器,就需要生成带有调试符号等信息的可执行文件和库。这需要对我们前面执行的编译脚本程序 rebuild.sh 做一点微小的修改,在这个文件中会调用 android/configure.sh 程序来多编译过程做配置:
1run android/configure.sh --out-dir=$OUT_DIR "$@" || 2 panic "Configuration error, please run ./android/configure.sh to see why."
默认情况下,这个配置程序生成的配置文件,指导编译过程生成不含调试符号信息的可执行文件和库。但可以为 android/configure.sh 程序的执行加上 --symbols 以生成带有调试符号信息的可执行文件和库。
rebuild.sh 修改之后,大概就像下面这样:
1run android/configure.sh --symbols --out-dir=$OUT_DIR "$@" || 2 panic "Configuration error, please run ./android/configure.sh to see why."
修改之后,重新进入 external/qemu/android/ 目录下并执行 rebuild.sh。
这次将产生带有调试符号信息的可执行文件和库文件,这些文件位于 external/qemu/objs/build/debug_info 目录下:
1~/emu-2.4-release/external/qemu/objs/build/debug_info$ ls 2android_emu64_unittests emulator64_img2simg emulator-check 3android_emu_metrics64_unittests emulator64_libui_unittests lib64 4emugl64_common_host_unittests emulator64_make_ext4fs lib64GLcommon_unittests 5emulator emulator64-mips lib64OpenglRender_unittests 6emulator64-arm emulator64_simg2img qemu 7emulator64_crashreport_unittests emulator64_test_crasher 8emulator64-crash-service emulator64-x86
原来不带调试符号信息的文件依然位于 external/qemu/objs/ 目录下。
然后就可以通过 GDB 来调试带符号信息的可执行文件和库了。进入 external/qemu/objs/build/debug_info 目录下,执行如下命令:
1~/emu-2.4-release/external/qemu/objs/build/debug_info$ gdb ./emulator 2GNU gdb (Ubuntu 7.11.1-0ubuntu1~16.5) 7.11.1 3Copyright (C) 2016 Free Software Foundation, Inc. 4License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> 5This is free software: you are free to change and redistribute it. 6There is NO WARRANTY, to the extent permitted by law. Type "show copying" 7and "show warranty" for details. 8This GDB was configured as "x86_64-linux-gnu". 9Type "show configuration" for configuration details. 10For bug reporting instructions, please see: 11<http://www.gnu.org/software/gdb/bugs/>. 12Find the GDB manual and other documentation resources online at: 13<http://www.gnu.org/software/gdb/documentation/>. 14For help, type "help". 15Type "apropos word" to search for commands related to "word"... 16Reading symbols from emulator...done.
该命令用于加载可执行文件。随后,在 GDB 的调试会话中,为可执行文件设置命令行参数,并设置端点:
1(gdb) set args -avd Nexus_5_API_21_arm 2(gdb) break Thread_pthread.cpp:66 3(gdb) break emug::RenderThread::main
需要注意的是,为一个类函数设置端点时,需要带上它的命名空间。
然后启动可执行程序:
(gdb) run
随后在程序执行到我们加端点的位置时,程序将被断下来。
Done.