Skip to content

字段参考

设备信息字段

以下字段可在模板或 [[apps]] 中使用。每个字段同时驱动 android.os.Build 静态字段(JNI 覆写,仅在应用进程内生效)和对应的系统属性(供 native 层 __system_property_get 等读取):

字段Build 字段系统属性说明
manufacturerBuild.MANUFACTURERro.product.manufacturer 及分区变体厂商 (如: Xiaomi, Samsung)
brandBuild.BRANDro.product.brand 及分区变体品牌 (如: Redmi, nubia)
marketname—(仅属性)ro.product.marketname + ro.vendor.oplus.market.name市场名 (如: Nothing Phone (3));OnePlus/OPPO 设备读取后者
modelBuild.MODELro.product.model 及分区变体型号 (如: NX769J, SM-S9280)
name—(仅属性)ro.product.name 及分区变体产品内部名 (如: popsicle)
deviceBuild.DEVICEro.product.device 及分区变体代号 (如: xuanyuan);未设置时自动使用 name 的值
productBuild.PRODUCT—(无系统属性)代号 (如: xuanyuan),仅覆写 Build 字段
hardwareBuild.HARDWAREro.hardware硬件名 (如: qcom),无分区变体
boardBuild.BOARDro.product.board主板名 (如: kalama),无分区变体
fingerprintBuild.FINGERPRINTro.build.fingerprint指纹
build_idBuild.IDro.build.idro.system.build.idro.vendor.build.idro.product.build.idBuild ID (如: UKQ1.230917.001)
characteristics—(仅属性)ro.build.characteristics特性 (如: tablet)

什么是「分区变体」?

ro.product.{odm,vendor,system,system_ext,product,bootimage}.<字段> 共 6 个属性。bionic 的属性读取按前缀路由到不同分区属性区,OnePlus/OPPO 等设备会读取这些变体,统一写入可保证各设备读取一致。

Android 版本伪装

字段Build 字段系统属性示例
android_versionBuild.VERSION.RELEASEro.build.version.releasero.system.build.version.releasero.vendor.build.version.releasero.product.build.version.release"15", "14", "13"
sdk_intBuild.VERSION.SDK_INT(整数)ro.build.version.sdkro.system.build.version.sdkro.vendor.build.version.sdkro.product.build.version.sdk35, 34, 33

DPI 伪装

在模板或 [[apps]] 中设置 dpi(范围 120640),例如 dpi = 420。模块先保存当前的 DPI;目标应用退后台约 2 秒或退出后恢复原值,回到前台时重新应用。没有备份时会重置。

自定义属性

custom_props 可设置任意系统属性(直接写入,无分区变体展开),支持在模板与 [[apps]] 中使用,也支持特殊标记值

toml
[[apps]]
package = "com.custom.app"
manufacturer = "Custom"

[apps.custom_props]
"ro.custom.property" = "custom_value"
"ro.debug.mode" = "__DELETE__"    # 删除该属性
"ro.empty.value" = "__EMPTY__"    # 设为空字符串

特殊标记值

标记值含义
普通字符串设置为该值
""设置为空字符串(等价于 __EMPTY__
"__EMPTY__"设置为空字符串
"__DELETE__"删除该属性(经 companion resetprop)

结构化字段中的标记值行为不同

__DELETE__ 会触发对应属性删除,但字面量 __DELETE__ 仍会同时写入属性和 Build 字段;__EMPTY__ 则完全按字面值写入。建议只在 custom_props 中使用标记值;结构化字段留空("" 或省略)即为不修改。

功能开关

字段默认值说明
companion_resetpropfalsetrue 时跳过 COW,所有属性交给 companion 进程 resetprop 写入(直写属性区,不经过 property_service),全系统读取一致;false(默认)时 COW 优先,仅影响当前进程内存。详见 高级用法
dpi临时设置系统显示 density(wm density),范围 120640;由 companion 保存并恢复原始 override
force_denylist_unmount继承 default_force_denylist_unmount对该应用强制启用 Zygisk FORCE_DENYLIST_UNMOUNT;优先级:应用 > 模板 > 全局默认
cpu_spoofCPU 伪装预设名,引用 [cpu_presets],详见 CPU 伪装
cpu_spoof_custom直接指定 /proc/cpuinfo 内容,优先级高于 cpu_spoof

注意

  • package 外所有字段均为可选
  • 使用模板的 packages 时无需写 [[apps]](自动应用)
  • [[apps]] 中的字段整记录取代模板,未设置字段不回落(见基础配置
  • 不在上表中的字段会被静默忽略(不影响解析)

基于 GPL-3.0 许可证发布。