个人打包安卓系统 AOSP（Android Open Source Project）是一项复杂但极具价值的任务，尤其适合希望深度定制系统或学习 Android 底层机制的开发者。根据最新公开资料（截至 2026 年 5 月），以下是个人打包 AOSP 时需特别注意的麻烦问题，按关键阶段分类整理：
3 r7 C3 H/ [# o3 T* Q5 j
3 N2 Q# g) F3 i7 A q4 e一、环境准备阶段
. ` Y$ l. Q. [- }. i操作系统要求严格% U0 a/ Q# u, L7 u
AOSP 官方仅支持 64 位 Linux 系统（推荐 Ubuntu 20.04 或 22.04 LTS），且需满足 glibc ≥ 2.17 - e2 `1 j! x+ F D9 V
1# O8 J+ l: W3 e& G% B& |# |
2。Windows 或 macOS 不被官方支持，虽可通过 WSL 或虚拟机运行，但易引发兼容性问题。4 M2 p( N& ]& H1 o3 U9 t
( @! g) r2 o4 W& o! \7 o
硬件资源门槛高( l" |; @2 T( J U
% }* n" J( g) a9 \. R# |2 c' `磁盘空间：AOSP 13 源码约 150GB，编译输出需额外 100–150GB，建议预留至少 500GB SSD 空间 / z2 |6 J% a1 D
2。
% S5 {/ U% s7 Z内存：官方推荐 16GB RAM 起步，32GB 更佳；若 RAM 不足，需大幅增加 swap 空间（如 25GB+）
+ N* d. s5 o \. H% ~" F5。5 V+ [" t5 m2 p
CPU：建议 8 核及以上，以加速编译 * h1 S% l8 b; E0 R4 x8 _5 J: T
3
# K0 a( R5 |. P6 Z0 T' _5 |( g/ W4。% X1 w3 S6 T" n/ u' J& j: D
网络环境敏感9 k0 F4 e6 H6 H" e6 U
国内访问 Google 服务不稳定，必须使用国内镜像源（如清华、中科大）加速 repo 同步和依赖下载
: A$ H/ {+ e0 i- F2
1 o# g% T$ {& G8 S% g0 P9 ]% A5。
' w1 ]1 V5 @: I/ j+ w1 ]" B( Q示例配置清华源：
5 r% e, _- T( S- _$ b, i4 l1 M" ^3 n
bash! m, S% ]2 T7 V) G
export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo'
, q; s" u3 }" ~5 Q# t- }! hrepo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-13.0.0_r417 }! R, |* F* y
二、源码获取与管理
# c1 r( T7 e6 P+ a( D- Drepo 工具易出错
" i/ m! h0 m( m* Qrepo 是 Git 的封装工具，用于管理数百个仓库。常见问题包括：! k% {6 \, ]+ r, N! g0 T$ l6 r
% s) X3 B; e9 S: H( l同步中断：使用 repo sync -f 强制继续 ! q0 a& Y- Z! M0 [
2。4 l7 w9 o8 U: f9 o! W w, i: F
并发过高导致服务器拒绝：同步时建议用 -j4 或更低并发
3 L0 O! E8 f/ ^! p8 z* H: N' o5。# K O- T/ i3 L2 E, H. X
.repo/repo/ 目录被修改：可执行 git checkout -f 恢复（仅限非生产环境）
. j; ^% s* g- l: g% A- z% w5。& E% _* ^$ r3 K: s* G9 v4 U4 S2 ]
避免使用移动硬盘或 NTFS 分区存储源码
" P. o! @! F2 uAOSP 编译依赖 Linux 文件权限和符号链接，NTFS 或 FAT32 文件系统会导致文件创建失败，编译直接报错 & o5 Q) E: E5 N }8 \# g/ c
8。- g4 G Y0 E, z' u; |* M
, H: H' ]' U' T, V D/ y" R三、编译配置与执行
8 P! J) a5 Z+ h; K( ^目标设备选择关键# S4 T& z# [4 Y1 A; p/ k
首次建议选择 Pixel 系列设备（如 Pixel 6：aosp_oriole-userdebug），因其有完整官方驱动和社区支持
& u* D( c( U% W; q0 Y2。
) M5 m5 n3 o( s& U其他设备需自行适配 HAL 和驱动，难度陡增。2 p+ [. ?' o2 r- f% R$ c
7 e# \1 m$ x( t8 f, L, W: t% L0 M
必须匹配专有驱动（Binary Blobs）
' ?# N7 G4 H M% k$ w/ d @. C: M1 U- D对于 Pixel 或其他厂商设备，必须从 Google Android Drivers 下载对应版本的驱动包，解压至 AOSP 根目录并运行提取脚本，否则编译或刷机后无法启动
9 Z8 V" T8 p X2 Y4 b2。. a1 Z6 Y& s! s4 ~' P: I! d
5 l, @( F6 g* V! c8 ` SJava 版本冲突! E* z! }2 }# k" y' D8 @( q
AOSP 13 要求 OpenJDK 11，若系统默认 Java 版本不符，会报 unsupported Java version 错误
) @, U% l, z5 v2。
& q. F8 Z1 Y/ s3 ~/ X设置命令：2 x, x+ L) n+ ?" x
$ C S1 H" `' q4 y" V) {
bash/ ~( K* M/ j9 ~- b
sudo apt install openjdk-11-jdk- V ~- N3 k1 P$ }3 d% \
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
\6 Y H) {) J% F% J& f内存不足导致 OOM# U; T4 _, z1 W( w7 c9 b8 q" Q3 Z
编译大模块（如 framework）时，若 RAM 不足，可尝试：
# }; G4 Z' f0 d- s- x- p& O5 T q0 A$ m( |8 H, D
增加 swap 分区（至少 20GB）2 z( S$ p: v, `+ C* ^) K, u& t
5。* M% \4 ]# e, g8 O7 S
设置 JACK 服务器堆大小（仅旧版 AOSP）：
8 l& j& h; [% \bash7 b1 s/ k) }$ l* C- ]' I4 s1 ?0 Q
export JACK_SERVER_VM_ARGUMENTS="-Dfile.encoding=UTF-8 -Xmx8g"5 p) F: P- s0 f" _$ J
四、打包与刷机风险; a3 }( d; P k% z9 ] u# y+ r/ y; @
镜像格式与分区兼容性
. ?4 N u4 S) F+ o6 `) N打包后生成的 system.img、vendor.img 等必须与目标设备的分区布局匹配。混合不同 Android 版本的系统镜像（如 AOSP 16 + Android 14 Vendor）需特殊工具处理，否则设备变砖
0 S* W3 M6 j2 `7。 | r- O# T7 R* Y
" x. _5 S# D1 c$ [. `/ \刷机前务必解锁 Bootloader8 d) Y& d; M8 G2 O+ A
Pixel 设备需进入 Fastboot 模式后执行：
! z4 i" W- x, ]% o1 `+ a! Y* [9 T$ g# z
bash# N* _2 ~3 F! h6 {
fastboot flashing unlock
# f/ g1 Q/ P5 d8 U5 I此操作会清除设备所有数据，请提前备份 * {: ^1 _" W% x% X E" K
2。
* [9 x8 ~) j* m3 ~/ o6 p9 }( Y5 c3 r! m1 m# |
自定义 ROM 验证困难
/ t* z# [7 A+ I, a' D刷机后若无法启动，需通过 Fastboot 或 Recovery 查看日志。缺乏设备调试接口（如 UART）将极大增加排障难度。
- C& C7 A# a& V0 X# t+ p; l2 _
6 @3 I# V) @1 a; E0 M5 G/ N五、其他实用建议
* S2 M5 n7 K% P2 M使用 ccache 加速重复编译
! a9 {' ~+ K. y% K; j" u* B0 T
$ J% |+ L) C4 F" P2 p: nbash+ S. w/ R4 x5 R" `
export USE_CCACHE=1' \+ g* ^0 s8 G( H
prebuilts/misc/linux-x86/ccache/ccache -M 50G5 @3 I5 z; {' L, \ G
优先选择 userdebug 构建类型2 s- p& O( I; |, V; \* W
相比 user 版本，userdebug 提供 root 权限和 adb 调试能力，便于开发调试 7 ~% h7 ?* t/ h
2。 I7 {- `& H$ ]+ o! `2 j7 @
* T: w. P8 o' ] R+ ^* V4 c
参考最新教程2 y) F1 Q1 e7 Q" T3 t
AOSP 接口和工具链变化快，优先参考 2025–2026 年发布的实战指南（如 ; _( `8 N' A6 |0 C+ I
2
1 t& V8 q$ R1 L6 x# h3 a# P7），避免沿用过时文档。
3 o5 r; o5 G8 Z1 Y( p, C+ i/ X
* `) @1 ?2 B4 {/ h0 u# w! V如需完整操作流程，可参考：从零编译 AOSP 13 定制 ROM（2026 年最新版）。
: ~1 G4 q# l1 m& M4 G9 W. H8 U& m6 n, \& f
参考 |
提升卡
置顶卡
沉默卡
喧嚣卡
变色卡
千斤顶
照妖镜