Holoscan Debian apt 安装

要解决什么问题

在 Ubuntu（含 Jetson / IGX 等 ARM64）上跑 Holoscan 边缘 AI 流水线时，C++ SDK 往往不能靠系统自带包安装，而需要从 NVIDIA 官方 apt 源拉取 holoscan-cuda-12、holoscan-cuda-13 或通用 holoscan 等变体。选错变体会直接触发 CUDA driver version is insufficient；仓库或 cuda-keyring 未配好时还会出现 Unable to locate package。本技能面向「已有可用 NVIDIA 驱动（nvidia-smi 正常）」的主机，把文档里的 Debian/apt 流程落成可执行的检查、安装与验证路径。

技能如何工作

安装前会先对照 官方安装说明 的 Debian/apt 章节，确认包名与支持发行版，并按 nvidia-smi 报告的 CUDA 版本 选定 apt 包（例如 13.x+ 用 holoscan-cuda-13，非 IGX 的 12.x 用 holoscan-cuda-12）。

先决条件检查会尽量短路重复劳动：已装 cuda-keyring、仓库已在 apt-cache 中可见、或目标包已安装时，会跳过对应步骤。

验证侧重 C++ 侧：设置栈大小（如 ulimit -s 32768）、LD_LIBRARY_PATH 指向 /opt/nvidia/holoscan/lib 等，运行捆绑示例确认运行时与头文件可用；验证通过后会给出可写入 ~/.bashrc 的环境片段。

边界与注意

• apt 路径不提供 Python 绑定（自 v3.0.0 起 Debian 包仅 C++）；需要 Python 时应配合 holoscan-install-wheel 技能。
• 仅限 Ubuntu；其它发行版需容器或 wheel 安装。
• 示例缺数据时可设置 HOLOSCAN_INPUT_PATH 或运行 download_example_data；libholoscan_core.so 加载失败通常是未导出 LD_LIBRARY_PATH。