IDEA助手操作手册（协同开发平台在线构建）
1 IDEA助手下载与安装
1.1 IDEA助手下载
（1）下载地址：
https://prod.cosmicstudio.cn/开发助手/kingdee-developer-tools-for-idea-2.2.0-Beta-58.zip
（2）支持版本说明：
IDEA助手目前支持的IDEA版本为支持IntelliJ IDEA 2021.3.x~2023.2.x 版本，本操作手册示例使用的版本为IntelliJ IDEA 2023.2.5 (Community Edition)，并安装中文插件，使用的IDEA开发助手版本为2.2.0-Beta-57。
1.2 安装方法
步骤一：打开IDEA界面，依次点击【文件】【设置】【插件】【小齿轮】【从磁盘安装插件】，如下图：
步骤二：选择本地已提前下载好的插件安装文件（此处文件名称只作示例，请按下载的实际版本文件名称选择），点击【确定】如下图：
步骤三：重启IDEA
步骤四：当IDEA重启完毕，菜单栏显示【苍穹开发助手】即代表安装成功
步骤五：Git配置检查，进入【文件】【设置】【版本控制】【Git】，若没有预置的Git可使用IDEA自带的安装功能进行安装。若PC是第一次安装Git，建议安装完毕后，重启以一次IDEA再进行后续操作，推荐使用Git-2.37.1-64-bit版本或以上。
请确保本地已安装Git并在IDEA中测试成功，如下图所示：
2 苍穹gradle工程初始化
2.1 线上新建协同开发平台工程
步骤一：进入协同开发平台，按界面所要求的字段新建好协同开发平台项目，记下新建工程的代码仓地址：
步骤二：协同开发平台的kingcode（代码托管）账号激活：
kingcode密码修改请参考链接：https://vip.kingdee.com/link/s/lBDlY
kingcode账号激活请参考链接：https://vip.kingdee.com/link/s/lBDGi
步骤三：登录kingcode代码仓，当代码仓出现如下几个文件及文件夹，即代表代码仓初始化完成：
2.2 使用IDEA助手初始化工程
步骤一：【文件】【新建】【项目】【北斗项目工程生成器】，依次点击下一步
步骤二：进入【代码仓地址配置】界面，填写代码仓的地址及项目本地目录，点击【下一步】后会弹出kingcode登录认证，请填写kingcode账号及密码：
步骤三：当小助手连通代码仓后，会自动进入【工程信息填写】界面，填写完毕后点击【完成】：
字段填写说明：
1） 苍穹模板：星空旗舰版推荐使用“一个云一个工程”的模板；
2） 开发商标识、项目标识：从远程代码仓的工程配置文件自动带出，无需填写，不能修改；
3） 云标识：填写云编码，必填；
4） 应用标识：默认值为app，非必填，可清空；
5） 服务器信息：根据实际情况填写开发服务器的资源下载地址（本地工程构建依赖下载地址），mc地址和zk地址；
步骤四：点击【完成】后，IDEA会自动创建本地的工程目录。待工程目录新建完毕后，已自动完成本地仓库的新建及远程仓库的对接
步骤五：需等待本地工程依赖jar包下载完毕及依赖自动刷新，当依赖文件已成功下载并引入，截止到这一步，工程及本地环境已初始化完毕，如下图：
2.3 将工程提交至代码仓
步骤一：进入IDEA的Git管理界面，选择需要提交到代码仓的文件（由于是初始化，本示例选择提交所有文件，可根据实际情况删减不必要提交的文件或者目录，如.idea .gradle等）
步骤二：填写本次commit日志，本示例以“代码仓初始化”为例，并选择【提交并推送】，将代码提交并推送至远程仓库
查看远程仓库日志，代码已被成功提交：
2.4 线上启动在线构建
步骤一：进入协同开发平台项目列表，选择项目，点击【在线构建】，进行第一次构建测试
步骤二：待构建完毕，进入制品列表，选择项目，查看制品及扫描报告
3 苍穹工程日常团队开发
当代码仓初始化完毕后，团队成员可以通过以下方法拉取远程代码并运行本地工程，实现插件代码开发及调试。
3.1 从代码仓拉取代码
步骤一：【文件】【新建】【来自版本控制的项目】【填写代码仓链接】后点击【克隆】
步骤二：输入kingcode账号和密码，将代码仓拉到本地
3.2 使用IDEA助手拉取版本构建依赖
步骤一：当代码拉取成功后，可修改gradle.properties中的systemProp.cosmic_home参数，调整构建依赖的本地存放目录：
步骤二：点击【苍穹开发助手】菜单【更新苍穹资源包】，填写或调整开发服务器资源下载地址后点击【确定】：
步骤三：当依赖jar包下载并解压完毕，若工程没有自动刷新，可点击IDEA右侧gradle工程的刷新按钮刷新依赖引入
等待依赖关系自动刷新，待依赖被成功引入后，本地工程就初始化完毕了
3.3 运行本地debug工程
步骤一：待工程刷新完毕后，视实际情况调整DebugApplication.java里面的参数（若团队均连同一开发服务器，可不调整，若开发成员连的开发服务器不一样，则需要按需调整启动类中的mc和zk地址等参数）
步骤二：打开DebugApplication.java点击【运行】按钮
步骤三：通过http://127.0.0.1:8881/ierp/login.html 访问本地环境
4 三方包的引入
当工程使用到第三方jar包，可以通过以下方式引入：
步骤一：将三方包放到工程code/lib目录下，修改工程config.gradle文件，增加lib目录三方包引入：
lib : rootDir.path + "/code/lib"
步骤二：修改code/base/common工程的build.gradle文件，引入lib目录的依赖包：
def lib = ext.path.lib
api fileTree(dir: lib, include: '*.jar')
步骤三：本地构建测试成功后，可以将上述代码及文件改动提交至远程仓库后进行构建，生成的补丁包会内置lib目录内提交的三方包，如下图：
5 工程新增子模块
步骤一：【文件】【新建】【新模块】【北斗项目工程生成器】，填写【云标识】（开发商标识、项目标识不能修改）
步骤二：子模块自动新建完毕，如下图：
6 常见问题
1） 初始化代码仓时，填写了代码仓地址点击【下一步】，没有弹出登录认证，助手直接进入了【填写工程信息】界面。
解决方法：无需解决，继续填写工程信息即可。没有弹出登录认证，可能是用户本地已经提前登录过kingcode，凭据已经被存储在本地缓存中，所以自动校验通过，如下图：
2） 代码仓初始化时，连不上远程代码仓，出现类似如下报错：
解决方法：可提前在本地使用TortoiseGit、IDEA自带的版本控制管理等软件先连接一次远程代码仓，先测试本地PC能连通远程代码仓，然后再通过苍穹IDEA小助手进行代码仓初始化，如下图。
