Try   HackMD

Android 第三方 Recovery 繁體中文編譯教學

從零開始的編譯指南

挑選一個想要編譯的 Recovery

先備知識

  • Linux 終端指令語法
  • git 指令（至少需要基礎的能力）
  • 永不放棄的心
  • 一顆清晰的頭腦

配置一台主機

  • CPU:至少4核心，建議8核心
  • RAM:至少4GB (Android 10)，建議配置8GB以上
  • 儲存空間容量:至少50GB，建議100GB
  • 儲存裝置類型:HDD即可 (SATA 3)，SSD更好
  • 系統:初學者建議安裝 Ubuntu 18.04 LTS / Ubuntu 20.04 LTS

安裝必要的編譯套件

  • Ubuntu 18.04 LTS
sudo apt 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 openjdk-11-jdk git vim repo libwxgtk3.0-dev
  • Ubuntu 20.04 LTS
sudo apt 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 openjdk-11-jdk git vim

設定 git

git config --global user.email "您的e-mail"
git config --global user.name "您的名字"

同步 Recovery 原始碼

參考各個 Android Custom Recovery 的編譯 Manifest

本文皆以 Orange Fox Recovery Project 與 ASUS ZenFone 4 Max (X00I)進行舉例
  • 先建立資料夾
mkdir -p ~/OrangeFox
cd ~/OrangeFox
  • 同步 Recovery 源代碼
repo init -u https://gitlab.com/OrangeFox/Manifest.git -b fox_9.0

repo sync -j8 --force-sync

更新原始碼

  • 在這之後如果有需要更新原始碼，請使用 repo sync 進行同步（更新 Recovery 原始碼）
repo sync
  • 待原始碼同步完成之後，還需要配置 TWRP Device Tree

同步 TWRP Device Tree

Example: git clone {url} -b {branch name} {directory}

git clone Github連結 -b 分支 device/品牌名/機型代號

範例如下：

git clone https://github.com/asusdevices/twrp_device_asus_X00I -b omni-9.0 device/asus/X00I
  • 設定 Cache
export USE_CCACHE=1
export CCACHE_EXEC=/usr/bin/ccache
ccache -M 50G
  • 都把檔案放置完成後，可以開始進行編譯
cd OrangeFox
source build/envsetup.sh
export ALLOW_MISSING_DEPENDENCIES=true
export FOX_USE_TWRP_RECOVERY_IMAGE_BUILDER=1
export LC_ALL="C"
lunch omni_裝置代號-eng && mka recoveryimage
範例如下：
cd OrangeFox
source build/envsetup.sh
export ALLOW_MISSING_DEPENDENCIES=true
export FOX_USE_TWRP_RECOVERY_IMAGE_BUILDER=1
export LC_ALL="C"
lunch omni_X00I-eng && mka recoveryimage
編譯 Orange Fox Recovery Project 使用的參數

官方支援參數列表

腳本

編譯 OFRP 腳本

#!/bin/bash
cd OrangeFox
. build/envsetup.sh
export ALLOW_MISSING_DEPENDENCIES=true
export LC_ALL="C"
export OF_AB_DEVICE=0
export FOX_REPLACE_BUSYBOX_PS=1
export FOX_REPLACE_TOOLBOX_GETPROP=1
export FOX_USE_TAR_BINARY=1
export FOX_USE_ZIP_BINARY=1
export FOX_USE_NANO_EDITOR=1
export OF_DISABLE_MIUI_SPECIFIC_FEATURES=1
export OF_NO_TREBLE_COMPATIBILITY_CHECK=1
export FOX_DELETE_AROMAFM=1
export OF_USE_LOCKSCREEN_BUTTON=1
export OF_SUPPORT_OZIP_DECRYPTION=1
export FOX_ADVANCED_SECURITY=1
export OF_MAINTAINER=維護者名字
export TW_DEVICE_VERSION="R11.0"
export FOX_VERSION=R11.0_0
export FOX_R11=1
export OF_USE_TWRP_SAR_DETECT=1
export TARGET_DEVICE_ALT="代號1,代號2"
lunch omni_裝置代號-eng && mka recoveryimage

範例如下：

#!/bin/bash
cd OrangeFox
. build/envsetup.sh
export ALLOW_MISSING_DEPENDENCIES=true
export LC_ALL="C"
export OF_AB_DEVICE=0
export FOX_REPLACE_BUSYBOX_PS=1
export FOX_REPLACE_TOOLBOX_GETPROP=1
export FOX_USE_TAR_BINARY=1
export FOX_USE_ZIP_BINARY=1
export FOX_USE_NANO_EDITOR=1
export OF_DISABLE_MIUI_SPECIFIC_FEATURES=1
export OF_NO_TREBLE_COMPATIBILITY_CHECK=1
export FOX_DELETE_AROMAFM=1
export OF_USE_LOCKSCREEN_BUTTON=1
export OF_SUPPORT_OZIP_DECRYPTION=1
export FOX_ADVANCED_SECURITY=1
export OF_MAINTAINER=EdwardWu
export TW_DEVICE_VERSION="R11.0"
export FOX_VERSION=R11.0_0
export FOX_R11=1
export OF_USE_TWRP_SAR_DETECT=1
export TARGET_DEVICE_ALT="X00I,X00ID"
lunch omni_X00I-eng && mka recoveryimage

Happy Hacking!

其他注意事項

編譯 Recovery 是一個不小的工程

  • 推薦在編譯的時候使用 tmux 指令去新增一個 session 以便把當前的工作階段保留在後台
  • 如果要上傳檔案到雲端硬碟，推薦使用 rclone 上傳檔案
  • 需要熟悉 git 指令
  • 建議編寫一些簡單的腳本方便自己執行命令

參考資料連結

  1. tmux
  2. tee
  3. rclone
  4. git
    修改 Commit 紀錄
    剛才的 Commit 後悔了，想要拆掉重做…
    追加檔案到最近一次的 Commit
    同步遠端分支
    Git 基礎 - 與遠端協同工作
    rename git branch locally and remotely
    Git cherry-pick from another repository
    使用 Git 時如何做出跨 repo 的 cherry-pick
    git 場景 ：從一個分支cherry-pick多個commit
    合併發生衝突了，怎麼辦？
    下載Github上特定Repository內的資料夾

Q&A

  1. 編譯過程遇到 FAILED 的時候，可以嘗試去看看哪個檔案造成的，它會寫在 FAILED 的後方
  2. 如果真的遇到自己無法解決的問題，可以加入這兩個 Telegram 群組
    Android Building Help
    RomDevelopment
  3. 快速上手 Android Custom ROM 適配 - Prebuilt Vendor
  4. 等我想到還有什麼問題再加上來

聯絡我

Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

tags: Android Recovery 編譯 第三方 教學
Last changed by 
 
EdwardWu
2
3486

Read more

Nothing Phone 3a 系列評測：性能、攝影與設計的全面升級

Nothing Phone 3a 系列評測：性能、攝影與設計的全面升級

Mar 22, 2025
EdwardWu 整理 OEM 系統備份

鑒於我個人是原廠系統（OEM）愛好者，我自己在挑選二手筆電的時候，會優先注意是否有保留 OEM 系統。價格加個 $500 ~ $1000 多，我都願意 XDD

Nov 14, 2024
流著 Nothing OS 血液的平價版 Nothing Phone：CMF By Nothing Phone 1

IMG_20240719_211923700

Jul 27, 2024
不同以往的 Nothing Phone：睽違已久的 Mediatek

IMG_20240505_225622578

Jul 27, 2024
Read more from EdwardWu
Published on HackMD