张帆
张帆
Published on 2026-08-26 / 44 Visits
0
0

TypeScript扩展脚本开发手册

1. 准备工作

1.1 创建开发者个人分支

进入 Git 为 sie-imom-scripts 项目创建开发者个人分支:

● 地址: http://192.168.168.207:30033/admin/sie-imom-scripts

 

2. 后端项目运行

2.1 拉取后端项目

 

git clone http://192.168.175.208/imom/public/imom-application.git

2.2 后端代码分支

● 分支名称: dev

2.3 运行模块

运行 imom-server 模块

2.4 TS本地存储目录结构

类型

路径

默认代码存储根目录

D:/SieWebApiDev_data

开发者代码目录

D:/SieWebApiDev_data/.dev/<开发者账号>

示例: D:/SieWebApiDev_data/.dev/zhangfan

2.5 Clone 开发者代码

进入开发者代码目录 clone 代码:

 

cd D:/SieWebApiDev_data/.dev/<你的账号>
git clone http://192.168.168.207:30033/admin/sie-imom-scripts.git

2.6 切换分支

切换到开发者自己的分支:

 

git checkout -b zhangfan origin/zhangfan

注意: 检出的文件夹名称默认是 sie-imom-scripts,请手工改为 apps。后续本地提交代码都在 D:/SieWebApiDev_data/.dev/<用户名>/apps 目录采用 Git 操作。

2.7 发布 Dev 环境

如果需要发布 dev 环境:

1. 将开发者自己的分支合并到 master 分支

2. 在 dev 环境的开发平台点击按钮:【运行环境】获取 gitea 最新代码

 

3. 开发平台前端项目运行(Nginx 方式)

3.1 启动前端

前端已打包为 Nginx,直接启动 Nginx 程序即可。

3.2 访问前端

浏览器访问:http://localhost:3001/_Admin/dev-mode

3.3 设置开发者模式

1. 点击右上角开发者

2. 输入自己的用户名切换进入开发者工作空间, 例如:zhangfan

3. 使用postman测试开发接口时, 需要增加header:Session-Key,用来区分不同的开发空间,例如:Session-Key:zhangfan

4. 请求要带上IMOM的Token

 

目录结构总览

 

D:/SieWebApiDev_data/
├── .dev/
│   ├── <开发者账号>/
│   │   └── apps/              (sie-imom-scripts 代码)
│   └── ...
└── ...
 
imom-application/              (后端项目)
└── imom-server/               (运行模块)
 
Nginx/                         (前端,已打包)

 

快速开始 checklist

● [ ] 创建开发者个人分支

● [ ] 拉取后端项目并切换到 dev 分支

● [ ] 运行 imom-server 模块

● [ ] 在开发者目录 clone 代码并切换到个人分支

● [ ] 将代码目录从 sie-imom-scripts 改为 apps

● [ ] 启动 Nginx 前端服务

● [ ] 访问 http://localhost:3001/_Admin/dev-mode

● [ ] 设置开发者用户名进入工作空间

 

常见问题

问题

解决方案

分支名称冲突

确保使用个人专属分支名

代码目录名称

clone 后需手动将 sie-imom-scripts 改为 apps

前端无法访问

确认 Nginx 服务已启动

无法进入开发者空间

检查用户名是否正确,如:zhangfan

java服务更新后, 但是s.service点不出提示

前端页面点击按钮: 【开发者环境】从运行环境同步代码

开发平台无法进入TS断点

使用idea启动项目时修改应用的启动配置,Add VM options 配置: --module-path=imom-server/target/dependency --add-modules=org.graalvm.polyglot,org.graalvm.truffle,org.graalvm.js,org.graalvm.truffle.runtime,com.oracle.truffle.enterprise,org.graalvm.truffle.compiler,com.oracle.truffle.regex,org.graalvm.jniutils,org.graalvm.collections,org.graalvm.nativeimage,org.graalvm.shadowed.icu4j,org.graalvm.shadowed.org.json,org.graalvm.nativebridge,org.graalvm.word --add-exports=org.graalvm.truffle/com.oracle.truffle.api.debug.impl=ALL-UNNAMED

 

如果没有imom-server/target/dependency目录的话,执行maven的compile命令自动创建

jdk版本统一使用GraalVM

graalvm-jdk-21

 


Comment