Packages 与 Apps

目录约定

框架支持三种 package 布局：

布局	示例	说明
跨平台（推荐）	packages/hello/default.nix	对所有 systems 生成
system-first（推荐）	packages/x86_64-linux/hello/default.nix	仅对应架构
后缀兼容（不推荐）	packages/hello.x86_64-linux/default.nix	旧式，可能歧义

新配置推荐使用跨平台或 system-first 两种，避免点号歧义。

包文件签名

# packages/hello/default.nix
{ stdenv, lib, ... }:
stdenv.mkDerivation {
  pname = "hello";
  version = "1.0";
  src = ./.;
}

除标准 pkgs 参数外，可按需声明 inputs、self、snowveil：

{ stdenv, inputs, ... }:
stdenv.mkDerivation {
  src = inputs.my-source;
}

统一 nixpkgs 配置

自动发现的包使用与 NixOS/HM 相同的 nixpkgs 实例（含 nixpkgs.config 与 overlays），不再使用未经配置的 legacyPackages：

outputs = inputs:
  inputs.snowveil.lib.mkFlake {
    inherit inputs;
    nixpkgs = {
      config.allowUnfree = true;
      overlays = [ (final: prev: { myPkg = ...; }) ];
    };
  };

Apps

apps/<name>/default.nix 映射为 apps.<system>.<name>：

# apps/hello/default.nix
{ lib, hello }:
{
  type = "app";
  program = lib.getExe hello;
}

nix run .#hello

Formatter

# formatter/default.nix
{ nixfmt }:
nixfmt

nix fmt

禁用特定 output

inputs.snowveil.lib.mkFlake {
  inherit inputs;
  outputs.disabled = [
    "packages.some-broken-package"
    "checks.x86_64-linux.expensive"
    "apps.debug"
  ];
}

也可用 meta.nix 禁用单个条目：

# packages/some-package/meta.nix
{
  enable = false;
  systems = [ "x86_64-linux" ];  # 限制架构
}