LiveArea e Empacotamento de VPK
Construção de pacotes de distribuição VPK, configuração de LiveArea (template.xml, icon0.png, bg0.png), resolução do erro 0x8010113D e purga de arquivos AppleDouble do macOS.
O pacote final instalável no PlayStation Vita é um arquivo com extensão .vpk. Um VPK é internamente um arquivo ZIP contendo o executável assinado (eboot.bin), metadados do sistema (sce_sys/param.sfo) e a interface gráfica do sistema (LiveArea).
🖼️ Especificações de Imagens do LiveArea¶
O shell do sistema (SceShell) impõe dimensões rígidas e limites máximos de tamanho de arquivo:
| Recurso | Dimensões (Pixels) | Tamanho Máximo Permitido | Papel no Console |
|---|---|---|---|
icon0.png |
128 x 128 | 128 KiB | Ícone circular da bolha na tela inicial. |
startup.png |
280 x 158 | 64 KiB | Botão central interativo na porta do LiveArea. |
bg0.png |
840 x 500 | 128 KiB | Imagem de fundo da porta do LiveArea. |
pic0.png |
960 x 544 | 256 KiB | Imagem de fundo em tela cheia (opcional). |
🚫 O Erro 0x8010113D Durante a Instalação¶
O erro 0x8010113D no VitaShell ocorre quando uma das imagens do LiveArea viola as especificações da Sony:
flowchart TD
PNG["Imagem PNG do LiveArea"] --> CheckDims{"Dimensões exatas?"}
CheckDims -- Não --> Fail1["❌ Erro 0x8010113D (Dimensão incorreta)"]
CheckDims -- Sim --> CheckSize{"Tamanho dentro do limite em KiB?"}
CheckSize -- Não --> Fail2["❌ Erro 0x8010113D (Arquivo muito grande)"]
CheckSize -- Sim --> CheckFormat{"Paleta indexada de 8 bits?"}
CheckFormat -- Não --> Fail3["❌ Erro 0x8010113D (RGB 32 bits entrelaçado)"]
CheckFormat -- Sim --> Success["✅ Válido para LiveArea"]
Regras de Ouro:¶
- Paleta Indexada a 8 bits (256 cores): Quantize as imagens com ferramentas como
pngquant. - Sem Entrelaçamento (Non-interlaced): O decodificador de hardware não suporta PNGs progressivos.
- Conversão com
psvita-toolkit:
🍏 Arquivos Fantasma ._* do macOS¶
Ao compilar no macOS, o sistema gera metadados AppleDouble (._icon0.png, ._eboot.bin) em volumes FAT32/exFAT.
[!CAUTION] Se arquivos
._*forem compactados dentro do.vpk, a instalação no VitaShell falhará ou criará bolhas corrompidas.
Limpeza obrigatória:
📜 Configuração de param.sfo¶
Gere o arquivo param.sfo com o utilitário vita-mksfoex:
Regras do TITLE_ID:¶
- Exatamente 9 caracteres alfanuméricos em maiúsculas.
- Padrão homebrew comum:
PSVseguido de letras e números identificadores (ex:PSVHOS001).
📦 Empacotamento Automatizado no CMake¶
No arquivo CMakeLists.txt:
vita_create_self(eboot.bin ${PROJECT_NAME})
vita_create_vpk(${PROJECT_NAME}.vpk ${TITLE_ID} eboot.bin
VERSION "01.00"
NAME "${GAME_NAME}"
FILE extras/livearea/icon0.png sce_sys/icon0.png
FILE extras/livearea/startup.png sce_sys/livearea/contents/startup.png
FILE extras/livearea/bg0.png sce_sys/livearea/contents/bg0.png
FILE extras/livearea/template.xml sce_sys/livearea/contents/template.xml
)