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