Frida Workbench para VSCode

Repositório | Issues | Instalar

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

中文说明

Pré-requisitos

• Python >= 3.7
• Pacote Python frida-tools

Dependências opcionais

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

Se você estiver no Windows, precisa manter o iTunes aberto para interagir com dispositivos iOS via USB.

Instalar frida-tools

Devido ao 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 no momento 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

Liste apps 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, iniciar (spawn), iniciar em modo suspenso, encerrar processos ou copiar informações do dispositivo/processo para a área de transferência. Suporta dispositivos locais, Apple Simulator, 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 de Runtime Interativos

Navegador de Módulos e Exportações

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 exportações para geração de hooks.

Navegador de Classes e Métodos

Explore classes e métodos em tempo de execução 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 Header

Exporte headers de classes para engenharia reversa:

• Objective-C — gere arquivos de header a partir dos metadados de classes em tempo de execução
• Java — gere stubs de classes descompiladas com declarações de pacote e importação

Geração de Hooks

Gere código de hook 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 logging de argumentos com reconhecimento de tipos

Autocomplete Inteligente (LSP)

Completions sensíveis 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étodos
• 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 language server 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 Set LSP Target, 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 entre app, pid ou process.

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

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

Anexar por nome do 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, um ID de Simulator ou dispositivo 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 language server com o novo alvo.

Syslog

Transmita logs de aplicação em tempo real dos processos anexados.

Estruturação de Projetos

• New Agent — crie um novo projeto Frida Agent com suporte a TypeScript
• New C Module — crie um novo projeto Frida C Module
• Download Typings — baixe as definições de tipos 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)
• Extrair APK do dispositivo (clique com o botão direito em um app Android para extrair)

Integração com Ferramentas Externas

• Objection — Exploração Mobile em Tempo de Execução

Shell

Para dispositivos Android, Open 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 pela barra lateral.

CHANGELOG

Contribuidores