frida-legacy-compat 1.0.0

Restore a Frida 16-style Python session.create_script() workflow on Frida 17+

frida-legacy-compat

默认中文 | English

frida-legacy-compat 是一个面向 Frida 17+ 的 Python 兼容层，用来把 Frida 16 风格的 session.create_script() 注入体验尽量恢复回来。

这个库就是专门用来解决 Frida 17.0.0 以上版本中，使用 Python API 执行旧版 JS 脚本时常见的 bridge 报错问题，例如：

{'type': 'error', 'description': "ReferenceError: 'Java' is not defined", 'stack': "ReferenceError: 'Java' is not defined\n at (/script1.js:3)"}

Frida 17 以后，旧版 bridge 默认不再跟随原来的 plain JS 工作流一起可用，很多场景需要改成 TypeScript/ESM 编译，或者额外下载 bridge，使用成本明显变高。

这个库的目标很直接：

• 安装一次
• 多加一行 import frida_legacy_compat
• 继续直接把旧版 JS 字符串传给 session.create_script(source)
• 旧脚本里的 Java、ObjC、Swift 继续可用

仓库地址：https://github.com/RYF5584/frida-legacy-compat

特性

• 安装后自动 patch frida.core.Session.create_script()
• 自动识别旧版 bridge 脚本并按需编译
• 自动安装所需 bridge 包
• 不需要 Node.js
• 根据 frida.__version__ 自动选择默认 bridge profile

安装

pip install frida-legacy-compat

如果希望同时安装推荐范围内的 Frida：

pip install 'frida-legacy-compat[full]'

使用 uv add：

uv add frida-legacy-compat
uv add 'frida-legacy-compat[full]'

兼容性

• frida < 17：可安装、可保留 import frida_legacy_compat，导入后默认静默 no-op
• 17.0 <= frida < 17.2：不支持
• 17.2 <= frida < 18：支持
• frida >= 18：当前版本默认视为未验证

快速开始

import frida
import frida_legacy_compat

device = frida.get_usb_device()
session = device.attach("com.example.app")
source = """
Java.perform(function () {
  var Activity = Java.use("android.app.Activity");
  console.log(Activity);
});
"""

script = session.create_script(source)
script.load()

CLI

frida-legacy -U -f com.example.app -l agent.js

文档

• English documentation
• 更新日志
• 安全策略
• v1.0.0 发布说明
• GitHub 仓库

注意事项

• 第一次运行可能会慢一点，因为 bridge 包会按需安装
• 已编译的 Frida bundle 会被自动识别并直接透传
• 当前兼容入口是 Session.create_script()