READMECN.md

Miku UI Vampire

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 ?

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 新建工作区！

虽然说、、直接在根目录同步源码也没什么问题。。但是真的不会觉得乱吗？

所以最好是，新建一个文件夹来放源码哦！

# 新建文件夹用来存放 Miku UI 源码
# ~/指用户目录
# 用户目录指 /home/用户名
# 此处的 miku 为文件夹名，可自定义
mkdir ~/miku
cd ~/miku

同步源码

终于到了这个步骤啦！接下来让我们来用 repo 来同步源码吧！

使用以下命令来初始化仓库：

repo init -u https://github.com/Miku-UI/manifesto -b Vampire

开始同步源码：

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_[设备代号]-[release版本]-user

# 开始编译属于你的 Miku UI (Diva) !
make diva