psvita-porting

name	psvita-porting
description	Guía de desarrollo y habilidades para realizar ports de Android a PS Vita usando cargadores de librerías dinámicas (.so) como SoLoader Boilerplate o falsos entornos JNI. Activar cuando se realicen ports, depuración de llamadas JNI de Android o configuraciones del SDK de Vita (vitasdk).

Desarrollo de Ports de Android para PS Vita (SoLoader)

Esta habilidad contiene directrices detalladas, flujos de trabajo comunes y referencias para adaptar ejecutables y librerías dinámicas de Android para que funcionen de forma nativa en la PS Vita.

Referencias y Subdocumentos

• Guía de Carga Dinámica y Relocalización (.so): references/so_loading.md
  • Cómo mapear múltiples módulos, definir offsets de direcciones de memoria en main.c y usar so_file_load.
• Implementación de FalsoJNI y Enlaces JNI de Cocos2d-x: references/jni_bindings.md
  • Mapeo de llamadas JNI nativas del motor (Touches, KeyDown, nativeInit, nativeRender).
• Ajustes de Compilación con VitaSDK: references/vitasdk_setup.md
  • Modificación de CMakeLists.txt, dependencias de linkeo (vitaGL, mathneon, kubridge_stub) y uso de softfp.
• Renderizado de Texto en C con stb_truetype: references/text_rendering.md
  • Resolución de problemas de tipografía, escalado, saltos de línea (word wrap) y uso vital del Alfa Premultiplicado para evitar errores de color.
• Creación Segura de Recursos del LiveArea: references/livearea_assets.md
  • Reglas estrictas (dimensiones, PNGs 8-bit indexados, eliminación de metadatos ._) para evitar el error de instalación 0x8010113D en VitaShell.

Lecciones confirmadas en hardware real (esta sesión de debugging)

• Depuración en consola real sin plugins de red: references/hardware_debugging.md
  • Logging a archivo por ejecución, método iterativo de "un fallo a la vez", y cómo leer un .psp2dmp con vita-parse-core (setup completo, incluyendo el parche necesario para Python moderno).
• .apk/.obb vs. archivos sueltos: references/asset_packaging.md
  • El fallback real de CCFileUtils::getFileData a ZIP, y cómo armar .apk/.obb mínimos o completos con Python en vez de duplicar el peso en la tarjeta.
• Stubs de JNI que cuelgan el motor: references/jni_stubs.md
  • Cuándo un no-op alcanza y cuándo hay que disparar el callback de "completado" real del motor (patrón onVideoCompleted y similares).
• Input táctil y de botones: references/input_handling.md
  • sceTouchSetSamplingState apagado por default, por qué nunca hay que pasarle al motor el ID crudo de SceTouchReport (corrompe el heap), y cómo mapear botones físicos a touches sintéticos sin usar un slot "extra".
• Errores de instalación del .vpk no relacionados al gameplay: references/vpk_packaging.md
  • Complementa a livearea_assets.md con la metodología general para diagnosticar estos errores.
• Gotchas de toolchain: references/toolchain_gotchas.md
  • Rutas con espacios, CMAKE_POLICY_VERSION_MINIMUM, y symlinks/directorios de build que pueden desaparecer entre sesiones.