blob: 865a64af598d698ce40e039f39d71866202a5d45 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
<html devsite><head>
<title>已知问题</title>
<meta name="project_path" value="/_project.yaml"/>
<meta name="book_path" value="/_book.yaml"/>
</head>
<body>
<!--
Copyright 2017 The Android Open Source Project
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<p>尽管我们一直万分谨慎，但 Android 源代码有时还是会出现一些小问题。本页记录了使用 Android 源代码方面的已知问题。</p>
<h2 id="build-issues">编译问题</h2>
<h3 id="missing-cellbroadcastreceiver">在针对 toro 进行编译时缺少 CellBroadcastReceiver</h3>
<p><strong>症状</strong></p>在针对 toro 进行 AOSP 编译时（最高为 Jelly Bean 4.2.1），CellBroadcastReceiver 无法添加到系统中。<p></p>
<p><strong>原因：</strong></p><code>vendor/samsung/toro/device-partial.mk</code> 中存在拼写错误，<code>PRODUCT_PACKAGES</code> 将其中的 K 替换成了 H。<p><strong>解决方法</strong>：使用适用于 4.2.2 的最新程序包，或手动更正该拼写错误。</p>
<h3 id="missing-cts-native-xml-generator">缺少 CTS 本机 XML 生成器</h3>
<p><strong>症状</strong>：在对 IceCreamSandwich 及更高版本进行的一些编译中，编译初期显示以下警告：<code>/bin/bash: line 0: cd: cts/tools/cts-native-xml-generator/src/res: No
such file or directory</code></p>
<p><strong>原因</strong>：有些 Makefile 引用该路径，但该路径并不存在。</p>
<p><strong>解决方法</strong>：无。这是一个无害的警告。</p>
<h3 id="black-gingerbread-emulator">黑屏 Gingerbread 模拟器</h3>
<p><strong>症状</strong>：从 Gingerbread 分支直接编译的模拟器无法启动，一直卡在黑屏状态。</p>
<p><strong>原因</strong>：Gingerbread 分支使用的是 R7 版本的模拟器，该模拟器并不具备运行最近推出的一些 Gingerbread 版本所需的所有功能。</p>
<p><strong>解决方法</strong>：使用 R12 版本的模拟器，以及与这些工具匹配的较新内核。无需进行清除编译。</p>
<pre><code>$ repo forall platform/external/qemu -c git checkout aosp/tools_r12
$ make
$ emulator -kernel prebuilt/android-arm/kernel/kernel-qemu-armv7
</code></pre>
<h3 id="emulator-built-on-macos-107-lion-doesnt-work">在 MacOS 10.7 Lion 中编译的模拟器无法正常工作。</h3>
<p><strong>症状</strong>：在 MacOS 10.7 Lion 和/或 XCode 4.x 中编译的模拟器（所有版本）无法启动。</p>
<p><strong>原因</strong>：在开发环境中进行的某些更改导致系统在对模拟器进行编译时，采用的方式使模拟器无法正常工作。</p>
<p><strong>解决方法</strong>：使用 SDK 中的模拟器二进制文件，该文件是通过 XCode 3 在 MacOS 10.6 中编译的，可在 MacOS 10.7 中正常工作。</p>
<h3 id="partial-and-emulator-builds"><code>WITH_DEXPREOPT=true</code> 和模拟器编译。</h3>
<p><strong>症状</strong>：在模拟器编译期间进行部分编译或同步（使系统没有任何依赖关系）时，生成的版本无法正常工作。</p>
<p><strong>原因</strong>：默认情况下，所有模拟器编译操作现在都会在编译时运行 Dex 优化，这就需要遵循所有依赖关系，以便在框架每次发生更改时都重新优化应用。</p>
<p><strong>解决方法</strong>：通过 <code>export WITH_DEXPREOPT=false</code> 在本地停用 Dex 优化，通过 <code>make installclean</code> 删除现有的已优化版本，然后运行完整编译以重新生成未优化的版本。完成上述操作后，部分编译将会正常工作。</p>
<h3 id="permission-denied-during-builds">编译期间提示“权限遭拒”。</h3>
<p><strong>症状</strong>：所有编译都会失败，并且系统会提示“权限遭拒”，可能还会显示防病毒警告。</p>
<p><strong>原因</strong>：某些防病毒程序将 Android 源代码树中的一些源文件错误地识别为包含病毒的文件。</p>
<p><strong>解决方法</strong>：确认实际上并未包含病毒之后，在 Android 树中停用防病毒程序。这还有助于减少编译次数。</p>
<h3 id="build-errors-related-to-using-the-wrong-compiler">与使用错误编译器相关的编译错误。</h3>
<p><strong>症状</strong>：编译会失败，而且症状各式各样。其中一种症状是 <code>cc1: error: unrecognized command line option "-m32"</code></p>
<p><strong>原因</strong>：Android 编译系统使用路径中的默认编译器，并假设它是用于生成在主机上运行的二进制文件的合适编译器。其他情况（例如：使用 Android NDK，或编译内核）导致默认编译器不是主机编译器。</p>
<p><strong>解决方法</strong>：使用一个“干净的”shell，其中没有任何先前操作可能更换了默认编译器。</p>
<h3 id="build-errors-caused-by-non-default-tool-settings">由非默认工具设置导致的编译错误。</h3>
<p><strong>症状</strong>：编译会失败，而且症状各式各样，并且系统可能会提示缺少文件或文件格式不正确。其中一种症状是 <code>member [...] in archive is not an object</code>。</p>
<p><strong>原因</strong>：Android 编译系统倾向于使用多种主机工具并依赖其默认行为。有些设置会更改这些工具的行为，导致其行为方式干扰编译系统。导致此类问题的已知变量是 <code>CDPATH</code> 和 <code>GREP_OPTIONS</code>。</p>
<p><strong>解决方法</strong>：在自定义设置尽可能少的环境中编译 Android。</p>
<h3 id="build-error-with-40x-and-earlier-on-macos-107">在 MacOS 10.7 中编译 4.0.x 及更低版本时出现的错误。</h3>
<p><strong>症状</strong>：在 MacOS 10.7 中编译 IceCreamSandwich 4.0.x（及更低版本）时会失败，并显示类似以下的错误：<code>Undefined symbols for architecture i386: "_SDL_Init"</code></p>
<p><strong>原因</strong>：4.0.x 与 MacOS 10.7 不兼容。</p>
<p><strong>解决方法</strong>：改用 MacOS 10.6，或使用可在 MacOS 10.7 中编译的 master 分支。</p>
<pre><code>$ repo init -b master
$ repo sync
</code></pre>
<h3 id="build-error-on-macos-with-xcode-43">在 MacOS 中使用 XCode 4.3 进行编译时出现的错误。</h3>
<p><strong>症状</strong>：使用 XCode 4.3 时，所有编译都会失败。</p>
<p><strong>原因</strong>：XCode 4.3 将默认编译器从 gcc 切换成了 llvm，而 llvm 拒绝接受之前 gcc 会接受的代码。</p>
<p><strong>解决方法</strong>：使用 XCode 4.2。</p>
<h3 id="build-error-with-40x-and-earlier-on-ubuntu-1110">在 Ubuntu 11.10 中编译 4.0.x 及更低版本时出现的错误。</h3>
<p><strong>症状</strong>：在 Ubuntu 11.10 及更高版本中编译 IceCreamSandwich 4.0.x（及更低版本）时会失败，并显示类似以下的错误：<code><command-line>:0:0: warning: "_FORTIFY_SOURCE" redefined [enabled by default]</code></p>
<p><strong>原因</strong>：Ubuntu 11.10 使用的 gcc 版本中默认已定义该符号，而 Android 也会定义该符号，从而导致冲突。</p>
<p><strong>解决方法</strong>：改用 Ubuntu 10.04，或使用可在 Ubuntu 11.10 及更高版本中编译的 master 分支。</p>
<pre><code>$ repo init -b master
$ repo sync
</code></pre>
<h2 id="source-sync">源代码同步问题</h2><h2>
</h2><h3 id="difficulties-syncing-the-source-code-proxy-issues">同步源代码时遇到的问题（代理问题）。</h3>
<p><strong>症状</strong>：<code>repo init</code> 或 <code>repo sync</code> 失败，并显示 HTTP 错误，通常为 403 或 500。</p>
<p><strong>原因</strong>：有很多可能的原因，大多数情况下都与 HTTP 代理有关，这些代理无法顺利传输大量数据。</p>
<p><strong>解决方法</strong>：虽然还没有通用的解决方法，但有人报告说使用 Python 2.7 以及明确使用 <code>repo sync -j1</code> 可以改善某些用户的情况。</p>
<h3 id="difficulties-syncing-the-source-tree-virtualbox-ethernet-issues">同步源代码树时遇到的问题（VirtualBox 以太网问题）。</h3>
<p><strong>症状</strong>：在某些 VirtualBox 安装过程中运行 <code>repo sync</code> 时，进程挂起或失败，而且症状各式各样。其中一种症状是 <code>DownloadError: HTTP 500 (Internal Server Error: Server got itself in trouble)</code>。</p>
<p><strong>原因</strong>：VirtualBox 的默认网络行为是使用 NAT（网络地址转换）将客户系统连接到网络。在执行 repo sync 时的大量网络活动会触发 NAT 代码中的某些临界情况。</p>
<p><strong>解决方法</strong>：将 VirtualBox 配置为使用桥接网络，而非 NAT。</p>
<h3 id="difficulties-syncing-the-source-tree-dns-issues">同步源代码树时遇到的问题（DNS 问题）。</h3>
<p><strong>症状</strong>：在运行 <code>repo sync</code> 时进程失败，并显示与无法识别主机名相关的各种错误。其中一种错误是 <code><urlopen error [Errno -2] Name or service not known></code>。</p>
<p><strong>原因</strong>：有些 DNS 系统难以应对同步源代码树时涉及的大量查询（在最糟糕的情况下，可能会有数百条查询请求）。</p>
<p><strong>解决方法</strong>：手动解析相关主机名，并在本地对解析结果进行硬编码。</p>
<p>您可以使用 <code>nslookup</code> 命令解析主机名，该命令将为每个主机名指定一个数字 IP 地址（通常是在输出的“Address”（地址）部分）。</p>
<pre><code>$ nslookup googlesource.com
$ nslookup android.googlesource.com
</code></pre>
<p>然后，您可以在本地对它们进行硬编码，方法是修改 <code>/etc/hosts</code>，在该文件中添加两行内容，形式如下：</p>
<pre><code>aaa.bbb.ccc.ddd googlesource.com
eee.fff.ggg.hhh android.googlesource.com
</code></pre>
<p>请注意，这种方法只适用于服务器的地址不会更改的情况；如果服务器的地址发生更改，导致您无法连接，那么您必须重新解析这些主机名，并相应地修改 <code>etc/hosts</code>。</p>
<h3 id="difficulties-syncing-the-source-tree-tcp-issues">同步源代码树时遇到的问题（TCP 问题）。</h3>
<p><strong>症状</strong>：在同步时 <code>repo sync</code> 挂起，通常是在同步操作完成 99% 时出现这种情况。</p>
<p><strong>原因</strong>：TCP/IP 堆栈中的某些设置在有些网络环境中会导致出现问题，使得 <code>repo sync</code> 既无法完成，也不会失败。</p>
<p><strong>解决方法</strong>：在 Linux 中，请运行 <code>sysctl -w net.ipv4.tcp_window_scaling=0</code>。在 MacOS 中，请在网络设置部分停用 rfc1323 扩展程序。</p>
<h2 id="runtime-issues">运行时问题</h2>
<h3 id="camera-and-gps-dont-work-on-galaxy-nexus">摄像头和 GPS 在 Galaxy Nexus 上无法正常工作。</h3>
<p><strong>症状</strong>：摄像头和 GPS 在 Galaxy Nexus 上无法正常工作。比如，摄像头应用一启动便会崩溃。</p>
<p><strong>原因</strong>：Android 开放源代码项目中未提供这些硬件外围设备所需的专有库。</p>
<p><strong>解决方法</strong>：无。</p>
</body></html>
|
