本文為真實開發(fā)踩坑全記錄，覆蓋Linux服務(wù)器、Windows WSL2雙場景，解決編譯環(huán)境依賴、權(quán)限報錯、環(huán)境持久化、跨系統(tǒng)移植全流程問題，看完就能從零搭建一套可復(fù)用的Android編譯環(huán)境。

前言

做嵌入式Android系統(tǒng)開發(fā)的朋友都懂：Android源碼編譯對環(huán)境依賴極其苛刻，不同Android版本要求的JDK、Python、系統(tǒng)工具鏈天差地別。

不同版本的ubuntu系統(tǒng)環(huán)境和依賴都不一樣。
直接在物理機(jī)裝環(huán)境，很容易把系統(tǒng)搞亂；用VMware虛擬機(jī)，不僅啟動慢、資源占用高，共享文件夾還一堆權(quán)限坑。
而Docker容器化方案，能完美解決這些痛點：環(huán)境隔離、秒級啟動、資源占用極低、環(huán)境可一鍵移植，是編譯Android源碼的最優(yōu)解。

本文就以全志H618平臺Android12.0源碼編譯為例，把從0到1搭建Docker編譯環(huán)境的完整流程、所有踩過的坑和解決方案，一次性全部分享給大家。

一、先搞懂：Docker編譯Android，比VMware好在哪？

很多朋友會問，我用VMware裝Ubuntu也能編譯，為什么非要用Docker？一張表給你講透差異：

對比維度	Docker容器	VMware虛擬機(jī)
啟動速度	秒級啟動，瞬間進(jìn)入編譯環(huán)境	開機(jī)幾十秒到幾分鐘，需等待完整系統(tǒng)啟動
資源占用	僅占用編譯所需資源，無冗余系統(tǒng)進(jìn)程，內(nèi)存占用極低	完整系統(tǒng)本身就要吃掉2-4G內(nèi)存，后臺進(jìn)程大量占用資源
文件互通	直接掛載宿主機(jī)目錄，宿主機(jī)改代碼，容器里直接編譯，無延遲	共享文件夾卡頓、權(quán)限坑多，文件傳輸麻煩
環(huán)境一致性	鏡像一次配置，永遠(yuǎn)一致，刪了重開還是一模一樣的環(huán)境	長期使用環(huán)境會變臟，依賴沖突頻發(fā)，重裝需從頭配置
編譯性能	接近原生物理機(jī)性能，IO損耗極低	有明顯性能損耗，編譯速度普遍比Docker慢20%以上
環(huán)境移植	一個tar包就能跨機(jī)器、跨系統(tǒng)遷移	虛擬機(jī)鏡像動輒幾十GB，遷移極其麻煩

結(jié)論：單純編譯Android /嵌入式SDK，Docker全方位吊打VMware，完全沒必要用虛擬機(jī)。

二、環(huán)境準(zhǔn)備

本文覆蓋兩個最常用的開發(fā)場景，大家按需選擇即可：

1.Linux服務(wù)器場景：Dell PowerEdge R720xd物理服務(wù)器，Ubuntu系統(tǒng)

2.Windows辦公機(jī)場景：Win10/Win11臺式機(jī)/筆記本，用WSL2+Docker實現(xiàn)編譯

前置要求

?Linux服務(wù)器：已安裝Docker，內(nèi)存≥16GB（推薦32GB），CPU核心數(shù)≥8核

?Windows機(jī)器：已開啟虛擬化，Win10 2004+/Win11系統(tǒng)，內(nèi)存≥16GB，源碼存放于NVMe SSD（機(jī)械硬盤編譯會巨慢）

三、Linux服務(wù)器：Docker編譯環(huán)境完整搭建

這是最穩(wěn)定、性能最好的場景，我們從拉取基礎(chǔ)鏡像開始，一步步搞定完整編譯環(huán)境。

3.1拉取適配的基礎(chǔ)鏡像

Android12.0編譯最適配的Ubuntu版本是20.04/22.04，這里我們選擇長期支持的ubuntu:22.04：

# 拉取官方基礎(chǔ)鏡像sudodocker pull ubuntu:22.04# 驗證鏡像是否拉取成功sudodocker images

3.2正確啟動容器（避坑核心）

很多新手第一個坑就踩在這里：啟動容器的命令不對，要么退出就刪環(huán)境，要么源碼掛載不上。

錯誤命令（退出就刪環(huán)境）

# 帶--rm參數(shù)，退出容器會自動刪除，裝的依賴全沒了！sudodocker run -it --rm-v $(pwd):/h618-android12.0 -w /h618-android12.0 ubuntu:22.04

正確命令（持久化容器，環(huán)境永久保留）

# 給容器命名，不帶--rm，退出后容器僅停止，環(huán)境完全保留sudodocker run -it --name h618-build -v $(pwd):/h618-android12.0 -w /h618-android12.0 --privileged ubuntu:22.04

命令參數(shù)詳解：

?-it：以交互式終端進(jìn)入容器

?--name h618-build：給容器命名，方便后續(xù)管理

?-v 宿主機(jī)路徑:容器路徑：把宿主機(jī)的Android源碼目錄掛載到容器內(nèi)

?-w：指定進(jìn)入容器后的默認(rèn)工作目錄，直接進(jìn)入源碼根目錄

?--privileged：給容器最高權(quán)限，避免編譯過程中權(quán)限不足

3.3容器內(nèi)：全量編譯依賴安裝（一次性避坑）

進(jìn)入容器后，第一步就是安裝Android12編譯所需的所有依賴，把后續(xù)會踩的坑一次性解決：

aptinstall git bc bison build-essential curl flex libsdl1.2-devaptinstall g++-multilib gcc-multilib gnupg gperf libncurses5-devaptinstall imagemagick lib32ncurses5-dev lib32readline-dev squashfs-toolsaptinstall lib32z1-dev liblz4-tool xsltproc libssl-dev libwxgtk3.0-gtk3-devapt install libxml2 libxml2-utils schedtool lzop pngcrush rsyncaptinstall yasm zip zlib1g-dev python device-tree-compileraptinstall python-pip gawk openjdk-8-jdk u-boot-tools patchelf expectpipinstall pyelftools

3.4容器內(nèi)：前置配置修復(fù)（解決必現(xiàn)報錯）

安裝完依賴，先做兩個配置修復(fù)，否則編譯一定會報錯：

# 1. 修復(fù)git安全目錄問題，解決掛載目錄的git權(quán)限報錯git config --global--addsafe.directory /h618-android12.0# 2. 配置git換行符，避免Windows和Linux換行符沖突導(dǎo)致腳本報錯git config --globalcore.autocrlf input

3.5高頻報錯合集&解決方案

這里把編譯過程中99%會遇到的報錯，全部整理好，遇到直接復(fù)制命令解決：

報錯1：python: command not found

?原因：Ubuntu22.04默認(rèn)只有python3命令，沒有python命令，老的編譯腳本只認(rèn)python

?解決方案：

ln-s /usr/bin/python3 /usr/bin/python# 或者直接安裝python-is-python3包（上面依賴安裝已經(jīng)包含）

報錯2：fatal: detected dubious ownership in repository at 'xxx'

?原因：容器內(nèi)root用戶，不信任宿主機(jī)掛載的git倉庫目錄

?解決方案：上面的git safe.directory配置命令

報錯3：xxd: command not found

?原因：缺少xxd工具，編譯bootloader必備

?解決方案：apt install -y xxd（上面依賴安裝已經(jīng)包含）

報錯4：cpio: not found

?原因：缺少cpio工具，編譯內(nèi)核和boot.img必備

?解決方案：apt install -y cpio（上面依賴安裝已經(jīng)包含）

報錯5：permission denied while trying to connect to the Docker daemon socket

?原因：當(dāng)前普通用戶沒有權(quán)限訪問Docker的socket文件

?解決方案：把當(dāng)前用戶加入docker用戶組，永久免sudo

# 創(chuàng)建docker組（若不存在）sudogroupadd docker# 把當(dāng)前用戶加入docker組sudousermod -aG docker$USER# 關(guān)鍵：退出當(dāng)前SSH會話重新登錄，權(quán)限才會生效

報錯6：Unable to find image 'xxx:latest' locally

?原因：鏡像標(biāo)簽不對，Docker默認(rèn)找latest標(biāo)簽，而你的鏡像標(biāo)簽不是latest

?解決方案：運行命令必須帶上完整的鏡像標(biāo)簽，比如h618-android-build:v1，不能只寫鏡像名

3.6容器的日常使用命令

# 退出容器：exit# 下次重新進(jìn)入容器（環(huán)境全保留）sudodocker start h618-buildsudodockerexec-it h618-build bash# 停止容器sudodocker stop h618-build# 刪除容器（環(huán)境亂了可以刪了重建）sudodockerrm-f h618-build

四、Windows辦公機(jī)：WSL2+Docker編譯環(huán)境搭建

很多朋友只有Windows辦公機(jī)，也想編譯Android源碼，這里給大家一套替代VMware的最優(yōu)方案，性能接近原生Linux。

4.1開啟WSL2（前置步驟）

1.以管理員身份打開PowerShell，執(zhí)行安裝命令：

wsl--install

2.命令會自動啟用WSL、虛擬機(jī)平臺，下載安裝Ubuntu，完成后重啟電腦

3.重啟后會彈出Ubuntu窗口，設(shè)置用戶名和密碼（用戶名必須小寫字母開頭，只能包含小寫字母、數(shù)字、下劃線、短橫，否則會報錯）

4.驗證WSL是否正常：

wsl-l -v

看到Ubuntu Running 2，說明WSL2安裝成功

4.2 Docker Desktop安裝與配置

1.官網(wǎng)下載Docker Desktop安裝包，雙擊安裝，必須勾選Use WSL 2 instead of Hyper-V

2.安裝完成后重啟電腦，打開Docker Desktop

3.進(jìn)入Settings → General，確認(rèn)勾選Use the WSL 2 based engine

4.進(jìn)入Settings → Resources → WSL Integration，勾選Ubuntu，保存并重啟Docker

5.驗證Docker是否正常：

dockerrun hello-world

出現(xiàn)歡迎信息，說明Docker安裝成功

4.3啟動編譯容器（和Linux服務(wù)器完全一致）

PowerShell進(jìn)入你的Android源碼所在目錄，執(zhí)行啟動命令：

docker run -it --name h618-build` -v D:h618-android12.0:/h618-android12.0 ` -w /h618-android12.0` --privileged `ubuntu:22.04

后續(xù)的依賴安裝、配置修復(fù)、編譯命令，和Linux服務(wù)器場景完全一致。

4.4更穩(wěn)的替代方案：直接用WSL2原生編譯

如果Docker Desktop啟動失敗，完全可以不用Docker，WSL2本身就是完整的Linux系統(tǒng)，直接在里面安裝依賴編譯即可：

1.PowerShell輸入wsl進(jìn)入Ubuntu系統(tǒng)

2.執(zhí)行本文3.3的全量依賴安裝命令

3.進(jìn)入源碼目錄：cd /mnt/d/h618-android12.0（Windows的D盤對應(yīng)WSL里的/mnt/d/）

4.執(zhí)行編譯命令即可，效果和Docker完全一致

五、編譯環(huán)境持久化與跨系統(tǒng)移植

環(huán)境配置好之后，我們可以把它打包成自定義鏡像，實現(xiàn)一勞永逸，還能跨機(jī)器、跨系統(tǒng)移植。

5.1把配置好的容器打包成自定義鏡像

1.先保持容器處于運行狀態(tài)，不要退出

2.新開一個終端窗口，執(zhí)行commit命令，把容器打包成鏡像：

# 格式：docker commit 容器名 鏡像名:標(biāo)簽sudodocker commit h618-build h618-android-build:v1

3.驗證鏡像是否打包成功：

sudodocker images

能看到h618-android-build:v1，說明打包成功

5.2自定義鏡像的使用

以后編譯，直接用這個打包好的鏡像啟動容器，進(jìn)去就能直接編譯，所有依賴、配置都已經(jīng)預(yù)裝好：

sudodocker run -it --rm -v $(pwd):/h618-android12.0 -w /h618-android12.0 h618-android-build:v1

5.3鏡像跨系統(tǒng)移植

方案一：離線導(dǎo)出/導(dǎo)入（推薦，無網(wǎng)絡(luò)也能用）

1.源機(jī)器導(dǎo)出鏡像為tar包：

# 若是tar.gz包，先解壓gunzip h618-android-build-v1.tar.gz# 導(dǎo)入鏡像sudodocker load -i h618-android-build-v1.tar

2.把tar包通過U盤、scp、局域網(wǎng)共享等方式，傳輸?shù)侥繕?biāo)機(jī)器

3.目標(biāo)機(jī)器導(dǎo)入鏡像：

# 若是tar.gz包，先解壓gunzip h618-android-build-v1.tar.gz# 導(dǎo)入鏡像sudodocker load -i h618-android-build-v1.tar

4.驗證：sudo docker images能看到鏡像，說明移植成功

方案二：Docker Registry推送（適合有網(wǎng)絡(luò)、多人共享）

1.給鏡像打倉庫標(biāo)簽（以Docker Hub為例）：

sudodocker tag h618-android-build:v1 你的DockerHub用戶名/h618-android-build:v1

2.登錄Docker Hub并推送：

sudodocker tag h618-android-build:v1 你的DockerHub用戶名/h618-android-build:v1

3.目標(biāo)機(jī)器直接拉取鏡像：

sudodocker pull 你的DockerHub用戶名/h618-android-build:v1

六、最終編譯驗證

環(huán)境全部配置好之后，進(jìn)入容器的源碼目錄，執(zhí)行標(biāo)準(zhǔn)Android編譯命令即可：

SDK$sourcebuild/envsetup.shSDK$lunch apollo_p2-userdebugSDK$make installclean -j32

七、核心避坑總結(jié)

1.啟動容器不要隨便加--rm參數(shù)，除非是臨時測試，否則退出容器環(huán)境就會被刪除

2.Ubuntu22.04默認(rèn)沒有python命令，必須安裝python-is-python3或者做軟鏈接

3.掛載的git倉庫目錄，必須配置git safe.directory，否則一定會報權(quán)限錯誤

4.Docker權(quán)限問題，優(yōu)先把用戶加入docker用戶組，不要每次都用sudo

5.鏡像操作必須帶上完整標(biāo)簽，Docker默認(rèn)找latest標(biāo)簽，很容易踩坑

6.Windows下源碼不要放在機(jī)械硬盤，必須放在NVMe SSD，否則編譯速度會慢到離譜

結(jié)尾

以上就是全志H618 Android12 Docker編譯環(huán)境的完整搭建流程，從踩坑到落地，所有細(xì)節(jié)和解決方案都毫無保留地分享給大家。
按照這個流程操作，不管是Linux服務(wù)器還是Windows辦公機(jī)，都能快速搭建一套穩(wěn)定、可復(fù)用的Android編譯環(huán)境，再也不用為環(huán)境問題頭疼。

如果大家在操作過程中遇到任何問題，歡迎在評論區(qū)留言交流，我會一一回復(fù)。如需鏡像，請留言。

審核編輯 黃宇