APKLab

A experiência definitiva de RE do Android diretamente no seu VS Code.

APKLab integra perfeitamente as melhores ferramentas de código aberto: Apktool, smali-lsp, Jadx, uber-apk-signer, apk-mitm e muito mais ao excelente VS Code para que você possa focar na análise do aplicativo e realizá-la sem sair da IDE.

Recursos

• Decodificar/Editar/Reconstruir arquivos de recursos do aplicativo
• Desmontar/Modificar/Reconstruir um APK para/de Smali
• Descompilar o APK para código-fonte Java
• Excelente suporte para a linguagem Smali com smali-lsp — ir para definição, encontrar referências, passar o mouse, hierarquia de chamada/tipo, lente de código, conclusão, diagnósticos
• Analisar e modificar efetivamente no VS Code com todos os recursos da IDE
• Assinar e Instalar o APK após a reconstrução
• Gerar hooks do Frida para quaisquer métodos smali
• Injetar gadget do Frida no APK com correção automática da atividade principal
• Inicializar repositório git no diretório do projeto para rastrear alterações
• Aplicar patch MITM para inspeção HTTPS
• Relatório Interativo de Análise de Malware
• Suporte para projetos no estilo Apktool (apktool.yml)
• Suporte para argumentos de linha de comando do Apktool 3.0+
• Gerenciamento de frameworks de recursos do Android
• Suporte para keystore fornecido pelo usuário para assinatura de APK
• Verificar atualizações e instalar ferramentas necessárias automaticamente
• Suporta Linux, Mac e WSL2

Requisitos

• JDK 17+

  Execute java -version no seu Shell, se não encontrar, baixe aqui.

• quark-engine >=21.01.6 (opcional - para análise de malware)

  Execute quark no seu Shell, se não encontrar, consulte a documentação oficial.

• adb (opcional)

  Execute adb devices no seu Shell, se não encontrar, consulte este guia.

Primeiros Passos

Abrir APK ou projeto Apktool

• Abra a Paleta de Comandos (Ctrl+Shift+P) ➜ APKLab: Abrir um APK

  

• Ou simplesmente abra uma pasta de projeto Apktool existente

Aplicar patch MITM

• Clique com o botão direito sobre ou dentro do arquivo apktool.yml ➜ APKLab: Preparar para inspeção HTTPS

  

Reconstruir e Assinar APK

• Clique com o botão direito sobre ou dentro do arquivo apktool.yml ➜ APKLab: Reconstruir o APK

  

Instalar APK no dispositivo

• Clique com o botão direito no arquivo .apk (no diretório dist) ➜ APKLab: Instalar o APK

  

Gerar Hook do Frida

• Clique com o botão direito dentro de um .method em um arquivo .smali ➜ APKLab: Gerar Hook do Frida
• O hook é anexado ao frida_hooks.ts na raiz do projeto

Injetar Gadget do Frida

• Clique com o botão direito sobre ou dentro do arquivo apktool.yml ➜ APKLab: Injetar Gadget do Frida
• Selecione o arquivo .so do gadget, a arquitetura alvo, e a atividade principal é corrigida automaticamente

Limpar diretório de frameworks do ApkTool

• Abra a Paleta de Comandos (Ctrl+Shift+P) ➜ APKLab: Esvaziar Diretório de Framework do ApkTool

Configurações da Extensão

Caminhos das Dependências

• apklab.apktoolPath: Caminho completo do apktool.jar. Se quiser usar uma versão diferente, altere para:

  "apklab.apktoolPath": "/home/oozer/downloads/apktool_2.4.1.jar"

• apklab.apkSignerPath: Caminho completo do uber-apk-signer.jar. Se quiser usar uma versão diferente, altere para:

  "apklab.apkSignerPath": "/home/oozer/downloads/uber-apk-signer-1.1.0.jar"

• apklab.jadxDirPath: Caminho completo do diretório jadx-x.y.z. Se quiser usar uma versão diferente, altere para:

  "apklab.jadxDirPath": "/home/oozer/downloads/jadx-1.1.0"

• apklab.smaliLspPath: Caminho completo do smali-lsp.jar. Se quiser usar uma versão diferente, altere para:

  "apklab.smaliLspPath": "/home/oozer/downloads/smali-lsp.jar"

• apklab.javaPath: Caminho para o executável Java (padrão: java). Altere se o Java não estiver no seu PATH:

  "apklab.javaPath": "/usr/lib/jvm/java-17/bin/java"

Configuração do Keystore

• apklab.keystorePath: Coloque o caminho absoluto do seu arquivo keystore Java (.jks ou .keystore) aqui.

  "apklab.keystorePath": "/home/oozer/downloads/debug.keystore"

• apklab.keystorePassword: Coloque a senha do seu keystore aqui.

• apklab.keyAlias: Coloque o alias da chave usada no keystore aqui.

• apklab.keyPassword: Coloque a senha da chave usada no keystore aqui.

Configuração Adicional

• apklab.initProjectDirAsGit: Inicializar o diretório de saída do projeto como repositório Git.
• apklab.updateTools: Se o APKLab deve verificar atualizações das ferramentas (para apklab, jadx...) e exibir uma notificação.
• smaliLsp.trace.server: Rastreia a comunicação entre o VS Code e o Servidor de Linguagem Smali (off, messages, verbose).

Problemas Conhecidos

Consulte nosso Rastreador de Bugs para problemas conhecidos.

Guia de Contribuição