Frida Workbench para VSCode

Repositório | Issues | Instalar

Este é um projeto contribuído pela comunidade, não afiliado à equipe oficial do Frida. Ele é desenvolvido e mantido por @CodeColorist como uma extensão de código aberto para o Visual Studio Code para melhorar a experiência de criação de scripts com Frida.

中文说明

Pré-requisitos

• Python >= 3.7
• frida-tools pacote python

Dependências opcionais

• libimobiledevice (para o comando inetcat iniciar um shell SSH)
• iTunes no Windows (para conexão USB iOS)

Se você estiver no Windows, é necessário manter o iTunes aberto para interagir com dispositivos iOS via USB.

Instalar frida-tools

Por causa do PEP0668, você pode encontrar um erro ao executar pip3 install frida-tools globalmente.

A maneira recomendada é abrir uma pasta (workspace) no VSCode e, em seguida, criar e ativar um ambiente virtual usando a extensão Python. Nesse caso, a extensão usará seu venv Python ativo atual para carregar os comandos do frida.

Alternativamente, você pode usar um gerenciador de pacotes como pipx ou UV para instalá-lo no $PATH, mantendo-o isolado.

Recursos

Lista de Apps e Processos

Lista aplicativos e processos em dispositivos conectados em um painel lateral. Clique com o botão direito para anexar, anexar com privilégios elevados para alvos locais, spawn, spawn em modo suspenso, encerrar processos ou copiar informações do dispositivo/processo para a área de transferência. Suporta dispositivos locais, USB e remotos. As entradas de processos locais incluem metadados de melhor esforço, como caminho do executável, proprietário, PID pai e argumentos quando disponíveis.

Painéis Interativos de Runtime

Navegador de Módulos e Exports

Navegue pelos módulos nativos carregados e suas funções exportadas para qualquer processo anexado. Filtre módulos por nome, inspecione endereço base, tamanho e caminho e selecione exports para geração de hooks.

Navegador de Classes e Métodos

Explore classes e métodos de runtime tanto para Java quanto para Objective-C. Filtre classes, alterne entre métodos próprios e herdados e selecione métodos em lote para geração de hooks. Também inclui inspeção de protocolos Objective-C para navegar e analisar protocolos.

Gerar Cabeçalho

Extraia cabeçalhos de classe para engenharia reversa:

• Objective-C — gerar arquivos de cabeçalho a partir dos metadados de classe em runtime
• Java — gerar stubs de classe descompilados com declarações de pacote e import

Geração de Hooks

Gere código de hook do Frida a partir dos painéis de Módulos e Classes:

• Hooks nativos — Interceptor.attach() com callbacks onEnter / onLeave para funções exportadas
• Hooks Objective-C — hooks baseados em classe e seletor com uso adequado da ponte ObjC
• Hooks Java — hooks Java.perform() / Java.use() com suporte a sobrecarga de métodos
• Hooks com IA — use o GitHub Copilot para inferir assinaturas de funções nativas (tipos de parâmetros, tipos de retorno) e gerar log de argumentos ciente de tipos

Autocomplete Inteligente (LSP)

Autocompletar sensível ao contexto para scripts Frida em JavaScript / TypeScript:

• ObjC.classes.<ClassName> — completa nomes de classes Objective-C
• ObjC.classes.Foo['<method>'] — completa seletores de método
• ObjC.classes.Foo.method — completa seletores de métodos de classe
• Java.use('<ClassName>') — completa nomes de classes Java
• Process.getModuleByName('<name>') — completa nomes de módulos carregados

O servidor de linguagem depende do contexto de um processo alvo. Você precisa criar um arquivo de configuração .vscode/frida.json no seu workspace. A maneira mais fácil é clicar com o botão direito em um processo ou app na barra lateral e selecionar Definir Alvo do LSP, que gera o arquivo automaticamente.

Configuração do .vscode/frida.json

O arquivo especifica a qual dispositivo e alvo o LSP deve se anexar. Ele requer um campo device e exatamente um de app, pid ou process.

Anexar por identificador de app (recomendado — inicia (spawn) ou anexa ao app):

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

Anexar por nome de processo:

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

Anexar por PID (útil quando vários processos compartilham o mesmo nome):

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

O valor de device corresponde ao ID do dispositivo Frida — local para a máquina host, usb para um dispositivo conectado via USB ou uma string host:port para dispositivos remotos.

O LSP monitora este arquivo em busca de alterações. Editá-lo ou recriá-lo reinicia automaticamente o servidor de linguagem com o novo alvo.

Syslog

Transmita logs de aplicativos em tempo real de processos anexados.

Scaffolding de Projetos

• Novo Agent — criar um novo projeto de Frida Agent com suporte a TypeScript
• Novo Módulo C — criar um novo projeto de Módulo C do Frida
• Baixar Typings — baixar as definições de tipo TypeScript do Frida para autocomplete

Configuração de Debug

Gere launch.json e tasks.json do VSCode para depurar scripts Frida com breakpoints.

Ferramentas Android

• Baixar e iniciar o frida-server no dispositivo Android (detecção automática de arquitetura)
• Puxar APK do dispositivo (clique com o botão direito no app Android para puxar)

Integração com Ferramentas Externas

• Objection — Exploração Mobile em Runtime

Shell

Para dispositivos Android, Abrir Shell é um wrapper para adb shell.

Para iOS, fornece um shell SSH em dispositivos com jailbreak. Pode ser necessário configurar credenciais.

Suporte a Dispositivos Remotos

Conecte-se a dispositivos Frida remotos via host:port diretamente da barra lateral.

CHANGELOG

Contribuidores