friman

Hast du jemals das Gefühl, dass die Suche nach der richtigen Frida-Version für die Aufgabe wie ein Nadelöhr ist? Da verschiedene Projekte, Geräte und Debugging-Szenarien alle spezifische Builds erfordern, kann die Übersicht über Frida-Versionen schnell zu einem mühsamen Balanceakt werden. friman (ausgesprochen „free man") wurde entwickelt, um genau dieses Problem zu lösen.

Warum

Es ist üblich, zwischen Frida-Versionen zu wechseln, da verschiedene Umgebungen mit der neuesten Version nicht immer gleich funktionieren. Je nach Ziel kann eine bestimmte Version die einzige sein, die zuverlässig funktioniert. Häufige Gründe sind:

• Geräte-/OS-Eigenheiten: Ältere oder ungewöhnliche Android-/iOS-Builds funktionieren möglicherweise nur mit bestimmten Frida-Versionen.
• Projektkompatibilität: Manche Skripte, Tools oder Workflows sind auf das Verhalten einer bestimmten Version angewiesen (z. B. haben sich viele APIs zwischen v16 und v17 geändert).
• Stabilität vs. Funktionen: Neuere Versionen beheben manche Probleme, können aber andere einführen, daher ist die „richtige“ Version nicht immer die neueste.

Übersicht

Frida entwickelt sich schnell weiter, und verschiedene Projekte oder Geräte erfordern oft unterschiedliche Versionen. Das manuelle Wechseln kann fehleranfällig sein, besonders wenn man mehrere Umgebungen, Server-Binärdateien und Gadgets verwaltet.

friman bietet:

• Versionen installieren und nahtlos wechseln
• Lokale Versionsverfolgung
• Eine saubere, isolierte Verzeichnisstruktur ($HOME/.friman)
• Hilfsfunktionen zum Herunterladen von Release-Assets (derzeit frida-gadget und frida-server Assets)
• Praktische Dienstprogramme für Aktionen wie das Übertragen von Frida-Server-Binärdateien auf Android-Geräte

Ziel ist es, die Frida-Versionsverwaltung so reibungslos wie möglich zu gestalten.

Installation

Die empfohlene Installationsmethode ist direkt von GitHub:

# With pipx (recommended)
pipx install git+https://github.com/thelicato/friman

# Or with pip
pip install git+https://github.com/thelicato/friman

Nach der Installation führe Folgendes aus:

friman ensurepath # Setup PATH for the currently selected Frida environment
friman update # Update the local list of available Frida versions and compatibility matrix

Verwendung

friman bietet eine Befehlszeilenschnittstelle zum Installieren, Wechseln und Verwalten mehrerer Frida-Versionen. Nachfolgend die Haupthilfeausgabe:

Usage: friman [OPTIONS] COMMAND [ARGS]...

Options:
  -v, --version  Show the application's version and exit.
  -d, --debug    Show debug output.
  -h, --help     Show this message and exit.

Commands:
  update       Update the local list of available Frida versions.
  install      Install a <version> of Frida.
  uninstall    Uninstall a <version> of Frida.
  use          Use <version>.
  disable      Disable friman.
  current      Display the currently activated version of Frida.
  list         List all the installed versions.
  ensurepath   Ensure friman directories are correctly set.
  download     Download a specific release file (only server and gadget)...
  push-server  Pushes a the Frida server into the selected ANDROID device.

Spezifische Hilfebefehle sind in den folgenden Abschnitten verfügbar.

Usage: friman update [OPTIONS]

  Update the local list of available Frida versions.

Options:
  -h, --help  Show this message and exit.

Usage: friman install [OPTIONS] version

  Installiert eine <version> von Frida.

Arguments:
  version  Die zu installierende Frida-Version  [required]

Options:
  -f, --force  Force install.
  --list       Show all the installable versions and exit.
  -h, --help   Show this message and exit.

Usage: friman uninstall [OPTIONS] version

  Deinstalliert eine <version> von Frida.

Arguments:
  version  Die zu deinstallierende Frida-Version  [required]

Options:
  -h, --help  Show this message and exit.

Usage: friman use [OPTIONS] version

  Verwendet <version>.

Arguments:
  version  Die zu verwendende Frida-Version  [required]

Options:
  -h, --help  Show this message and exit.

Usage: friman disable [OPTIONS]

  Deaktiviert friman.

Options:
  -h, --help  Show this message and exit.

Usage: friman current [OPTIONS]

  Zeigt die aktuell aktivierte Frida-Version an.

Options:
  -h, --help  Show this message and exit.

Usage: friman list [OPTIONS]

  Listet alle installierten Versionen auf.

Options:
  -h, --help  Show this message and exit.

Usage: friman ensurepath [OPTIONS]

  Stellt sicher, dass die friman-Verzeichnisse korrekt gesetzt sind.

Options:
  -h, --help  Show this message and exit.

Usage: friman download [OPTIONS] type platform

  Lädt eine bestimmte Release-Datei (nur Server und Gadget) für die aktuelle Version herunter.

Arguments:
  type      Der ausgewählte Asset-Typ  [required]
  platform  Die zu verwendende Plattform  [required]

Options:
  -o, --output TEXT  Wähle den Ordner zum Herunterladen der Datei.
  -h, --help         Show this message and exit.

Usage: friman push-server [OPTIONS] device_id platform

  Überträgt den Frida-Server auf das ausgewählte ANDROID-Gerät.

Arguments:
  device_id  Das ausgewählte ANDROID-Gerät  [required]
  platform   Die Plattform des Geräts  [required]

Options:
  --list      Alle USB-Geräte anzeigen und beenden.
  -h, --help  Show this message and exit.

Mitwirken

Pull-Requests sind willkommen! Bitte eröffne zuerst ein Issue, um größere Änderungen zu besprechen.

Lizenz

friman wird unter der MIT-LIZENZ veröffentlicht.