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日 |
235 在 Unix API 中
每月 29 次下载
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