安装

有几种安装Agda的方法：

可以使用不同的标志安装Agda（请参阅安装标志).

提示

如果您想在不安装Agda的情况下偷看它，请尝试Agda Pad公司

从源安装

步骤1：先决条件

您需要以下程序的最新版本才能编译Agda：

您还应该确保程序由电缆安装位于shell的搜索路径上。安装位置按字段描述安装目录在阴谋集团结构中（检查~/.cabal/config; 默认为~/.电缆/箱子).因此，例如在Ubuntu或macOS下，您可能需要添加

出口 路径=~/.电缆/箱子：$路径

到您的.配置文件或.bash_配置文件.

非Windows用户需要确保图书馆zlib公司和ncurses公司已安装（请参见网址：http://zlib.net和http://www.gnu.org/software/ncurses/). 您的包管理器可能是能够为您安装这些文件。例如，在Debian或Ubuntu上它应该足够跑了

适配基 安装 zlib1g-dev软件 libncurses5-dev公司

以root身份安装正确的文件。

ICU和集群计数

也可以选择安装重症监护室图书馆，用于实现--计数群集选项。安装并配置ICU库后，可以启用--计数群集选项通过提供启用群集计数标记为阴谋集团安装:

阴谋集团 安装 -（f） 启用群集计数

有关在各种操作系统上安装ICU先决条件的信息，请访问https://github.com/haskell/text-icu/blob/master/README.markdown#前提条件（检索日期：2022-02-09）。

  • 在Debian或Ubuntu下安装可能就足够了利比亚迪夫.

  • 在macOS下，尝试酿造 安装 icu4c.请注意，这将在非标准位置安装ICU。您可能需要设置

    出口 包装_配置_路径="$(酿造 --前缀)/opt/icu4c/lib/pkgconfig“

    请参见酿造 信息 icu4c了解详细信息。

步骤2：安装阿格达和agda-模式程序

安装后先决条件你可以从安装Agda的最新发布版本黑客攻击.

使用阴谋集团

用于安装阿格达和agda-模式程序使用阴谋集团运行以下命令：

阴谋集团 更新阴谋集团 安装 阿格达

如果您使用Nix风格的本地构建,使用Cabal≥3.0或运行阴谋集团 v2安装，你会得到使用GHC后端编译时出现以下错误：

汇编 错误：MAlonzo/RTE.hs:13:1: 错误：    失败 到 负载 接口 对于 '数字。IEEE标准    使用 -v（v） 到 看见 一 列表 属于 这个 文件夹 已搜索 的。

这是因为包在$HOME/.cabal/store（$HOME/.cabal/商店）并且必须在GHC环境.这可以通过运行以下命令来完成：

阴谋集团 v2安装 --图书馆 阿格达 第754页

这将注册ieee754标准在GHC默认环境中。

您可能希望保持默认环境干净，例如避免与其他已安装的软件包。在这种情况下，您可以创建单独的Agda环境，通过运行：

阴谋集团 v2安装 --包装-环境 阿格达 --图书馆 阿格达 ieee754标准

然后必须设置GHC_环境当您调用Agda时：

GHC_环境=阿格达 阿格达 -c（c） 你好，世界。阿格达

注释

实际上，没有必要注册Agda库，但这样做迫使Cabal安装相同版本的ieee754标准如Agda所用。

警告

如果您在Windows上使用Cabal安装Agda，取决于您的系统区域设置，阴谋集团 安装 阿格达可能因错误而失败消息：

hGetContents（获取内容）： 无效 论点 (无效 字节 序列)

如果发生这种情况，您可以尝试更改控制台代码页使用以下命令将其转换为UTF-8：

CHCP公司 65001

使用堆栈

用于安装阿格达和agda模式程序使用堆栈运行以下命令：

阴谋集团 得到 阿格达-X.Y.Z光盘 阿格达-X.Y.Z堆栈 --堆垛山药 堆叠-x.y.z.yaml 安装

更换X、Y、Z阿格达版本的黑客和整数解分别按您的GHC版本。

步骤3：运行agda-模式程序

警告：安装agda-模式通过梅尔帕不鼓励。强烈建议安装agda-模式对于电子邮箱如下所述：

安装后agda-模式程序使用阴谋集团或堆栈运行以下命令：

agda-模式 设置

上述命令尝试通过Emacs模式。作为替代方法，您可以复制将以下文本发送给您.emacs公司文件：

(加载文件 (让 ((读取的编码系统 'utf-8))
                (外壳命令到字符串 “agda-模式定位”)))

编译Emacs模式的文件夹：

agda-模式 编译

在某些情况下，这可以显著加快速度。

警告：如果重新安装Agda模式而不重新编译Emacs Lisp文件，那么Emacs可以继续使用旧的编译后的文件夹。

步骤4：安装标准库

如果您选择使用标准库，是使用的附加步骤单独的存储库.

预装包和系统特定说明

警告：根据系统的不同，预构建包可能不会最新版本。请参见https://repology.org/project/agda/versions.

体系结构Linux

以下预构建包可用：

然而，由于严重的打包错误，例如这，您可能希望使用其他安装方法。

Debian/Ubuntu

从Karmic开始，Debian和Ubuntu都可以使用预构建包。要安装：

适配基 安装 阿格达 agda-模式

这应该会安装Agda和Emacs模式。

从Lucid起，标准库在Debian和Ubuntu中可用。安装步骤：

适配基 安装 agda-stdlib型

更多信息：

报告错误：

请使用以下方法向Debian报告任何错误：

报告错误 -B类 debian公司 阿格达报告错误 -B debian公司 agda-stdlib型

费多拉/EPEL（Centos）

阿格达是包装好的用于Fedora Linux和EPEL。Agda-stdlib是可获得的为费多拉。

dnf公司 安装 阿格达 Agda-stdlib公司

将使用emacs模式和Agda-stdlib安装Agda。

GNU吉他

GNU Guix为这两者提供了包阿格达和agda-stdlib型。您可以通过运行以下命令安装最新版本：

贵宾 安装 阿格达 agda-stdlib型

您还可以通过运行以下程序安装特定版本：

贵宾 安装 agda@x.x.x agda-stdlib@x.x.x

其中x是特定的版本号。

程序包源：

自由BSD

程序包可从以下位置获得FreshPorts公司对于Agda和Agda标准库。

Nix或NixOS

Agda是Nixpkgs系列的一部分https://nixos.org/nixos。有两种方法可以从nix安装Agda：

  • 新方法：如果你正在跟踪nixos不稳定或nixpkgs不稳定（MacOS上的默认设置）或您正在使用NixOS版本20.09或更高版本，则您应该能够安装Agda（和标准库），通过：

    nix-env -（f） “<nixpkgs>” -国际教育协会 “nixpkgs:（nixpkgs{}）.agda.withPackages（p:[p.standard-library]）”agda-模式 设置回声 “标准实验室” > ~/.agda/默认值

    第二个命令尝试设置Agda emacs模式。如果出现以下情况，请跳过此项您不想设置emacs模式。请参见从安装来源有关的更多详细信息，请参见上文agda-模式 设置. The第三个命令设置标准实验室作为默认库，因此它总是对阿格达可用。如果你不想这样做，你可以忽略此步骤并基于每个项目控制库导入使用.agda-磅每个项目根目录中的文件。

    如果您不想通过nix安装标准库，那么您可以只能运行：

    nix-env -（f） “<nixpkgs>” -iA公司 阿格达agda-模式 设置

    有关nix中Agda基础设施的更多信息，以及如何使用nix管理和开发Agda库，请参阅https://nixos.org/manual/nixpkgs/unstable/#agda特别是agda.带包装函数可以安装更多库标准库。或者，请参见图书馆管理了解如何手动管理库。

  • 旧方法（已弃用）：因为Agda是可用的Haskell包从Hackage，您可以像安装任何其他Haskell软件包一样安装它：

    nix-env -（f） “<nixpkgs>” -国际机场 haskell软件包。阿格达agda-模式 设置

    此方法不为工作提供任何额外支持使用Agda库。请参见图书馆管理了解如何手动管理库。它也受到这种影响未决问题哪个是“新的”“方式”不是。

Nix非常灵活，我们只描述了如何安装Agda全球使用nix-env。还可以声明哪些包在配置文件中全局安装或引入Agda和一些特定项目的相关库使用nix外壳.

Agda-git存储库是一个尼克斯薄片允许在Nix中使用开发版本。薄片具有以下特性输出：

  • 覆盖：A零爆炸物 覆盖这使得haskell软件包。阿格达（其中顶层阿格达包依赖）是相关签出的构建。

  • haskellOverlay公司：覆盖haskell包其中覆盖了这个阿格达属性指向相关签出的构建。这可以用于在不同的属性名，或覆盖替代haskell包的Agda设置。

操作系统X

自制软件是一个免费的开源软件包为OS X提供预构建包的管理系统安装在系统中后，就可以安装agda了。打开终端应用程序并运行以下命令：

酿造 安装 阿格达agda-模式 设置

此过程将花费不到一分钟的时间，它会将Agda与它的Emacs模式及其标准库。有关酿造命令，请参阅自制文档和自制常见问题解答.

默认情况下，标准库安装在文件夹中/usr/local/lib/agda/。要使用标准库方便添加agda-lib文件的位置/usr/local/lib/agda/standard-library.agda-lib到~/.agda/库文件，并写入行标准实验室在里面这个~/.agda/默认值文件。为此，请运行以下命令：

mkdir公司 -第页 ~/.agda回声 $(酿造 --前缀)/lib/agda/standard-library.agda-lib >>~/.agda/库回声 标准实验室 >>~/.agda/默认值

请注意，此配置不会自动执行。你可以了解更多信息使用标准库或一般使用库.

也可以使用命令行选项关键字进行安装--头部.这需要从源头构建Agda。

要配置编辑agda文件的方式，请遵循一节Emacs模式.

注释

如果Emacs找不到agda-模式可执行文件，它可能有助于安装exec-path-from外壳通过执行打包M-x公司 软件包-安装 转塔 exec-path-from外壳 转塔并添加线条（exec-path-from-shell-initialize）到您的.emacs（电子邮件）文件。

窗户

与Emacs 26.1捆绑的Agda 2.6.0.1预编译版本必要的数学字体，可在网址：http://www.cs.uiowa.edu/~astump/agda.

安装开发版本

从Git获取开发版本后储存库

  • 安装先决条件.注意，对于开发版本启用群集计数默认情况下处于启用状态，因此，除非你设法关闭它，否则你还需要安装ICU图书馆.

  • 在Agda源代码树的顶级目录中，运行：

    阴谋集团 更新制作 安装

    要通过安装堆栈而不是阴谋集团，复制其中一个堆叠-x.y.z.yaml您选择的文件堆垛山药之前的文件运行制作。例如：

    内容提供商 堆叠-8.10.7.yaml 堆垛山药制作 安装

安装标志

安装Agda时，可以使用以下标志：

调试

启用调试打印。这使得Agda稍微慢了一点，并且建造Agda的速度也较慢。这个--详细={N}选项只有当Agda安装了此标志时才有效。默认设置：禁用。

调试序列化

在序列化中启用调试模式。这使得序列化速度变慢。默认设置：禁用。

调试传递

在分析器中启用调试模式。这使得解析速度变慢。默认设置：禁用。

启用群集计数

启用Agda选项--计数群集注意，如果启用群集计数是False（错误），然后选择--计数群集触发错误给阿格达的消息。默认值：关闭。

高度优化

大幅优化阿格达。（在这种情况下，限制GHC的内存使用。）默认设置：禁用。

安装Agda的多个版本

使用–program后缀标志可以同时安装多个版本的Agda。例如：

阴谋集团 安装 Agda-2.6.1型 --程序后缀=-2.6.1

将以agda-2.6.1的名称安装2.6.1版。然后可以切换到此版本通过Emacs中的Agda

抄送 C-x公司 首席执行官 2.6.1 返回

然后通过以下方式切换回Agda的标准版本：

抄送 C-x公司 首席执行官 返回