Sistema de Arquivos e Gestão de Assets
Redirecionamento de caminhos Linux ext4 (/sdcard/, /data/data/) para partições do PS Vita (ux0:, app0:), sanitização transparente de I/O e mitigação de cluster slack FAT32.
A topologia de armazenamento e as partições do PlayStation Vita diferem substancialmente do ambiente Android Linux. O redirecionamento de caminhos e o correto empacotamento dos arquivos de dados garantem que o jogo encontre seus modelos, texturas e arquivos de progresso (saves).
💾 Topologia de Armazenamento no VitaOS¶
graph TD
subgraph "Partições do VitaOS"
UX0["ux0: (Cartão de Memória Principal / SD2Vita)"]
APP0["app0: (Montagem somente leitura da aplicação atual)"]
UR0["ur0: (Memória do sistema / Plugins taiHEN)"]
end
subgraph "Tradução de Caminhos"
AndroidPath["Caminho Android: /sdcard/Android/data/com.jogo/"]
VitaDataPath["Destino Real: ux0:data/meu_jogo/"]
end
AndroidPath -->|sanitize_path()| VitaDataPath
VitaDataPath --> UX0
APP0 -->|Contém eboot.bin e LiveArea| UX0
Papel das Partições:¶
app0:(Somente Leitura): Diretório de instalação do app (ux0:app/<TITLEID>/). Contém oeboot.bine metadados. Qualquer tentativa de escrita emapp0:resulta em erro imediato de permissão.ux0:data/<jogo>/(Leitura e Escrita): Localização padrão da comunidade homebrew para dados do jogo, arquivos de progresso (saves/) e registros de log (logs/).
🔀 Redirecionamento de Caminhos POSIX¶
Jogos Android utilizam caminhos fixos do Linux:
- /sdcard/Android/data/com.gameloft.spaw/files/...
- /data/data/com.gamevil.zenonia3/...
No carregador (io.c), intercepte as funções de I/O (fopen, open, stat, mkdir):
#define DATA_PATH "ux0:data/heroofsparta/"
char *sanitize_path(const char *path, char *out_path, size_t max_len) {
if (!path) return NULL;
if (strncmp(path, "ux0:", 4) == 0 || strncmp(path, "app0:", 5) == 0) {
strncpy(out_path, path, max_len);
return out_path;
}
const char *p = path;
if (strncmp(p, "/sdcard/", 8) == 0) p += 8;
else if (strncmp(p, "/storage/emulated/0/", 20) == 0) p += 20;
else if (*p == '/') p++;
snprintf(out_path, max_len, "%s%s", DATA_PATH, p);
return out_path;
}
FILE *vita_fopen(const char *filename, const char *mode) {
char clean_path[1024];
sanitize_path(filename, clean_path, sizeof(clean_path));
return fopen(clean_path, mode);
}
📦 Estratégias de Empacotamento de Assets¶
| Estratégia | Vantagens | Desvantagens |
|---|---|---|
| 1. Arquivos Soltos Descompactados | Fácil de inspecionar e modificar texturas e áudio. | O tamanho de cluster do FAT32 (32KB/64KB) desperdiça centenas de megabytes em jogos com milhares de arquivos pequenos (slack space). |
| 2. Leitura Direta de APK/OBB (ZIP na RAM) | Economiza espaço considerável; pacote único comprimido. Leituras mais rápidas no cartão. | Requer suporte a ZIP nativo no motor (ex: CCFileUtils no Cocos2d-x) ou vinculação com libzip / minizip. |
🔠 Sensibilidade a Maiúsculas e Minúsculas (FAT vs ext4)¶
- Android (ext4): Estritamente sensível a maiúsculas e minúsculas (
Textura.PNG!=textura.png). - PS Vita (FAT32 / exFAT): Preserva maiúsculas, mas a busca é insensível.
[!WARNING] Se o APK contiver arquivos com o mesmo nome diferenciados apenas por maiúsculas na mesma pasta, ao copiá-los para o Vita um sobrescreverá o outro.