尽管我们一直万分谨慎，但 Android 源代码有时还是会出现一些小问题。本页记录了使用 Android 源代码方面的已知问题。
症状
在针对 toro 进行 AOSP 编译时（最高为 Jelly Bean 4.2.1），CellBroadcastReceiver 无法添加到系统中。原因：
vendor/samsung/toro/device-partial.mk 中存在拼写错误，PRODUCT_PACKAGES 将其中的 K 替换成了 H。解决方法：使用适用于 4.2.2 的最新程序包，或手动更正该拼写错误。
症状：在对 IceCreamSandwich 及更高版本进行的一些编译中，编译初期显示以下警告：/bin/bash: line 0: cd: cts/tools/cts-native-xml-generator/src/res: No
such file or directory
原因：有些 Makefile 引用该路径，但该路径并不存在。
解决方法：无。这是一个无害的警告。
症状：从 Gingerbread 分支直接编译的模拟器无法启动，一直卡在黑屏状态。
原因：Gingerbread 分支使用的是 R7 版本的模拟器，该模拟器并不具备运行最近推出的一些 Gingerbread 版本所需的所有功能。
解决方法：使用 R12 版本的模拟器，以及与这些工具匹配的较新内核。无需进行清除编译。
$ repo forall platform/external/qemu -c git checkout aosp/tools_r12
$ make
$ emulator -kernel prebuilt/android-arm/kernel/kernel-qemu-armv7
症状：在 MacOS 10.7 Lion 和/或 XCode 4.x 中编译的模拟器（所有版本）无法启动。
原因：在开发环境中进行的某些更改导致系统在对模拟器进行编译时，采用的方式使模拟器无法正常工作。
解决方法：使用 SDK 中的模拟器二进制文件，该文件是通过 XCode 3 在 MacOS 10.6 中编译的，可在 MacOS 10.7 中正常工作。
WITH_DEXPREOPT=true 和模拟器编译。症状：在模拟器编译期间进行部分编译或同步（使系统没有任何依赖关系）时，生成的版本无法正常工作。
原因：默认情况下，所有模拟器编译操作现在都会在编译时运行 Dex 优化，这就需要遵循所有依赖关系，以便在框架每次发生更改时都重新优化应用。
解决方法：通过 export WITH_DEXPREOPT=false 在本地停用 Dex 优化，通过 make installclean 删除现有的已优化版本，然后运行完整编译以重新生成未优化的版本。完成上述操作后，部分编译将会正常工作。
症状：所有编译都会失败，并且系统会提示“权限遭拒”，可能还会显示防病毒警告。
原因：某些防病毒程序将 Android 源代码树中的一些源文件错误地识别为包含病毒的文件。
解决方法：确认实际上并未包含病毒之后，在 Android 树中停用防病毒程序。这还有助于减少编译次数。
症状：编译会失败，而且症状各式各样。其中一种症状是 cc1: error: unrecognized command line option "-m32"
原因：Android 编译系统使用路径中的默认编译器，并假设它是用于生成在主机上运行的二进制文件的合适编译器。其他情况（例如：使用 Android NDK，或编译内核）导致默认编译器不是主机编译器。
解决方法：使用一个“干净的”shell，其中没有任何先前操作可能更换了默认编译器。
症状：编译会失败，而且症状各式各样，并且系统可能会提示缺少文件或文件格式不正确。其中一种症状是 member [...] in archive is not an object。
原因：Android 编译系统倾向于使用多种主机工具并依赖其默认行为。有些设置会更改这些工具的行为，导致其行为方式干扰编译系统。导致此类问题的已知变量是 CDPATH 和 GREP_OPTIONS。
解决方法：在自定义设置尽可能少的环境中编译 Android。
症状：在 MacOS 10.7 中编译 IceCreamSandwich 4.0.x（及更低版本）时会失败，并显示类似以下的错误：Undefined symbols for architecture i386: "_SDL_Init"
原因：4.0.x 与 MacOS 10.7 不兼容。
解决方法：改用 MacOS 10.6，或使用可在 MacOS 10.7 中编译的 master 分支。
$ repo init -b master
$ repo sync
症状：使用 XCode 4.3 时，所有编译都会失败。
原因：XCode 4.3 将默认编译器从 gcc 切换成了 llvm，而 llvm 拒绝接受之前 gcc 会接受的代码。
解决方法：使用 XCode 4.2。
症状：在 Ubuntu 11.10 及更高版本中编译 IceCreamSandwich 4.0.x（及更低版本）时会失败，并显示类似以下的错误：<command-line>:0:0: warning: "_FORTIFY_SOURCE" redefined [enabled by default]
原因：Ubuntu 11.10 使用的 gcc 版本中默认已定义该符号，而 Android 也会定义该符号，从而导致冲突。
解决方法：改用 Ubuntu 10.04，或使用可在 Ubuntu 11.10 及更高版本中编译的 master 分支。
$ repo init -b master
$ repo sync
症状：repo init 或 repo sync 失败，并显示 HTTP 错误，通常为 403 或 500。
原因：有很多可能的原因，大多数情况下都与 HTTP 代理有关，这些代理无法顺利传输大量数据。
解决方法：虽然还没有通用的解决方法，但有人报告说使用 Python 2.7 以及明确使用 repo sync -j1 可以改善某些用户的情况。
症状：在某些 VirtualBox 安装过程中运行 repo sync 时，进程挂起或失败，而且症状各式各样。其中一种症状是 DownloadError: HTTP 500 (Internal Server Error: Server got itself in trouble)。
原因：VirtualBox 的默认网络行为是使用 NAT（网络地址转换）将客户系统连接到网络。在执行 repo sync 时的大量网络活动会触发 NAT 代码中的某些临界情况。
解决方法：将 VirtualBox 配置为使用桥接网络，而非 NAT。
症状：在运行 repo sync 时进程失败，并显示与无法识别主机名相关的各种错误。其中一种错误是 <urlopen error [Errno -2] Name or service not known>。
原因：有些 DNS 系统难以应对同步源代码树时涉及的大量查询（在最糟糕的情况下，可能会有数百条查询请求）。
解决方法：手动解析相关主机名，并在本地对解析结果进行硬编码。
您可以使用 nslookup 命令解析主机名，该命令将为每个主机名指定一个数字 IP 地址（通常是在输出的“Address”（地址）部分）。
$ nslookup googlesource.com
$ nslookup android.googlesource.com
然后，您可以在本地对它们进行硬编码，方法是修改 /etc/hosts，在该文件中添加两行内容，形式如下：
aaa.bbb.ccc.ddd googlesource.com
eee.fff.ggg.hhh android.googlesource.com
请注意，这种方法只适用于服务器的地址不会更改的情况；如果服务器的地址发生更改，导致您无法连接，那么您必须重新解析这些主机名，并相应地修改 etc/hosts。
症状：在同步时 repo sync 挂起，通常是在同步操作完成 99% 时出现这种情况。
原因：TCP/IP 堆栈中的某些设置在有些网络环境中会导致出现问题，使得 repo sync 既无法完成，也不会失败。
解决方法：在 Linux 中，请运行 sysctl -w net.ipv4.tcp_window_scaling=0。在 MacOS 中，请在网络设置部分停用 rfc1323 扩展程序。
症状：摄像头和 GPS 在 Galaxy Nexus 上无法正常工作。比如，摄像头应用一启动便会崩溃。
原因：Android 开放源代码项目中未提供这些硬件外围设备所需的专有库。
解决方法：无。