Skip to content
Edição em Português

Enciclopédia e Guia de Porting para PS Vita (SoLoader)

Manual completo de engenharia passo a passo e base de referência técnica para transformar um binário compilado de Android (.apk / .so) em um aplicativo nativo executável (.vpk) no PlayStation Vita.

🧭 Mapa de Navegação do Manual

flowchart TD
    A["00. Fundamentos e Arquitetura"] --> B["01. Ambiente e Ferramentas"]
    B --> C["02. Triagem e Seleção de APK"]
    C --> D["03. Análise Estática & Engenharia Reversa"]
    D --> E["04. Arquitetura SoLoader & Realocações"]
    E --> F["05. FalsoJNI & Ponte Java"]
    F --> G["06. Pipeline Gráfico vitaGL"]
    F --> H["07. Subsistema de Áudio"]
    F --> I["08. Controles e Entrada"]
    F --> J["09. Sistema de Arquivos & Assets"]
    G & H & I & J --> K["10. LiveArea e Empacotamento VPK"]
    K --> L["11. Triagem de Crashes & Depuração em Hardware"]
    L --> M["12. Arqueologia de Motores Reais"]
    M --> N["13. Guia de Porting com IA"]

📚 Índice de Capítulos

# Capítulo Foco e Conteúdo Técnico
00 Fundamentos e Arquitetura CPU ARMv7 Cortex-A9, GPU PowerVR SGX543MP4+, partições CDRAM e RAM, SoLoader vs Emulação vs Recompilação Estática.
01 Ambiente e Ferramentas Configuração do VitaSDK, vitaGL, kubridge, fd_fix, FalsoJNI, psvita-toolkit, Docker com Ghidra headless, jadx.
02 Triagem e Seleção de APK Análise preliminar de viabilidade: ARMv7 vs 64-bit, GLES1 vs GLES2, dependências de STL, matriz de decisão.
03 Análise Estática & Engenharia Reversa Descompilação de Java (jadx), geração de pseudo-C (Ghidra), extração de tabelas de símbolos com objdump e nm.
04 Arquitetura SoLoader & Realocações Formato ELF em memória, tabelas de realocação ARM (R_ARM_RELATIVE, R_ARM_GLOB_DAT), patches binários e hooking.
05 FalsoJNI & Ponte Java Emulação de JVM/JNIEnv, assinaturas de tipo Android, callbacks Java, projeto de stubs ativos e seguros.
06 Pipeline Gráfico vitaGL vitaGL sobre SCE GXM, tradução de shaders GLSL para Cg/GXP, FBOs, resolução 960x544, alpha pré-multiplicado e VRAM.
07 Subsistema de Áudio sceAudioOut, OpenAL-Soft para Vita, decodificação Vorbis/MP3, emulação de AudioTrack, SoundPool e MediaPlayer.
08 Controles e Entrada Tela de toque frontal e traseira, botões físicos e analógicos, prevenção de corrupção de heap por report IDs, toque sintético.
09 Sistema de Arquivos & Assets Redirecionamento de caminhos para ux0:data/, insensibilidade a maiúsculas/minúsculas no FAT, leitura de ZIP/OBB na RAM.
10 LiveArea e Empacotamento VPK Regras estritas de PNG indexado a 8 bits (evitar 0x8010113D), param.sfo, template.xml, limpeza de arquivos ._ do macOS.
11 Triagem de Crashes & Depuração Metodologia de triangulação: análise de .psp2dmp, vita-parse-core, PC vs LR, armadilhas de alinhamento ARMv7 (ldrd).
12 Arqueologia de Motores Reais Dissecação de motores reais de mais de 30 ports: Gameloft, Gamevil Nexus2/Clet, Com2uS, Cocos2d-x.
13 Guia de Porting com IA Protocolos de colaboração Humano + IA, economia de contexto e tokens, prompts determinísticos para stubs e engenharia reversa.
14 Guia Base de gl33ntwine O artigo clássico de Vitaliy Atamanenko traduzido para português com notas e contexto técnico moderno.
15 Referência Rápida & Cheat Sheets Assinaturas de tipos JNI, códigos de erro do kernel VitaOS e tabela de correspondência Bionic libc para Newlib.

[!TIP] Para novos desenvolvedores: Comece pelos capítulos 00, 01 e 02 antes de baixar qualquer APK. Para desenvolvedores avançados / Agentes de IA: Os capítulos 04 (Realocações ELF), 05 (FalsoJNI), 06 (vitaGL) e 11 (Triagem de Crashes) contêm a lógica de baixo nível necessária para resolver travamentos complexos no hardware físico.