这是一个由国内东方众自行发起制作、以东方 Project 元素为特色的类原生 Android 项目，基于 LineageOS
exthm-10 EOL 时间为2021年底，届时请迁移至本exthm-11分支 很抱歉让大家失望了qwq 因为一些原因我们未能实现当初的基于AOSP的想法，因此本11分支将继续基于LineageOS AOSP基线为android-11.0.0_r29,LineageOS基线为18.1
本页面仅供想要成为 Build Bot 的萌新阅读：）各位大佬请多多包含 xD
这是一个包教包会的 Build Bot 教学，尽管这样做非常不好
参考 Android Open Source Project 的官方硬件要求，我们给出以下最低配置要求：
- 操作系统：使用 64 位环境的 Linux 操作系统（如果是不了解 Linux 的新手，优先推荐使用 Ubuntu 20.04 LTS）
- 至少需要 16 GB 的可用 RAM
- 最好使用能够流畅访问 github.com 与 source.android.com 的网络
sudo apt-get install 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 python- 低于 20.04 的 Ubuntu，还需安装：
libwxgtk3.0-dev - 低于 16.04 的 Ubuntu，还需安装：
libwxgtk2.8-dev
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/repomkdir -p ~/bin
curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo -o repo > ~/bin/repo
sudo cp ~/bin/repo /bin/repo
sudo chmod a+x /bin/repo先启用 [multilib]
sudo pacman -S android-tools android-udev #安装来自官方源的软件包
yay -S lineageos-devel #安装 AUR 上的软件包git config --global url.https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/.insteadof https://android.googlesource.com
repo的运行过程中会尝试访问官方的git源更新自己，如果想使用tuna的镜像源进行更新，可以将如下内容复制到你的~/.bashrc里或者是直接运行
export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo'
或者是修改.repo/manifests.git/config内的
url = https://android.googlesource.com/platform/manifes
改为
url = https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/platform/manifest
git config --global user.email "[email protected]"
git config --global user.name "xxx"这里的工作区指存放 exTHmUI 源码的路径
# 新建文件夹用来存放 exTHmUI 源码
# ~/指用户目录
# 用户目录指 /home/用户名
# 此处的 exTHmUI 为文件夹名，可自定义
mkdir ~/exTHmUI
cd ~/exTHmUIrepo 是一个用来管理多个仓库的工具
要开始编译 exTHmUI，你需要熟悉 Repo 和 Git
要开始同步源码，请使用这些命令
repo init -u https://github.com/exthmui/android.git -b exthm-11您也可以使用如下命令来初始化仓库，这样可以节省磁盘空间
# depth=1 表示不同步历史提交
repo init -u https://github.com/exthmui/android.git -b exthm-11 --depth=1[方括号]内为可选参数，可以根据网络情况按需使用。
# -j 参数为下载线程数，不带该参数默认自动分配线程
# -l 参数用于更新本地存储库
# --fail-fast 参数可以处理上次repo时由于网络原因导致的同步失败问题
#--force-sync 参数忽略本地修改，强制同步git仓库的内容。
repo sync [-j8 --fail-fast --force-sync]
参考同步命令
repo sync -j$(nproc --all) -c -j$(nproc --all) --force-sync --no-clone-bundle --no-tags请尊重开发者们的劳动成果，如果使用了其他开发者开源的设备树或者内核，请声明出处
请勿做出剽窃，抄袭，倒卖，诽谤开发者等下流行为
我们不主张过多的去编译固件，Build Bot 不等于开发者，按照本文的流程最多只能算作一个 Build Bot，本文的全部流程实际上使用脚本就可以完成。
请尊重开发者们的劳动成果，并且努力成为一名真正的开发者。
以 OnePlus 8(设备代号 instantnoodle)为例，如果我们想要基于现有的开发者们的劳动成果去编译 exTHm，步骤如下
笔者选择使用 Lineage OS 仓库中的开源内核为例
首先我们去 Lineage OS 的仓库搜索 instantnoodle，可以得到 oneplus_device_instantnoodle，这就是我们的设备树
因为 OnePlus 8 使用的 CPU 为 sm8250，所以我们可以搜索到kernel_oneplus_sm8250 与 device_oneplus_sm8250-common
通常我们可以在设备树中找到 dependencies 文件，它会告诉我们需要同步哪些文件
供应商文件？如果你搜索设备代号无果，可以在 TheMuppets 的仓库 寻找对应的厂商
依旧是以 OnePlus 8 为例，我们可以在 proprietary_vendor_oneplus 中同步得到需要的厂商文件sm8250-common 与 instantnoodle
请参考此提交：vince: exthm-ify · exthmui-devices/android_device_xiaomi_vince@03b4077 (github.com)
. build/envsetup.sh
lunch exthm_[您的设备代号]-userdebug
mka bacon如果对详细的系统介绍和编译有兴趣，欢迎访问我们的 Wiki
我们欢迎开发者通过 Gerrit 参与到 exTHmUI 的开发中，请访问 exTHmUI Code Review
### 提交commit
> 我们欢迎开发者在Gerrit提交commit，你可以使用以下命令提交commit：
cd <project>
<make edits>
git add -A
git commit -m "commit信息"
git push ssh://<username>@review.exthmui.cn:29418/<project> HEAD:refs/for/exthm-11
# 如何使用SSH提交到Gerrit
> 首先生成SSH密钥
git config --global user.email "[email protected]"
git config --global user.name "xxx"
ssh-keygen -t rsa
然后后面的提示一路回车即可
> 复制密钥
cat ~/.ssh/id_rsa.pub
>配置ssh key
首先打开exTHmUI代码审查(下面有) -> 点击右上角的Sign in -> 再点击Github OAuth2那一行使用git登录
然后点击右上角的设置 (齿轮图标)
1.找到Email Addresses部分 添加您的邮箱
2.在您的邮件收件箱找到Gerrit的验证邮件, 点击它通过验证
3.转到SSH Keys部分将密钥输出内容粘贴到SSH Keys中的New SSH Keys输入框中
4.点击添加按钮 (即 ADD NEW SSH KEY), 然后点击SAVE CHANGES
5.稍后您的邮件中收到Gerrit的答复.
好耶!!
>推送提交至审核服务器
所需文件: [commit-msg](https://review.exthmui.cn/tools/hooks/commit-msg)
1. 首先进入到带有您要推送更改提交的源码目录
2. 添加远程服务器 输入git remote add gerrit <审核服务器地址>/源码目录的仓库名称
< 例如 git remote add gerrit https://review.exthmui.cn/android >
3. 设置Change-Id功能
3-1: 下载commit-msg文件 并将它移动至 <源码目录/.git/hooks> 下
3-2: 输入 chmod a+x .git/hooks/commit-msg
4. 将您要修改好的文件添加到暂存区, 并写好提交描述
* 如果先前修改好的提交可以使用 git commit --amend 重新提交
5. 然后将提交推送到审核服务器
即 git push ssh://<用户名>@<代码审查服务器地址>:<端口>/<仓库名称> HEAD:refs/for/<分支>
* 例如 < git push ssh://[email protected]:29418/android HEAD:refs/for/exthm-11 >
6. 出现 SUCCESS 即推送完成, 待审查人与审稿人测试无误后即可合并
好耶!!
> 一次提交即可提交commit。使用以下命令压缩多个提交：`git rebase -i HEAD~<提交数量>`
> 如果您要添加其他内容，只需重复步骤（不要提交新的commit），而是使用`git commit --amend`代替`git commit -m`。Gerrit会将其识别为新的commit集。
> 要查看您和其他commit的状态，请访问[exTHmUI](https://review.exthmui.cn)代码审查。