安装

要开始使用Agda,请遵循以下三个步骤:

如果出现安装问题,请检查上的部分故障排除.

提示

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

步骤1:安装Agda

安装Agda至少有三个选项:

选项2:从源安装Agda的开发版本(适用于高级用户)

如果您想使用Agda编译器本身,或者您想使用最新版本的Agda,然后您可以从源代码中从Github存储库.

您应该安装GHC和Cabal(如果没有,请参阅选项1:将Agda安装为Haskell包(推荐)).

注释

对于开发版本启用群集计数默认情况下处于启用状态,所以除非你把它关掉(参见安装标志,如下),您还需要安装ICU图书馆.

安装亚历克斯幸福的依赖关系

Agda依赖于亚历克斯幸福的工具,但取决于您的系统和Cabal版本,这些可能不会自动安装。你可以使用Cabal手动安装:

阴谋集团 更新阴谋集团 安装 亚历克斯 幸福的

使用Cabal构建Agda

在Agda源代码树的顶级目录中,运行:

阴谋集团 更新制作 安装

使用堆栈构建Agda

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

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

选项3:将Agda作为预构建包安装

打包的Agda二进制文件和Agda标准库由各种包管理器提供。安装Agda二进制文件比从源代码安装Agda更快,但安装问题可能更难解决。

Agda的操作系统相关二进制安装由python安装程序.

警告

根据系统的不同,预构建包可能不包含最新版本的Agda。请参阅复活学获取各种包管理器上可用的Agda版本列表。

请参阅预装包和系统特定说明获取已知系统及其特定于系统的指令的列表。

步骤2:安装Agda标准库(Agda-stdlib)

大多数用户都希望安装标准库.您可以将其安装为任何其他Agda库(请参见图书馆管理).请参阅agda-stdlib项目的安装说明有关安装最新版本的步骤。

步骤3:为Agda安装和配置文本编辑器

在Agda中,您选择的文本编辑器比在大多数其他编程语言中更重要。这是因为Agda代码通常使用大量unicode符号,并且您通常会相互作用在编写程序时通过文本编辑器使用Agda。

最常见的选择是Emacs公司.其他对Agda提供交互式支持的编辑器包括

Emacs公司

Emacs对unicode输入有很好的支持agda-模式用于维护emacs由Agda开发人员在主Agda存储库中提供许多高级功能。

运行agda-模式程序

警告

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

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

agda-模式 设置

上述命令尝试通过Emacs模式。作为替代方法,您可以复制将以下文本发送给您.emacs(电子邮件)文件:

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

编译Emacs模式的文件夹:

agda-模式 编译

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

警告

如果重新安装Agda模式而不重新编译Emacs Lisp文件,然后Emacs可以继续使用旧的编译文件。

安装参考

故障排除

Windows上的一个常见问题:无效字节序列

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

hGetContents(获取内容): 无效 论点 (无效 字节 序列)

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

CHCP公司 65001

一个常见问题:缺少ieee754依赖项

使用GHC后端进行编译时,可能会出现以下错误:

汇编 错误:MAlonzo/RTE/Float.hs:6:1: 错误:    失败  负载 接口 对于 '数字。IEEE’    使用 -v(v)  看见  列表 属于 这个 文件夹 已搜索 的。

这是因为软件包在Cabal商店中被沙盒(例如。$HOME/.cabal/store($HOME/.cabal/商店))并且必须在GHC环境.这可以通过运行以下命令来完成:

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

这将注册第754页在GHC默认环境中。

由于动态链接问题,Cabal安装失败

如果您有设置可执行动态: 真的在您的阴谋集团配置中则在Linux和Windows上安装可能会失败。

治愈:更改为默认值可执行动态: False(错误).

更多信息:

阿格达和哈斯克尔

测试的GHC版本

Agda已通过GHC 8.6.5、8.8.4、8.10.7、9.0.2、9.2.8、9.4.8、9.6.6、,9.8.2和GHC 9.10.1。

安装标志

安装Agda时,可以使用以下标志:

调试

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

调试串行化

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

调试传递

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

启用群集计数

启用集群计数.这将需要text-icu Haskell库,这反过来要求安装ICU.注意,如果启用群集计数False(错误),然后选择--计数群集给Agda时触发错误消息。默认值:关闭,但对于开发版本为打开。

高度优化

大幅优化阿格达。(在这种情况下,限制GHC的内存使用。)默认设置:禁用。

提示

期间阴谋集团 安装可以使用-(f)参数:阴谋集团 安装 -fenable-cluster计数。而堆栈使用--旗帜和一个阿格达:前缀,如下所示:堆栈 安装 --旗帜 Agda:启用群集计数.

安装ICU

如果启用了群集计数(请参阅启用群集计数上面的标志,已启用默认情况下),则需要重症监护室图书馆待安装。请参阅text-icu先决条件文档了解如何在您的系统上安装ICU。

保持默认环境干净

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

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

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

GHC_环境=阿格达 阿格达 -c(c) 你好,世界,阿格达

注释

实际上,没有必要注册Agda库,但这样做迫使Cabal安装相同版本的第754页如Agda所用。

安装Agda的多个版本

可以使用--程序后缀标志。例如:

阴谋集团 安装 阿格达-2.6.4.3 --程序后缀=-2.6.4.3

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

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

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

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

预装包和系统特定说明

建议安装Agda的方法是通过阴谋集团,但在某些情况下,您可能希望改用系统的包管理器:

架构Linux

以下预构建包可用:

如果出现安装问题,请咨询问题跟踪器<https://gitlab.archlinux.org/archlinux/packaging/packages/agda/-/issues>_.

Debian/Ubuntu

从Karmic开始,Debian和Ubuntu都可以使用预构建包。安装步骤:

恰当的 安装 阿格达

这应该会安装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。

自由BSD

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

GNU吉他

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

贵宾 安装 阿格达 agda-stdlib型

您还可以通过运行以下命令安装特定版本:

贵宾 安装 agda@弗 agda-stdlib@版本

哪里版本是特定的版本号。

程序包源:

Nix或NixOS

Agda是Nixpkgs系列的一部分https://nixos.org/nixos。通过以下方式安装Agda(和标准库):

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

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

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

nix-env -(f) “<nixpkgs>” -国际机场 阿格达agda-模式 设置

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

Nix非常灵活,我们只描述了如何安装Agda全球使用nix环境。还可以声明哪些包在配置文件中全局安装或拉入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(电子邮件)文件。

Python安装程序(pip(点阵))

Agda的OS-independent二进制安装通过Python安装程序提供:

pip(点阵) 安装 阿格达

更多信息:https://pypi.org/project/agda/

窗户

与Emacs和必要的数学字体,可在网址:http://www.cs.uiowa.edu/~astump/agda.

  • Agda 2.6.0.1与Emacs 26.1捆绑

  • Agda 2.6.2.2…

警告

这些是Agda的旧版本。最好使用阴谋集团安装的Agda而不是。