快速开始

这条路径用最短的步骤把 ClientX 跑起来：获取 core 源码 → 创建资源 → 构建 → 本地预览。更完整的安装方式与架构说明见安装。

1. 前置条件

• Node.js 18 或更高版本
• npm

2. 获取 core 源码

从终端下载获取 clientx-core-source.tar.gz，解压并安装依赖：

tar xzf clientx-core-source.tar.gz
cd clientx/
npm install

解压后的目录包含 @clientx/runtime、@clientx/common、CLI（scripts/clientx.mjs）与全部构建器。

3. 创建第一个资源

用 CLI 生成 hello 资源骨架，并声明它依赖 client（应用壳）：

node scripts/clientx.mjs create hello --deps client

生成的结构：

src/resource/hello/
├── package.json     # @me/hello + clientx 配置
├── register.ts      # declareHello() + activateHello()
└── i18n/
    ├── zh.json
    └── en.json

4. 构建

node scripts/clientx.mjs build --resources hello,client

构建产物在 dist/，包含 core-app、shared-vendor、资源包与 manifest.json。

5. 本地预览

npx serve dist
# 或
python3 -m http.server --directory dist 3007

打开终端输出的地址即可看到应用。

下一步

• 安装：两种安装 core 的方式与目录结构。
• 开发：资源结构、register.ts 的 declare / activate 生命周期与依赖声明。
• 打包：构建流程与 dist/ 产物结构。
• 组装：从 manifest 加载资源、clientx run 开发服务器。