macOS 下安装 GMT

贡献者: 田冬冬

macOS 下可以直接使用 GMT 提供的安装包，也可以使用 Homebrew 或 Macports 软件管理工具进行安装。推荐使用Homebrew。

使用 Homebrew 安装

Homebrew 是 macOS 下的第三方软件包管理工具。未安装 Homebrew 的用户，可以参考《macOS 配置指南》了解如何安装与使用。

安装 GMT

更新 Homebrew 以及软件包描述文件，并更新所有已安装的软件包:
```
$ brew update && brew upgrade
```
安装最新的 GMT 稳定版本:
```
$ brew install gmt
```
也可以安装 GMT 开发版本（即 GMT 源码的 master 分支）:
```
$ brew install gmt --HEAD
```
安装 GMT 依赖的其它软件

生成 PDF、JPG 等图片格式需要 Ghostscript（必须）:
```
$ brew install ghostscript
```
制作 GIF 格式的动画需要 GraphicsMagick（可选）:
```
$ brew install graphicsmagick
```
制作 MP4、WebM 格式的动画需要 FFmpeg（可选）:
```
$ brew install ffmpeg
```
测试安装

重新打开一个终端，键入如下命令，若正确显示 GMT 版本号，则表示安装成功:
```
$ gmt --version
6.3.0
```
升级 GMT

GMT 新版本发布后，执行如下命令升级 GMT:
```
$ brew upgrade gmt
```
卸载 GMT

可以执行如下命令卸载 GMT:
```
$ brew uninstall gmt
```

使用 GMT 安装包

GMT 为 macOS 用户提供了 dmg 安装包，其不仅包含了 GMT，还包含了运行 GMT 所需的 Ghostscript、GDAL、GraphicsMagick 和 FFmpeg，可以直接双击安装使用。

备注

GMT 的 dmg 安装包只支持 macOS >= 10.15。

下载
- Intel：gmt-6.3.0-darwin-x86_64.dmg
- ARM：gmt-6.3.0-darwin-arm64.dmg
双击 dmg 包，在弹出的 Finder 窗口中，将 GMT-6.3.0.app 拖动到 Applications 目录
在 Finder 的左侧边栏中点击 Applications，找到 GMT 图标并右键点击，按下 option 键的同时鼠标点击“Open”选项。此时 macOS 系统会弹出警告窗口：“无法打开 GMT。因为 Apple 无法检测其是否为恶意软件”。在弹出的警告窗口中点击“Open”以忽略这一警告，并直接打开 GMT。

GMT 会启动一个终端并显示欢迎信息。根据欢迎信息中的提示将如下语句添加到 ~/.zshrc 中以修改环境变量:

export GMTHOME=/Applications/GMT-6.3.0.app/Contents/Resources
export PATH=${GMTHOME}/bin:${PATH}
export PROJ_LIB=$GMTHOME/share/proj
export GS_LIB=${GMTHOME}/share/ghostscript/9.53.3/Resource/Init
export MAGICK_CONFIGURE_PATH=$GMTHOME/lib/GraphicsMagick/config

备注

以上 export 语句仅供参考，请务必根据你看到的 GMT 欢迎信息中的提示修改环境变量。

打开一个终端，输入如下命令，检测安装是否成功:
```
$ gmt --version
6.3.0
```
卸载 GMT

若想要卸载 GMT，可直接到 /Applications 目录下找到 GMT，直接删除即可。
升级 GMT

GMT 包不支持自动升级，因而要先删除旧 GMT 包，再下载新版安装包并按照上面的步骤重新安装，即实现升级 GMT。

使用 Macports 安装

Macports 是 macOS 下的第三方软件包管理工具。

安装 GMT:

$ sudo port install gdal +hdf5 +netcdf +openjpeg
$ sudo port install gmt6

GMT 会安装在 /opt/local/lib/gmt6/ 目录下，需要将其 bin 目录添加至环境变量 PATH 中:
```
$ echo 'export PATH=/opt/local/lib/gmt6/bin:$PATH' >> ~/.zshrc
```
安装 GMT 依赖的其他软件

制作 GIF 格式的动画需要 GraphicsMagick（可选）:
```
$ sudo port install graphicsmagick
```
制作 MP4、WebM 格式的动画需要 FFmpeg（可选）:
```
$ sudo port install ffmpeg
```
重新打开一个终端，检测安装是否成功:
```
$ gmt --version
6.3.0
```
升级 GMT。当有新版本发布时，可以执行如下命令升级 GMT:
```
$ sudo port selfupdate
$ sudo port upgrade gmt6
```
如果需要卸载 GMT，可以执行如下命令:
```
$ sudo port uninstall gmt6
```