在Nix包管理器中集成Lan-Mouse的技术实践

Lan-Mouse是一款跨平台的鼠标键盘共享软件，类似于苹果设备上的通用控制功能。它允许用户使用单套鼠标键盘控制多台计算机，实现了多设备输入共享的功能。本文将详细介绍如何将Lan-Mouse集成到Nix包管理系统中。

背景与挑战

Lan-Mouse主要针对Linux Wayland环境设计，同时也支持Windows、MacOS和Xorg环境。在将其打包为Nix包时，开发者遇到了几个技术挑战：

1. 构建过程中缺少glib-compile-resources命令
2. 需要正确处理GTK4和libadwaita等GUI依赖
3. 需要配置适当的系统级服务以实现开机自启

解决方案

基础Nix包定义

通过分析构建错误和依赖关系，最终确定了以下Nix包定义：

rustPlatform.buildRustPackage rec {
  pname = "lan-mouse";
  version = "20240124";

  nativeBuildInputs = with pkgs; [
    pkg-config
    cmake
    buildPackages.gtk4
  ];

  buildInputs = with pkgs; [
    xorg.libX11
    gtk4
    libadwaita
    xorg.libXtst
  ];

  src = fetchFromGitHub {
    owner = "feschber";
    repo = "lan-mouse";
    rev = "8084b52cfc8c661baa43fbea158e0b44cd0ae203";
    hash = "sha256-qaPnTbfO1aabm4UsNKHXg/BoEnpNvNgqmIT4+tNG6Tw=";
  };

  cargoLock = {
    lockFile = "${src}/Cargo.lock";
    outputHashes = {
      "reis-0.1.0" = "sha256-sRZqm6QdmgqfkTjEENV8erQd+0RL5z1+qjdmY18W3bA=";
    };
  };

  RUST_BACKTRACE = "full";
}

关键点在于：

• 将GTK4同时添加到nativeBuildInputs和buildInputs
• 正确指定Cargo.lock文件和依赖哈希
• 启用完整的Rust回溯信息以辅助调试

系统服务集成

为了提供更好的用户体验，可以创建systemd用户服务实现开机自启：

systemd.user.services.lan-mouse = {
  description = "Lan Mouse";
  after = ["graphical-session.target"];
  bindsTo = ["graphical-session.target"];
  wantedBy = ["graphical-session.target"];

  serviceConfig = {
    ExecStart = "${pkgs.lan-mouse}/bin/lan-mouse --daemon";
    Restart = "on-failure";
  };
};

这种配置确保服务在图形会话启动后自动运行，并在失败时自动重启。

技术细节解析

1. 依赖处理：

   • GTK4开发包必须同时作为nativeBuildInputs和buildInputs
   • libadwaita提供现代GNOME界面组件
   • X11相关库提供底层输入共享支持

2. 构建过程：

   • 使用Rust平台的buildRustPackage构建工具
   • 显式指定Cargo.lock文件确保依赖版本一致
   • 为自定义crate(reis)提供预计算哈希值

3. 运行时配置：

   • 设置RUST_BACKTRACE环境变量便于问题诊断
   • 使用daemon模式运行减少资源占用

实际应用建议

对于希望在生产环境使用Lan-Mouse的NixOS用户，建议：

1. 将包定义提交到nixpkgs官方仓库
2. 考虑添加桌面条目(Desktop Entry)以便图形化启动
3. 实现配置管理，允许用户自定义连接参数
4. 添加多架构支持，特别是ARM平台

总结

通过合理的Nix包定义和系统集成，Lan-Mouse可以很好地融入NixOS生态系统。这一实践不仅解决了特定软件的打包问题，也为类似GUI应用的Nix集成提供了参考模式。未来随着Wayland生态的成熟，这类输入共享工具将发挥更大作用。