Back to Details

vitadeck-vdapp-upload

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

VitaDeck vdapp upload

VitaDeck vdapp 上传

Prerequisite

前置条件

VitaDeck must be running on the Vita with Runtime Upload active (Shell → Upload → confirm). The listener serves 
POST /upload
on port 8787 (falls forward if busy).
Vita设备上必须运行VitaDeck且Runtime Upload处于激活状态（Shell → Upload → 确认）。监听器在端口8787提供
POST /upload
服务（端口繁忙时会自动转发）。

Quick start

快速开始

From any directory, upload a built archive:
sh
/path/to/vitadeck/.cursor/skills/vitadeck-vdapp-upload/scripts/upload-vdapp.sh /path/to/myapp.vdapp.zip
Success looks like: 
{"ok":true,"packageName":"myapp.vdapp","version":"0.1.0"}
在任意目录下，上传已构建的归档文件：
sh
/path/to/vitadeck/.cursor/skills/vitadeck-vdapp-upload/scripts/upload-vdapp.sh /path/to/myapp.vdapp.zip
成功时的返回示例：
{"ok":true,"packageName":"myapp.vdapp","version":"0.1.0"}

Build the archive (if needed)

构建归档文件（如需要）

Inside a Deck App project (this repo or elsewhere):
sh
vitadeck build
Produces 
<outDir>/<name>.vdapp/
and 
<outDir>/<name>.vdapp.zip
(e.g. 
dist/chat.vdapp.zip
). Use the 
.zip
, not the unpacked folder.
在Deck App项目中（本仓库或其他项目）：
sh
vitadeck build
生成
<outDir>/<name>.vdapp/
和
<outDir>/<name>.vdapp.zip
（例如
dist/chat.vdapp.zip
）。请使用**
.zip
**压缩文件，而非解压后的文件夹。

Vita IP

Vita IP地址

Override explicitly:
sh
upload-vdapp.sh --ip 192.168.1.50 myapp.vdapp.zip
显式指定IP：
sh
upload-vdapp.sh --ip 192.168.1.50 myapp.vdapp.zip

or

或

PSVITAIP=192.168.1.50 upload-vdapp.sh myapp.vdapp.zip

Default resolution (first hit wins):

1. `--ip` / `PSVITAIP`
2. `out-vita/CMakeCache.txt` → `PSVITAIP:STRING=…`
3. `out/CMakeCache.txt` → `PSVITAIP:STRING=…`
4. `CMakeLists.txt` → `set(PSVITAIP "…")` (repo default)
PSVITAIP=192.168.1.50 upload-vdapp.sh myapp.vdapp.zip

默认IP优先级（按顺序匹配）：

1. `--ip` 参数 / `PSVITAIP` 环境变量
2. `out-vita/CMakeCache.txt` → `PSVITAIP:STRING=…`
3. `out/CMakeCache.txt` → `PSVITAIP:STRING=…`
4. `CMakeLists.txt` → `set(PSVITAIP "…")`（仓库默认值）

Manual curl

手动使用curl上传

sh
curl -X POST "http://${PSVITAIP:-192.168.1.177}:8787/upload" \
  -F archive=@/path/to/myapp.vdapp.zip
sh
curl -X POST "http://${PSVITAIP:-192.168.1.177}:8787/upload" \
  -F archive=@/path/to/myapp.vdapp.zip

Troubleshooting

故障排除

  • Connection refused — Upload screen not open on Vita, or wrong IP.
  • 409 — Another upload in progress; wait and retry.
  • 422 — Bad archive layout; zip must contain exactly one top-level 
    *.vdapp
    directory.
  • After upload, pick the package on Shell Home Screen (Enter) if it did not become active automatically.
  • 连接被拒绝 — Vita设备未打开上传界面，或IP地址错误。
  • 409错误 — 有其他上传任务正在进行；请等待后重试。
  • 422错误 — 归档文件结构错误；压缩包必须恰好包含一个顶层
    *.vdapp
    目录。
  • 上传完成后，如果应用未自动激活，请在Shell主屏幕选择该包（按Enter键）。