打包与分享
应用打包
将应用打包为 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 # 格式标识 + 清单如何导出
- 打开应用管理器(AppManager)
- 进入目标应用的详情页
- 点击「导出应用」按钮
- 系统自动打包并下载 ZIP 文件
仅已启动过的应用可导出。未启动过时按钮显示为禁用。
如何安装
和安装普通 ZIP 包完全相同:
- 右键桌面 → 安装应用
- 选择快照包
.zip文件 - 系统自动识别快照格式并安装
与标准 ZIP 包的区别
| 标准 ZIP 包 | 快照包 | |
|---|---|---|
| 安装速度 | 需要 npm install | 秒级(跳过安装) |
| 文件大小 | 仅源码 | 包含已安装依赖 |
| 适用场景 | 依赖简单 | 依赖复杂 |