Frida Workbench para VSCode

Repositorio | Problemas | Instalar

Este es un proyecto contribuido por la comunidad, no está afiliado con el equipo oficial de Frida. Es desarrollado y mantenido por @CodeColorist como una extensión de código abierto para Visual Studio Code para mejorar la experiencia de scripting con Frida.

中文说明

Requisitos previos

• Python >= 3.7
• Paquete de Python frida-tools

Dependencias opcionales

• libimobiledevice (para el comando inetcat para iniciar una shell SSH)
• iTunes en Windows (para conexión USB de iOS)

Si estás en Windows, necesitas mantener iTunes abierto para interactuar con dispositivos iOS vía USB.

Instalar frida-tools

Debido a PEP0668, podrías encontrar un error al ejecutar pip3 install frida-tools de forma global.

La forma recomendada es abrir una carpeta (espacio de trabajo) en VSCode, luego crear y activar un entorno virtual usando la extensión de Python. En este caso, la extensión usará tu venv de Python activo actual para cargar los comandos de frida.

Alternativamente, puedes usar un gestor de paquetes como pipx o UV para instalarlo en $PATH, manteniéndolo aislado.

Características

Lista de aplicaciones y procesos

Lista aplicaciones y procesos en dispositivos conectados en un panel lateral. Haz clic derecho para adjuntar, adjuntar con privilegios elevados para objetivos locales, lanzar, lanzar en modo suspendido, matar procesos, o copiar información del dispositivo/proceso al portapapeles. Soporta dispositivos locales, Apple Simulator, USB y remotos. Las entradas de procesos locales incluyen metadatos de mejor esfuerzo como ruta del ejecutable, propietario, PID padre y argumentos cuando están disponibles.

Paneles de tiempo de ejecución interactivos

Navegador de módulos y exportaciones

Explora módulos nativos cargados y sus funciones exportadas para cualquier proceso adjunto. Filtra módulos por nombre, inspecciona dirección base, tamaño y ruta, luego selecciona exportaciones para generación de hooks.

Navegador de clases y métodos

Explora clases y métodos en tiempo de ejecución tanto para Java como para Objective-C. Filtra clases, alterna entre métodos propios y heredados, y selecciona métodos en lote para generación de hooks. También incluye inspección de protocolos Objective-C para explorar y analizar protocolos.

Generar encabezado

Volcar encabezados de clases para ingeniería inversa:

• Objective-C — genera archivos de encabezado desde metadatos de clases en tiempo de ejecución
• Java — genera stubs de clases descompiladas con declaraciones de paquete e importación

Generación de hooks

Genera código de hooks de Frida desde los paneles de Módulos y Clases:

• Hooks nativos — Interceptor.attach() con callbacks onEnter / onLeave para funciones exportadas
• Hooks de Objective-C — hooks basados en clase y selector con uso adecuado del puente ObjC
• Hooks de Java — hooks Java.perform() / Java.use() con soporte de sobrecarga de métodos
• Hooks potenciados por IA — usa GitHub Copilot para inferir firmas de funciones nativas (tipos de parámetros, tipos de retorno) y generar registro de argumentos con reconocimiento de tipos

Autocompletado inteligente (LSP)

Completados conscientes del contexto para scripts de Frida en JavaScript / TypeScript:

• ObjC.classes.<ClassName> — completa nombres de clases Objective-C
• ObjC.classes.Foo['<method>'] — completa selectores de métodos
• ObjC.classes.Foo.method — completa selectores de métodos de clase
• Java.use('<ClassName>') — completa nombres de clases Java
• Process.getModuleByName('<name>') — completa nombres de módulos cargados

El servidor de lenguaje depende de un contexto de proceso objetivo. Necesitas crear un archivo de configuración .vscode/frida.json en tu espacio de trabajo. La forma más fácil es hacer clic derecho en un proceso o aplicación en la barra lateral y seleccionar Set LSP Target, lo que genera el archivo automáticamente.

Configuración de .vscode/frida.json

El archivo especifica a qué dispositivo y objetivo debe adjuntarse el LSP. Requiere un campo device y exactamente uno de app, pid o process.

Adjuntar por identificador de aplicación (recomendado — lanza o se adjunta a la aplicación):

{
    "device": "local",
    "app": "com.example.myapp"
}

Adjuntar por nombre de proceso:

{
    "device": "local",
    "process": "myprocess"
}

Adjuntar por PID (útil cuando múltiples procesos comparten el mismo nombre):

{
    "device": "local",
    "pid": 1234
}

El valor de device corresponde al ID de dispositivo de Frida — local para la máquina anfitriona, un ID de Simulator o dispositivo USB, o una cadena host:port para dispositivos remotos.

El LSP observa este archivo en busca de cambios. Editarlo o recrearlo reinicia automáticamente el servidor de lenguaje con el nuevo objetivo.

Syslog

Transmite registros de aplicaciones en tiempo real desde procesos adjuntos.

Andamiaje de proyectos

• Nuevo Agente — crea un nuevo proyecto de Frida Agent con soporte de TypeScript
• Nuevo Módulo C — crea un nuevo proyecto de Frida C Module
• Descargar Tipados — descarga definiciones de tipos de TypeScript de Frida para autocompletado

Configuración de depuración

Genera launch.json y tasks.json de VSCode para depurar scripts de Frida con puntos de interrupción.

Herramientas de Android

• Descargar e iniciar frida-server en dispositivo Android (detección automática de arquitectura)
• Extraer APK del dispositivo (clic derecho en aplicación Android para extraer)

Integración con herramientas externas

• Objection — Exploración Móvil en Tiempo de Ejecución

Shell

Para dispositivos Android, Open Shell es un envoltorio para adb shell.

Para iOS proporciona una shell SSH en dispositivos con jailbreak. Puede necesitar configurar credenciales.

Soporte de dispositivos remotos

Conéctate a dispositivos Frida remotos vía host:port directamente desde la barra lateral.

CHANGELOG

Colaboradores