Flakes/zh: Difference between revisions
Updating to match new version of source page |
No edit summary |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 3: | Line 3: | ||
{{Cleanup}} | {{Cleanup}} | ||
'''Nix flakes''' 是 [[Nix]] 2.4 版本中首次引入的一项[https://nix.dev/manual/nix/stable/contributing/experimental-features 实验性功能]{{Cite manual|nix|development/experimental-features|number=13.8|title=Experimental Features|subsection=xp-feature-flakes|subtitle=flakes}}{{Cite manual|nix|release-notes/rl-2.4|number=14.27|title=Release 2.4 (2021-11-01)}}，旨在解决 Nix 生态系统许多领域的改进问题：它们为 Nix 项目提供了一个统一结构、允许固定每个依赖项的特定版本并通过锁文件共享这些依赖项，同时总体上使编写可复现的 Nix 表达式变得更加方便。 | |||
'''Nix flakes''' 是 [[Nix]] 2.4 版本中首次引入的一项[ | |||
Flake 是一个直接包含 <code>flake.nix</code> 文件的目录，该文件内容遵循一种特定结构。Flakes 引入了一种类似 URL 的语法{{Cite manual|nix|command-ref/new-cli/nix3-flake|number=8.5.17|title=nix flake|subsection=url-like-syntax|subtitle=URL-like syntax}} 来指定远程资源。为了简化这种 URL 语法，Flakes 使用符号标识符注册表{{Cite manual|nix|command-ref/new-cli/nix3-registry|number=8.5.62|title=nix registry}}，这允许通过类似 <code>github:NixOS/nixpkgs</code> 的语法直接指定资源。 | Flake 是一个直接包含 <code>flake.nix</code> 文件的目录，该文件内容遵循一种特定结构。Flakes 引入了一种类似 URL 的语法{{Cite manual|nix|command-ref/new-cli/nix3-flake|number=8.5.17|title=nix flake|subsection=url-like-syntax|subtitle=URL-like syntax}} 来指定远程资源。为了简化这种 URL 语法，Flakes 使用符号标识符注册表{{Cite manual|nix|command-ref/new-cli/nix3-registry|number=8.5.62|title=nix registry}}，这允许通过类似 <code>github:NixOS/nixpkgs</code> 的语法直接指定资源。 | ||
| Line 88: | Line 86: | ||
====Nix 独立程序==== | ====Nix 独立程序==== | ||
{{Note |[https://github.com/DeterminateSystems/nix-installer Determinate Nix 安装程序] 默认启用 Flakes 功能，但安装的是专有的 Determinate Nix。}} | |||
{{Note |[https://github.com/DeterminateSystems/nix-installer Determinate Nix 安装程序] 默认启用 Flakes 功能。}} | |||
添加如下内容至 <code>~/.config/nix/nix.conf</code> 或 <code>/etc/nix/nix.conf</code>: | 添加如下内容至 <code>~/.config/nix/nix.conf</code> 或 <code>/etc/nix/nix.conf</code>: | ||
| Line 164: | Line 160: | ||
==== 在 flake 仓库中构建特定属性 ==== | ==== 在 flake 仓库中构建特定属性 ==== | ||
运行 <code>nix build</code> 将在 <code>legacyPackages</code> 和 <code>packages</code> 输出属性中查找相应的 [[derivations|derivation]]，然后基于您的系统架构构建默认输出项。如果您想在 flake 仓库中指定构建属性，可以运行 <code>nix build .#<attr></code>。在上面的示例中，如果您想构建 <code>packages.x86_64-linux.hello</code> 属性，请运行： | |||
运行 <code>nix build</code> 将在 <code>legacyPackages</code> 和 <code>packages</code> 输出属性中查找相应的 [[ | |||
<syntaxHighlight lang=console> | <syntaxHighlight lang=console> | ||
| Line 239: | Line 233: | ||
=== 输出规范 === | === 输出规范 === | ||
[https://nix.dev/manual/nix/2.33/command-ref/new-cli/nix3-flake-check.html#evaluation-checks Nix flake check 手册页]中对输出规范进行了描述。 | |||
一旦 Inputs 被解析，它们就会与 <code>self</code> 一起传递给函数 <code>outputs</code>，<code>self</code> 是此 flake 在 Store 中的目录。<code>outputs</code> 根据以下规范返回 flake 的输出。 | 一旦 Inputs 被解析，它们就会与 <code>self</code> 一起传递给函数 <code>outputs</code>，<code>self</code> 是此 flake 在 Store 中的目录。<code>outputs</code> 根据以下规范返回 flake 的输出。 | ||
| Line 316: | Line 308: | ||
* {{Nixpkgs Manual|name=fetchurl|anchor=#sec-pkgs-fetchers-fetchurl-inputs}} 和 {{Nixpkgs Manual|name=fetchzip|anchor=#sec-pkgs-fetchers-fetchzip-inputs}} 需要传入 <code>sha256</code> 参数才会被视为纯函数。 | * {{Nixpkgs Manual|name=fetchurl|anchor=#sec-pkgs-fetchers-fetchurl-inputs}} 和 {{Nixpkgs Manual|name=fetchzip|anchor=#sec-pkgs-fetchers-fetchzip-inputs}} 需要传入 <code>sha256</code> 参数才会被视为纯函数。 | ||
* <code>builtins.currentSystem</code> 函数是非确定且不纯的，因为它返回的是执行推导的主机系统。通常可以通过将系统类型（例如 x86_64-linux）显式传递给需要它的 Derivations 来避免使用。 | |||
* <code>builtins.currentSystem</code> 函数是非确定且不纯的，因为它 | |||
* <code>builtins.getEnv</code> 函数也是不纯的。请避免从环境变量中读取数据，同样，也不要引用 flake 目录之外的文件。 | * <code>builtins.getEnv</code> 函数也是不纯的。请避免从环境变量中读取数据，同样，也不要引用 flake 目录之外的文件。 | ||