Linux 版本工具链的支持与安装

适用于各 Linux 发行版的仓颉工具链依赖安装命令

注意：

当前仓颉工具链依赖的部分工具在一些 Linux 发行版上可能无法通过系统默认软件源直接安装，你可以参考下一节“编译安装依赖工具”进行手动安装。

SLES 12-SP5

$ zypper install \
         binutils \
         glibc-devel \
         gcc-c++

此外，还需要安装 OpenSSL 3，安装方法请参考[编译安装依赖工具](## 编译安装依赖工具)。

Ubuntu 18.04

$ apt-get install \
          binutils \
          libc-dev \
          libc++-dev \
          libgcc-7-dev \

此外，还需要安装 OpenSSL 3，安装方法请参考[编译安装依赖工具](## 编译安装依赖工具)。

Ubuntu 20.04

$ apt-get install \
          binutils \
          libc-dev \
          libc++-dev \
          libgcc-9-dev \

此外，还需要安装 OpenSSL 3，安装方法请参考[编译安装依赖工具](## 编译安装依赖工具)。

EulerOS R11

$ yum install binutils \
              glibc-devel \
              gcc

其他 Linux 发行版

根据使用的 Linux 发行版的不同，你可能需要参考以上系统的依赖安装命令，使用你的系统包管理工具安装对应依赖。若你使用的系统没有提供相关软件包，你可能需要自行安装链接工具、C 语言开发工具、C++ 开发工具、GCC 编译器、以及 OpenSSL 3 以正常使用仓颉工具链。

编译安装依赖工具

当前仓颉工具链中的部分标准库（以及部分工具）使用了 OpenSSL 3 开源软件。对于系统包管理工具未提供 OpenSSL 3 的场景，用户可能需要源码编译安装 OpenSSL 3，本节提供了 OpenSSL 3 源码编译的方法和步骤。

OpenSSL 3

从以下链接可以下载到 OpenSSL 3 的源码：

https://www.openssl.org/source/
https://www.openssl.org/source/old/

建议使用 openssl-3.0.7 或更高版本。

注意：

请在执行以下编译和安装命令前仔细阅读注意事项，并根据实际情况调整命令。不正确的配置和安装可能会导致系统其他软件不可用。如果在编译安装过程中遇到问题或希望进行额外的安装配置，请参考 OpenSSL 源码中的 INSTALL 文件或 OpenSSL 的 FAQ。

此处以 openssl-3.0.7 为例，下载后使用以下命令解压压缩包：

$ tar xf openssl-3.0.7.tar.gz

解压完成后进入目录：

$ cd openssl-3.0.7

编译 OpenSSL：

注意：

如果你的系统已经安装了 OpenSSL，建议使用 --prefix=<path> 选项指定一个自定义安装路径，例如 --prefix=/usr/local/openssl-3.0.7 或你的个人目录。在系统目录已经存在 OpenSSL 的场景下直接使用以下命令编译安装可能会使系统 OpenSSL 被覆盖，并导致依赖系统 OpenSSL 的应用不可用。

$ ./Configure --libdir=lib
$ make

测试 OpenSSL：

$ make test

将 OpenSSL 安装至系统目录（或你先前指定的 --prefix 目录），你可能需要提供 root 权限以成功执行以下命令：

$ make install

或

$ sudo make install

如果先前编译 OpenSSL 时没有通过 --prefix 设置自定义安装路径，你的 OpenSSL 安装已经完成了。如果先前通过 --prefix 指定了自定义的安装路径，你还需要设置以下变量，以使仓颉工具链可以找到 OpenSSL 3。

注意：

如果你的系统中原先存在其他版本的 OpenSSL，通过以下方式配置后，除了仓颉工具链外，你的其他编译开发工具默认使用的 OpenSSL 版本也可能受到影响。如果使用其他编译开发工具时出现 OpenSSL 不兼容的情况，请仅为仓颉开发环境配置以下变量。

请将 <prefix> 替换为你指定的自定义安装路径。

$ export LIBRARY_PATH=<prefix>/lib:$LIBRARY_PATH
$ export LD_LIBRARY_PATH=<prefix>/lib:$LD_LIBRARY_PATH

通过以上方式所配置的环境变量仅在当前执行命令的 shell 会话窗口有效。若希望 shell 每次启动时都自动配置，你可以在 $HOME/.bashrc、$HOME/.zshrc 或其他 shell 配置文件（依你的 shell 种类而定）加入以上命令。

若希望配置可以默认对所有用户生效，你可以执行以下命令：

请将 <prefix> 替换为你指定的自定义安装路径。

$ echo "export LIBRARY_PATH=<prefix>/lib:$LIBRARY_PATH" >> /etc/profile
$ echo "<prefix>/lib" >> /etc/ld.so.conf
$ ldconfig

执行完毕后重新打开 shell 会话窗口即可生效。

至此，OpenSSL 3 已经成功安装，你可以回到原来的章节继续阅读或尝试运行仓颉编译器了。

仓颉语言用户指南