安装 GDK

星河低代码开发包（GDK, Galaxy Development Kit） 是本地化开发的基础工具，安装到开发者本机，为开发者提供本地化的开发环境和工具支持，包括创建项目、管理依赖、IDE开发调试支持、云地协同开发、团队协同开发等。

环境准备

• JDK 要求 JDK 1.8 ，推荐 Hotspot JDK 1.8 或 OpenJDK 1.8 。

参考：《安装 JDK》

• Maven 要求 Maven 3.0 以上，本教程使用 Maven 3.8.4 。

参考：《安装 Maven》

• NodeJS 要求 NodeJS 16.0 以上，本教程使用 NodeJS 21 。

参考：《安装 NodeJS》

安装注册

• 从 下载中心 下载 GDK 安装包。
• 将 GDK 安装包解压缩到一个目录，该安装目录称为的 主目录(HOME)。
• 注册 GDK 安装目录。
• 启动 GDK 控制台。

下载安装包

打开 下载中心 页面，选择下载 gdk 的最新版本。

• .RELEASE 结尾的是正式发布的稳定版，包含经过充分验证的稳定功能。
• -SNAPSHOT结尾的是预发布验证的快照版，包含即将正式发布的最新功能。

下需要关注的目录和文件如下：

GALAXY_HOME
  |—— bin                     # 可执行脚本目录
  |   |__ gdk.sh              # GDK脚本（MacOS / Linux）；
  |   |__ gdk.bat             # GDK脚本（Windows）；
  |   |__ gdk-reg.sh          # 注册GDK（MacOS / Linux）；
  |   |__ gdk-reg.bat         # 注册GDK（Windows）；
  |   |__ gdk-version.sh      # 查看GDK版本（MacOS / Linux）；
  |   |__ gdk-version.bat     # 查看GDK版本（Windows）；
  |   |__ gdk-env.sh          # 注册GDK环境变量（MacOS / Linux）；
  |   |__ gdk-env.bat         # 注册GDK环境变量（Windows）；
  |   |__ gdk-start.sh        # 启动GDK控制台（MacOS / Linux）；
  |   |__ gdk-stop.bat        # 停止GDK控制台（Windows）；
  |
  |—— con 
  |   |__ server.conf         # 应用服务器配置； 
  |   |__ log4j2.xml          # 日志配置； 
  |
  |__ libs                    # 公共代码库；
  |
  |__ galaxy                  # GDK核心库；
        

注册

• 执行 HOME 目录下的注册安装脚本（bin/gdk-reg.sh 或 bin/gdk-reg.bat） 将 GDK 注册到当前安装目录。

cd $GALAXY_HOME/bin

chmod +x *.sh # 赋予脚本可执行权限

./gdk-reg.sh

cd %GALAXY_HOME%/bin

gdk-reg.bat

Windows操作系统下，需以管理员身份执行。 Linux 或 MacOS 操作系统下，需要先赋予脚本执行权限。 注册时，会提示是否“注册环境变量”，这是可选的步骤。

执行成功后，显示如下结果：

查看 GDK 版本

cd $GALAXY_HOME/bin

./gdk-version.sh

cd %GALAXY_HOME%/bin

gdk-version.bat

执行成功后，显示如下结果：

启动 GDK 控制台

GDK 控制台管理本地开发的工具，提供了一些便利的命令操作，同时也提供了与云上的星河低代码开发中心进行连接登录和协同的操作入口，帮助开发者进行云地协同开发。

cd $GALAXY_HOME/bin

./gdk-start.sh

cd %GALAXY_HOME%/bin

gdk-start.bat

GDK 控制台的启动过程会以本地环回地址 127.0.0.1 默认端口 9087 开启 SSH 服务，然后通过 SSH 客户端接入控制台服务。

进入控制台后，按 TAB 键显示所有的可执行命令。

注意，首次执行时，由于这是 SSH 客户端首次连接到地址 [127.0.0.1]:9087，所以可能会做出如下的提示。如遇到此情况，输入 yes 继续执行。

The authenticity of host '[127.0.0.1]:9087 ([127.0.0.1]:9087)' can't be established.
RSA key fingerprint is SHA256:qXxKNXP6Dg7TVrpxqUyEDoU4YWdpSM264N2nO+0rmVQ.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])?

至此，恭喜你，GDK 安装成功！

关于 GDK 的更多内容，请查看《GDK 控制台参考》

下一步

在正式开始星河低代码的应用开发之前，应先安装 MongoDB 数据库，具体参考：《安装 MongoDB》

建议！！！

建议为 MongoDB 配置复制集，使其支持数据库事务！！