PixelFlasher项目中的KernelSU-Next补丁执行问题分析与解决

问题背景

在Pixel 7 Pro设备上使用PixelFlasher工具进行KernelSU-Next（非LKM模式）补丁时，用户遇到了pf_patch.sh脚本无法执行的问题。该问题发生在设备已解锁Bootloader并恢复至出厂设置后，尝试通过PixelFlasher工具进行内核补丁的过程中。

问题现象

当用户尝试通过PixelFlasher执行KernelSU-Next补丁时，系统报告错误：

/bin/sh: 1: /data/local/tmp/pf_patch.sh: not found

尽管通过adb shell手动检查确认脚本文件确实存在于指定路径，且权限设置正确（755），但通过PixelFlasher自动执行时仍然失败。

技术分析

1. 执行环境差异

通过深入分析发现，问题根源在于shell执行环境的差异：

• 手动执行：通过adb shell直接执行脚本时，使用的是设备上的/system/bin/sh（mksh）
• 自动执行：PixelFlasher通过adb命令执行时，系统错误地尝试使用本地主机的/bin/sh（dash）

2. Shell解析器路径问题

设备端脚本的shebang明确指定了#!/system/bin/sh，但执行时却被主机环境的shell解释器拦截。这表明adb命令在执行远程脚本时存在路径解析问题。

3. 解决方案验证

通过以下两种方式验证了解决方案的有效性：

1. 引号包裹命令：

   adb -s 设备ID shell "cd /data/local/tmp; /data/local/tmp/pf_patch.sh"
   

   这种方式强制在设备端shell环境中执行整个命令序列。

2. 直接指定完整路径：

   adb -s 设备ID shell /system/bin/sh /data/local/tmp/pf_patch.sh
   

两种方式都能成功执行补丁脚本，生成正确的内核镜像文件。

解决方案实现

基于以上分析，PixelFlasher项目采取了以下改进措施：

1. 命令执行方式优化：在所有adb shell命令执行处添加引号包裹，确保命令在设备端shell环境中正确解析。

2. 执行环境隔离：明确指定使用设备端的/system/bin/sh作为解释器，避免与主机环境冲突。

3. 错误处理增强：增加更详细的错误日志记录，帮助用户快速定位类似问题。

技术启示

这个案例揭示了Android开发中常见的一个陷阱：混合执行环境问题。开发者在编写跨主机-设备执行的自动化脚本时需要注意：

1. 明确区分主机和设备的执行环境
2. 谨慎处理路径和shell解释器指定
3. 考虑不同Android版本和厂商定制的环境差异
4. 增加环境检查机制，提前发现潜在问题

总结

通过分析PixelFlasher项目中KernelSU-Next补丁执行失败的问题，我们不仅解决了特定的技术障碍，更重要的是建立了一套更健壮的跨环境脚本执行方案。这种方案不仅适用于当前问题，也为处理类似场景提供了参考模式，体现了在Android系统工具开发中环境隔离和明确执行路径的重要性。