Triaje y Análisis de Viabilidad de APK
Diagnóstico sistemático de compatibilidad de arquitectura ABI (ARMv7 vs 64-bit), pipeline gráfico (GLES 1.1 vs 2.0 vs Vulkan), límites de memoria y ratio de código nativo.
Antes de escribir una sola línea de código o crear un proyecto CMake, es fundamental realizar un análisis de viabilidad del APK. No todos los juegos de Android pueden ser portados mediante la técnica SoLoader; evaluar las características del binario en los primeros diez minutos previene semanas de trabajo estéril.
📦 Anatomía de un APK de Android¶
Un archivo .apk es internamente un archivo comprimido estándar en formato ZIP. Puedes descomprimirlo con cualquier herramienta o renombrarlo a .zip:
juego.apk (ZIP)
├── AndroidManifest.xml # Manifiesto binario (paquete Java, versión GLES, permisos)
├── classes.dex # Bytecode Dalvik ejecutable de las clases Java
├── assets/ # Assets directos del juego (modelos, texturas, música, niveles)
├── res/ # Recursos de interfaz de Android (iconos, layouts XML)
├── lib/ # LIBRERÍAS NATIVAS COMPILADAS (.so)
│ ├── armeabi/ # Binarios ARMv5/v6 (32 bits, soft-float)
│ ├── armeabi-v7a/ # Binarios ARMv7-A (32 bits, Thumb-2, VFPv3/NEON) [IDEAL]
│ ├── arm64-v8a/ # Binarios ARMv8 (64 bits) [INCOMPATIBLE DIRECTAMENTE]
│ └── x86/ # Binarios Intel x86 [INCOMPATIBLE]
└── META-INF/ # Firmas de seguridad y certificados
🔍 Criterio 1: Compatibilidad de Arquitectura (ABI)¶
Extrae la carpeta lib/ y examina las carpetas presentes:
| Directorio de ABI | Veredicto | Notas Técnicas para PS Vita |
|---|---|---|
lib/armeabi-v7a/ |
EXCELENTE (Óptimo) | Código nativo ARMv7 de 32 bits con soporte para instrucciones Thumb-2 y aceleración vectorial NEON. Coincide exactamente con la CPU ARM Cortex-A9 de la Vita. |
lib/armeabi/ |
COMPATIBLE | Código ARMv5TE / ARMv6 de 32 bits con aritmética de punto flotante por software (soft-float). La Vita lo ejecuta perfectamente porque ARMv7 es un superset estricto de ARMv6. |
lib/arm64-v8a/ |
NO COMPATIBLE (en 32-bit) | Instrucciones AArch64 de 64 bits. La CPU de la PS Vita es estrictamente de 32 bits. Si el APK solo tiene arm64-v8a, busca una versión anterior del juego (versiones previas a agosto de 2019, fecha en la que Google impuso la obligatoriedad de 64 bits). |
lib/x86/ / lib/x86_64/ |
INCOMPATIBLE | Binarios para procesadores Intel/AMD. |
🎨 Criterio 2: Versión de API Gráfica (OpenGL ES)¶
La GPU de la PS Vita soporta hardware equivalente a OpenGL ES 1.1 y OpenGL ES 2.0 a través de la biblioteca vitaGL.
¿Cómo saber qué versión usa el juego?¶
- Revisar
AndroidManifest.xmlconjadx: Busca la etiquetaglEsVersion: 0x00010000o0x00010001: OpenGL ES 1.0 / 1.1 (Pipeline de función fija).0x00020000: OpenGL ES 2.0 (Shaders programables de vértices y fragmentos).-
0x00030000o superior: OpenGL ES 3.0+. Precaución: La Vita no tiene hardware GLES3 completo, aunque muchas funciones básicas son mapeables a vitaGL. -
Inspeccionar los símbolos importados en el
.soconobjdump: - Si aparecen
glVertexPointer,glColorPointer,glTexCoordPointer,glMatrixMode: Es OpenGL ES 1.1. vitaGL lo ejecuta con su pipeline de función fija de manera ultraeficiente. - Si aparecen
glCreateShader,glCompileShader,glAttachShader,glUniformMatrix4fv: Es OpenGL ES 2.0. Requerirá el traductor de shaders de vitaGL o recompilación manual a Cg/GXP. - Si aparecen
vkCreateInstance,vkCreateDevice: Es Vulkan. La PS Vita NO tiene soporte para Vulkan. Salvo que el motor tenga un fallback de OpenGL ES, el port no es viable.
🔗 Criterio 3: Dependencias NDK y Middleware¶
Ejecuta el siguiente comando para listar las librerías dinámicas compartidas de las que depende el juego:
Salida típica de un juego apto:
0x00000001 (NEEDED) Shared library: [liblog.so]
0x00000001 (NEEDED) Shared library: [libGLESv2.so]
0x00000001 (NEEDED) Shared library: [libz.so]
0x00000001 (NEEDED) Shared library: [libm.so]
0x00000001 (NEEDED) Shared library: [libc.so]
0x00000001 (NEEDED) Shared library: [libstdc++.so]
Tabla de resolución de dependencias comunes:¶
| Librería Requerida | Estado en Vita | Cómo se Resuelve en el Loader |
|---|---|---|
libc.so, libm.so, libdl.so |
Resuelto | Mapeado directamente a las funciones de Newlib / VitaSDK. |
libGLESv1_CM.so / libGLESv2.so |
Resuelto | Mapeado a vitaGL. |
liblog.so |
Resuelto | Mapeado a funciones de logging (sceClibPrintf / escritura en archivo). |
libz.so |
Resuelto | Enlazado contra zlib de VitaSDK. |
libOpenSLES.so |
Resuelto | Reimplementado mediante un wrapper hacia sceAudio o OpenAL. |
libfmod.so / libfmodstudio.so |
Resuelto | Existe FMOD nativo para PS Vita o se puede enlazar con wrappers de audio. |
libunity.so / libmono.so |
Complejo | Los juegos de Unity antiguos con Mono pueden requerir configuraciones avanzadas; Unity moderno con IL2CPP en ARMv7 suele exceder los límites de RAM si el juego es pesado. |
🚦 Matriz de Decisión de Viabilidad¶
flowchart TD
Start["APK Seleccionado"] --> CheckArch{"¿Posee carpeta lib/armeabi-v7a o armeabi?"}
CheckArch -- No --> Fail1["❌ Inviable (Solo 64-bit o x86)"]
CheckArch -- Sí --> CheckGL{"¿Qué API Gráfica utiliza?"}
CheckGL -- Vulkan Exclusivo --> Fail2["❌ Inviable (PS Vita carece de driver Vulkan)"]
CheckGL -- GLES 1.1 / 2.0 --> CheckRAM{"¿Tamaño del juego y RAM estimada?"}
CheckRAM -- "> 400 MB de assets activos simultáneos" --> WarnRAM["⚠️ Riesgo Alto: OOM (Out Of Memory en 512MB RAM)"]
CheckRAM -- "< 250 MB de RAM estimada" --> CheckCode{"¿Lógica del juego en .so o en Java?"}
CheckCode -- "Lógica 100% en Java (classes.dex) sin código nativo" --> Fail3["❌ Inviable para SoLoader (No hay binario C/C++)"]
CheckCode -- "Motor nativo en .so (C/C++)" --> Success["✅ VIABLE: Proceder a Fase de Análisis Estático"]