转载

macOS（Sierra）上Android源码的下载、编译与导入到Android Studio

整理中，未完，待续~~

背景

背景简介

最近因为项目需要，要研究Android系统中应用安装的详细过程。在这种场景下，最好的办法就是Read the Fucking Source Code。之前都是在线看，这次因为看的内容比较多，而且看的比较细，因此打算在本地checkout一份。这篇文章就 主要记录本人使用macOS(Sierra 10.12.1)在本地checkout出AOSP并编译导入Android Studio的完整过程 。

参考内容

关于如果checkout源码，其实网上已经有很详细的内容，个人在checkout的过程中主要参考了以下内容，也可直接按照他们的建议尝试：

  1. Google官方关于checkout的指引： https://source.android.com/source/index.html
    • 清华大学Android镜像关于checkout的指引： https://mirrors.tuna.tsinghua.edu.cn/help/AOSP/#section-1
    • 中国科学技术大学AOSP(Android) 镜像使用帮助： https://lug.ustc.edu.cn/wiki/mirrors/help/aosp
    • Android源码的下载、编译与导入到Android Studio： http://wl9739.github.io/2016/05/09/Android%E6%BA%90%E7%A0%81%E7%9A%84%E4%B8%8B%E8%BD%BD%E3%80%81%E7%BC%96%E8%AF%91%E4%B8%8E%E5%AF%BC%E5%85%A5%E5%88%B0Android-Studio/

checkout时推荐使用清华大学的镜像，checkout过程中有交替切换测试，发现清华大学的镜像会比VPN的效果相对好一点（也可能是个人的VPN不够快）。

系统环境

在完成下面的准备工作相关的内容以后，本机的系统环境如下：

  • macOS Sierra 10.12.1
  • JDK 1.8.0_77
  • Xcode 8.2.1
  • 本地源码地址：/Volumes/Document/android (对应分区存储空间450G)
  • shell：bash

准备工作

创建分区

由于macOS默认的文件系统是大小写不敏感的，如果不做处理，编译过程会引起下面的异常

Checking build tools versions...
build/core/main.mk:159: ************************************************************
build/core/main.mk:160: You are building on a case-insensitive filesystem.
build/core/main.mk:161: Please move your source tree to a case-sensitive filesystem.
build/core/main.mk:162: ************************************************************
build/core/main.mk:163: *** Case-insensitive filesystems not supported.
make: *** [out/build-aosp_arm.ninja] Error 1

为了避免该异常，我们要首先在macOS里面创建一个支持大小写敏感的文件系统。具体的方法可以参考下面两篇文章：

  • Android官网的Setting up a Mac OS build environment： https://source.android.com/source/initializing.html#setting-up-a-mac-os-x-build-environment
  • 个人博客的macOS中设置大小写敏感的分区并切换 http://blog.bihe0832.com/mac-disk-utility.html

本人选择checkout的源码是android-7.1.1_r6，下载完占用空间22.12 GB，编译完占用空间 G，因此建议分区的时候，Android源码至少使用 G

创建目录

在新的分区磁盘创建你放保存源码的目录，例如我直接放在新建分区（Document）根目录的android文件夹。

$ mkdir /Volumes/Document/android

然后进入对应目录继续开始接下来的工作

$ cd /Volumes/Document/android

切换shell

由于Android的相关编译只能是使用bash，因此如果是使用zsh等其余的shell，请先切换shell到bash。切换方法

  • 用如下命令切换shell:

    $ chsh -s /bin/bash

  • 重启终端。只有重启终端shell切换才会生效。可以使用下面的命令检查当前的shell:

    $ echo $0
  -bash

安装软件

下面的软件是在编译源码过程中需要使用到的软件，建议提前下载好。最好是按照下面的顺序来下载，部分软件间有一定的依赖关系。

Xcode

  • 使用场景：在编译源码是使用，我直接下载了最新版
  • 下载地址： https://itunes.apple.com/us/app/xcode/id497799835?ls=1&mt=12

MacOSX-SDK

  • 使用场景：在编译源码是使用，macOS10.12.SDK弃用了编译源码需要的syscall，因此需要单独下载更早版本的macOS的SDK
  • 下载地址： https://github.com/phracker/MacOSX-SDKs
  • 暂时下载准备好即可，会在后文中具体介绍怎么使用。另外由于整个github项目也不大，可以直接全部下载下来，这样比较方便。

JDK

  • 使用场景：在编译源码是使用，我使用的版本是：jdk1.8.0_77
  • 下载地址： http://www.oracle.com/technetwork/java/javase/downloads/java-archive-javase8-2177648.html#jdk-8u45-oth-JPR

MacPorts

  • 使用场景：用来下载其余编译源码需要的软件，我使用的版本是macOS Sierra v10.12对应的版本
  • 下载地址： https://www.macports.org/install.php

其他软件

  • 使用场景：用来下载其余编译源码需要的软件，可以使用MacPorts来安装

  • 安装方法：在MacPorts安装好以后运行下面的命令即可安装gmake等编译工具

    $ POSIXLY_CORRECT=1 sudo port install gmake libsdl git gnupg
  • 备注：

    1. 如果这里报错 port: command not found ，说找不到port命令，就需要在命令行运行下面的命令: 

      $ export PATH=/opt/local/bin:$PATH

    • 如果在这里报错 Port gmake not found ，那就在安装之前需要先执行下面的命令。 

      $ sudo port -d sync

      然后就可以再执行上面的命令安装相关的工具了

概览

在上述内容都安装完毕以后，本机的系统环境如下：

  • macOS Sierra 10.12.1
  • JDK 1.8.0_77
  • Xcode 8.2.1
  • shell：bash

下载

下载Repo

Repo is a tool that makes it easier to work with Git in the context of Android.简单理解，Repo就是一个方便你checkout Android相关源码的工具。官方、清华和中科大镜像都提供了对应的Repo的下载。

备注：下载Repo之前，官方提示需要创建一个bin文件，并且将路径写入到path中，不过这一步我没有操作，下面是官方给出的操作步骤：

$ mkdir ~/bin
$ PATH=~/bin:$PATH

我没有设置环境变量，直接跳转到上一步创建的目录下，然后在命令行中输入下面的命令，下载Repo，并且修改属性。建议直接你使用的镜像提供的Repo。本人是直接下载了官方提供的镜像。

$ curl https://storage.googleapis.com/git-repo-downloads/repo > ./repo
$ chmod a+x ~/bin/repo

下面是官方给出的三个版本的Repo的sha。

  • For version 1.21, the SHA-1 checksum for repo is b8bd1804f432ecf1bab730949c82b93b0fc5fede

  • For version 1.22, the SHA-1 checksum for repo is da0514e484f74648a890c0467d61ca415379f791

  • For version 1.23, the SHA-1 checksum for repo is ac9d646f6d699f6822a6bc787d3e7338ae7ab6ed

初始化Repo

继续在根目录，初始化Repo，主要是设置你使用的镜像以及想要checkout的Android的版本。例如使用官方的镜像，下载android-7.1.1_r6的源码，运行下面的命令

$ repo init -u https://android.googlesource.com/platform/manifest -b  android-7.1.1_r6

如果是使用清华的镜像，运行

$ repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-7.1.1_r6

关于源码和tag的对应关系，可以在官网查看，Source Code Tags and Builds： https://source.android.com/source/build-numbers.html#source-code-tags-and-builds

下载源码

完成上面的初始化任务以后，就可以开始调用下面的命令来下载源码，repo同步是支持断点续传。因此如果下载过程中终端以后，继续执行下面的命令就可以接着下载，并不会从头开始：

$ repo sync -j4

命令最后的j4的意思是同时发起四个并发请求，之所以选择4是因为清华的镜像的并发请求的限制的上限就是4个。

由于下载时间太长，中途可能会出现链接断开的情况，尤其是很多人会选择半夜下载，如果链接断开了没能继续就白白浪费了一个晚上，湫水长天的博客里面提供了一个自己写的简单的shell脚本可以参考，本人略做了修改。

#!/bin/bash 
repo sync -j4
while [ $? = 1 ]; do 
   echo "================sync failed, re-sync again =====" 
   sleep 3 
   repo sync
   	done

将上面的代码保存成repo_sync.sh，放在下载源码的根目录，例如我的/Volumes/Document/android，然后在命令行运行

/bin/bash ./get_android.sh

源码的下载时间会非常长，因此建议选择晚上下载。 由于macOS默认的节能设置，为了防止mac在长时间无操作以后休眠，因此建议修改macOS中关于节能相关的配置。修改路径为：系统偏好设置-》节能。下图为本人修改后的效果：

macOS（Sierra）上Android源码的下载、编译与导入到Android Studio

编译

当源码全部下载完成以后，就进入了源码编译环节。

编译前准备

切换shell

在准备工作中已经提醒，为防止有人遗忘，再次提示一次。 由于Android的相关编译只能是使用bash，因此如果是使用zsh等其余的shell，请先切换shell到bash。 切换方法：

  • 用如下命令切换shell:

    $ chsh -s /bin/bash

  • 重启终端。只有重启终端shell切换才会生效。

设置文件描述符限制

在macOS中，默认限制的同时打开的文件数量很少，不能满足编译过程中的高并发需要，因此需要在shell中运行命令：

$ ulimit -S -n 1024

编译源码

环境设置

在源码根目录（/Volumes/Document/android）下调用下面的命令：

$ source build/envsetup.sh

选择设备

在命令行输入下面的命令选择打算编译的源码类型

$ lunch
	
	You're building on Darwin
	
	Lunch menu... pick a combo:
	     1. aosp_arm-eng
	     2. aosp_arm64-eng
	     3. aosp_mips-eng
	     4. aosp_mips64-eng
	     5. aosp_x86-eng
	     6. aosp_x86_64-eng
	     7. full_fugu-userdebug
	     8. aosp_fugu-userdebug
	     9. mini_emulator_arm64-userdebug
	     10. m_e_arm-userdebug
	     11. m_e_mips-userdebug
	     12. m_e_mips64-eng
	     13. mini_emulator_x86-userdebug
	     14. mini_emulator_x86_64-userdebug
	     15. aosp_dragon-userdebug
	     16. aosp_dragon-eng
	     17. aosp_marlin-userdebug
	     18. aosp_sailfish-userdebug
	     19. aosp_flounder-userdebug
	     20. aosp_angler-userdebug
	     21. aosp_bullhead-userdebug
	     22. hikey-userdebug
	     23. aosp_shamu-userdebug
	
	Which would you like? [aosp_arm-eng]

根据后缀可以判断出使用的场景如下：

类型 用途
user 权限少，用于刷机使用
userdebug 和“user”类似，但可以root，并且可以调试
eng 具有开发配置，并且有额外的调试工具

根据需要选择对应的类型，比如我选择 “1”

Which would you like? [aosp_arm-eng] 1

============================================
PLATFORM_VERSION_CODENAME=REL
PLATFORM_VERSION=7.1.1
TARGET_PRODUCT=aosp_arm
TARGET_BUILD_VARIANT=eng
TARGET_BUILD_TYPE=release
TARGET_BUILD_APPS=
TARGET_ARCH=arm
TARGET_ARCH_VARIANT=armv7-a
TARGET_CPU_VARIANT=generic
TARGET_2ND_ARCH=
TARGET_2ND_ARCH_VARIANT=
TARGET_2ND_CPU_VARIANT=
HOST_ARCH=x86_64
HOST_2ND_ARCH=x86
HOST_OS=darwin
HOST_OS_EXTRA=Darwin-16.1.0-x86_64-i386-64bit
HOST_CROSS_OS=
HOST_CROSS_ARCH=
HOST_CROSS_2ND_ARCH=
HOST_BUILD_TYPE=release
BUILD_ID=NMF26Q
OUT_DIR=out
============================================

开始编译

为了加快编译的速度，我们最好并发来编译，首先查看下本机CPU的内核数与线程数：

$ sysctl machdep.cpu
machdep.cpu.tsc_ccc.denominator: 0
machdep.cpu.tsc_ccc.numerator: 0
machdep.cpu.thread_count: 8
machdep.cpu.core_count: 4

可以看到线程数为8，因此我们执行下面的命令开始源码相关的编译

$ make -j16

参数-jN中的数字N，即为根据电脑线程数量设置的并发值，一般为线程数的1～2倍。 之后就会开启漫长的一到两个小时的编译过程。编译过程可能出错，出错以后继续运行命令编辑即可。

编译异常解决

在启动编译的过程中，比较常见的遇到的问题主要有：

  • 文件分区不支持大小写

    • 错误现象

      Checking build tools versions...
  build/core/main.mk:159: ************************************************************
  build/core/main.mk:160: You are building on a case-insensitive filesystem.
  build/core/main.mk:161: Please move your source tree to a case-sensitive filesystem.
  build/core/main.mk:162: ************************************************************
  build/core/main.mk:163: *** Case-insensitive filesystems not supported.
  make: *** [out/build-aosp_arm.ninja] Error 1

    • 解决方案

      查看文章最开始准备工作中关于macOS分区配置的说明

  • could not find jdk tools.jar

    • 错误现象

      $ make -j16
  build/core/config.mk:600: *** Error: could not find jdk tools.jar at /System/Library/Frameworks/JavaVM.framework/Versions/Current/Commands/../lib/tools.jar, please check if your JDK was installed correctly.  Stop.

    • 解决方案

      主要是因为环境变量没有设置 ANDROID_JAVA_HOME 导致的，添加对应的环境变量即可，输入下面的命令： 

      export ANDROID_JAVA_HOME=$(/usr/libexec/java_home -v 1.8)

  • ‘syscall’ is deprecated:

    • 错误现象：

      编译过程中直接报错，看编译报类似下文的错误：

      system/core/libcutils/threads.c:38:10: error: 'syscall' is deprecated: first deprecated in OS X 10.12 - syscall(2) is unsupported; please switch to a supported interface. For SYS_kdebug_trace use kdebug_signpost(). [-Werror,-Wdeprecated-declarations]
    return syscall(SYS_thread_selfid);

    • 解决方案

      这是因为最新的macOS的调整引起的，个人下载的最新版的源码也没有解决这个问题，最终采用的方法是使用更早版本的macOS的SDK，下载地址参考前面准备工作中的说明。解压(也会用时比较久)zip包以后将 MacOSX10.11.sdk 拷贝到 /Applications/XCode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs 。为了避免下次升级的时候再被删除，建议拷贝到自定义目录，然后建立软链接。例如我放在~lib目录下，再给它创建一个软链接： 

      $ sudo ln -s ~/lib/MacOSX10.11.sdk /Applications/XCode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.11.sdk

    • 参考博客：解决macOSX10.12.SDK下编译Android Open Source Project出错的问题: http://palanceli.com/2016/09/25/2016/0925AOSPOnMac/

导入

其他

原文  http://blog.bihe0832.com/macOS-AOSP.html
正文到此结束
所属分类： 编程技术

热门推荐

相关文章

阿里云首购8折
说给你听

本文目录
随机标签
书籍教程
springboot-demo Java入门教程 bootstrap3 CSS Apache基础教程 php ionic 教程 Python mysql教程 eclipse Ubuntu VPS系统配置 AngularJS 教程 MongoDB教程 Struts2教程 Redis教程 Spring教程 Git教程 Jenkins进阶系列 openfire参考指南 Java设计模式 HBase教程 java-demo Maven教程 springcloud-demo hibernate教程 Docker 教程 memcached教程 Quartz指南 Hive教程 ANTLR教程 SpringCloud Ant教程 java实例教程 Hazelcast教程 XStream教程 Elastic-Job-Lite 深入浅出MyBatis ibaties教程 SVN教程 rabittmq教程 Hadoop教程 solr教程 WebService CXF学习 JPA教程 ActiveMQ中文指南 Java内存模型 dubbo教程 python3-demo Linux入门视频教程
近期评论
  1. 1 使用 Docker 打包和运行 Vue 应用
  2. 2 Dependency Check命令行方式扫描jar包的安全漏洞
  3. 3 maven使用Dependency-Check来扫描安全漏洞
  4. 4 使用sonarqube分析代码质量
  5. 5 使用screw来对比数据库表和字段差异
  6. 6 Spring Boot 实现防盗链功能
  7. 7 在Spring Boot中的实现国际化（i18n）
  8. 8 一个用于 SMB/CIFS 网络的 Java 库-JCIFS
  9. 9 Spring Boot 3.x嵌入MongoDB 进行测试
  10. 10 java如何解析和生成yaml文件？
网站信息
  • 文章总数：82,737 篇
  • 文件总数：284,312 个
  • 标签总数：2,416 个
  • 分类总数：85 个
  • 留言数量：2,559 条
  • 在线人数：627 人
  • 运行天数：4,440天
  • 最后更新：2024年12月23日03点
Loading...

其他链接

关于本站

本站定位：个人技术类博客

本站作用：写博客、记日志、闲聊扯淡鼓捣技术。

问题交流

[HBLOG]公众号 HBLOG HBLOG