获取源代码
几个分支
目前,我们有以下几个可能的分支:
开发分支 | 发布分支 | IntelliJ | 备注 |
studio-1.0-dev | studio-1.0-release | idea13-dev | 这是个用于1.0的分支 已关闭 |
studio-1.1-dev | studio-1.1-release | idea13-1.1-dev | 这是个用于1.1的分支 已关闭 |
studio-1.2-dev | studio-1.2-release | idea14-1.2-dev | 这是个用于1.2的分支 现在只在修复BUG |
studio-1.3-dev | studio-1.3-release | idea14-1.3-dev | 这是个用于 1.3的分支 |
studio-master-dev | studio-master-dev | idea14-dev | 这个分支用于提交到1.3 |
当前的开发分支是studio-1.2-dev。
我们会进行自动合并,顺序如下: studio-1.0-dev -> studio-1.1-dev -> studio-1.2-dev -> studio-1.3-dev -> studio-master-dev
ub-tools-idea133和ub-tools-master分支已经停用了。我们也没有使用master分支。
检出代码
首先,你需要为你的平台安装一些先决条件。这意味着你需要 git,C 编译器,等等。这里有相当多的步骤,并且这一切都依赖于平台,因此请转到正式的构建介绍,那里我们有详细的说明: http://source.android.com/source/initializing.html。
有些要求是不需要的(比如区分大小写的文件系统),除非您也计划构建这个平台。您还需要 XCode 用于构建模拟器。
一旦你配置好一切后,按照这下面的说明下载“repo”工具: http://source.android.com/source/downloading.html
然后你就可以通过在shell中使用下面的命令来检出源代码了:
$ mkdir studio-1.3-dev
$ cd studio-1.3-dev
$ repo init -u https://android.googlesource.com/platform/manifest -b studio-1.3-dev
$ repo sync
(显然,你可以创建一个你想要的顶级目录;我们中那些检出多个分支的人,更愿意在分支后重命名这个目录。
检出一个特定的发布分支
我们正在开始标记发布版本。这意味着您可以使用标记(tag)来获得某个特定版本的源代码。我们当前正在使用下列标记:
Gradle | gradle_x.y.z |
Studio | studio_x.y.z |
例如,您可以使用下面的命令来检出 1.0.0 版本的Gradle 插件:
$
repo init -u https://android.googlesource.com/platform/manifest -b gradle_1.0.0
$ repo sync
进行构建
可以通过 studio-* branches 构建的 SDK 的部分,只是 IDE 的组件和 SDK Tools。由于不由的构建系统,每个组件的构建是不同的。
它们都不使用基于make 的平台构建系统
构建 Android Studio
从历史上看,构建 Android tools 也需要构建整个的 Android SDK,因为比如模拟器,就需要系统镜像(system image)。
然而,我们已经逐渐地把 tools 的源代码迁移到更加独立的安装程序中,您现在可以在没有完全检出Android 和 C 编译器的情况下,构建 Android Studio IDE。构建 Android 工作室的说明列于 构建 Android Studio页 ;本文档的其余部分记录了构建其他tools(Eclipse
插件、 模拟器等) 的过程
构建 Android Gradle 插件
相关说明请参见生成 Android Gradle 插件。
构建 Linux 和 MacOS 的 SDK
这一部分仅生成 SDK Tools。请按照下列步骤操作:
$ mkdir -p out/dist
$ ./tools/buildSrc/servers/build_tools.sh `pwd`/out `pwd`/out/dist 1234
这将会为你当前的平台构建 SDK Tools。构建结果位于于 out/sdk/
由以下内容组成
- 模拟器及相关联的可执行文件和类库
- 基于 Java 的独立tools
- 监视器
只用基于Java的tools,你可以在tools/base 中打开IJ 项目。
如果要只构建或测试 java tools:
$ cd tools/
$ ./gradlew assemble // builds only
$ ./gradlew check // runs tests as well.
构建 Windows SDK
这些操作指南目前已经过时了。新的指南即将推出。
完整的 Windows SDK 构建只在Linux上才支持——大部分的框架都不是设计于在 Windows 上构建,所以从技术上说,Windows SDK 是在被替换了一些二进制文件的 Linux SDK 上面构建的。.
安装:
$ sudo apt-get install mingw32 tofrodos
mingw32 是交叉编译器,tofrodos 则添加了一个 unix2dos 命令
用于构建:
$ . build/envsetup.sh
$ lunch sdk-eng
$ make win_sdk
注意,这将会先构建出 Linux SDK,然后构建出 Windows SDK。构建结果位于
out/host/windows/sdk/android-sdk_eng.username_windows /
构建基于 Eclipse 的Tools。
下一步是基于你想要工作的项目准备安装:
- Traceview, Hierarchy Viewer 和 DDMS 是所有要安装的,如下:
- 核心逻辑分别位于 sdk/traceview、 sdk/hierarchyviewer2 和 sdk/ddms 下的 Java 项目。将这些项目导入 Eclipse。
- 上述项目会生成jar文件,然后由它们相应的插件引用。traceview 插件、 hierarchyviewer 插件和 ddms 插件,都位于 sdk/eclipse/plugins 下。
- 待办:添加模拟器的说明