适用:把驱动 / 属性 / SELinux 策略等补丁直接打进 Android 动态分区镜像(erofs),再刷入设备。本例机型为骁龙 SM7475 / Adreno 725 / HyperOS-Android 17,但方法对同类机型通用。 读者:① 人类可逐条照做;② AI 新对话读完即可无缝接手执行。 使用方式:实操时,把占位路径(
<>处)替换为你的实际路径;每完成一个阶段,回写「第 0 章 状态记录模板」——照着填,换人(或换 AI)接手也不会断档。
0. 状态记录模板(实操时先填这份)
| 项 | 值(开工前记录) |
|---|---|
| 设备 / SN | <机型>,SN = <fastboot devices 查到> |
| BL 解锁 / 当前槽位 | 已解锁 / slot <a或b> |
| ROM 版本 | <getprop ro.build.version.incremental> |
| 原厂镜像备份 | <原厂镜像目录>/{system,system_ext,vendor}_a.img(只读,勿改) |
| 成品输出目录 | <成品镜像目录>/ |
| 工具目录 | <MIO-KITCHEN目录>、<adb_fastboot目录> |
| 目标改动 | <本轮要打哪些补丁> |
| 进度 | 进行到阶段 <E几> |
AI 接手:先跑「A1 快速体检」核对上表,不一致以实际为准并更新。
# A1 快速体检
cd <工作区>
ADB=<adb_fastboot目录>/adb.exe; FB=<adb_fastboot目录>/fastboot.exe
$ADB devices; $FB devices # 连接状态
$ADB shell getprop ro.build.version.incremental # ROM 版本(需已开机)
$FB getvar current-slot; $FB getvar unlocked # 槽位/锁
1. 前置准备
1.1 必备条件
- 设备已解锁 BL、电量充足、数据已备份(刷分区不动 data,但要防意外)
- 原厂固件包(内含
system_a.img/system_ext_a.img/vendor_a.img)→ 复制一份作为只读备份,后续全程不动 - 一台 Windows 电脑(工具均为 Windows 版,可在 WSL 中通过路径调用)
1.2 工具
| 工具 | 用途 | 调用注意(踩过的坑) |
|---|---|---|
| MIO-KITCHEN 3.x | 解包/打包 erofs 镜像(自带 extract.erofs.exe、mkfs.erofs.exe) | ① -i 只认相对路径,绝对路径报 does not exist → 先把镜像 cp 到工具目录下;② -o 输出目录名 = 之后一切 config 的前缀;③ -X 单文件提取不可靠,验证内容请全量 -x |
| adb / fastboot | 刷机、验证 | 分区相关必须用 fastbootd(见 E6);adb kill-server 可修假死 |
| Python3 | 批量文件对比、元数据校验 | 无 |
| 文本编辑器 / xxd / md5sum | 改 build.prop、读镜像头、校验 | 无 |
1.3 必须理解的三个概念
- 动态分区:system/system_ext/vendor/product 都住在
super分区里 → bootloader 模式的 fastboot 看不到它们,必须fastboot reboot fastboot进 fastbootd 才能刷。 - erofs 镜像结构:文件开头 1024 字节零头,之后才是 superblock(superblock 内
0x30处是 16 字节 UUID);镜像内容默认压缩 → 直接grep镜像搜文件内容是搜不到的(文件名/元数据可用-p查)。 - config 三件套:解包工具会生成
config/<名>_file_contexts(每个文件的 SELinux 标签规则)、<名>_fs_config(权限)、<名>_fs_options(记录原厂 mkfs 全参数,含 UUID 与 mount-point)。打包时用哪套 config,镜像里文件的标签/权限就按哪套打。
2. 核心决策规则(动手前必读)
| 编号 | 规则 | 教训来源 |
|---|---|---|
| R1 三镜像同源铁律 | system / system_ext / vendor 必须来自同一 ROM 版本。混搭(新 system_ext + 旧 system/vendor)= 必然开机循环、bootloader 自动跳槽、getprop 读到错乱的旧版本指纹 | 实测 |
| R2 补丁落点 | SELinux 规则必须写进域声明所在的那个策略文件(域在哪个组 plat/system_ext/vendor,allow 就写哪组)。跨组引用 → secilc 编译失败 → 若无 precompiled_sepolicy 兜底 = 黑砖 | 实测:某机 vendor 组引用 system_ext 专属类型 0/821、plat 非公共类型 0 |
| R3 命名与冲突 | 平台组(plat/system_ext/product)策略里用无后缀类型名(如 hwservicemanager_prop);vendor/odm 组惯例用带版本后缀的名字(如 hwservicemanager_prop_32_0,以同文件既有规则为准)。build.prop 同名属性后写覆盖 → 冲突属性只留最终意图一个值 | 实测 |
| R4 config 格式 | config 中的路径前缀 = 解包时的 mount-point(即 -o 目录名),不是 /vendor/。file_contexts 路径按正则转义(. → \.),fs_config 不转义,格式 <路径> <uid> <gid> <mode>(文件一般 0 0 0644) | 实测 |
| R5 UUID 沿用原厂 | 打包必须 -U <原厂UUID>,直接从 fs_options 抄文本(最权威);UUID 为标准 8-4-4-4-12 十六进制,勿手工拼字节序(拼错 mkfs 报 invalid UUID) | 实测 |
| R6 备份与校验 | 原厂镜像只读留底;改文件前 cp 原件到临时目录做 diff 基准;每次打包后必须过 E5 全套校验 | 实测 |
| R7 属性归档 | ro./debug./persist. 系统级属性 → system 镜像的 system/build.prop;vendor.* → vendor 镜像 build.prop;一律写在 # end of file 之前 | 实测 |
| R8 bootloop 处置 | 开不了机先怀疑 R1 版本混搭 与槽位状态,再逐个分区回退(每次只动一个变量);不要一上来怀疑补丁内容 | 实测 |
3. 流程总览
| 阶段 | 内容 | 产出 |
|---|---|---|
| E1 | 解包三镜像 | 解包目录 + config 三件套 |
| E2 | 分析:驱动对比 / 改动清单 /(模块源)反混淆 | 逐文件改动清单 |
| E3 | 三分区打补丁(vendor / system / system_ext) | 修改后的解包目录 |
| E4 | 重打包(原厂 UUID + 原 mount-point) | 三个新 .img |
| E5 | 校验(5 项全过才算数) | 放入成品目录 |
| E6 | 刷入(fastbootd) | 已刷设备 |
| E7 | 开机验证 → 回写状态 | 完成 |
E1 解包
cd <MIO-KITCHEN目录>
cp <原厂镜像目录>/system_a.img ./n_sys.img # ⚠️ 必须 cp 到 cwd(相对路径)
EX="bin/Windows/AMD64/extract.erofs.exe"
"$EX" -i n_sys.img -x -o x_sys -T0 # system 同理做 system_ext、vendor
产物结构:
x_sys/
├── config/
│ ├── n_sys_file_contexts # SELinux 标签规则(打包时给文件打标签)
│ ├── n_sys_fs_config # 权限(uid gid mode)
│ └── n_sys_fs_options # ⭐ 原厂 mkfs 完整命令(UUID / mount-point / 参数)
└── n_sys/ # 分区根内容(即 /system 的内容)
立即记下两个打包必填参数:
grep -E "Filesystem UUID|mount-point" x_sys/config/n_sys_fs_options
注意:三个镜像的 mount-point / UUID 各不相同,分别记录。
E2 分析与改动清单
E2.1 驱动版本对比(判断要不要换驱动)
从三处取 lib64/egl/libGLESv2_adreno.so(原厂镜像、驱动包、目标版本),提取版本与构建日期:
python3 -c "
import re
d=open('<path>/lib64/egl/libGLESv2_adreno.so','rb').read()
print(sorted(set(x.decode() for x in re.findall(rb'V@[0-9]{3,4}\.[0-9]+(?:\.[0-9]+)?',d))))
print(sorted(set(x.decode() for x in re.findall(rb'Date:[0-9]{2}/[0-9]{2}/[0-9]{2}',d))))"
参考(分支数字越大越新,但以构建日期为准;不同分支不可跨代比较):
| 来源(示例) | 版本 | 构建日期 |
|---|---|---|
| 某 ROM 原生 | [email protected] | 2025-01-23 |
| 某驱动包 762.36 | [email protected] | 2025-05-16 |
| 另一版本 ROM | [email protected] | 2026-06-24 |
选哪个源由使用者拍板,记入状态表。
E2.2 逐文件对比(驱动包 vs 镜像)
对包内 driver_files/** 每个文件与镜像同路径比对,生成三类清单:
- 新增(镜像没有)→ ★必须补 config 条目(E3.1b)
- 替换(存在但内容不同)→ 直接覆盖,config 沿用原条目
- 一致 → 跳过
E2.3 信息源是 Magisk 模块时:反混淆 + 提取上下文
模块的 customize.sh 常是「字符串碎片 + eval 拼接」混淆。反混淆(关键:用双引号内展开,避免碎片里的 $(/` 反引号被二次解析):
# deobf.sh
cd "<模块目录>"
eval "$(sed -n '1,2p' customize.sh)" # 1-2 行:碎片变量定义(注意第一个变量常跨两行)
body=$(sed -n '3p' customize.sh) # 3 行:eval "$Az$Bz..."
body=${body#eval }; body=${body#\"}; body=${body%\"}
eval "printf '%s' \"$body\""
bash -n customize.deobf.sh # 语法检查
grep -nE "chcon|set_perm" customize.deobf.sh # 提取 SELinux 标签与权限
典型输出(这就是新增文件的标签来源):
set_perm_recursive .../lib*/*.so ... 0644 u:object_r:same_process_hal_file:s0
set_perm_recursive .../permissions/*.xml ... 0644 u:object_r:vendor_configs_file:s0
E3 三分区打补丁
E3.1 vendor 分区
(a) 复制/覆盖驱动文件 → 解包目录下同路径。
(b) 仅为「新增文件」补 config 两个文件(替换文件已有条目,勿重复):
# config/<名>_file_contexts(路径按正则转义,前缀=<mount-point>)
/<mount>/lib/libXXX\.so u:object_r:same_process_hal_file:s0
/<mount>/etc/permissions/android\.hardware\.vulkan\.version-1_3\.xml u:object_r:vendor_configs_file:s0
# config/<名>_fs_config(不转义)
<mount>/lib/libXXX.so 0 0 0644
<mount>/etc/permissions/android.hardware.vulkan.version-1_3.xml 0 0 0644
标签选取速查:驱动库(.so)→ same_process_hal_file;etc/permissions/*.xml → vendor_configs_file;未被 HAL 加载的附属库 → vendor_file。不确定时:照抄同目录既有条目的标签。
(c) build.prop(写在 # end of file 之前,先查重):
vendor.display.vds_allow_hwc=1 # 若已有 =true 则改值
vendor.hwc.dpp.downscale=4 # 不存在则追加
⚠️ 见 F5:HyperOS 对
vendor.*属性有白名单,写进去可能仍不加载 —— 属平台限制,不阻塞流程。
(d) GPU 抢占补丁(可选) → 追加到 bin/init.qcom.post_boot.sh 文件末尾:
# Start Patch Preemption
if [ -f /sys/class/kgsl/kgsl-3d0/preemption ]; then
echo 0 >/sys/class/kgsl/kgsl-3d0/preemption
fi
# End Patch Preemption
落点合法性必查 5 项(缺一不可,详见 F4):服务启动时机、脚本标签→域、该域对该 sysfs 类型有 write、脚本已有同类写入先例、脚本内无 exit。
E3.2 system 分区(build.prop 属性)
写在 system/build.prop 的 # end of file 之前,先查重:
# ==== Adreno GPU / Vulkan patch ====
ro.zygote.disable_gl_preload=false # ← 若模块原值是 true,按需改为 false
debug.graphics.game_default_frame_rate.disabled=true
ro.egl.blobcache.multifile=true
ro.egl.blobcache.multifile_limit=33554432
debug.hwui.skia_tracing_enabled=false
debug.hwui.skia_use_perfetto_track_events=false
ro.hwui.use_vulkan=true
ro.hwui.render_ahead=3
debug.hwui.renderer=skiavk
debug.stagefright.renderengine.backend=threaded
debug.renderengine.backend=skiavkthreaded # ← 与 skiaglthreaded 是同一属性,冲突只留一个
debug.renderengine.vulkan=true
persist.sys.enhance_vkpipelinecache.enable=true
可选项:MIUI 逐应用 Vulkan 白名单(
persist.sys.vk_mode_enabled=true+persist.sys.vk.<包名>=1若干)——按需决定是否加,默认不加。
E3.3 system_ext 分区(SELinux 策略补丁)
典型场景:MIUI 自研 graphicsengine(Vulkan 管线缓存预热服务)缺一条属性读权限,导致预热全废 → 每个 App 首帧现场编译管线卡顿。
修复:在域声明所在文件(etc/selinux/system_ext_sepolicy.cil)中,照该文件既有的 MIUI 标注风格插入:
;;* lmx <行号> miui/system/sepolicy/generic/private/graphicsengine.te
(allow graphicsengine hwservicemanager_prop (file (read getattr map open)))
;;* lme
完整证据链(判断"该补哪条、写哪"的方法论):
- 域在哪声明?→ 搜
grep -rn "^(type graphicsengine)" */etc/selinux/*.cil→ 定位到 system_ext ⇒ 规则也写这里(R2) - 文件标签在哪?→
system_ext_file_contexts:/system/bin/graphicsengine → graphicsengine_exec、缓存目录 →pipelinecache_data_file - 现状是否真缺?→ 域属于
coredomain+domain属性集,检查这俩属性集的规则里是否含目标属性类型;再看 plat 策略是否给目标属性类型授权给固定域名列表(该域名不在列)→ 缺,必被拒 - 属性类型名?→
plat_property_contexts查映射:hwservicemanager.→hwservicemanager_prop - 权限集合?→ 抄同文件里同族域的先例,如
(allow miuibooster hwservicemanager_prop (file (read getattr map open)))
改完必查:文件括号平衡(( 数 = ) 数)。
E4 重打包
cd <MIO-KITCHEN目录>
MK="bin/Windows/AMD64/mkfs.erofs.exe"
"$MK" -zlz4hc,1 -T 1230768000 -U <原厂UUID> \
--mount-point=<该镜像解包时的mount-point> \
--fs-config-file=<解包目录>/config/<名>_fs_config \
--file-contexts=<解包目录>/config/<名>_file_contexts \
out_<名>.img <解包目录>/<名>
- 三个镜像逐个执行,各自用自己的 UUID 与 mount-point
- mkfs 输出自带 1024 字节头(与原厂格式一致)——不要再手工加头
- 打出来比原厂大几十 MB 属正常(压缩策略差异)
E5 校验(每镜像 5 项全过)
| # | 项 | 方法 | 通过标准 |
|---|---|---|---|
| 1 | UUID | xxd -s $((0x400+0x30)) -l 16 out_x.img,与原厂比 | 一致 |
| 2 | inode 数 | mkfs 输出的 total inodes | 与原厂相等(仅新增文件时才变多) |
| 3 | 元数据 | extract -p 原厂/新图各出一份 → 下方脚本比对 | 0 删除、0 权限标签变化;新增文件条目与预期完全一致 |
| 4 | 内容抽查 | 全量 -x 解包后查:build.prop 属性、CIL 规则、驱动版本、脚本尾部 | 逐项命中 |
| 5 | 可解包 | -x 全量解包 | 正常完成、文件数合理 |
元数据比对脚本(必须忽略 dataLayout) —— erofs 会在 COMPRESSED/INLINE 存储方式间抖动,这不是错误,只比 fsConfig+seLabel:
import re
def parse(p):
d={}
for line in open(p, encoding="utf-8", errors="replace"):
m=re.search(r"fsConfig=\[(/[^ ]*) ([^\]]*)\] seLabel=\[([^\]]*)\]", line)
if m: d[m.group(1)]=(m.group(2).strip(), m.group(3))
return d
o, w = parse("orig.txt"), parse("new.txt") # 由 extract -p | sort 生成
print("新增:", sorted(set(w)-set(o)))
print("删除:", sorted(set(o)-set(w)))
print("变化:", [k for k in set(o)&set(w) if o[k]!=w[k]])
# 预期:未动的镜像全 0;动过的镜像只有预期的"新增"
E6 刷入(fastbootd)
:: 1) 必须进 fastbootd —— 在 bootloader fastboot 刷动态分区会报 Partition not found
fastboot reboot fastboot
fastboot getvar partition-type:system_a :: 必须返回 raw 才能刷
fastboot getvar current-slot :: 记下当前槽位
:: 2) 逐个刷(在成品目录执行)
fastboot flash system_a system_a.img
fastboot flash system_ext_a system_ext_a.img
fastboot flash vendor_a vendor_a.img
:: 3) 重启
fastboot reboot
- 刷前槽位健康检查(bootloop 排查用):
fastboot getvar slot-successful:a/slot-unbootable:a - 回退:
fastboot flash <分区> <原厂镜像>—— 原厂备份就是救命符,永远保留
E7 开机验证(全绿才算完成)
等 sys.boot_completed=1(约 60~120s):
# 1) 驱动
adb shell "dumpsys SurfaceFlinger | grep GLES:" # 期望显示目标驱动版本
adb shell cat /sys/class/kgsl/kgsl-3d0/gpu_model # GPU 型号正常
# 2) 属性(对照 E3.2 清单逐条 getprop)
adb shell getprop ro.zygote.disable_gl_preload # false(若按需设置)
adb shell getprop debug.hwui.renderer # skiavk
# 3) 抢占补丁 —— 服务在 boot_completed 后才执行,刚开机读到 1 属正常,等 1~2 分钟
adb shell cat /sys/class/kgsl/kgsl-3d0/preemption # 0
# 4) graphicsengine 预热(策略补丁生效判据)
adb shell ls /data/system/graphicsengine/pipelinecache/ # 出现包名目录且持续增加
adb shell "su -c 'dmesg | grep -i \"avc.*graphicsengine\"'" # 期望空
# 5) SELinux 标签抽查(新文件)
adb shell ls -Z /vendor/lib64/libXXX.so # u:object_r:same_process_hal_file:s0
全绿 → 回写第 0 章状态记录。
F. 组件知识库(补丁的"为什么")
F1 GPU 驱动(Adreno)
- 模块/包内
system/vendor/lib{,64}/**→ 镜像/vendor/lib{,64}/**同路径覆盖 - 版本识别:
lib64/egl/libGLESv2_adreno.so的[email protected]+Date:+GIT@ - 常见新增件:
libOpenCL_adreno.so、libadreno_compiler_cl.so、gpu/kbc/*.bin、etc/permissions/android.hardware.vulkan.version-1_3.xml(Vulkan 1.3 声明,version="4206592"=0x403000)
F2 Vulkan / HWUI 属性
- 全局 HWUI 走 Vulkan:
ro.hwui.use_vulkan=true+debug.hwui.renderer=skiavk+debug.renderengine.backend=skiavkthreaded - 预热缓存总开关:
persist.sys.enhance_vkpipelinecache.enable=true(服务、libEGL、libhwui 三方都读) - 模块的
system.prop按 R7 搬进对应 build.prop;其中ro.zygote.disable_gl_preload模块常写true,是否改 false 按机型实测决定
F3 graphicsengine(VkPipelineCache 预热服务)
- MIUI 自研,非 AOSP:二进制
/system/bin/graphicsengine,rc 位于/system/etc/init/graphicsengine.rc(标记# MIUI ADD: SF_EnhanceVkPipelineCache;无 seclabel → 域由文件_exec标签推导) - 职责:开机遍历系统应用,把 Vulkan 管线缓存写入
/data/system/graphicsengine/pipelinecache/<包名>/ - 失效链:进程首次走 HIDL → libhidltransport 等
hwservicemanager.ready→ 属性类型hwservicemanager_prop无读权限 → 轮询超时 → 二进制打印ARCHI_PipelineCache, vulkan environment not ready→ 服务退出 → 预热全废 → 每个 App 首帧现场编译管线(卡顿) - MIUI 自身疏漏:给 AIDL(
servicemanager_prop)配了,漏了 HIDL 这条 - 二进制还会读:
persist.sys.enhance_vkpipelinecache.enable/.force、persist.sys.vkcache.sys_app_max_entries、debug.vulkan.pipeline_cache.config_path、ro.arch等 - 验证生效:E7 第 4 项
F4 GPU 硬件抢占补丁(为何落点是 post_boot.sh)
- 服务
qcom-post-boot在init.qcom.rc:on property:sys.boot_completed=1触发(class late_start、oneshot、无 seclabel) - 脚本标签
vendor_qti_init_shell_exec→ 运行域vendor_qti_init_shell - 该域对
vendor_sysfs_kgsl有 write(vendor 策略中的 allow),而/sys/class/kgsl/kgsl-3d0/*正是此类型 - 脚本里本就有 9 处同目录节点写入(
max_pwrlevel/min_pwrlevel)——同权限先例 - 脚本 0 个
exit、LF 行尾、#!/vendor/bin/sh→ 追加必执行 init域对该类型无 write → 想在.rc里直接write的方案不可行,只能走脚本- 节点不存在时由
[ -f ]兜底,无副作用
F5 HyperOS 平台限制(不是 bug,别去"修")
| 现象 | 解释 |
|---|---|
vendor.* 属性写进 build.prop 却 getprop 读不到 | init 属性白名单:实测某机原厂 build.prop 191 条 vendor.* 只加载 7 条,vendor.display.* 全军覆没(原厂自己写 =true 也没生效过)。system 的 ro./debug./persist. 属性不受影响,正常加载 |
cat /vendor/build.prop → Permission denied | 该文件标签 shell 无读权限;init 不受影响。要看内容就解镜像 |
| 打包工具"新增文件检测"只补一部分条目 | 设备侧 /vendor/etc/selinux/vendor_file_contexts 必须手动核对补全 |
F6 qgl_config.txt(驱动调优,可选)
- 驱动库硬编码读取
/data/vendor/gpu/qgl_config.txt→ data 分区,只读镜像放不进去 - 不装 = 驱动默认参数,完全可用;装 = 作者调优(队列优先级、wave size 等)
- 手动安装(需 root,装完必须重启):
adb push qgl_config.txt /data/local/tmp/ adb shell "su -c 'mkdir -p /data/vendor/gpu && cp /data/local/tmp/qgl_config.txt /data/vendor/gpu/ && chown 0:0 /data/vendor/gpu/qgl_config.txt && chmod 644 /data/vendor/gpu/qgl_config.txt && chcon u:object_r:same_process_hal_file:s0 /data/vendor/gpu/qgl_config.txt'" adb reboot
G. 故障排查
G1 开机循环(每步只动一个变量)
- 版本混搭(R1):三镜像是否同一 ROM 版本?混刷 → 必循环
- 槽位状态:进 fastboot 查
slot-successful/slot-unbootable/current-slot;设备可能已自动跳到另一槽(表现为 getprop 显示旧 Android 版本) - 逐分区回退:先 vendor → 再 system_ext → 再 system,每次刷一个原厂镜像后试开机,定位肇事分区
- 全部原厂仍循环 → 与镜像无关,考虑
/data状态(必要时双清)
G2 adb / root 连接
| 症状 | 处理 |
|---|---|
unauthorized | 开发者选项 → 撤销 USB 调试授权 → 重插线 → 屏幕弹窗允许(勾"始终") |
| 通知栏"仅充电" | 下拉通知 → USB 用途改"传输文件(MTP)" |
su: inaccessible or not found | KernelSU:管理器 → 首页确认已激活 → 设置 → 超级用户 → 授权 shell(内核 root 正常但 su 未挂载时必做) |
fastbootd 里 GetVar Variable Not found | 还在 bootloader fastboot → fastboot reboot fastboot |
| 刚开机 getprop 读到离谱值(如旧 Android 版本) | boot 期间 USB 可能断连、属性未就绪 → 等 sys.boot_completed=1 稳定后再读 |
G3 补丁"没生效"
| 项 | 排查顺序 |
|---|---|
| preemption 仍为 1 | ① 是否已过 boot_completed(服务触发时机);② 设备上 tail /vendor/bin/init.qcom.post_boot.sh 确认补丁在;③ 手动 echo 0 > 节点 && cat 验证可写 |
| pipelinecache 为空 | ① dmesg | grep -i "avc.*graphicsengine" 看拒绝;② CIL 里的规则是否对应本 ROM 版本;③ getprop persist.sys.enhance_vkpipelinecache.enable |
| 驱动版本没变 | ① dumpsys SurfaceFlinger | grep GLES;② 是否刷成了原厂镜像而非成品 |
H. 历史坑索引
| # | 坑 | 规避 |
|---|---|---|
| 1 | 路径含 [、] 等字符时 ${f#前缀} 被当 glob 字符类 → 对比/复制全错 | find -printf '%P' 取相对路径 |
| 2 | config 前缀写成 /vendor/(应为解包 mount-point)→ 条目无效 | R4 |
| 3 | 打包工具漏补设备侧 vendor_file_contexts | 手动核对补全 |
| 4 | UUID 从 superblock 读时偏移猜错 | 用 fs_options,或 0x400+0x30 |
| 5 | mkfs 输出已带 1024 头,再加 = 双头 | 直接用 mkfs 输出 |
| 6 | 手拼 UUID 字节序 → invalid UUID | 直接抄 fs_options 文本 |
| 7 | bootloader fastboot 刷动态分区报 Partition not found | fastboot reboot fastboot |
| 8 | 三镜像跨版本混刷 → bootloop + 自动跳槽 | R1 |
| 9 | 元数据比对被 dataLayout 抖动干扰(假差异) | 用 E5 脚本忽略该字段 |
| 10 | grep -a 镜像内搜文件内容 = 压缩搜不到 | 全量解包后搜,或用 -p |
| 11 | extract 工具 -X 单文件提取不可靠 | 全量 -x |
| 12 | 策略规则写错组 → secilc 编译失败 → 黑砖 | R2 |
| 13 | KernelSU 有 root 但 su 找不到 | 管理器初始化 + 授权 shell(G2) |
| 14 | boot 期间 getprop 读到错乱版本号 | 等 boot_completed(G2) |
| 15 | 抢占值开机初读到 1(服务未跑) | 等 sys.boot_completed=1 后再读(G3) |
| 16 | 模块脚本反混淆用 heredoc/二次 eval 展开失败 | 用 E2.3 的双引号内展开写法 |
I. 术语速查
| 词 | 含义 |
|---|---|
| erofs | Android 只读分区镜像格式(压缩;前 1024 字节为头,其后 superblock) |
| file_contexts | 每个文件的 SELinux 标签规则(正则路径);打包时据此打标签 |
| fs_config | 每个文件的 uid/gid/mode 权限 |
| mount-point | mkfs 匹配 file_contexts 用的路径前缀 = 解包输出目录名 |
| fastbootd | 用户空间 fastboot;刷动态分区必需 |
| secilc / CIL | SELinux 策略编译器 / 策略源文件格式 |
| plat / system_ext / vendor 策略组 | 策略编译分组,组间类型默认不可互引 |
| domain transition | init 启动服务时的域切换,依赖可执行文件的 _exec 标签 |
| slot a/b | A/B 双槽;刷机只影响当前槽(current-slot) |
| preemption | GPU 硬件抢占;sysfs 节点 /sys/class/kgsl/kgsl-3d0/preemption |
| VkPipelineCache | Vulkan 管线缓存;MIUI graphicsengine 负责开机预热 |
致谢
本教程整理自实测记录,方案与资源来自酷安多位作者,在此一并感谢:
- 762.36 GPU 驱动包 GPU 硬件抢占补丁(
patch_preemption.sh) —— 酷安 做梦书 - VkPipelineCache缓存生成修复(
预热门)—— 酷安 Gerose - GPU 驱动修补、SELinux 规则修复思路 —— 酷安 枫落1911
- 其他参考作者:酷安 忽明忽暗不知所措、辰渊尘、欧阳春晨 等