Miku UI 是一个基于 AOSP 的系统。专注于性能优化与......
Miku?
我要怎么开始捏!
什么?你原来是个 BuildBot 吗!
在开始前,请先看看我们的官方 Wiki !
首先,确认好自己是否准备好了编译环境呢?
我们以 Ubuntu20.04 来做例子吧!
在你的终端下面执行以下命令:
sudo apt-get update
sudo apt-get install -y python bc bison build-essential ccache curl flex g++-multilib gcc-multilib git gnupg gperf imagemagick lib32ncurses5-dev lib32readline-dev lib32z1-dev liblz4-tool libncurses5 libncurses5-dev libsdl1.2-dev libssl-dev libxml2 libxml2-utils lzop pngcrush rsync schedtool squashfs-tools xsltproc zip zlib1g-dev
这里我们做了什么呢?
通过上面这段命令,你将会部署好编译所需要的环境
那么接下来你要做的就是......
等等,什么事 repo ?
repo 是一个方便的仓库管理工具,谷歌使用它来管理 AOSP 的源码
所以如果我们想要拉取 AOSP 源码的话,就需要安装这个工具哦!
在终端里执行:
mkdir -p ~/bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
sudo cp ~/bin/repo /bin/repo
sudo chmod a+x /bin/repo
这下你就完成了 repo 的安装~!我们可以开始拉源码了吗!
你兴冲冲地做完以上步骤,认为可以开始拉源码了!
但是你应该也知道,某咕噜咕噜在中国是被墙的状态哦。
所以你需要有魔法才能拉取源码~
什么..?你没有魔法?
git config --global url.https://mirrors.bfsu.edu.cn/git/AOSP/.insteadof https://android.googlesource.com
git config --global url.https://kgithub.com/.insteadof https://github.com
echo "export REPO_URL='https://mirrors.bfsu.edu.cn/git/git-repo'" >> ~/.bashrc
source ~/.bashrc
在终端执行以上命令,就可以不用魔法来愉快地同步源码啦!
虽然说、、直接在根目录同步源码也没什么问题。。但是真的不会觉得乱吗?
所以最好是,新建一个文件夹来放源码哦!
# 新建文件夹用来存放 Miku UI 源码
# ~/指用户目录
# 用户目录指 /home/用户名
# 此处的 miku 为文件夹名,可自定义
mkdir ~/miku
cd ~/miku
终于到了这个步骤啦!接下来让我们来用 repo 来同步源码吧!
使用以下命令来初始化仓库:
repo init -u https://github.com/Miku-UI/manifesto -b Udon
开始同步源码:
repo sync -c -j$(nproc --all) --force-sync --no-clone-bundle --no-tags
-j
参数为下载线程数,不带该参数默认自动分配线程
-l
参数用于更新本地存储库
--fail-fast
参数可以处理上次 repo 时由于网络原因导致的同步失败问题
--force-sync
参数忽略本地修改,强制同步 git 仓库的内容。
你需要准备好以下”材料“:
- Device Configuration(或者叫 Device Tree?如果是自己写的那就太好了!)
- Kernel Source(如果你使用预编译内核的话,请无视~)
- Vendor Blobs(这个一般可以从手机里提取捏)
当然你也可以对现有的材料进行 Ify
如果你使用的是 Ify 的 Device Configuration 来编译 Miku UI , 建议只供自己使用。
请尽量不要发布 Ify 后过的 Device Configuration,如果一定要发布的话,请注明 Device Configuration 的原作者!
同时也请尽量不要发布你使用 Ify 的 Device Configuration 编译出的 Miku UI 到各种论坛,
因为 Ify 过后的 Device Configuration 通常不能与 Miku UI 契合,从而导致各种各样的问题!
准备好了这些以后,让我们开始...
- 可选
使用 ccache 可以加快再次编译速度哦!为什么不试试嘛
但此操作需要你拥有足够的硬盘空间哟~
当然,它也不会立刻见效啦、、
echo "export USE_CCACHE=1" >> ~/.bashrc
echo "export CCACHE_COMPRESS=1" >> ~/.bashrc
source ~/.bashrc
# 同时,你可以使用 ccache -M [size] 来限制 ccache 存储对象的大小,例如:
#ccache -M 50G
# 初始化编译环境
. build/envsetup.sh
# 初始化编译设备
lunch miku_[设备代号]-user
# 开始编译属于你的 Miku UI (Diva) !
make diva