XWorker 安装教程

XWorker 本质上是一个由 Maven 管理的 Java 项目。即便是发行版，底层也仍是通过 Maven 来组织与构建的。理解这一点，你就理解了一切安装方式的背后逻辑：

• 核心机制：XWorker 的"安装"本质上是在某个工作目录中创建一个 pom.xml，然后通过 Maven 拉取所需的 xworker_* 类库并构建启动脚本。这与你用 Maven 管理一个普通 Java 项目完全一致。
• 统一启动器：无论哪种方式安装，最终都以 xworker.cmd（Windows）或 xworker.sh（Linux/macOS）作为统一启动入口，避免因启动方式不一而产生歧义。
• 无需区分操作系统：通用的 Jar 安装方式在 Windows、Linux、macOS 上完全一致，差异仅在启动脚本的后缀（.cmd / .sh）。

1.1 前置准备：安装 Java 与 Maven

Jar 安装方式需要你自行安装 Java（JDK 8 或更高） 与 Maven 3。安装后请确认下列命令可用：

java -version      # 应显示 Java 版本信息
mvn -version        # 应显示 Maven 版本信息

• 未安装 Java？ 推荐从 Adoptium / Eclipse Temurin 下载 JDK。若你的机器已装过其它软件依赖 Java，建议直接升级到受支持版本。
• 未安装 Maven？ 从 Apache Maven 官网 下载，解压后将其 bin 目录加入系统 PATH 即可。
• 如果你不想手工配置，可跳至文末的自动化安装脚本，脚本会自动检测并引导安装 Java / Maven。

1.2 下载发行版 Jar

下载 XWorker 的发行版 xworker-2.0.4-SNAPSHOT.jar：

1.3 运行安装程序（交互选择版本）

将下载的 jar 放到你希望作为 XWorker 工作目录的文件夹中，然后执行：

java -jar xworker-2.0.4-SNAPSHOT.jar

程序会在当前目录判断是否存在 pom.xml。若不存在，将出现下面的版本选择菜单：

1.4 自动构建（mvn package）与初始化

选定版本后，安装程序会自动完成以下工作：

1. 创建 pom.xml：写入所选版本的 Maven 工程描述，声明对 xworker_swt_thingeditor、xworker_webserver 等类库的依赖。
2. 执行 mvn package：从 Maven 仓库（含 central-portal-snapshots 快照源）拉取所有依赖并打包。首次构建较慢，请耐心等待。
3. 拷贝依赖：将依赖的 jar 拷贝到本地 lib/mvn、lib_rap 等目录，供 XWorker 离线运行。
4. 生成启动脚本：在目录下生成 swt.cmd/swt.sh、web.cmd/web.sh 等启动入口。
5. 初始化数据库与索引：完成 XWorker 运行所需的数据库与模型索引初始化。

1.5 生成统一启动器 xworker.cmd / xworker.sh

安装程序会生成 swt.cmd/swt.sh、web.cmd/web.sh 等，但不会生成统一的 xworker.cmd / xworker.sh。为保证所有用户使用统一的启动入口、避免歧义，请手动复制一份（内容一致）：

REM 复制 swt.cmd 为 xworker.cmd（内容一致）
copy swt.cmd xworker.cmd

# 复制 swt.sh 为 xworker.sh（内容一致）并赋予执行权限
cp swt.sh xworker.sh
chmod +x xworker.sh

1.6 启动 XWorker

xworker.cmd

./xworker.sh

启动后即进入 XWorker 的图形化模型编辑器，你可以开始创建模型、封装功能，以及创建属于你自己的 Agent 和工具了。

为不同操作系统提供了一键自动化安装脚本。脚本会自动完成：检测并自动安装 Java 与 Maven → 下载发行版 jar → 提示选择版本 → 运行安装 → 生成统一的 xworker.cmd/xworker.sh，无需手工逐条执行。

3.1 下载脚本

3.2 使用步骤

1. 下载对应系统的脚本，放到希望作为 XWorker 工作目录的文件夹中。
2. 运行脚本（Windows 需管理员身份；Linux/macOS 用 bash 执行）。
3. 脚本会依次：自动安装缺失的 Java / Maven → 下载 jar → 提示你选择版本（1=Java11 版、2=Java17 版、4=Web 版等）→ 运行安装并等待构建完成。
4. 自动生成 xworker.cmd（Windows）或 xworker.sh（Linux/macOS）。
5. 启动：双击 xworker.cmd，或执行 ./xworker.sh。

如果你在 Windows 上且还没有安装 Java 和 Maven，推荐使用绿色版——它已经把所有运行时（含 Java 与 Maven）打好包，解压即用，无需任何环境配置。

4.1 下载绿色版

4.2 解压与安装

1. 将下载的 xworker2.0.4b.zip 解压到本地磁盘。建议解压到不含中文和空格的路径，例如 C:\xworker\。
2. 绿色版 无需安装程序、无需写注册表，解压即完成"安装"。
3. 删除整个目录即可彻底卸载。

4.3 启动

进入解压目录，双击启动脚本即可（绿色版已内置统一启动脚本）：

xworker.cmd          # 统一启动器（模型编辑器）
web.cmd            # 启动 Web 版编辑器

4.4 从绿色版升级到 Jar 方式（可选）

XWorker 的后续升级主要通过修改 pom.xml 实现，然后重新执行 java -jar xworker-2.0.4-SNAPSHOT.jar 完成安装与升级。

5.1 升级流程（通用）

1. 修改 pom.xml：在 <dependencies> 中调整依赖的版本号（例如将 xworker_swt_thingeditor 的版本升级到最新 2.0.x），或新增你需要的类库依赖。
2. 运行安装程序：
   执行安装与升级

   java -jar xworker-2.0.4-SNAPSHOT.jar

3. 因为此时目录下已存在 pom.xml，程序会直接使用现有 pom.xml 执行构建（不会让你重新选择版本），拉取新版依赖并更新 lib/mvn、lib_rap 等目录及初始化索引。
4. 重启 XWorker：关闭后重新执行 xworker.cmd（Windows）或 ./xworker.sh（Linux/macOS），即完成升级。

5.2 举个升级例子

假设你想把 XWorker 从当前版本升到新版本，只需在 pom.xml 中把依赖版本号提高：

<!-- 修改前 -->
<dependency>
    <groupId>org.xworker</groupId>
    <artifactId>xworker_swt_thingeditor</artifactId>
    <version>2.0.4-SNAPSHOT</version>
</dependency>

<!-- 修改后：升级到新版本 -->
<dependency>
    <groupId>org.xworker</groupId>
    <artifactId>xworker_swt_thingeditor</artifactId>
    <version>2.0.5-SNAPSHOT</version>
</dependency>

5.3 升级安装新类库

XWorker 通过 Maven 管理依赖，因此安装新的类库也是通过修改 pom.xml 添加依赖来实现的：

<!-- 在 <dependencies> 中新增一个类库依赖 -->
<dependency>
    <groupId>com.example</groupId>
    <artifactId>some-lib</artifactId>
    <version>1.0.0</version>
</dependency>

保存后重新运行 java -jar xworker-2.0.4-SNAPSHOT.jar，依赖就会被拉取并随之可用。这也印证了最初那句话：XWorker 本质是一个 Maven 管理的 Java 项目，安装、升级、增删依赖，全都统一收敛到 Maven 的 pom.xml 上。