Skip to content
Capítulo 02 • Viabilidade & Triagem

Triagem e Análise de Viabilidade de APK

Diagnóstico sistemático de compatibilidade de arquitetura ABI (ARMv7 vs 64-bit), pipeline gráfico (GLES 1.1 vs 2.0 vs Vulkan), limites de memória e proporção de código nativo.

⚡ Nível: Intermediário 🔍 Foco: Triagem ABI, Detecção GLES, Orçamento de RAM 🎮 Casos: Hero of Sparta, Zenonia 3, Badland 2

Antes de escrever qualquer código ou configurar um projeto CMake, é essencial realizar uma análise de viabilidade do APK. Nem todos os jogos Android podem ser portados via SoLoader; avaliar o binário nos primeiros minutos evita semanas de trabalho infrutífero.


📦 Anatomia de um APK Android

Um arquivo .apk é internamente um arquivo compactado padrão ZIP. Você pode extraí-lo com qualquer ferramenta:

jogo.apk (ZIP)
├── AndroidManifest.xml        # Manifesto binário (pacote Java, versão GLES, permissões)
├── classes.dex                # Bytecode Dalvik executável das classes Java
├── assets/                    # Dados do jogo (modelos 3D, texturas, áudio, fases)
├── res/                       # Recursos de interface do Android e ícones
├── lib/                       # BIBLIOTECAS NATIVAS COMPILADAS (.so)
│   ├── armeabi/               # Binários ARMv5/v6 (32-bit, soft-float)
│   ├── armeabi-v7a/           # Binários ARMv7-A (32-bit, Thumb-2, VFPv3/NEON) [IDEAL]
│   ├── arm64-v8a/             # Binários ARMv8 (64-bit) [INCOMPATÍVEL DIRETAMENTE]
│   └── x86/                   # Binários Intel x86 [INCOMPATÍVEL]
└── META-INF/                  # Certificados e assinaturas do APK

🔍 Critério 1: Compatibilidade de Arquitetura (ABI)

Inspecione a pasta lib/ do APK:

unzip -l jogo.apk "lib/*"
Pasta de ABI Veredito Realidade Técnica no PS Vita
lib/armeabi-v7a/ EXCELENTE (Ideal) Código ARMv7 de 32 bits com instruções Thumb-2 e aceleração vetorial NEON. Compatibilidade perfeita com o Cortex-A9 do Vita.
lib/armeabi/ COMPATÍVEL Código ARMv5TE/v6 de 32 bits com ponto flutuante por software (soft-float). Funciona perfeitamente porque ARMv7 é um superset estrito de ARMv6.
lib/arm64-v8a/ INCOMPATÍVEL (em 32-bit) Instruções AArch64 de 64 bits. O processador do PS Vita é estritamente de 32 bits. Se o APK só possui 64 bits, procure versões anteriores do jogo (lançadas antes de agosto de 2019).
lib/x86/ / lib/x86_64/ INCOMPATÍVEL Arquiteturas Intel/AMD.

🎨 Critério 2: Versão da API Gráfica (OpenGL ES)

A GPU do PS Vita oferece aceleração nativa equivalente a OpenGL ES 1.1 e OpenGL ES 2.0 via vitaGL.

Como detectar a versão do jogo:

  1. Inspecione o AndroidManifest.xml via jadx: Procure por glEsVersion:
  2. 0x00010000 / 0x00010001: OpenGL ES 1.0 / 1.1 (Pipeline de função fixa).
  3. 0x00020000: OpenGL ES 2.0 (Shaders programáveis de vértices e fragmentos).
  4. 0x00030000+: OpenGL ES 3.0+. Atenção: Recursos avançados de GLES3 não são suportados nativamente pelo hardware do Vita.

  5. Inspecione os símbolos importados no .so com objdump:

    objdump -T lib/armeabi-v7a/libgame.so | grep -E "gl(Vertex|Color|CreateShader|Uniform)"
    

  6. Se encontrar glVertexPointer, glColorPointer, glMatrixMode: OpenGL ES 1.1. Roda com eficiência extrema no pipeline de função fixa do vitaGL.
  7. Se encontrar glCreateShader, glCompileShader, glUniformMatrix4fv: OpenGL ES 2.0. Requer o pipeline programável do vitaGL.
  8. Se encontrar vkCreateInstance, vkCreateDevice: Vulkan. O PS Vita NÃO possui suporte a Vulkan. Sem fallback para OpenGL ES, o port é inviável.

🔗 Critério 3: Dependências do NDK

Verifique as dependências externas da biblioteca nativa:

arm-vita-eabi-readelf -d lib/armeabi-v7a/libgame.so | grep NEEDED

Tabela de status para dependências comuns:

Biblioteca Status Solução no PS Vita
libc.so, libm.so, libdl.so Suportado Mapeado diretamente para as funções da Newlib do VitaSDK.
libGLESv1_CM.so / libGLESv2.so Suportado Mapeado para o vitaGL.
liblog.so Suportado Mapeado para o logger da Vita (sceClibPrintf / arquivo de log).
libz.so Suportado Vinculado à zlib do VitaSDK.
libOpenSLES.so Suportado Reimplementado via sceAudio ou OpenAL-Soft.
libunity.so / libmono.so Complexo Jogos antigos de Unity com Mono são viáveis; jogos modernos com IL2CPP frequentemente excedem os 512 MB de RAM do console.

🚦 Matriz de Decisão de Viabilidade

flowchart TD
    Start["APK Selecionado"] --> CheckArch{"Possui pasta lib/armeabi-v7a ou armeabi?"}
    CheckArch -- Não --> Fail1["❌ Inviável (Apenas 64-bit ou x86)"]
    CheckArch -- Sim --> CheckGL{"Qual API Gráfica utiliza?"}

    CheckGL -- Vulkan Exclusivo --> Fail2["❌ Inviável (Sem Vulkan no Vita)"]
    CheckGL -- GLES 1.1 / 2.0 --> CheckRAM{"Estimativa de RAM ativa?"}

    CheckRAM -- "> 400 MB de assets ativos" --> WarnRAM["⚠️ Alto Risco: OOM (Falta de Memória em 512MB RAM)"]
    CheckRAM -- "< 250 MB de assets ativos" --> CheckCode{"Onde reside a lógica do jogo?"}

    CheckCode -- "100% Java (classes.dex) sem código nativo" --> Fail3["❌ Inviável para SoLoader (Não há binário C/C++)"]
    CheckCode -- "Motor nativo em .so (C/C++)" --> Success["✅ VIÁVEL: Prosseguir para Análise Estática"]