SuperAPI AI 工具集

vitadeck-deck-app-init

通用与其它

查看项目

更新于 10-16 00:06

技能介绍

用途:在磁盘任意位置初始化一个独立的 VitaDeck Deck App 项目,使用已发布的 npm 包而非 VitaDeck 单仓库。Deck App 是运行在 PlayStation Vita(或桌面宿主)上、用 React 针对 VitaDeck Runtime API(@vitadeck/sdk 的 Screen、Text、Button 等组件)编写的交互体验。

主要能力:构建时 SDK 将 Deck App 源入口(默认 src/App.tsx)编译为可移植的 .vdapp 文件夹及用于上传的 .vdapp.zip 归档,包内含编译后的应用与元数据,React 与运行时由设备上的 VitaDeck 提供。

使用方式:前置条件为 Node.js 22+、npm/pnpm/Bun,以及设备上已安装 VitaDeck。在目标目录执行 npx @vitadeck/sdk create my-deck-app,然后 cd my-deck-app 并 npm install。编辑 src/App.tsx(默认导出即根组件),用 npx @vitadeck/sdk build 或 npm run build 构建,产物在 dist/ 下:<slug>.vdapp/ 与 <slug>.vdapp.zip,slug 来自 vitadeck.config.json 的项目名。可用 npx @vitadeck/sdk build --no-zip 跳过 zip。脚手架生成 vitadeck.config.json、package.json、src/App.tsx、src/vitadeck-env.d.ts、tsconfig.json;可选配置字段有 version、fonts。类型检查用 npx tsc 或 npm run tsc。部署需通过 Runtime Upload 上传 dist/*.vdapp.zip。

限制:React 必须为 18.3.x,否则构建失败;入口须默认导出一个 React 组件,不要调用 VitaDeck 注册 API;构建清单版本来自 package.json,除非配置中设置 version;目标目录已存在会报错;本技能仅适用于单仓库之外的项目。