1 简介

你可以通过以下方式体验苍穹开发：

• 低代码开发：访问在开发者工具（CosmicStudio）中已搭建的环境

• 高代码开发：本地安装IDEA，并在IDEA中安装苍穹开发助手，进行插件开发

    本文主要介绍高代码开发的环境配置，即个人本地开发环境搭建。低代码开发的环境搭建过程请参考环境安装。

    金蝶云·苍穹开发助手2.1.0及以上版本对苍穹Gradle项目的工程目录结构进行了全面设计。目录结构说明如下：

2 Gradle项目工程创建

2.1 IDEA内安装开发助手插件

    根据安装指南在IDEA中安装金蝶云·苍穹开发助手插件。

2.2 新增苍穹Gradle项目

    操作路径：File—>New—>Project—>左侧选择“金蝶云·苍穹Gradlle工程”—>填写相关内容—>创建完成。

填写字段描述如下：

    填写配置项后，点击“创建”，等待资源包下载、解压、更新、索引。项目创建过程中会优先从苍穹资源目录中查找苍穹依赖JAR包与静态资源，若资源目录中不存在苍穹开发资源，则从填写的资源地址中下载资源包。

    下载解压完毕后，IDEA会提示环境更新完毕，然后初始化Gradle工程，并按照配置导入项目依赖的JAR。此后，IDEA将对JAR包进行索引，请耐心等待一段时间。 

    若索引中断，可手动点击Gradle的刷新按钮，重新进行索引。  

    更新完毕后，会生成新的Gradle工程结构。 

    请阅读工程项目目录下的readme.md文件，了解常见的操作说明及相关网址。

2.3 检查配置

    运行新建的工程前，请检查或配置以下内容：

1. 提前启动MC服务。

2. 检查各配置项是否正确。若是本地开发，可以不修改MC及ZK的IP地址，用127.0.0.1即可。
   

3. 苍穹微服务端口默认为8881，可自行修改。苍穹访问地址：http://localhost:8881/ierp

4. 若服务器ZK有密码，开发环境要连接使用，需同步配置。

  5. 检查"gradle.properties"配置文件，确保已添加以下参考配置：

org.gradle.parallel=true
org.gradle.daemon=true
org.gradle.caching=true
org.gradle.jvmargs=-Xms512m -Xmx1024m -XX:MaxMetaspaceSize=256m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8

  6. 打开"gradlew"以及"gradlew.bat"脚本文件，在文件中查找"DEFAULT_JVM_OPTS"配置项，检查参数是否配置为如下：

• "gradlew"文件：

  DEFAULT_JVM_OPTS="-Xmx1024m" "-Xms256m"
  

• "gradlew.bat"文件：

  set DEFAULT_JVM_OPTS="-Xmx1024m" "-Xms256m"

  7. 检查IDEA的JVM参数，防止后续JVM内存不足或IDEA内存溢出。

2.4 启动苍穹工程

IDEA内运行程序后，输入苍穹访问地址，即可访问苍穹。

2.5 创建苍穹子应用模块

    若你想添加新的云或者应用，可在当前苍穹项目根目录下，按云、应用标识的目录结构，创建对应的苍穹子应用模块。

    操作路径：右键项目—>New—>Module—>填写云、应用标识—>创建

    创建后，等待Gradle刷新项目。刷新完成后，即可查看新创建的苍穹子应用模块。

2.6 更新开发环境资源

当服务器打完补丁后，服务端可通过“同步开发资源”生成最新版苍穹开发资源，供客户端开发环境下载、更新。

2.6.1 服务端更新资源

•  若你的环境是通过开发者工具创建，需在已创建的环境详情中执行“同步开发资源”操作。

    操作路径：开发者工具—>环境详情—>点击“同步开发资源”，等待生成最新的开发资源。

•  若你的环境是通过容器版或者虚拟机等其他方式创建，需在MC管理后台执行“同步开发资源”操作。

    操作路径：MC管理后台—>集群管理—>点击编码进入环境详情—>点击“同步开发资源”，获取开发文件地址（即环境资源地址）—>复制地址。

2.6.2 客户端更新资源

服务器端通过“同步开发资源”生成最新的环境资源地址后，客户端可通过开发助手的“更新环境”功能，更新开发环境。

注意事项：如果开发者本地的苍穹资源目录为本地CosmicStudio苍穹环境的目录，则不需要通过开发助手“更新环境”功能进行更新。

操作路径：IDEA—>顶部导航栏“苍穹开发助手”—>更新环境—>填写新的环境资源地址—>确定（OK）。

苍穹开发助手提供自动检测更新功能，在初次打开工程或开发过程中会定时检测版本的变化，如有新版则询问是否更新。你可根据需要打开或关闭该功能。

2.6.3 苍穹资源更新流程

以上为本地创建苍穹Gradle工程项目的基础说明，如需了解更多内容，请下载附件的说明手册！金蝶云·苍穹开发助手使用手册_20240118.pdf