设置

本节讨论开发 Astraios 的一次性设置。

为本地开发做好准备

安装 Java & Maven (Mac版)

brew update
brew install openjdk@17

在最后一个命令提示符的末尾，将显示如下内容：

For the system Java wrappers to find this JDK, symlink it with
  sudo ln -sfn ...openjdk@17/libexec/openjdk.jdk .../JavaVirtualMachines/openjdk-17.jdk

openjdk@17 is keg-only, which means it was not symlinked into /usr/local,
because this is an alternate version of another formula.

If you need to have openjdk@17 first in your PATH, run:
  echo 'export PATH=".../openjdk@17/bin:$PATH"' >> .../.bash_profile

For compilers to find openjdk@17 you may need to set:
  export CPPFLAGS="-I.../openjdk@17/include"

确保执行上面的 sudo ln -sfn、 echo 'export PATH=...、 和 export CPPFLAGS= 命令

提示

Maven 使用单独的 JDK 版本，可以通过 mvn -v 查看。如果不是 JDK 17，我们应该使用 JAVA_HOME 让 Maven 指定我们的 JDK 17 ：

$ /usr/libexec/java_home
/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home

$ export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home

如果我们在输入查看版本的命令后看到类似的内容，我们就可以开始了

$ java --version
openjdk 17.0.10 2021-01-19
OpenJDK Runtime Environment (build 17.0.10+9)
OpenJDK 64-Bit Server VM (build 17.0.10+9, mixed mode)

安装 Docker Engine

Astraios 有基于 Docker 的集成测试；它还支持在 Docker Compose 中运行。 Docker 可以按照官方说明进行安装

获取源代码

git clone git@github.com:paion-data/astraios.git
cd astraios

与 IntelliJ 同步 Astraios 的代码风格

目前，我们已经提炼了与Astraios的代码相关的最重要的代码风格约定，作为IntelliJ的设置。如果IntelliJ用于IDE，我们可以通过导入repo根目录下的 Astraios-Project-intellij-code-style.xml 文件来导入这些代码风格设置。项目的设置将在IDE的 编辑器 -> 代码样式 部分下显示为名为 “Astraios-Project” 的新方案。

另外，还请通过 Editor -> General -> Auto Import -> Optimize Imports on the Fly 开启自动无用 import 移除功能。