JSOS
开发指南

开发入门

5 分钟创建一个 JSOS 应用

开发入门

JSOS 应用本质上就是一个运行在 WebContainer 中的 Node.js 程序。你可以把它简单地理解为一台远端服务器上的 Node.js 项目——只不过这台服务器就在你的浏览器里。

两种应用类型

类型说明场景
GUI启动 Web 服务,iframe 显示界面任何需要图形界面的应用
CLI直接跑命令,终端窗口交互命令行工具、脚本

最简单的 GUI 应用

创建一个目录,里面放两个文件:

package.json

{
  "name": "hello-jsos",
  "version": "1.0.0",
  "type": "module",
  "dependencies": {
    "express": "^4.18.0"
  },
  "jsos": {
    "id": "hello-jsos",
    "name": "Hello JSOS",
    "description": "我的第一个 JSOS 应用",
    "startCommand": "node server.js",
    "installCommand": "npm install"
  }
}

server.js

import express from 'express';
const app = express();
const port = process.env.PORT || 3000;

app.get('/', (req, res) => {
  res.send(`
    <html>
      <head><title>Hello</title></head>
      <body style="background:#1e1e2e;color:#cdd6f4;padding:40px;font-family:system-ui">
        <h1>Hello JSOS!</h1>
      </body>
    </html>
  `);
});

app.listen(port, () => console.log(`running on ${port}`));

打包安装

zip -r hello-jsos.zip package.json server.js

然后安装:右键桌面 → 获取应用(打开应用商店),或打开应用管理器 → 安装 → 本地安装,选择 ZIP 包即可安装。安装完成后桌面会出现图标,点击图标即可运行。

最简单的 CLI 应用

package.json

{
  "name": "hello-cli",
  "version": "1.0.0",
  "type": "module",
  "jsos": {
    "id": "hello-cli",
    "name": "Hello CLI",
    "type": "cli",
    "startCommand": "node cli.js"
  }
}

cli.js

console.log('Hello JSOS CLI!');
console.log('输入点什么吧:');

process.stdin.on('data', data => {
  const input = data.toString().trim();
  console.log(`你输入了: ${input}`);
});

同样打包成 ZIP 安装,点击打开会看到一个终端窗口,直接和你的程序交互。

字段速查

package.json 中的 jsos 字段只需三个必填项:

字段说明
id唯一标识(如 my-app)
name应用显示名称
startCommand启动命令(如 node server.js)

其他所有字段都是可选的——够简单吧?

后续

On this page