#android #固件 #分区 #提取 #厂商 #镜像 #引导

app Android果汁机

从Android厂商分区中提取固件

5个版本

0.2.1 2024年1月11日
0.2.0 2023年2月8日
0.1.2 2023年1月12日
0.1.1 2023年1月12日
0.1.0 2022年12月20日

235Unix API

每月 29 次下载

MIT 许可证

19KB
339 代码行

Android果汁机

droid-juicer 是一个用于从Android设备厂商分区中提取二进制固件文件的工具。它允许将所需的固件导入Linux系统/lib/firmware文件夹,避免分发此类固件及其相应的法律问题。

配置

全局/etc/droid-juicer/config.toml配置文件可用于设置与设备无关的选项。此文件目前仅允许配置后处理命令,以字符串数组的形式编写。这些命令可以包括特殊的%k参数,该参数将在运行时用当前运行内核的修订版(uname -r的值)替换。

示例配置(用于Debian系统)可以在config.toml.sample文件中找到。

设备配置

droid-juicer 依赖于按设备DT compatible属性命名的每个设备的TOML配置文件。

配置文件包含一个名为juicer的单个部分,该部分有一个名为firmware的单个键。此键的预期值是以下属性的"对象"数组

  • partition:包含固件文件的厂商分区的名称,它出现在/dev/disk/by-partlabel/下。
  • origin:包含固件文件的厂商分区文件夹
  • destination:必须复制的固件文件的/lib/firmware子文件夹;如果不存在,将创建此文件夹
  • files:这些是droid-juicer要复制的固件文件,存储为以下属性的简单对象
    • name:原始文件名
    • rename(可选):重命名文件的新名称

示例配置可以在configs文件夹中找到。

用法

droid-juicer由systemd服务在设备首次启动时启动。它根据相应的配置文件复制固件文件,然后更新initramfs和Android引导镜像,以便在后续引导时提取的固件可用。最后,它重启设备。

droid-juicer也可以手动执行(作为root)。在这种情况下,建议首先运行droid-juicer -cleanup,在新的运行之前删除现有的文件和重定向。

许可证

droid-juicer根据MIT许可证许可。

贡献

请在项目的gitlab存储库中自由地打开问题/合并请求。

依赖项

~3–4MB
~78K SLoC