mirror of https://github.com/Heretek-AI/Android-RE.git synced 2026-07-19 20:43:32 -04:00

Files

T

John Smith fb74beb6f4 Initial import: Android-RE monorepo

Fresh re-import of the project. The prior history of the
Heretek-AI/Android-RE repository was rebuilt from a single squashed
initial commit per the project's vendor-neutrality policy (see
CLAUDE.md for the policy and translation table).

The audit trail for the rebuild is preserved at
/tmp/sanitize/pre-destroy/ on the analyst host. The redaction spec
is at /tmp/sanitize/redacts.json; the audit decision log is at
/tmp/sanitize/audit-decision.md.

2026-06-05 13:51:51 -04:00

2.2 KiB

Raw Permalink Blame History

Frida Server Versions

frida (the Python client) and frida-server (the on-device binary) must be the same version for a session to attach. A version mismatch produces an opaque protocol error from the daemon and is the #1 source of "Frida not working" reports.

v0.1.0 pinning

Component	Version
`frida`	17.10.1
`frida-tools`	13.0+ (matches 17.10.x)
`frida-server`	17.10.1

bin/pull-tools.sh downloads frida-server-17.10.1-<arch>.xz for all four architectures (arm, arm64, x86, x86_64) and unpacks them into vendor/frida-server/17.10.1/.

bin/doctor.sh checks the version of frida-server running on every connected device and warns on a mismatch with the Python client.

Upgrading Frida

When a new Frida release comes out:

Update the pin in android_re_core/pyproject.toml:
```
"frida==17.10.1",
"frida-tools>=13.0",
```
Update bin/pull-tools.sh to fetch the new server binary.
Update docs/frida-server-versions.md (this file) with the new pin.
Run the device integration test matrix (Phase 3+).
Tag a release. Do not ship a release with a pinned client and an unpinned server.

What if the pinned version is no longer available?

Frida publishes all releases to https://github.com/frida/frida/releases. We pin to a specific tag and download from the matching asset URL. If the asset has been removed (rare; only happens for yanked security releases), the user must either:

Stay on the previous pinned version (recommended for reproducibility).
Or manually set FRIDA_VERSION in their environment to a different pinned version that they have vendored themselves.

We do not fall back to "latest" because that would break reproducibility.

Frida licensing note

frida-server is licensed under the wxWindows Library Licence, Version 3.1 with a personal-use restriction. The on-device binary may not be redistributed for commercial use without a commercial agreement with the Frida maintainers. The Python client libraries (frida, frida-tools) are full wxWindows and may be used in commercial products. See LICENSE-3rdparty.md for the full terms and contact information.

2.2 KiB Raw Permalink Blame History