Android Open Source Project 本地编译流程记录

前言

本文以Ubuntu22.04、AOSP13代码为例,
演示了从安装环境, 下载代码, 到编译映像和搭建本地AOSP代码镜像服务器的全部过程。

1、安装Repo

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

2、初始化Repo

Google官方地址

sudo apt-get install curl
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo

如果电脑不支持访问Google官方地址,可以使用下面清华的源进行替换

sudo apt-get install curl
curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo -o ~/bin/repo
chmod a+x ~/bin/repo

3、添加环境配置(可选)

repo运行过程中会尝试访问官方的git源更新自己,如果使用清华的镜像源进行更新,需要添加环境配置
过程如下:

sudo apt-get install vim
vim .bashrc(不安装vim也可, 可以直接用gedit编辑)

#末尾添加
export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo'

#执行(使配置生效)
source .bashrc

4、配置git

使用自己邮箱的用户名以及邮箱地址即可

sudo apt-get install git
git config --global user.name "XXXX"
git config --global user.email "XXXXX@XXXXXXXXX.com"

5、创建用于下载源码的文件夹

mkdir -p aosp/android13
cd aosp/android13/

6、拉取代码

使用Google的源

repo init -u https://android.googlesource.com/platform/manifest

#如需签出 master 分支,请运行以下命令:
repo init -u https://android.googlesource.com/platform/manifest -b master

#如需签出 master 之外的其他分支,请使用 -b 指定此分支。官方文档可以查看可以拉取到哪些分支
#https://source.android.com/docs/setup/about/build-numbers?hl=zh-cn#source-code-tags-and-builds

使用清华的源:

# 此处以拉取android-13.0.0_r37分支为例
repo init -u https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/platform/manifest -b android-13.0.0_r37

执行完该命令,会提示没有Python的问题



查看谷歌官网,给出解决方式如下

sudo ln -s /usr/bin/python3 /usr/bin/python


尝试重新拉取代码


7、同步代码

repo sync -j8(推荐使用j4或者$(nproc --all))

8、安装依赖库

sudo apt-get install libx11-dev:i386 libreadline6-dev:i386 libgl1-mesa-dev g++-multilib
sudo apt-get install -y git flex bison gperf build-essential libncurses5-dev:i386
sudo apt-get install tofrodos python python-markdown libxml2-utils xsltproc zlib1g-dev:i386
sudo apt-get install dpkg-dev libsdl1.2-dev libesd0-dev (找不到)
sudo apt-get install git-core gnupg flex bison gperf build-essential
sudo apt-get install zip curl zlib1g-dev gcc-multilib g++-multilib
sudo apt-get install libc6-dev-i386
sudo apt-get install lib32ncurses5-dev x11proto-core-dev libx11-dev(ubutun20也找不到,会被安装6,下面有解决办法)
sudo apt-get install libgl1-mesa-dev libxml2-utils xsltproc unzip m4
sudo apt-get install lib32z-dev ccache
sudo apt-get install libssl-dev

特别注意:如遇到 libesd0-dev 找不到,执行下面的

sudo vim /etc/apt/sources.list
#在行尾添加下面这个源保存
deb http://archive.ubuntu.com/ubuntu/ trusty main universe restricted multiverse
 
#安装libesd0-dev
sudo apt-get update && sudo apt-get install libesd0-dev

关于编译时报 lib32ncurses5-dev的问题,这个包安装不上。在安装的时候发现要安装libncurses5-dev,但是软件包都更新为最新版本的了,也就是libncurses5-dev 最新版本是6.2的,查看了下/usr/lib/x86_64-linux-gnu 这个目录下的动态库,发现只有libncurses.so.6,这就是因为libncurses5-dev这个包太新了,已经更新到6.2了,所以没有libncurses.so.5,因为后面编译需要有libncurses.so.5,不然编译会报错。


cd /usr/lib/x86_64-linux-gnu 
sudo cp libncurses.so.6 libncurses.so.5
sudo cp libtinfo.so.6 libtinfo.so.5

9、开始编译

source build/envsetup.sh
lunch 1
make -j8(或者$(nproc --all))

step1:执行envsetup脚本
脚本文件envsetup.sh记录着编译过程中所需要的各种函数实现,如lunch、m、mm等。可以根据项目需求进行一定的修改。
step2:选择编译目标
编译目标由两部分组成,即BUILD和BUILDTYPE
编译目标的格式:BUILD-BUILDTYPE,例如:aosp_arm-eng的BUILD是aosp_arm,BUILDTYPE是eng。
Build:

BUILD指的是特定功能的组合的特定名称,即表示编译出的镜像可以运行在什么环境.
其中,aosp(Android Open Source Project)代表Android开源项目;
arm表示系统是运行在arm架构的处理器上,
arm64则是指64位arm架构处理器,
x86则表示x86架构的处理器。

BUILD TYPE:

BUILD TYPE则指的是编译类型,通常有三种:
 -user:代表这是编译出的系统镜像是可以用来正式发布到市场的版本,其权限是被限制的(如,没有root权限)
 -userdebug:在user版本的基础上开放了root权限和debug权限.
 -eng:代表engineer,也就是所谓的开发工程师的版本,拥有最大的权限(root等),此外还附带了许多debug工具

了解编译目标的组成之后,就可以根据目前的情况选择响应的编译目标,如果不知道有哪些类型可以选择,
可以执行不带参数的lunch指令,控制台会列出所有的编译目标,可以根据提示进行选择,只需要输入相应的数字即可。


step3:执行编译命令
通过make指令进行代码编译,该指令通过-j参数来设置参与编译的线程数量,以提高编译速度.比如设置8个线程同时编译:make -j8
参与编译的线程并不是越多越好,通常是根据机器cup的核心来确定:core*2,即当前cpu的核心的2倍。
执行make命令之后,等待即可

10、参考链接

Google官方链接
Ubuntu20编译最新版Android源码教程
ubuntu 20.04.4编译 继续尝试编译Android 12,13

11、补充说明

[1].清理命令

# 执行清理操作,等价于 rm -rf $OUT
make clean

# 为了确保新安装的二进制文件在解压后会被适当考虑在内,可使用以下命令删除所有以前编译操作的已有输出, 等价于rm -rf out/
make clobber

make clean与make clobber的区别
在你build for devices的时候(需要解压一些私有的驱动与安装包),google会建议使用make clobber进行清除操作,以避免之前进行的build干扰到接下来的build。
make clean:它会删除本次设置所生成的所有的output与中间文件。等价于指令rm -rf OUT,这里的OUT指的是out/target/product/[product_name]
make clobber:make clobber的功能是把上一次make命令生成的文件或目录清除掉,效果比make clean更严格。它会删除所有设置所生成的所有的output与中间文件。等价于指令rm -rf out/,make clobber的严格在于它把整个out目录都删除了。
其他:


[2].设立ccache(可选)
如果经常执行“make clean”,或者需要经常编译不同的产品类别,设立ccache还是有必要的。它可以作为编译时的缓冲,从而加快重新编译的速度。
设置方法:

  • 安装:sudo apt-get install ccache
  • 要想长久方便使用,需要将以下环境变量写入/etc/profile或者~/.bashrc中
    1. export USE_CCACHE=1
    2. export CCACHE_DIR=/<path_of_your_choice>/.ccache
      其中<path_of_your_choice>是要设置ccache缓存的目录,如果不设置,则默认缓存到~/.ccache中。
  • 然后进入Android源码的编译目录,执行:
    1. prebuilts/misc/linux-x86/ccache/ccache -M 50G
  • 后面继续执行:
    1. source build/envsetup.sh
    2. lunch xxxxx
    3. make -j16

注意事项:

  • 上面的设置会永久存储在CCACHE_DIR中。
  • 可通过ccache -s查看缓存使用情况,通过ccache -C清除缓存

[3].AOSP Git镜像
下载AOSP git 镜像, 在局域网搭建AOSP mirror
为了减少拉取代码时的时间,方便团队开发,提高开发效率,可以为整个服务器内容创建本地镜像,并从该镜像同步客户端(不需要访问远程服务器)
step1:创建局域网内镜像服务器

# 在局域网镜像服务器中创建Git镜像文件夹
mkdir -p /usr/local/aosp/mirror

# 使用repo下载Google源或者清华源镜像
cd /usr/local/aosp/mirror
repo init -u https://android.googlesource.com/mirror/manifest --mirror
# 或者
repo init -u https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/mirror/manifest --mirror

repo sync

在本地服务器同步镜像后, 执行以下命令创建AOSP镜像服务
git daemon --verbose --export-all --base-path=WORKING_DIR WORKING_DIR
step2:使用局域网镜像服务器下载代码
在局域网镜像服务器本地同步代码

mkdir -p /usr/local/aosp/local13
cd /usr/local/aosp/local13
repo init -u /usr/local/aosp/mirror/platform/manifest.git -b android-13.0.0_r37
repo sync

在使用局域网连接镜像服务器同步代码

mkdir -p /usr/local/aosp/AOSPlocalserver13
cd /usr/local/aosp/AOSPlocalserver13
repo init -u git://ip.to.mirror/platform/manifest.git -b android-13.0.0_r37
repo sync

最后,要将客户端与服务器同步,先将镜像与服务器同步,然后再将客户端与镜像同步:

# 服务机
cd /usr/local/aosp/mirror
repo sync

# 客户机
cd /usr/local/aosp/AOSPlocalserver13
repo sync

可以将镜像存储在 LAN 服务器上,然后通过 NFS、SSH 或 Git 访问它。您还可以将其存储在移动存储盘上,并在用户之间或计算机之间传递该存储盘。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,332评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,508评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,812评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,607评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,728评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,919评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,071评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,802评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,256评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,576评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,712评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,389评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,032评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,026评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,473评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,606评论 2 350

推荐阅读更多精彩内容