Entorno de Desarrollo y Herramientas
ConfiguraciĂłn de la toolchain cruzada VitaSDK, librerĂas vdpm (vitaGL, mathneon), suites de ingenierĂa inversa (jadx, Ghidra Docker) y plugins de kernel (kubridge, fd_fix).
Para desarrollar y depurar un port de Android para PS Vita se necesita una cadena de compilaciĂłn cruzada en el sistema anfitriĂłn (Linux, macOS o WSL en Windows) y un conjunto de herramientas de ingenierĂa inversa y plugins en la consola fĂsica.
🛠️ Herramientas en la Máquina de Desarrollo (Host)¶
1. VitaSDK (El Toolchain Oficial de la Comunidad)¶
VitaSDK es la suite de compilaciĂłn cruzada basada en GCC (arm-vita-eabi-gcc) para la PlayStation Vita.
InstalaciĂłn rápida (Linux / macOS):¶
# Definir directorio de instalaciĂłn (ejemplo en ~/.vitasdk)
export VITASDK="$HOME/vitasdk"
export PATH="$VITASDK/bin:$PATH"
# Descargar e instalar mediante el script oficial
git clone https://github.com/vitasdk/vdpm.git
cd vdpm
./bootstrap-vitasdk.sh
./install-all.sh
Añade las variables a tu archivo de configuración de shell (~/.bashrc o ~/.zshrc):
Verifica la instalaciĂłn ejecutando:
2. LibrerĂas de Enlace Indispensables (vdpm)¶
Instala las librerĂas base de la comunidad requeridas por la mayorĂa de los ports:
3. Herramientas de IngenierĂa Inversa (Reverse Engineering)¶
Para abrir el APK y examinar el binario nativo:
- jadx (Decompilador de bytecode DEX de Android a cĂłdigo Java limpio):
- macOS:
brew install jadx - Linux: Descargar desde Releases de jadx en GitHub.
- Docker +
devrvk/so-decompiler(Ghidra Headless): Permite decompilar cualquier.sode ARMv7 a pseudo-C legible desde la lĂnea de comandos sin tener que interactuar con la interfaz gráfica de Ghidra: - Herramientas binarias de VitaSDK:
arm-vita-eabi-objdump: Desensamblador con soporte especĂfico de Thumb-2 y ELF ARM.arm-vita-eabi-nm: Extractor de sĂmbolos.arm-vita-eabi-readelf: Lector de cabeceras ELF, tablas dinámicas y relocalizaciones.
4. psvita-toolkit CLI¶
El CLI de automatizaciĂłn desarrollado para gestionar ports de forma estandarizada:
# DiagnĂłstico del entorno
psvita-toolkit doctor
# CompilaciĂłn con CMake / Ninja
psvita-toolkit build --preset debug
# Despliegue ultra-rápido de eboot.bin por FTP
psvita-toolkit deploy --eboot --yes
🎮 Plugins de Kernel Requeridos en la PS Vita¶
Para que la PlayStation Vita permita ejecutar cĂłdigo cargado dinámicamente en espacio de usuario, es obligatorio que la consola fĂsica tenga instalados los siguientes plugins de kernel en ur0:tai/config.txt:
1. kubridge (de TheFloW)¶
Repositorio: github.com/TheOfficialFloW/kubridge
¿Por qué es vital?
La PlayStation Vita por seguridad no permite que una aplicaciĂłn en modo usuario asigne páginas de memoria con permisos simultáneos de lectura, escritura y ejecuciĂłn (RWX), ni permite resolver sĂmbolos directamente del kernel. kubridge expone las llamadas de kernel kuKernelAllocMemBlock y servicios de puente que hacen posible que el cargador asigne la memoria ejecutable donde se mapea el archivo .so.
2. fd_fix (de TheFloW)¶
Repositorio: github.com/TheOfficialFloW/fd_fix
¿Por qué es vital?
En el kernel de PlayStation Vita, cuando una aplicación intenta cerrar un descriptor de archivo duplicado o inválido, el sistema operativo puede generar un kernel panic o corromper el árbol de descriptores I/O de la aplicación. fd_fix previene este comportamiento garantizando compatibilidad total con la semántica de descriptores POSIX esperada por los motores de Android.
[!CAUTION] Si intentas arrancar un port basado en SoLoader en una consola que no tiene
kubridge.skprxinstalado o activo, el juego se cerrará inmediatamente al iniciar con un error de acceso a memoria o pantalla negra antes de ejecutar la primera lĂnea de cĂłdigo del motor.
🗂️ Estructura del Repositorio de un Port¶
Un repositorio tĂpico de porting mantiene la siguiente organizaciĂłn limpia:
mi-juego-vita/
├── CMakeLists.txt # Configuración de compilación con VitaSDK y vitaGL
├── PORTING_PLAN.md # Plan maestro, matriz de sĂmbolos y checklist
├── CLAUDE.md # Instrucciones para asistentes de IA y desarrollo
├── .psvita-toolkit.json # Configuración de IP de la consola y rutas locales
├── source/ # Código fuente del cargador (C / C++)
│ ├── main.c # Punto de entrada, inicialización de vitaGL, bucle principal
│ ├── dynlib.c / so_util.c # Cargador de ELF, procesador de relocalizaciones
│ ├── patch.c # Parches de memoria en caliente e intercepción de funciones
│ ├── falso_jni/ # Entorno FalsoJNI (JVM, JNIEnv y callbacks Java)
│ │ ├── falso_jni.c
│ │ └── falso_jni.h
│ └── reimpl/ # Reimplementaciones de subsistemas (audio, input, io)
├── extras/ # Materiales gráficos para LiveArea
│ └── livearea/
│ ├── icon0.png # 128x128 (8-bit indexado)
│ ├── startup.png # 280x158 (8-bit indexado)
│ ├── bg0.png # 840x500 (8-bit indexado)
│ ├── pic0.png # 960x544 (opcional)
│ └── template.xml # Plantilla XML del LiveArea
└── ux0_data/ # Assets necesarios para copiar a ux0:data/mi-juego/
└── mi-juego/
└── libgame.so # Archivo .so original extraĂdo del APK