JSOS
打包与分享

应用打包

将应用打包为 ZIP 分发

应用打包

开发完成后,将应用打包为 .zip 文件即可分发。

打包方式

手动打包

cd my-app/
zip -r ../my-app.zip .

使用脚本

# package.sh
APP_DIR=$1
OUTPUT=$2
if [ ! -f "$APP_DIR/package.json" ]; then
  echo "package.json not found"
  exit 1
fi
cd "$APP_DIR"
zip -r "../$OUTPUT" .
cd ..
echo "Created: $OUTPUT"

打包检查清单

  • package.json 在 ZIP 根目录
  • 包含 jsos 字段(id、name、startCommand)
  • 版本号按当天日期设置(同日多次更新用 .1、.2,见版本规范)
  • 图标使用 data URI 或包内本地文件(不要用网络链接)
  • ZIP 大小合理

常见问题

问题原因解决
安装报错"未找到 package.json"文件不在 ZIP 根目录确保 package.json 在 ZIP 根目录
图标报错"不支持网络图标"icon 用了 URL改为 data URI 或包内文件
启动时 npm 报错依赖不兼容使用纯 JS 替代包(见注意事项)
服务启动不了端口错误检查是否使用 process.env.PORT

注意事项

图标不要用网络链接

// ❌ 错误
"icon": "https://example.com/icon.png"

// ✅ 正确
"icon": "data:image/svg+xml,<svg>...</svg>"

// ✅ 正确
"icon": "icon.png"

包内文件自动挂载

ZIP 内的所有文件会自动挂载到 WebContainer,无需在 jsos 中声明 files 字段。

快照包

快照包是标准 ZIP 包的扩展格式,包含 WebContainer 运行时快照,安装后可跳过 npm install 直接启动。

适用场景

  • 应用依赖复杂、npm install 耗时长
  • 需要分发给其他用户快速安装
  • 依赖包含需要编译的原生模块(WebContainer 无法编译)

内部结构

my-app-v1.0.0.zip
├── .jsos-snapshot       # 二进制快照
└── .jsos-config.json    # 格式标识 + 清单

如何导出

  1. 打开应用管理器(AppManager)
  2. 进入目标应用的详情页
  3. 点击「导出应用」按钮
  4. 系统自动打包并下载 ZIP 文件

仅已启动过的应用可导出。未启动过时按钮显示为禁用。

如何安装

和安装普通 ZIP 包完全相同:

  1. 右键桌面 → 安装应用
  2. 选择快照包 .zip 文件
  3. 系统自动识别快照格式并安装

与标准 ZIP 包的区别

标准 ZIP 包快照包
安装速度需要 npm install秒级(跳过安装)
文件大小仅源码包含已安装依赖
适用场景依赖简单依赖复杂

On this page