holoscan-install-debian

Holoscan 5.x Debian 安装

发行版和平台检查

此技能面向 Holoscan SDK 5.x。选择所需的 5.x 发行版后，再选择对应的制品。阅读该版本的发行说明以及匹配的 SDK 安装指南。 选择 5.x 文档版本；未指定版本的页面可能介绍的是 4.x。 对于尚未发布的代码检出版本，请使用其 docs/sdk_installation.mdx 和 DEVELOP.md。Early Access 二进制命令介绍的是计划中的制品，因此安装前请确认对应发行版的制品已发布。如果尚未发布，请说明其状态并提供 holoscan-install-source；保留所需的 5.x 版本。

5.0 制品集面向 CUDA 13，以及 x86_64 或 arm64 上的 dGPU 系统。原生软件包使用 Ubuntu 24.04；wheel 使用 glibc 2.39 和常规 CPython 3.12–3.14。请检查所选发行版的变更，确认该矩阵是否有调整。此制品集中没有 CUDA 12 变体，也没有单独的 Tegra/iGPU 制品。驱动报告支持 CUDA 12 时，安装 CUDA 13 前需要评估兼容性或升级驱动；nvidia-smi 中的 CUDA 字段表示驱动支持能力，而非已安装的工具包版本。切勿仅凭该字段推断兼容性。

选择软件包并检查可用性

此路径会在 /usr 下提供 C++ 库、头文件、CMake 配置和 C++ 示例。Python 绑定需另行使用 holoscan-install-wheel。 计划中的制品集支持 Ubuntu 24.04 x86_64 和 SBSA arm64；SBSA 并不表示支持 Tegra/iGPU。

目标	软件包
完整 SDK	holoscan
仅核心库	holoscan-core
可选模块	holoscan-vision、holoscan-visualization、holoscan-inference

检查 /etc/os-release、uname -m、nvidia-smi 和现有软件包。 如有需要，请使用 Holoscan 下载中的、针对具体发行版的网络/本地安装程序配置 CUDA APT 仓库。根据实际情况选择 ubuntu2404/x86_64 或 ubuntu2404/sbsa；遵循已发布的、针对具体发行版的安装程序说明和软件包名称。

获准设置仓库后，刷新元数据并检查候选版本：

sudo apt update
apt-cache policy holoscan holoscan-core holoscan-vision holoscan-visualization holoscan-inference
apt-cache madison holoscan holoscan-core

选择与所需 5.x 发行版对应的确切 APT 版本。来自 4.x 的候选版本并非可用的 5.x 软件包。所有可选模块都应与 Core 使用相同的发行版。安装前预览依赖项变更：

# APT_VERSION is the exact available 5.x Debian version, including its revision.
apt-get --simulate install "holoscan=${APT_VERSION}"

如仅安装 Core，请替换为 holoscan-core。添加所选的可选模块软件包，并使用相匹配的版本。应用前请检查模拟事务是否会移除软件包，或是否涉及现有的 4.x 安装。 如果模拟失败，或提出超出所请求范围的变更，请停止并报告失败的命令/输出或冲突变更。解决冲突，或在安装前取得对扩大范围的授权。仅存在 4.x 安装本身，并不会阻止用户已请求的升级。

模拟事务符合要求后，安装所选的软件包集：

sudo apt install "holoscan=${APT_VERSION}"

验证 C++ 支持

dpkg-query -W 'holoscan*'
dpkg -L holoscan-core-cuda-13

未带后缀的组件软件包会选择 CUDA 13 原生软件包，例如 holoscan-core-cuda-13；请检查其已安装版本和文件列表。 使用软件包文件列表，在系统库层级下找到已安装的 hello_world/cpp/hello_world 和 hello_core/cpp/hello_core 可执行文件。 运行它们，预期输出分别为 Hello Holoscan! 和 holoscan core sample complete。 使用已安装的 hello_world 源码及其 CMakeLists.txt，在用户可写的构建目录中进行小型使用者构建；验证 find_package(holoscan) 和 holoscan::core 目标。先检查 cmake --version 报告的版本是否为 4.0 或更高；Ubuntu 24.04 默认的 CMake 3.28 无法配置该使用者项目。 请检查软件包内容，而不要导出旧的 /opt/nvidia/holoscan/lib 路径。将缺失的示例软件包记录为验证缺口。

Core 声明了 CUDA 开发依赖项；Vision 提供其 CV-CUDA 运行时，Inference 则建议使用 TensorRT 10 运行时库。请在声称完全支持之前，检查 应用所选的模块及其依赖项。 报告已安装的软件包版本、C++ 检查结果，以及任何未经测试的 GPU／模块路径。 如果用户要求进行 Python 导入，请说明 C++／Python 软件包的区别，并使用相同 SDK 版本的 wheel 工作流。