AÇÃO NECESSÁRIA (Execute imediatamente após a leitura)

Comparativo da comunidade para extração de endpoints/Frida adaptativa, etc.: ../references/community-security-skills.md; Análise dinâmica requer autorização de escopo para o dispositivo.

1. NOW: Ler ../field-journal/precedent-reverse.md — Confirme se a operação desta skill é uma operação regular autorizada
2. NOW: Confirme se a tarefa atual se enquadra no escopo desta skill
3. NEXT: Ler ../tool-index.md, verificar a disponibilidade e o caminho real da ferramenta
4. NEXT: Ao faltar ferramentas, chame o bootstrap, não adivinhe o caminho
5. ACT: Entre na primeira etapa do "fluxo de trabalho" e execute, não pare no estado de confirmação

Especificação de Tarefas CLI de Engenharia Reversa de APK

Escopo

Esta skill deve ser usada prioritariamente quando a tarefa se enquadra nos seguintes cenários:

• Analisar a lógica de negócios Java de APKs
• Localizar login, assinatura, controle de risco, verificação de certificado, detecção de root
• Visualizar e modificar AndroidManifest.xml
• Visualizar e modificar smali
• Reempacotar APKs
• Realizar Hook dinâmico Java/nativo com Frida
• Mudar para análise nativa quando o APK contiver .so

Ferramentas CLI Disponíveis e Verificadas na Máquina Atual

• jadx 1.5.5
• apktool 3.0.2
• frida-ps 17.9.6
• adb
• java

Cenários para Uso Prioritário de Scripts

Os seguintes fluxos são de alta frequência e os parâmetros são propensos a erros, portanto, use os scripts integrados da skill prioritariamente:

• Concluir o despejo de jadx + apktool em disco e gerar um resumo em uma única etapa: scripts/decode.ps1
• Verificação de dispositivo Frida, listagem de processos, injeção spawn/attach: scripts/frida-run.ps1
• Reconstruir, alinhar, assinar e instalar APKs: scripts/rebuild-sign-install.ps1
• Extrair rapidamente componentes e permissões chave do Manifest: scripts/manifest-summary.ps1

Os seguintes comandos de linha única devem ser chamados diretamente, sem encapsulamento separado:

• adb devices
• adb logcat
• frida-ps -U
• jadx --version
• apktool --version

Scripts Integrados

scripts/decode.ps1

Uso:

• Executar uniformemente jadx e apktool
• Cria um diretório de saída da tarefa no mesmo diretório do APK original por padrão
• Gera resumos como package, java_files, smali_dirs, so_files
• Compatível com casos em que a descompilação de jadx falha parcialmente, mas ainda produz artefatos utilizáveis

Exemplo:

pwsh -File "<skill-root>\apk-reverse\scripts\decode.ps1" -ApkPath "D:\DOWNLOAD\app.apk" -Clean
pwsh -File "<skill-root>\apk-reverse\scripts\decode.ps1" -ApkPath "D:\DOWNLOAD\app.apk" -Name demo -SkipJadx

scripts/frida-run.ps1

Uso:

• Entrada unificada para dispositivos, processos, spawn/attach do Frida
• Evita confusão de -f, -n, -U ao digitar parâmetros manualmente

Exemplo:

pwsh -File "<skill-root>\apk-reverse\scripts\frida-run.ps1" -ListDevices
pwsh -File "<skill-root>\apk-reverse\scripts\frida-run.ps1" -Usb -ListProcesses
pwsh -File "<skill-root>\apk-reverse\scripts\frida-run.ps1" -Usb -Spawn -Package com.example.app -ScriptPath "D:\hooks\test.js"

scripts/rebuild-sign-install.ps1

Uso:

• Reconstruir APK com apktool b
• Alinhar com zipalign
• Assinar e verificar assinatura com apksigner
• Opcionalmente, instalar diretamente com adb install

Exemplo:

pwsh -File "<skill-root>\apk-reverse\scripts\rebuild-sign-install.ps1" -ProjectDir "C:\work\apktool_out" -Clean
pwsh -File "<skill-root>\apk-reverse\scripts\rebuild-sign-install.ps1" -ProjectDir "C:\work\apktool_out" -Install -Reinstall -DeviceSerial "127.0.0.1:7555"

Observações:

• Gera e reutiliza o keystore de depuração por padrão
• A saída é direcionada para o mesmo diretório de ProjectDir por padrão, facilitando a organização junto com o pacote original e o diretório de descompactação

scripts/manifest-summary.ps1

Uso:

• Extrair o nome do pacote
• Listar permissões
• Listar activity/service/receiver/provider
• Marcar a activity principal de inicialização

Exemplo:

pwsh -File "<skill-root>\apk-reverse\scripts\manifest-summary.ps1" -ManifestPath "C:\work\apktool_out\AndroidManifest.xml"

Se você precisar analisar .so, lib/arm64-v8a/*.so, lib/armeabi-v7a/*.so, combine com:

• ida-reverse
• radare2

Divisão de Tarefas das Ferramentas

jadx

Usado para:

• Leitura da descompilação Java
• Pesquisa de nome de pacote, nome de classe, nome de método
• Compreender o APK a partir da lógica de alto nível primeiro

Comandos comuns:

jadx -d jadx_out app.apk
jadx --single-class com.example.LoginActivity -d jadx_out app.apk
jadx --deobf -d jadx_out app.apk

JEB Pro (Ferramenta comercial opcional)

Usado para:

• Verificação cruzada e descompilação profunda de Android DEX / APK / ARM
• Complementar a análise estática quando a saída do JADX é incompleta ou a ofuscação é pesada
• Verificação da segunda cadeia de ferramentas para classes, métodos e relações de chamada do mesmo alvo

Limitações:

• JEB Pro é um software comercial, e os usuários devem obtê-lo e instalar uma licença válida por conta própria; este pacote não fará download, crack ou contornará licenças.
• Chamado apenas quando tool-index confirmou que o JEB está disponível na máquina local; caso contrário, continue usando jadx, apktool, Ghidra, IDA ou radare2.
• A ponte JEB MCP de terceiros não é uma dependência deste pacote. Antes de instalar, revise o código-fonte, permissões, comportamento de rede e versão de acordo com ../ops/skill-supply-chain.md, e confirme explicitamente o registro pelo usuário.

apktool

Usado para:

• Descompactar APKs
• Visualizar e modificar AndroidManifest.xml
• Visualizar e modificar smali
• Reconstruir APKs

Comandos comuns:

apktool d app.apk -o apktool_out
apktool b apktool_out -o rebuilt.apk

frida

Usado para:

• Observar chamadas de métodos Java dinamicamente
• Hook de funções exportadas nativas
• Contornar detecção de root, verificação de certificado, detecção de depuração

Comandos comuns:

frida-ps -U
frida -U -f com.example.app -l hook.js
frida-trace -U -f com.example.app -j '*!*certificate*'

adb

Usado para:

• Conexão de dispositivo
• Instalação de APKs
• Visualização de logs
• Puxar arquivos

Comandos comuns:

adb devices
adb install -r app.apk
adb shell pm list packages
adb logcat
adb pull /data/local/tmp/file .

Fluxo de Trabalho Recomendado

1. Triagem

Primeiro, determine a estrutura geral do APK, sem se apressar em modificar o pacote ou fazer Hook.

Ações recomendadas:

1. Use jadx -d jadx_out app.apk para exportar o código Java
2. Use apktool d app.apk -o apktool_out para exportar smali e recursos
3. Veja primeiro:
   • AndroidManifest.xml
   • A principal package
   • application, activity, service, receiver
   • Se há .so no diretório lib/
4. Issue #65 Verificação rápida de formas de ameaça (amostra/dispositivo autorizado; veja ../reverse-engineering/references/nonpe-format-cookbook.md §7–8):
   • Ícone transparente/oculto (AU): aapt dump badging + tema/rótulo/ícone do manifest → E-android-hidden-icon-manifest
   • Características de bloqueio de Magisk/scripts e curl|sh remoto (AR/AS) → Características e URL como evidência, não execute comandos destrutivos
   • Caminhos de persistência (AT): service.d / priv-app, etc. → E-android-persistence

2. Observação da Lógica Java

Priorize a leitura de jadx_out:

• MainActivity
• Application
• Classes relacionadas a login, rede, criptografia, controle de risco
• Classes de inicialização de SDK de terceiros

…